turbo.json

{
  "$schema": "https://turborepo.com/schema.json",
  "ui": "tui",
  "remoteCache": { "signature": true },
  "agentGuidance": false,
  // errors-only output still prints a start and finish line per task
  "futureFlags": { "errorsOnlyShowHash": true },
  "tasks": {
    "transit": {
      "dependsOn": ["^transit"]
    },
    "build": {
      // umbrella over own-package passes; no-ops where scripts are absent
      "dependsOn": ["^build", "build:js", "build:types"],
      "outputs": ["dist/**"]
    },
    "build:js": {
      // oxc-emit inlines the exported @repo/* sources; no task edge hashes them
      "inputs": [
        "$TURBO_DEFAULT$",
        "$TURBO_ROOT$/packages/shared/*/src/*.ts",
        "$TURBO_ROOT$/packages/shared/*/package.json"
      ],
      "outputs": ["dist/**/*.js", "dist/**/*.js.map"]
    },
    "build:types": {
      // self-chain to build types transitively; the edge also hashes the @repo/* sources a package declares and inlines
      "dependsOn": ["^build:types"],
      "outputs": ["dist/**/*.d.ts", "dist/**/*.d.ts.map"]
    },
    "test": {
      // Suites import workspace deps by their published entry (dist), so the
      // upstream build is a real precondition — it was previously supplied by
      // accident, via the timing cushion of the old `^test` chain.
      "dependsOn": ["^build"],
      // $TURBO_DEFAULT$ is the key; the globs only document what the lane reads
      "inputs": [
        "$TURBO_DEFAULT$",
        "src/**/*.ts",
        "vitest.config.ts",
        "vitest.setup.ts"
      ],
      "env": ["VITEST_BROWSER_API_PORT", "VITE_EXPECT_LIT_MAJOR"],
      // CI, GITHUB_ACTIONS: they only pick reporters, so the artifact is
      // identical either way — hashing them would wall laptops off from CI's cache.
      "passThroughEnv": ["WRANGLER_LOG", "CI", "GITHUB_ACTIONS"]
    },
    "@tools/dts-backtest#test": {
      "dependsOn": ["^build"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "fixtures/**",
        "run.ts",
        "tsconfig.fixture*.json"
      ]
    },
    // Full TS version matrix; distinct task name = distinct cache key from
    // the current-leg-only #test above. Runs on main push, not the PR graph.
    "@tools/dts-backtest#test:matrix": {
      "dependsOn": ["^build"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "fixtures/**",
        "run.ts",
        "tsconfig.fixture*.json"
      ]
    },
    "test:coverage": {
      "dependsOn": ["^build"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "src/**/*.ts",
        "vitest.config.ts",
        "vitest.setup.ts"
      ],
      "env": ["VITEST_BROWSER_API_PORT", "VITE_EXPECT_LIT_MAJOR"],
      "passThroughEnv": ["CI", "GITHUB_ACTIONS"],
      "outputs": ["coverage/**"]
    },
    // Report-only CRAP hotspots from this package's coverage-final.json; in no
    // ci:* graph.
    "crap": {
      "dependsOn": ["test:coverage"],
      "inputs": ["$TURBO_DEFAULT$"]
    },
    // Report-only tinybench timings into each package's .cache/; measures the
    // host, so uncached. In no ci:* graph: the Acceptance workflow's
    // `acceptance (bench)` job runs it.
    "bench": {
      // per-task time budget; CI shortens it
      "env": ["BENCH_TIME_MS"],
      // the result files' sha field; git HEAD is the fallback
      "passThroughEnv": ["GITHUB_SHA"],
      "cache": false
    },
    // Firefox+WebKit full-suite pass for the vitest packages; chromium
    // correctness rides test:coverage on PRs. Runs on main push, not the
    // PR graph.
    "test:engines": {
      "dependsOn": ["^build"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "src/**/*.ts",
        "vitest.config.ts",
        "vitest.setup.ts"
      ],
      "env": ["VITEST_BROWSER_API_PORT", "VITE_EXPECT_LIT_MAJOR"],
      "passThroughEnv": ["CI", "GITHUB_ACTIONS"]
    },
    // Same unit suites resolved against the lit-2 alias (the 2.x line the
    // published lit peer range covers); cheap enough for the PR graph — no
    // extra browsers, and the alias tracks published lit, so no peer-floor
    // atomicity concern. $TURBO_DEFAULT$ covers the extra configs; the
    // workspace yaml feeds lit2-compat-guard (peer range + alias pin).
    // The lit-2 types ride the sibling typecheck:lit2 task, never chained
    // here: a runtime failure would mask the typecheck result.
    "test:lit2-compat": {
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/pnpm-workspace.yaml"],
      "env": ["VITEST_BROWSER_API_PORT", "VITE_EXPECT_LIT_MAJOR"],
      "passThroughEnv": ["CI", "GITHUB_ACTIONS"]
    },
    // Same unit suites resolved against the mobx-6 alias (the 6.x line the
    // widened mobx peer range still covers). Mirrors test:lit2-compat: no
    // extra browsers, alias tracks published mobx, workspace yaml feeds
    // mobx6-compat-guard (peer range + alias pin). The mobx-6 types ride the
    // sibling typecheck:mobx6 task, never chained here: a runtime failure
    // would mask the typecheck result.
    "test:mobx6-compat": {
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/pnpm-workspace.yaml"],
      "env": ["VITEST_BROWSER_API_PORT", "VITE_EXPECT_MOBX_MAJOR"],
      "passThroughEnv": ["CI", "GITHUB_ACTIONS"]
    },
    // Same unit suites resolved against the effect-3 alias (the 3.x line the
    // widened effect peer range still covers). Mirrors test:mobx6-compat, but
    // uploads coverage-effect3/ beside coverage/: the per-major shims in src
    // take their effect 3 branches only here.
    "test:effect3-compat": {
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/pnpm-workspace.yaml"],
      "env": ["VITEST_BROWSER_API_PORT", "VITE_EXPECT_EFFECT_MAJOR"],
      "passThroughEnv": ["CI", "GITHUB_ACTIONS"],
      "outputs": ["coverage-effect3/**"]
    },
    // The node --test suites resolved against the vite-7 alias (the 7.x line
    // the vite peer range covers) through a module resolve hook; mirrors
    // test:mobx6-compat. The vite-7 types ride typecheck:vite7.
    "test:vite7-compat": {
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/pnpm-workspace.yaml"],
      "passThroughEnv": ["CI", "GITHUB_ACTIONS"]
    },
    // Umbrellas (no script) fan out via dependsOn to the leaves that carry the
    // scripts and cache keys; `with` is only for persistent sidecars. A package
    // override replaces dependsOn wholesale, so it restates these lists.
    "lint": {
      "dependsOn": [
        "lint:oxlint",
        "//#lint:root",
        "//#lint:complexity",
        "//#lint:package-json",
        "//#lint:markdown",
        "//#lint:workflows",
        "//#lint:templates",
        "//#lint:doc-examples",
        "//#lint:md-examples",
        "//#lint:css",
        "@tools/repo-checks#check:patches",
        "@tools/repo-checks#check:shared-source",
        "@tools/repo-checks#check:dedupe",
        "@tools/repo-checks#check:single-version",
        "@tools/repo-checks#check:package-coverage",
        "@tools/repo-checks#check:graph-edges",
        "@tools/repo-checks#check:task-inputs",
        "@tools/repo-checks#check:knip",
        "@tools/release#check:release-closure"
      ]
    },
    "lint:oxlint": {
      // type-aware oxlint resolves cross-package imports to dist d.ts only;
      // the @tools/lint-elements edge folds its jsPlugin versions into the key
      "dependsOn": ["^build:types", "@tools/lint-elements#test"],
      // explicit globs hash gitignored files too, and oxlint reads none of
      // these: dist/, .cache/ and .probe-scratch/ mutate mid-graph (build:js,
      // pack:all tarballs, dts-backtest#test writing and deleting a probe under
      // its own package while this lane hashes), coverage/ and .turbo/ are
      // written by sibling lanes, and examples/* carry their own un-hoisted
      // npm installs
      "inputs": [
        "**/*.ts",
        "**/*.js",
        "!**/node_modules/**",
        "!**/dist/**",
        "!**/coverage/**",
        "!**/coverage-effect3/**",
        "!**/.turbo/**",
        "!**/.probe-scratch/**",
        "!.cache/**",
        "!**/.vitepress/cache/**",
        "$TURBO_ROOT$/.oxlintrc.json",
        "$TURBO_ROOT$/tools/lint-elements/elements.oxlintrc.json",
        "$TURBO_DEFAULT$"
      ],
      // selects github output, which the turbo_summary step re-emits
      "passThroughEnv": ["GITHUB_ACTIONS"]
    },
    "//#lint:root": {
      "inputs": [
        ".oxlintrc.json",
        "tools/lint-elements/elements.oxlintrc.json",
        "$TURBO_DEFAULT$"
      ],
      "passThroughEnv": ["GITHUB_ACTIONS"]
    },
    // Hard complexity ceiling over JS/TS outside gitignored paths (.vue files
    // aren't linted); disable comments don't apply
    // (tools/eslint/complexity-ceiling.ts mirrors the ignores).
    "//#lint:complexity": {
      "inputs": ["$TURBO_DEFAULT$"],
      // turns on github-formatter annotations, which the turbo_summary step re-emits
      "passThroughEnv": ["GITHUB_ACTIONS"]
    },
    // @tools/lit-template-lint over every tracked src .ts, each in its own tsconfig project.
    "//#lint:templates": {
      // element types come from each package's d.ts; check:graph-edges holds this list
      "dependsOn": [
        "eslint-plugin-lit-ui-router#build:types",
        "lit-ui-router#build:types",
        "lit-ui-router-effect#build:types",
        "lit-ui-router-mobx#build:types",
        "lit-ui-router-signals#build:types",
        "lit-ui-router-ssr#build:types",
        "ui-router-effect#build:types",
        "ui-router-mobx#build:types",
        "ui-router-navigation-location-plugin#build:types",
        "ui-router-registry#build:types",
        "ui-router-server#build:types",
        "ui-router-signals#build:types"
      ],
      "inputs": [
        "$TURBO_DEFAULT$",
        // `src/**`, not `src/**/*.ts`, so files directly in src/ count
        "packages/*/src/**",
        "apps/*/src/**",
        "examples/*/src/**",
        // examples check against the lit-ui-router their lockfile pins
        "examples/*/package-lock.json",
        "tools/lit-template-lint/src/**",
        "tools/shared/src/**",
        // each file is checked in its own tsconfig project
        "{packages,apps,examples}/*/tsconfig*.json",
        "tsconfig*.json",
        "pnpm-workspace.yaml"
      ]
    },
    // @tools/doc-example-check over the `ts` blocks in packages/*/src
    // `@example` tags, each one an in-memory module checked on the 7.1 API.
    "//#lint:doc-examples": {
      // examples import the published entry points, which resolve to dist
      // d.ts; package-qualified as for //#lint:templates (check:graph-edges)
      "dependsOn": [
        "eslint-plugin-lit-ui-router#build:types",
        "lit-ui-router#build:types",
        "lit-ui-router-effect#build:types",
        "lit-ui-router-mobx#build:types",
        "lit-ui-router-signals#build:types",
        "lit-ui-router-ssr#build:types",
        "ui-router-effect#build:types",
        "ui-router-mobx#build:types",
        "ui-router-navigation-location-plugin#build:types",
        "ui-router-registry#build:types",
        "ui-router-server#build:types",
        "ui-router-signals#build:types"
      ],
      "inputs": [
        "$TURBO_DEFAULT$",
        "packages/*/src/**",
        // export maps decide what each example's import resolves to
        "packages/*/package.json",
        "tools/doc-example-check/src/**",
        "tools/shared/src/resolution.ts",
        "tools/bootstrap/src/**",
        "pnpm-workspace.yaml",
        "pnpm-lock.yaml"
      ]
    },
    // @tools/md-content-mapper over the Markdown `ts` fences flagged `check`,
    // each one a module tsc checks through the 7.1 content mapper.
    "//#lint:md-examples": {
      // fences import each package's entry points, published or private, which
      // resolve to dist d.ts; package-qualified as for //#lint:templates (check:graph-edges)
      "dependsOn": [
        "eslint-plugin-lit-ui-router#build:types",
        "lit-ui-router#build:types",
        "lit-ui-router-effect#build:types",
        "lit-ui-router-mobx#build:types",
        "lit-ui-router-signals#build:types",
        "lit-ui-router-ssr#build:types",
        "postcss-lit-html#build:types",
        "ui-router-devtools#build:types",
        "ui-router-effect#build:types",
        "ui-router-mobx#build:types",
        "ui-router-navigation-location-plugin#build:types",
        "ui-router-otel#build:types",
        "ui-router-registry#build:types",
        "ui-router-server#build:types",
        "ui-router-signals#build:types"
      ],
      "inputs": [
        "$TURBO_DEFAULT$",
        // the Markdown tools/md-content-mapper/docs/tsconfig.json includes
        "*.md",
        "{apps,docs}/*.md",
        "packages/*/*.md",
        // reference/*/ is generated, so only the tracked tree is named
        "www/lit-ui-router.dev/*.md",
        "www/lit-ui-router.dev/{guides,packages,tutorial}/**/*.md",
        "www/lit-ui-router.dev/reference/index.md",
        // export maps decide what each fence's import resolves to
        "packages/*/package.json",
        "tools/md-content-mapper/package.json",
        "tools/md-content-mapper/src/**",
        "tools/md-content-mapper/docs/**",
        "tools/shared/src/resolution.ts",
        "tools/bootstrap/src/**",
        "pnpm-workspace.yaml",
        "pnpm-lock.yaml"
      ]
    },
    // stylelint over .css, .vue <style>, lit `css` blocks and <style> in lit html/svg templates;
    // stylelint.config.mjs maps each to its syntax and owns the ignores.
    "//#lint:css": {
      "inputs": [
        "$TURBO_DEFAULT$",
        // not gitignore-pruned, so the generated trees come off by hand
        "{apps,examples,packages,tools,www}/**/*.{css,vue,ts,mts,cts,js,mjs,cjs}",
        "!**/node_modules/**",
        "!**/dist/**",
        "!**/coverage/**",
        "!**/coverage-effect3/**",
        "!**/.turbo/**",
        "!**/.probe-scratch/**",
        "!**/.vitepress/cache/**",
        "!**/.cloudflare/**",
        "!**/worker-configuration.d.ts"
      ]
    },
    "//#lint:package-json": {
      // $TURBO_DEFAULT$ so the list can't go stale into a false cache hit;
      // the globs stay as documentation of what the lane actually reads
      "inputs": [
        "$TURBO_DEFAULT$",
        "**/package.json",
        "!**/node_modules/**",
        "!.claude/worktrees/**",
        "!**/.vitepress/cache/**",
        "eslint.config.ts",
        "tools/eslint/**",
        "!**/.turbo/**",
        "packages/eslint-plugin-lit-ui-router/src/**",
        "pnpm-workspace.yaml",
        ".oxlintrc.json"
      ],
      // turns on github-formatter annotations, which the turbo_summary step re-emits
      "passThroughEnv": ["GITHUB_ACTIONS"]
    },
    // Content lint (not config plumbing, so deliberately not under
    // //#lint:workflows): rumdl over every tracked .md. Its own cache group,
    // disjoint from oxfmt's format group, which owns .md *formatting*.
    "//#lint:markdown": {
      "inputs": [
        "**/*.md",
        "!**/node_modules/**",
        // rumdl lints tracked .md only, and this glob is not gitignore-pruned:
        // the sample apps stage READMEs into dist, typedoc writes www api/,
        // docs:release-stubs writes www package-releases/
        "!**/dist/**",
        "!www/lit-ui-router.dev/reference/*/**",
        "!www/lit-ui-router.dev/package-releases/**",
        "$TURBO_ROOT$/.config/rumdl.toml",
        "$TURBO_ROOT$/.config/mise/tasks/rumdl",
        "$TURBO_ROOT$/.config/mise/mise.lock"
      ],
      "passThroughEnv": ["GITHUB_ACTIONS"]
    },
    // Config-plumbing lint: one //# cache group per tool, aggregated by the
    // //#lint:workflows umbrella (which the lint task pulls in). The
    // lint_workflows mise umbrella covers the same set for the standalone
    // lint-workflows.yml job.
    "//#lint:workflows": {
      // no package.json script: turbo runs nothing for it, only its dependsOn
      "dependsOn": [
        "//#lint:actionlint",
        "//#lint:zizmor",
        "//#lint:toml",
        "//#lint:shellcheck"
      ]
    },
    "//#lint:actionlint": {
      // config.toml holds the task defs, mise.lock the tool pins.
      "inputs": [
        ".github/**",
        "$TURBO_ROOT$/.config/mise/config.toml",
        "$TURBO_ROOT$/.config/mise/mise.lock"
      ],
      "passThroughEnv": ["GITHUB_ACTIONS"]
    },
    "//#lint:zizmor": {
      "inputs": [
        ".github/**",
        "$TURBO_ROOT$/.config/mise/config.toml",
        "$TURBO_ROOT$/.config/mise/mise.lock"
      ]
    },
    "//#lint:toml": {
      // taplo lint over every tracked .toml; same input set as //#format:toml.
      "inputs": [
        "**/*.toml",
        "!**/node_modules/**",
        // gitignored mise overrides (setup writes one per worktree)
        "!$TURBO_ROOT$/.config/mise/**/*.local.toml",
        "$TURBO_ROOT$/.config/taplo.toml",
        "$TURBO_ROOT$/.config/mise/tasks/taplo",
        "$TURBO_ROOT$/.config/mise/mise.lock"
      ]
    },
    "//#lint:shellcheck": {
      // shellcheck over *.sh/*.bash + the extensionless mise task scripts it
      // shebang-scans (vendored sample-app scripts excluded in the task).
      "inputs": [
        "**/*.sh",
        "**/*.bash",
        "!**/node_modules/**",
        "$TURBO_ROOT$/.config/mise/tasks/**",
        "$TURBO_ROOT$/.config/mise/mise.lock"
      ]
    },
    // `turbo run typecheck` is the one command that answers "do the types
    // hold", so the compat typechecks are leaves of the same umbrella
    "typecheck": {
      "dependsOn": [
        "typecheck:tsc",
        "//#typecheck:root",
        "typecheck:src",
        "typecheck:lit2",
        "typecheck:mobx6",
        "typecheck:effect3",
        "typecheck:vite7"
      ]
    },
    "typecheck:tsc": {
      // types come from build:types alone; JS emit stays off the typecheck path
      "dependsOn": ["^build:types"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/tsconfig.base.json"]
    },
    "typecheck:src": {
      "dependsOn": ["^build:types"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/tsconfig.base.json"]
    },
    // src against the lit-2 alias's types; separate from test:lit2-compat so
    // the fast lane reports and caches without waiting on the suites.
    "typecheck:lit2": {
      "dependsOn": ["^build:types"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "$TURBO_ROOT$/tsconfig.base.json",
        "$TURBO_ROOT$/pnpm-workspace.yaml"
      ]
    },
    // src against the mobx-6 alias's types; separate from test:mobx6-compat so
    // the fast lane reports and caches without waiting on the suites. Gated,
    // unlike typecheck:peer-floor: the alias tracks published mobx.
    "typecheck:mobx6": {
      "dependsOn": ["^build:types"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "$TURBO_ROOT$/tsconfig.base.json",
        "$TURBO_ROOT$/pnpm-workspace.yaml"
      ]
    },
    // src against the effect-3 alias's types; mirrors typecheck:mobx6.
    "typecheck:effect3": {
      "dependsOn": ["^build:types"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "$TURBO_ROOT$/tsconfig.base.json",
        "$TURBO_ROOT$/pnpm-workspace.yaml"
      ]
    },
    // the vite seams against the vite-7 alias's types; mirrors typecheck:mobx6.
    "typecheck:vite7": {
      "dependsOn": ["^build:types"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "$TURBO_ROOT$/tsconfig.base.json",
        "$TURBO_ROOT$/pnpm-workspace.yaml"
      ]
    },
    "typecheck:peer-floor": {
      // manual-only: not in ci — the floor pin can only reference published
      // versions, so gating would break atomic core-API + mobx-adoption PRs
      // floor comes from the catalog; the aliased package is pinned by the lockfile
      // workspace peers without a floor alias resolve to their built d.ts
      "dependsOn": ["^build:types"],
      "inputs": [
        "$TURBO_DEFAULT$",
        "$TURBO_ROOT$/tsconfig.base.json",
        "$TURBO_ROOT$/pnpm-workspace.yaml",
        "$TURBO_ROOT$/pnpm-lock.yaml"
      ]
    },
    "//#typecheck:root": {
      "inputs": ["$TURBO_DEFAULT$"]
    },
    "ci:pull_request": {
      "dependsOn": [
        "build",
        "test",
        "test:coverage",
        "test:lit2-compat",
        "test:mobx6-compat",
        "test:effect3-compat",
        "test:vite7-compat",
        "lint",
        "typecheck",
        "format:check",
        "check:bundle",
        "check:dev-split",
        "@tools/release#check:exports"
      ]
    },
    // Bundles each dist export the way consumers install it, so the own
    // package's build:js runs first; workspace deps stay external. floor-guard
    // runs here too and reads its ranges from the catalogs.
    "check:bundle": {
      "dependsOn": ["transit", "build:js"],
      "inputs": ["$TURBO_DEFAULT$", "$TURBO_ROOT$/pnpm-workspace.yaml"]
    },
    // Reader of the two-pass build:js emit: asserts the declared dev-only
    // warnings ship in dist/development/*.js and in no dist/*.js. Own package's
    // build:js only — it reads that package's dist, nothing upstream.
    "check:dev-split": {
      "dependsOn": ["build:js"],
      "inputs": ["$TURBO_DEFAULT$", "dev-warnings.json"]
    },
    "ci:main": {
      // PR graph plus the main-only guards, scheduled by one turbo
      // invocation; future main-only guards join this dependsOn, not new
      // workflow steps.
      "dependsOn": [
        "ci:pull_request",
        "test:engines",
        "@tools/release#check:pack",
        "@tools/dts-backtest#test:matrix"
      ]
    },
    "ci": {
      // back-compat alias: `mise run ci` / `pnpm run ci` keep working
      "dependsOn": ["ci:pull_request"]
    },
    "codecov:bundle": {
      "dependsOn": ["build"],
      "cache": false,
      "passThroughEnv": ["CODECOV_TOKEN", "CI", "GITHUB_*"]
    },
    // Not in any ci:* graph — the gate is format:check. Run it ALONE: oxfmt
    // truncates in place, so any reader co-scheduled with it (lint:templates,
    // test, format:check) can observe a 0-byte source file.
    "format": {
      "dependsOn": ["format:oxfmt", "//#format:root", "//#format:toml"]
    },
    // WRITER. Rewrites its own inputs in place and declares no outputs, so a
    // cache hit restores nothing and silently leaves the tree unformatted;
    // uncacheable is the only correct setting.
    "format:oxfmt": {
      "cache": false
    },
    "format:check": {
      "dependsOn": [
        "format:check:oxfmt",
        "//#format:check:root",
        "//#format:check:toml"
      ]
    },
    "format:check:oxfmt": {
      // oxfmt skips gitignored files but this glob does not, so the generated
      // trees have to come off by hand (same set as `lint:oxlint` above)
      "inputs": [
        "**/*.{ts,js,mjs,cjs,json,jsonc,md,yml,yaml,html,vue,css}",
        "!**/node_modules/**",
        "!**/dist/**",
        "!**/coverage/**",
        "!**/coverage-effect3/**",
        "!**/test-results/**",
        "!**/.turbo/**",
        "!**/.probe-scratch/**",
        "!.cache/**",
        "!**/.vitepress/cache/**",
        ".oxfmtrc.json",
        "$TURBO_ROOT$/.oxfmtrc.json"
      ]
    },
    // WRITER, uncacheable for the same reason as `format:oxfmt` above.
    "//#format:root": {
      "cache": false
    },
    "//#format:check:root": {
      "inputs": ["$TURBO_DEFAULT$"]
    },
    // taplo owns .toml, disjoint from the oxfmt writers above. WRITER,
    // uncacheable for the same reason as `format:oxfmt`. //#format:check:toml keeps
    // the .toml-scoped cache key.
    "//#format:toml": {
      "cache": false
    },
    "//#format:check:toml": {
      "inputs": [
        "**/*.toml",
        "!**/node_modules/**",
        // gitignored mise overrides (setup writes one per worktree)
        "!$TURBO_ROOT$/.config/mise/**/*.local.toml",
        "$TURBO_ROOT$/.config/taplo.toml",
        "$TURBO_ROOT$/.config/mise/tasks/taplo",
        "$TURBO_ROOT$/.config/mise/mise.lock"
      ]
    },
    "e2e": {
      "dependsOn": ["^build"],
      "with": ["@www/lit-ui-router.dev#wrangler:dev"],
      // Override of the default in www/lit-ui-router.dev/dev-port.ts; both the
      // server and the Playwright config read it, so it must reach both.
      // E2E_BASE_URL points the Playwright config at another origin instead.
      "passThroughEnv": ["WWW_DEV_PORT", "E2E_BASE_URL"],
      "cache": false,
      "persistent": true
    },
    "dev": {
      "dependsOn": ["^build"],
      "cache": false,
      "persistent": true
    },
    "docs": {
      "dependsOn": ["^build"],
      "cache": false,
      "persistent": true
    },
    "docs:api": {
      // deliberately no self-chain (cf. build:types): it would serialize these
      "dependsOn": ["^build"],
      "inputs": ["$TURBO_DEFAULT$"]
    }
  }
}