Files

689 lines
25 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import "vite-plus/test/config";
import { defineConfig } from "vite-plus";
import * as NodeURL from "node:url";
import { remoteCacheUrl } from "./infra/task-cache/src/remoteCache.ts";
import { cachedTestTasks } from "./scripts/lib/cached-tests.ts";
const TEST_EXCLUDE = [
"**/.repos/**",
"**/.hanzo-dev/**",
"**/node_modules/**",
"**/dist/**",
"**/dist-electron/**",
"**/.{idea,git,cache,output,temp}/**",
];
// Directories whose tests belong to a package's own test config. desktop also
// owns the kde-snap-shot tests through its `include`.
const TEST_CONFIG_PACKAGES = [
"apps/desktop",
"apps/mobile",
"apps/server",
"apps/web",
"packages/client-runtime",
];
// `vp test run <file>` from the repo root hands each file to its package's
// config. Packages that borrow this config (`--config ../../vite.config.ts`) run
// from their own directory, as CI does, so they keep one plain project.
const isRepoRootTestRun = process.cwd() === import.meta.dirname;
const RESTRICTED_IMPORT_PATHS = [
{
name: "react-native",
importNames: ["FlatList"],
message:
"Use LegendList from @legendapp/list/react-native, with renderScrollComponent={NativeScrollView} in a screen. Pass whatever renderItem reads through extraData: rows only re-render when their item or extraData changes.",
},
{
name: "@hanzodev/client-runtime",
message:
"Import from an explicit @hanzodev/client-runtime/* subpath. The package has no root export.",
},
{
name: "@pierre/diffs/react",
importNames: ["CodeView"],
message: "Use StyledDiffCodeView so web diff surfaces share styling and virtualized geometry.",
},
{
name: "react-native-screens",
importNames: ["ScrollViewMarker"],
message:
"Use NativeScrollViewMarker or NativeScrollView (src/native/NativeScrollViewMarker.tsx): they carry the header's scroll-edge blur under the Duo's vertical bar.",
},
{
name: "react-native",
importNames: ["RefreshControl"],
message:
"Use RefreshControl from src/components/ui/RefreshControl: Android bottom sheets own the pull at the top, so it steps aside there.",
},
];
const RESTRICTED_UI_VARIANT_PATTERNS = [
{
group: ["**/components/ui/*", "**/ui/*", "./ui/*"],
importNames: ["buttonVariants", "toggleVariants", "badgeVariants", "selectTriggerVariants"],
message:
"Render the components/ui export instead of borrowing its class recipe (render={<Button …/>}, SelectButton, ToggleGroup).",
},
];
const RESTRICTED_PULL_REQUEST_GLYPH_IMPORTS = {
name: "lucide-react",
importNames: [
"GitMerge",
"GitMergeIcon",
"GitPullRequest",
"GitPullRequestIcon",
"GitPullRequestArrow",
"GitPullRequestArrowIcon",
"GitPullRequestClosed",
"GitPullRequestClosedIcon",
"GitPullRequestDraft",
"GitPullRequestDraftIcon",
"GitPullRequestCreate",
"GitPullRequestCreateIcon",
"GitPullRequestCreateArrow",
"GitPullRequestCreateArrowIcon",
],
message:
"Pick a glyph by meaning from PullRequestGlyph in apps/web/src/components/pullRequest/pullRequestIcons.tsx so every surface draws the same pull request the same way.",
};
// Vite+ supports remote configuration before its published types include it.
const cacheUrl = remoteCacheUrl(import.meta.dirname);
const taskCacheConfig = {
scripts: false,
...(cacheUrl ? { remote: { url: cacheUrl } } : {}),
};
export default defineConfig({
run: {
cache: taskCacheConfig,
tasks: {
...cachedTestTasks(process.env.HANZO_CACHED_TESTS),
// The two knip passes read the same files and write nothing, so they run side by side.
// The `knip:check` script runs this task, so `vp run knip:check` and `pnpm run knip:check` both use it.
"knip:check:all": {
command: 'node -e ""',
dependsOn: ["knip:check:files", "knip:check:exports"],
cache: false,
},
},
},
resolve: {
alias: {
"~": NodeURL.fileURLToPath(new URL("./apps/web/src", import.meta.url)),
},
},
test: {
environment: "node",
// Fixture subprocesses must not inherit the outer task runner’s cache policy.
env: { VP_REMOTE_CACHE: "off", VP_REMOTE_CACHE_URL: "" },
exclude: TEST_EXCLUDE,
hookTimeout: 60_000,
testTimeout: 60_000,
allowOnly: !process.env.CI,
// Flaky tests are fixed, not retried.
retry: 0,
fakeTimers: {
toFake: [
"setTimeout",
"clearTimeout",
"setInterval",
"clearInterval",
"setImmediate",
"clearImmediate",
"Date",
"performance",
"requestAnimationFrame",
"cancelAnimationFrame",
"requestIdleCallback",
"cancelIdleCallback",
],
},
setupFiles: [
NodeURL.fileURLToPath(
new URL("./packages/shared/src/testing/longTempDir.ts", import.meta.url),
),
NodeURL.fileURLToPath(
new URL("./packages/shared/src/testing/providerEnv.ts", import.meta.url),
),
NodeURL.fileURLToPath(new URL("./packages/shared/src/testing/gitEnv.ts", import.meta.url)),
],
...(isRepoRootTestRun
? {
projects: [
...TEST_CONFIG_PACKAGES,
{
extends: true,
test: {
name: "root",
exclude: [
...TEST_EXCLUDE,
...TEST_CONFIG_PACKAGES.map((dir) => `${dir}/**`),
"native/kde-snap-shot/**",
],
},
},
],
}
: {}),
},
staged: {
// In order, so lint reads the formatted file. CI lint failures cost a full round trip.
"*": ["vp fmt --no-error-on-unmatched-pattern", "vp lint --no-error-on-unmatched-pattern"],
// knip checks the whole repo, so it takes no file list. Any code or manifest change can leave
// a file, export, or dependency unused.
"{*.{js,jsx,ts,tsx,mjs,cjs,mts,cts},package.json,knip.jsonc}": () => "vp run knip:check",
},
fmt: {
ignorePatterns: [
".repos/**",
"infra/task-cache/vendor/**",
// Macroscope requires one glob per line; Markdown formatting corrupts it.
".macroscope/ignore.md",
".alchemy",
"dist",
"dist-electron",
"node_modules",
"pnpm-lock.yaml",
"*.tsbuildinfo",
"**/routeTree.gen.ts",
"**/*.graphql.ts",
"packages/source-control-github/schema/**",
"apps/server/schema/**",
"apps/mobile/android/**",
"apps/mobile/ios/**",
"apps/mobile/uniwind-types.d.ts",
// Vendored and generated C.
"apps/mobile/modules/hanzo-highlights/Vendor/**",
"apps/mobile/modules/hanzo-highlights/cpp/generated/**",
"apps/mobile/modules/hanzo-highlights/nitrogen/generated/**",
"*.icon/**",
],
sortPackageJson: {},
overrides: [
{
files: [".devcontainer/devcontainer.json"],
options: {
trailingComma: "none",
},
},
],
},
lint: {
ignorePatterns: [
".repos",
".repos/**",
"infra/task-cache/vendor/**",
"dist",
"dist-electron",
"node_modules",
"pnpm-lock.yaml",
"*.tsbuildinfo",
"**/routeTree.gen.ts",
"**/*.graphql.ts",
"packages/source-control-github/schema/**",
"apps/server/schema/**",
"apps/mobile/android/**",
"apps/mobile/ios/**",
"apps/mobile/uniwind-types.d.ts",
],
plugins: ["eslint", "oxc", "react", "unicorn", "typescript"],
jsPlugins: ["./oxlint-plugin-hanzo/index.ts", "@shadcn/lint"],
settings: {
shadcn: { ui: "~/components/ui" },
},
categories: {
correctness: "warn",
suspicious: "warn",
perf: "warn",
},
rules: {
"oxc/no-accumulating-spread": "error",
"eslint/no-control-regex": "off",
"typescript/no-this-alias": "off",
"unicorn/prefer-add-event-listener": "off",
"unicorn/prefer-string-starts-ends-with": "off",
"unicorn/prefer-set-has": "off",
"unicorn/prefer-array-find": "off",
"unicorn/no-new-array": "off",
"unicorn/no-array-reverse": "off",
"react/no-object-type-as-default-prop": "off",
"react/jsx-no-constructed-context-values": "off",
"react/memo-dependencies": "error",
"react/purity": "error",
"react/refs": "error",
"react/exhaustive-effect-dependencies": "error",
"react/set-state-in-effect": "error",
"react/immutability": "error",
"react/no-array-index-key": "error",
"react/no-unstable-nested-components": "error",
"react/static-components": "error",
"react/capitalized-calls": "error",
"typescript/no-extraneous-class": "error",
"eslint/no-empty-pattern": "error",
"eslint/no-new": "error",
"unicorn/no-useless-spread": "error",
"eslint/no-unused-vars": [
"error",
{ argsIgnorePattern: "^_", varsIgnorePattern: "^_", caughtErrorsIgnorePattern: "^_" },
],
"eslint/no-unsafe-optional-chaining": "error",
"eslint/no-unneeded-ternary": "error",
"unicorn/no-useless-fallback-in-spread": "error",
"unicorn/require-module-specifiers": "error",
"unicorn/no-array-sort": "off",
"unicorn/consistent-function-scoping": "off",
"oxc/no-map-spread": "off",
"react-in-jsx-scope": "off",
"react-hooks/exhaustive-deps": "off",
"eslint/no-shadow": "off",
"eslint/no-await-in-loop": "off",
"eslint/no-underscore-dangle": "off",
"typescript/consistent-return": "off",
"typescript/no-base-to-string": "off",
"typescript/no-duplicate-type-constituents": "off",
"typescript/no-floating-promises": "off",
"typescript/no-implied-eval": "off",
"typescript/no-meaningless-void-operator": "off",
"typescript/no-redundant-type-constituents": "off",
"typescript/no-unnecessary-boolean-literal-compare": "off",
"typescript/no-unnecessary-type-conversion": "off",
"typescript/no-unnecessary-type-arguments": "off",
"typescript/no-unnecessary-type-assertion": "off",
"typescript/no-unnecessary-type-parameters": "off",
"typescript/no-unsafe-type-assertion": "off",
"typescript/await-thenable": "off",
"typescript/require-array-sort-compare": "off",
"typescript/restrict-template-expressions": "off",
"typescript/unbound-method": "off",
"eslint/no-restricted-imports": [
"error",
{ paths: [...RESTRICTED_IMPORT_PATHS, RESTRICTED_PULL_REQUEST_GLYPH_IMPORTS] },
],
"hanzo/no-global-process-runtime": "error",
"hanzo/no-inline-schema-compile": "error",
"hanzo/no-low-value-comments": "error",
"hanzo/no-manual-effect-runtime-in-tests": "error",
"hanzo/no-native-title-tooltip": "error",
// Test files only (the rule checks the filename).
"hanzo/no-polling-loop-in-tests": "error",
"hanzo/no-raw-mcp-registration": "error",
"hanzo/no-real-time-wait-in-tests": "error",
"hanzo/no-test-in-loop": "error",
"hanzo/no-test-timeout-or-unreasoned-skip": "error",
"hanzo/no-rpc-permission-bypass": ["error", { allowRawClientAccess: true }],
"hanzo/no-unscoped-has": "error",
"hanzo/no-wall-clock-in-tests": "error",
"hanzo/namespace-node-imports": "error",
"hanzo/prefer-catch-tags": "error",
"hanzo/prefer-effect-fn": "error",
"hanzo/require-centered-scroll-gutter": "error",
"hanzo/require-suppression-reason": "error",
},
overrides: [
{
files: [
"**/*.{test,spec,testkit}.{ts,tsx}",
"**/{test,tests,testkit,testing,fixtures,integration}/**",
"packages/provider-testing/**",
],
rules: { "hanzo/prefer-effect-fn": "off" },
},
{
files: ["apps/web/src/**", "apps/mobile/src/**", "apps/desktop/src/**"],
// Users still pick their own project icon from the full Lucide set.
excludeFiles: ["apps/web/src/projectIconOptions.ts"],
rules: { "hanzo/no-sparkles-icon": "error" },
},
{
files: ["apps/web/**/*.test.{ts,tsx}"],
rules: { "hanzo/require-disposable-render": "error" },
},
{
files: ["apps/web/src/**/*.browser.test.{ts,tsx}"],
rules: { "hanzo/no-frame-waits-in-browser-tests": "error" },
},
{
files: ["apps/**/src/**", "packages/**/src/**"],
rules: { "hanzo/no-dom-test-environment": "error" },
},
{
files: ["packages/client-runtime/src/state/**", "apps/{web,mobile,desktop}/src/**"],
rules: { "hanzo/no-rpc-permission-bypass": ["error", { allowRawClientAccess: false }] },
},
{
files: [
"packages/client-runtime/src/state/runtime.ts",
"packages/client-runtime/src/state/vcsAction.ts",
],
rules: {
"hanzo/no-rpc-permission-bypass": [
"error",
{ allowGuardInstallation: true, allowRawClientAccess: false },
],
},
},
{
files: [
"apps/web/src/components/settings/AuthorizedClientsSettings.tsx",
"apps/mobile/src/features/updates/app-updates.ts",
"apps/web/src/components/device/DevicePhoneViewport.tsx",
"apps/web/src/components/device/DeviceDuoViewport.tsx",
],
rules: { "hanzo/no-rpc-permission-bypass": ["error", { allowRawClientAccess: true }] },
},
{
files: ["packages/client-runtime/src/connection/outdatedHostUpdate.ts"],
rules: { "hanzo/no-rpc-permission-bypass": "off" },
},
{
files: [
"packages/client-runtime/src/rpc/**",
"**/*.{test,spec}.{ts,tsx,js,jsx,mts,cts,mjs,cjs}",
],
rules: { "hanzo/no-rpc-permission-bypass": "off" },
},
{
files: ["packages/shared/src/HostProcess.ts"],
rules: { "hanzo/no-global-process-runtime": "off" },
},
{
// The `hanzo` npm launcher is published as plain, dependency-free Node.
files: ["scripts/npm-launcher/**"],
rules: {
"hanzo/no-global-process-runtime": "off",
"hanzo/namespace-node-imports": "off",
},
},
{
files: ["apps/server/src/mcp/McpHttpServer.ts"],
rules: { "hanzo/no-raw-mcp-registration": "off" },
},
{
files: ["apps/web/src/**"],
excludeFiles: ["apps/web/src/components/ui/**"],
rules: {
"eslint/no-restricted-imports": [
"error",
{
paths: [...RESTRICTED_IMPORT_PATHS, RESTRICTED_PULL_REQUEST_GLYPH_IMPORTS],
patterns: RESTRICTED_UI_VARIANT_PATTERNS,
},
],
},
},
{
files: ["apps/web/src/components/pullRequest/pullRequestIcons.tsx"],
rules: { "eslint/no-restricted-imports": ["error", { paths: RESTRICTED_IMPORT_PATHS }] },
},
{
// The server and every client load a forge's shared definition, so a UI runtime
// imported there would break the server; client-only forge code goes in `src/client/`.
files: ["packages/source-control-*/src/shared/**"],
rules: {
"eslint/no-restricted-imports": [
"error",
{
paths: [...RESTRICTED_IMPORT_PATHS, RESTRICTED_PULL_REQUEST_GLYPH_IMPORTS],
patterns: [
{
group: [
"react",
"react/*",
"react-*",
"expo",
"expo-*",
"lucide-react",
"@hanzodev/client-runtime",
"@hanzodev/client-runtime/*",
"../client/*",
"../server/*",
"../../client/*",
"../../server/*",
"../../../client/*",
"../../../server/*",
"@hanzodev/source-control-*/client/*",
"@hanzodev/source-control-*/server/*",
],
message:
"Shared forge definitions load on the server and every client; keep UI and server code out.",
},
],
},
],
},
},
{
files: ["apps/server/src/**", "packages/source-control-*/src/server/**"],
rules: {
"eslint/no-restricted-imports": [
"error",
{
paths: [...RESTRICTED_IMPORT_PATHS, RESTRICTED_PULL_REQUEST_GLYPH_IMPORTS],
patterns: [
{
group: [
"@hanzodev/source-control-*/client/*",
"../client/*",
"../../client/*",
"../../../client/*",
],
message:
"A forge's client entry is UI-only; the server reads its `shared/definition`.",
},
],
},
],
},
},
{
files: ["apps/mobile/src/**"],
rules: {
"hanzo/no-mobile-uniwind-theme-escape-hatches": "error",
"hanzo/require-registered-list-scroll": "error",
},
},
{
files: ["apps/mobile/src/**"],
excludeFiles: [
"apps/mobile/src/components/ui/AppSymbol.tsx",
"apps/mobile/src/components/ui/AppSymbol.android.tsx",
"apps/mobile/src/features/pull-requests/pullRequestGlyphs.ts",
],
rules: { "hanzo/no-mobile-pull-request-glyph-literals": "error" },
},
{
files: ["apps/mobile/src/**"],
excludeFiles: ["**/*.test.{ts,tsx}"],
rules: { "hanzo/no-ambiguous-detail-navigation": "error" },
},
{
// Raw ResizeObserver state commits miss the paint; observeResize flushes derived layout together.
files: ["apps/web/src/**"],
excludeFiles: [
"apps/web/src/lib/observeResize.ts",
"**/*.{test,spec}.{ts,tsx,js,jsx,mts,cts,mjs,cjs}",
],
rules: { "hanzo/no-raw-resize-observer": "error" },
},
{
files: ["apps/web/src/**"],
rules: { "shadcn/no-unknown-classes": "error" },
},
{
files: ["apps/web/src/**"],
rules: { "hanzo/no-outset-state-indicators": "error" },
},
{
files: ["apps/web/src/**"],
rules: { "hanzo/max-settings-description-length": "error" },
},
{
files: ["apps/*/src/**", "packages/*/src/**"],
excludeFiles: [
"**/*.{test,spec}.{ts,tsx,js,jsx,mts,cts,mjs,cjs}",
"**/testkit/**",
"**/_generated/**",
// Real user quotes stay verbatim.
"apps/marketing/src/lib/tweets.ts",
],
rules: { "hanzo/no-em-dash-copy": "error" },
},
{
files: ["apps/web/src/**"],
rules: { "shadcn/no-raw-colors": "error" },
},
{
// Third-party marks must retain their exact colors.
files: ["apps/web/src/components/Icons.tsx", "apps/web/src/components/JetBrainsIcons.tsx"],
rules: { "shadcn/no-raw-colors": "off" },
},
{
files: ["apps/web/src/**"],
excludeFiles: ["apps/web/src/components/ui/**"],
rules: {
"shadcn/require-static-classes": "error",
"shadcn/no-arbitrary-values": [
"error",
{
allow: [
"layout",
"transition",
"rounded-[inherit]",
"gap-[0.33em]",
"gap-[0.2em]",
"leading-[normal]",
"underline-offset-[0.2em]",
"rounded-[25%]",
"text-[length:80cqh]",
"bg-[Highlight]",
"fill-[#26251E]",
"fill-[#EDECEC]",
"fill-[#0F0F0F]",
"fill-[#F5F5F5]",
"fill-[#d97757]",
"text-[#d97757]",
],
},
],
"shadcn/no-restyle": [
"error",
{
allow: ["layout"],
contracts: [
{
// CollapsibleTrigger has no styled counterpart; other triggers use render={<Button …/>}.
pattern: "^CollapsibleTrigger$",
allow: ["layout", "color", "typography", "spacing", "shape", "effects", "motion"],
},
],
},
],
},
},
// Registered always so a disable comment for intentional English counts as used.
// `vp run i18n:untranslated` counts what it flags.
{
files: ["apps/web/src/**", "apps/mobile/src/**", "packages/client-runtime/src/**"],
excludeFiles: [
"**/*.{test,spec,bench}.{ts,tsx}",
"**/{test,testkit,testing,fixtures}/**",
"**/*.test-fixtures.ts",
"**/{test-fixtures,*TestFixtures}.ts",
"apps/mobile/src/features/development/**",
"packages/client-runtime/src/rpc/**",
],
rules: { "hanzo/no-untranslated-copy": "error" },
},
{
// React Compiler owns memoization; upstream rules do not ban redundant useMemo/useCallback.
files: ["apps/web/src/**/*.{ts,tsx}"],
rules: {
"react/exhaustive-effect-dependencies": "error",
"react/globals": "error",
"react/hooks": "error",
"react/immutability": "error",
// The compiler memoizes context values; this rule would ask for useMemo.
"react/jsx-no-constructed-context-values": "off",
"react/memo-dependencies": "error",
"react/preserve-manual-memoization": "error",
// Render-time clock reads use @hanzodev/client-runtime/clock or state seeded with the
// time; any other read carries a suppression that says why. oxlint also flags time reads
// inside event handlers (oxc#27309); those suppressions cite it.
"react/purity": "error",
"react/refs": "error",
"react/set-state-in-effect": "error",
"react/set-state-in-render": "error",
"react/static-components": "error",
"react/unsupported-syntax": "error",
"hanzo/no-manual-memo": "error",
},
},
{
// ESNext types allow APIs absent from Hermes; restrict shared client code, exempting Node tests.
files: [
"apps/mobile/src/**",
"packages/client-runtime/src/**",
"packages/contracts/src/**",
"packages/shared/src/**",
],
excludeFiles: ["**/*.test.ts", "**/*.test.tsx"],
rules: { "hanzo/no-hermes-unsupported-apis": "error" },
},
{
// Directives hide bailouts from mobile's compiler-coverage check; retain hooks until its allowlist is empty.
files: ["apps/mobile/src/**/*.{ts,tsx}"],
rules: { "hanzo/no-manual-memo": ["error", { allowMemoHooks: true }] },
},
{
files: ["apps/web/src/**", "apps/mobile/src/**", "packages/*/src/**"],
rules: { "hanzo/no-unreasoned-state-sync": "error" },
},
{
// React Compiler caches use* functions only if they call a hook.
files: ["apps/web/src/**/*.{ts,tsx}", "apps/mobile/src/**/*.{ts,tsx}"],
excludeFiles: ["**/*.test.ts", "**/*.test.tsx"],
rules: { "hanzo/no-hookless-use-function": "error" },
},
{
files: [
"apps/mobile/src/features/archive/ArchivedThreadsScreen.tsx",
"apps/mobile/src/features/connection/ConnectionsNewRouteScreen.tsx",
"apps/mobile/src/features/files/FileMarkdownPreview.tsx",
"apps/mobile/src/features/files/SourceFileSurface.tsx",
"apps/mobile/src/features/files/AttachmentFileScreen.tsx",
"apps/mobile/src/features/files/ThreadFilesRouteScreen.tsx",
"apps/mobile/src/features/files/thread-file-navigator-pane.tsx",
"apps/mobile/src/features/layout/nested-stacks.tsx",
"apps/mobile/src/features/review/ReviewSheet.tsx",
"apps/mobile/src/features/review/useNativeReviewDiffBridge.ts",
"apps/mobile/src/features/settings/SettingsEnvironmentsRouteScreen.tsx",
"apps/mobile/src/features/threads/ThreadComposer.tsx",
"apps/mobile/src/components/ComposerSurface.tsx",
"apps/mobile/src/features/threads/ThreadFeed.tsx",
"apps/mobile/src/features/threads/ThreadQueueControl.tsx",
"apps/mobile/src/features/review/ReviewCommentCard.tsx",
"apps/mobile/src/features/threads/thread-list-v2-items.tsx",
"apps/mobile/src/components/ui/SecretTextInput.android.tsx",
"apps/mobile/src/lib/useMobileNavigationTheme.ts",
"apps/mobile/src/native/HanzoComposerEditor.ios.tsx",
"apps/mobile/src/native/HanzoComposerEditor.native.tsx",
"apps/mobile/src/native/SelectableMarkdownText.tsx",
"apps/mobile/src/native/useEnrichedLinkVariants.ts",
],
rules: {
"hanzo/no-mobile-uniwind-theme-escape-hatches": ["error", { allowUniwindTheme: true }],
},
},
],
options: {
reportUnusedDisableDirectives: "error",
typeAware: false,
typeCheck: false,
},
},
});