@timber-js/app 0.2.0-alpha.192 → 0.2.0-alpha.195

package/dist/params/codec-registry.d.ts

@@ -11,7 +11,7 @@
  *
  * Design doc: design/41-global-params.md §"Link Component"
  */
-import type { Codec } from '../codec.js';
+import type { Codec } from '../codec.ts';
 /**
  * Register the resolved schema codecs for use by Link's URL interpolation.
  * Called once at startup from the browser entry or RSC entry.

package/dist/params/define-schema.d.ts

@@ -7,8 +7,8 @@
  *
  * Design doc: design/41-global-params.md
  */
-import type { Codec, CatchAllCodec, OptionalCatchAllCodec } from '../codec.js';
-import type { StandardSchemaV1 } from '../schema-bridge.js';
+import type { Codec, CatchAllCodec, OptionalCatchAllCodec } from '../codec.ts';
+import type { StandardSchemaV1 } from '../schema-bridge.ts';
 /**
  * Infer the output type from a Codec, StandardSchemaV1, or nuqs parser.
  *

package/dist/params/index.d.ts

@@ -1,5 +1,5 @@
-export { defineSchema } from './define-schema.js';
-export type { InferCodecType, SchemaConfig, SegmentParamCodec, ValidDynamicSegmentKeys, ValidDynamicSegmentKeysRegistry, } from './define-schema.js';
-export { resolveSchemaCodecs, toBracketKey } from './resolve-schema.js';
-export { setLinkCodecs, getLinkCodec } from './codec-registry.js';
+export { defineSchema } from './define-schema.ts';
+export type { InferCodecType, SchemaConfig, SegmentParamCodec, ValidDynamicSegmentKeys, ValidDynamicSegmentKeysRegistry, } from './define-schema.ts';
+export { resolveSchemaCodecs, toBracketKey } from './resolve-schema.ts';
+export { setLinkCodecs, getLinkCodec } from './codec-registry.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/params/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/params/define-schema.ts"],"sourcesContent":["/**\n * defineSchema — global segment param schema definition.\n *\n * Identity function at runtime; the type information is what matters.\n * The Vite plugin reads the schema at build time for codegen, and\n * the pipeline reads it at runtime for coercion.\n *\n * Design doc: design/41-global-params.md\n */\n\nimport type { Codec, CatchAllCodec, OptionalCatchAllCodec } from '../codec.js';\nimport type { StandardSchemaV1 } from '../schema-bridge.js';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Infer the output type from a Codec, StandardSchemaV1, or nuqs parser.\n *\n * Used by codegen to reference schema types without hardcoding:\n *   `InferCodecType<typeof schema.segmentParams['[year]']>`\n */\nexport type InferCodecType<V> =\n  V extends Codec<infer T>\n    ? T\n    : V extends StandardSchemaV1<infer T>\n      ? T\n      : V extends { parseServerSide: (value: string) => infer T }\n        ? T\n        : string;\n\n/** Acceptable codec value for segment params: a Codec or Standard Schema. */\nexport type SegmentParamCodec = Codec<unknown> | StandardSchemaV1<unknown>;\n\n/** Codec constraint for catch-all segment keys (`[...name]`). */\nexport type CatchAllParamCodec = CatchAllCodec<unknown> | StandardSchemaV1<readonly unknown[]>;\n\n/** Codec constraint for optional catch-all segment keys (`[[...name]]`). */\nexport type OptionalCatchAllParamCodec =\n  | OptionalCatchAllCodec<unknown>\n  | StandardSchemaV1<readonly unknown[] | undefined>;\n\n/**\n * Resolves the required codec type for a given bracket key pattern.\n * - `[...name]`    → requires a catch-all codec\n * - `[[...name]]`  → requires an optional catch-all codec\n * - `[name]`       → accepts any segment param codec\n */\nexport type CodecForKey<K extends string> = K extends `[[...${string}]]`\n  ? OptionalCatchAllParamCodec\n  : K extends `[...${string}]`\n    ? CatchAllParamCodec\n    : SegmentParamCodec;\n\n/**\n * Registry interface augmented by codegen with known filesystem bracket keys.\n * When empty (no codegen yet), ValidDynamicSegmentKeys falls back to string.\n */\n// eslint-disable-next-line typescript/no-empty-interface -- augmented by codegen\nexport interface ValidDynamicSegmentKeysRegistry {}\n\n/**\n * Union of valid bracket keys for defineSchema.\n * After codegen runs, this is the set of filesystem segment names.\n * Before codegen (fresh project), accepts any string.\n */\nexport type ValidDynamicSegmentKeys = keyof ValidDynamicSegmentKeysRegistry extends never\n  ? string\n  : keyof ValidDynamicSegmentKeysRegistry & string;\n\n/** Configuration object for defineSchema. */\nexport interface SchemaConfig<S extends Record<string, SegmentParamCodec>> {\n  segmentParams: S;\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Define the global segment param schema.\n *\n * Each key uses the bracket syntax from the filesystem (`[id]`, `[...slug]`,\n * `[[...slug]]`) mapped to a codec. This makes the relationship between\n * filesystem segments and codecs visually obvious.\n *\n * A dynamic segment with no key here defaults to `string` at codegen time.\n *\n * ```ts\n * // app/schema.ts\n * import { defineSchema } from '@timber-js/app/params';\n * import { codec } from '@timber-js/app/codec';\n * import { z } from 'zod';\n *\n * export default defineSchema({\n *   segmentParams: {\n *     '[artistSlug]': codec.string,\n *     '[year]': codec.integer,\n *     '[id]': z.coerce.number().int(),\n *   },\n * });\n * ```\n */\nexport function defineSchema<\n  S extends {\n    [K in keyof S]: K extends ValidDynamicSegmentKeys\n      ? K extends string\n        ? CodecForKey<K>\n        : SegmentParamCodec\n      : never;\n  },\n>(config: { segmentParams: S }): { segmentParams: S } {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwGA,SAAgB,aAQd,QAAoD;CACpD,OAAO;AACT"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/params/define-schema.ts"],"sourcesContent":["/**\n * defineSchema — global segment param schema definition.\n *\n * Identity function at runtime; the type information is what matters.\n * The Vite plugin reads the schema at build time for codegen, and\n * the pipeline reads it at runtime for coercion.\n *\n * Design doc: design/41-global-params.md\n */\n\nimport type { Codec, CatchAllCodec, OptionalCatchAllCodec } from '../codec.ts';\nimport type { StandardSchemaV1 } from '../schema-bridge.ts';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/**\n * Infer the output type from a Codec, StandardSchemaV1, or nuqs parser.\n *\n * Used by codegen to reference schema types without hardcoding:\n *   `InferCodecType<typeof schema.segmentParams['[year]']>`\n */\nexport type InferCodecType<V> =\n  V extends Codec<infer T>\n    ? T\n    : V extends StandardSchemaV1<infer T>\n      ? T\n      : V extends { parseServerSide: (value: string) => infer T }\n        ? T\n        : string;\n\n/** Acceptable codec value for segment params: a Codec or Standard Schema. */\nexport type SegmentParamCodec = Codec<unknown> | StandardSchemaV1<unknown>;\n\n/** Codec constraint for catch-all segment keys (`[...name]`). */\nexport type CatchAllParamCodec = CatchAllCodec<unknown> | StandardSchemaV1<readonly unknown[]>;\n\n/** Codec constraint for optional catch-all segment keys (`[[...name]]`). */\nexport type OptionalCatchAllParamCodec =\n  | OptionalCatchAllCodec<unknown>\n  | StandardSchemaV1<readonly unknown[] | undefined>;\n\n/**\n * Resolves the required codec type for a given bracket key pattern.\n * - `[...name]`    → requires a catch-all codec\n * - `[[...name]]`  → requires an optional catch-all codec\n * - `[name]`       → accepts any segment param codec\n */\nexport type CodecForKey<K extends string> = K extends `[[...${string}]]`\n  ? OptionalCatchAllParamCodec\n  : K extends `[...${string}]`\n    ? CatchAllParamCodec\n    : SegmentParamCodec;\n\n/**\n * Registry interface augmented by codegen with known filesystem bracket keys.\n * When empty (no codegen yet), ValidDynamicSegmentKeys falls back to string.\n */\n// eslint-disable-next-line typescript/no-empty-interface -- augmented by codegen\nexport interface ValidDynamicSegmentKeysRegistry {}\n\n/**\n * Union of valid bracket keys for defineSchema.\n * After codegen runs, this is the set of filesystem segment names.\n * Before codegen (fresh project), accepts any string.\n */\nexport type ValidDynamicSegmentKeys = keyof ValidDynamicSegmentKeysRegistry extends never\n  ? string\n  : keyof ValidDynamicSegmentKeysRegistry & string;\n\n/** Configuration object for defineSchema. */\nexport interface SchemaConfig<S extends Record<string, SegmentParamCodec>> {\n  segmentParams: S;\n}\n\n// ---------------------------------------------------------------------------\n// Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Define the global segment param schema.\n *\n * Each key uses the bracket syntax from the filesystem (`[id]`, `[...slug]`,\n * `[[...slug]]`) mapped to a codec. This makes the relationship between\n * filesystem segments and codecs visually obvious.\n *\n * A dynamic segment with no key here defaults to `string` at codegen time.\n *\n * ```ts\n * // app/schema.ts\n * import { defineSchema } from '@timber-js/app/params';\n * import { codec } from '@timber-js/app/codec';\n * import { z } from 'zod';\n *\n * export default defineSchema({\n *   segmentParams: {\n *     '[artistSlug]': codec.string,\n *     '[year]': codec.integer,\n *     '[id]': z.coerce.number().int(),\n *   },\n * });\n * ```\n */\nexport function defineSchema<\n  S extends {\n    [K in keyof S]: K extends ValidDynamicSegmentKeys\n      ? K extends string\n        ? CodecForKey<K>\n        : SegmentParamCodec\n      : never;\n  },\n>(config: { segmentParams: S }): { segmentParams: S } {\n  return config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAwGA,SAAgB,aAQd,QAAoD;CACpD,OAAO;AACT"}

package/dist/params/resolve-schema.d.ts

@@ -8,7 +8,7 @@
  *
  * Design doc: design/41-global-params.md §Pipeline Integration
  */
-import type { Codec } from '../codec.js';
+import type { Codec } from '../codec.ts';
 /**
  * Reconstruct the bracket key for a segment from its type and param name.
  * Used by the coercion layer to look up codecs in the bracket-keyed map.

package/dist/plugin-context.d.ts

@@ -7,15 +7,15 @@
  *
  * Design doc: 18-build-system.md §"Shared Plugin Context"
  */
-import type { RouteTree } from './routing/types';
-import type { BuildManifest } from './server/build-manifest';
-import type { CaptureSummary } from './server/prebuilt-builder';
-import type { StartupTimer } from './utils/startup-timer';
-import type { TimberUserConfig } from './config-types.js';
-import type { RscManifest } from './plugins/static-build.js';
-import type { HoldingServer } from './dev-tools/holding-server.js';
-import type { ProgramNode } from './plugins/callsite-ast.js';
-export type { TimberUserConfig, ClientJavascriptConfig } from './config-types.js';
+import type { RouteTree } from './routing/types.ts';
+import type { BuildManifest } from './server/build-manifest.ts';
+import type { CaptureSummary } from './server/prebuilt-builder.ts';
+import type { StartupTimer } from './utils/startup-timer.ts';
+import type { TimberUserConfig } from './config-types.ts';
+import type { RscManifest } from './plugins/static-build.ts';
+import type { HoldingServer } from './dev-tools/holding-server.ts';
+import type { ProgramNode } from './plugins/callsite-ast.ts';
+export type { TimberUserConfig, ClientJavascriptConfig } from './config-types.ts';
 /** Fully resolved client JavaScript configuration (no optionals). */
 export interface ResolvedClientJavascript {
     disabled: boolean;

package/dist/plugin-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin-context.d.ts","sourceRoot":"","sources":["../src/plugin-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin-context.d.ts","sourceRoot":"","sources":["../src/plugin-context.ts"],"names":[],"mappings":"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"}

package/dist/plugins/adapter-build.d.ts

@@ -13,8 +13,8 @@
  * Design docs: design/11-platform.md, design/25-production-deployments.md
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
-import type { BuildManifest } from '../server/build-manifest.js';
+import type { PluginContext } from '../plugin-context.ts';
+import type { BuildManifest } from '../server/build-manifest.ts';
 export declare function timberAdapterBuild(ctx: PluginContext): Plugin;
 /**
  * Strip JS references from the RSC plugin's assets manifest files.

package/dist/plugins/build-manifest.d.ts

@@ -16,8 +16,8 @@
  * Design docs: 18-build-system.md §"Build Manifest", 02-rendering-pipeline.md §"Early Hints"
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
-import { type BuildManifest } from '../server/build-manifest.js';
+import type { PluginContext } from '../plugin-context.ts';
+import { type BuildManifest } from '../server/build-manifest.ts';
 interface OutputChunk {
     type: 'chunk';
     fileName: string;

package/dist/plugins/build-report.d.ts

@@ -13,11 +13,11 @@
  * Task: TIM-287
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
-import type { SegmentNode, RouteTree } from '../routing/types.js';
-import type { CaptureSummary } from '../server/prebuilt-builder.js';
-import type { PrebuiltManifest } from '../server/prebuilt/payload-source.js';
-import { formatSize } from '../utils/format.js';
+import type { PluginContext } from '../plugin-context.ts';
+import type { SegmentNode, RouteTree } from '../routing/types.ts';
+import type { CaptureSummary } from '../server/prebuilt-builder.ts';
+import type { PrebuiltManifest } from '../server/prebuilt/payload-source.ts';
+import { formatSize } from '../utils/format.ts';
 export type RouteType = 'static' | 'dynamic' | 'function';
 export interface RouteEntry {
     path: string;

package/dist/plugins/cache.d.ts

@@ -53,7 +53,7 @@
  * See TIM-997, TIM-1053, design/06-caching.md §"Cache Key Security".
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Generate a stable callsite ID for a cache() call. See callsite-ast.ts for
  * the derivation properties.

package/dist/plugins/callsite-jsx.d.ts

@@ -10,8 +10,8 @@
  *
  * See design/44-render-at-build-time.md §Props Derivation at Build Time.
  */
-import type { PluginContext } from '../plugin-context.js';
-import type { PositionedNode, ProgramNode } from './callsite-ast.js';
+import type { PluginContext } from '../plugin-context.ts';
+import type { PositionedNode, ProgramNode } from './callsite-ast.ts';
 export type JsonValue = string | number | boolean | null | JsonValue[] | {
     [key: string]: JsonValue;
 };

package/dist/plugins/chunks.d.ts

@@ -21,7 +21,7 @@
  * Design docs: 27-chunking-strategy.md
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Check if a module is part of the timber framework runtime.
  *

package/dist/plugins/chunks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../../src/plugins/chunks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAU,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAOnD;AA4DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAQvD"}
+{"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../../src/plugins/chunks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAU,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAOnD;AA4DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAQvD"}

package/dist/plugins/cloudflare-wasm.d.ts

@@ -16,6 +16,6 @@
  * a clear build error), never silently externalized.
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 export declare function timberCloudflareWasm(ctx: PluginContext): Plugin[];
 //# sourceMappingURL=cloudflare-wasm.d.ts.map

package/dist/plugins/content.d.ts

@@ -8,7 +8,7 @@
  * Design doc: 20-content-collections.md §"Content Collections"
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Create the timber-content Vite plugin.
  *

package/dist/plugins/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/plugins/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoB1D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAgGxD"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/plugins/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoB1D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAoGxD"}

package/dist/plugins/dev-discovery.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Dev-server discovery records — `.timber/dev/<pid>-<port>-<token>.json`.
+ *
+ * On startup each dev server writes `{ port, pid, host, protocol }` to its own record
+ * file under the app's `.timber/dev/` so the `timber graph` CLI and the
+ * VS Code extension can discover a running dev server for the
+ * live-graph fast path.
+ *
+ * One record file per server, one writer per file. This is what makes
+ * multi-server roots (Vite auto-increments the port across processes;
+ * programmatic embeddings run several servers in one process) safe
+ * without any coordination: there is no shared file to displace, no
+ * ownership to arbitrate, and no shutdown-order dependency — each
+ * server removes exactly its own record.
+ *
+ * Consumers must list the directory and trust a record only if its pid
+ * is alive AND a probe request to the endpoint succeeds; anything else
+ * is treated as absent (silent fallback), never an error. Stale records
+ * (crashed servers) are therefore the normal case — startup sweeps
+ * dead-pid records best-effort, and consumers validate the rest away.
+ *
+ * The directory layout and file format are implementation details, not
+ * a public contract.
+ *
+ * Design doc: 47-module-environment-tooling.md §5, 21-dev-server.md.
+ */
+import type { Server } from 'node:net';
+/** Relative path of the discovery directory within the project root. */
+export declare const DEV_DISCOVERY_DIR: string;
+export interface DevRecord {
+    port: number;
+    pid: number;
+    /**
+     * The bound address, as reported by the socket. Consumers probing the
+     * endpoint need it for servers bound to non-default interfaces;
+     * wildcard addresses (`0.0.0.0`, `::`) should be probed via loopback.
+     */
+    host: string;
+    /**
+     * Probe scheme. `server.https` dev servers (including HTTP/2) answer
+     * only TLS — an http:// probe of one would fail and wrongly trigger
+     * the cold-crawl fallback.
+     */
+    protocol: 'http' | 'https';
+    /**
+     * Vite `base` path. When non-root (e.g. `/my-app/`), the WebSocket
+     * upgrade path is `base + hmrPath`.
+     */
+    base?: string;
+    /**
+     * HMR WebSocket path (from `server.ws.path` or deprecated
+     * `server.hmr.path`). Absent when no path is configured (default `/`).
+     */
+    hmrPath?: string;
+    /**
+     * Custom WebSocket host override (from `server.ws.host` or deprecated
+     * `server.hmr.host`). When set, the WS connection targets this host
+     * instead of the HTTP server's bound address.
+     */
+    hmrHost?: string;
+    /**
+     * Custom WebSocket port override (from `server.ws.clientPort` ??
+     * `server.ws.port`, or deprecated `server.hmr.clientPort` ??
+     * `server.hmr.port`). When set, the WS connection targets this port
+     * instead of the HTTP server's bound port.
+     */
+    hmrPort?: number;
+    /**
+     * Custom WebSocket protocol override (from `server.ws.protocol` or
+     * deprecated `server.hmr.protocol`). When set (e.g. `'wss'`), the
+     * upgrade request uses the corresponding HTTP scheme.
+     */
+    hmrProtocol?: string;
+    /**
+     * Vite 8 WebSocket token (from `config.webSocketToken`). Required for
+     * browser WS upgrades; the extension passes it as `?token=` on the
+     * WebSocket URL.
+     */
+    webSocketToken?: string;
+    /**
+     * Absolute path to the Vite config file this server was started with.
+     * When multiple dev servers share a project root but use different
+     * configs, the fast path must only accept the record matching the
+     * config the CLI resolved (TIM-1393).
+     */
+    configFile?: string;
+}
+/** Best-effort "is this pid alive" — signal 0 probes without killing. */
+export declare function isPidAlive(pid: number): boolean;
+/**
+ * Register discovery-record lifecycle handlers on the dev server's HTTP
+ * server. Writes `.timber/dev/<pid>-<port>-<token>.json` once the server is
+ * listening (the bound port is only known then) and removes exactly
+ * that record on clean shutdown.
+ *
+ * All filesystem work is best-effort: a failure to write or remove a
+ * record must never break the dev server. `httpServer` is null in
+ * middleware mode — no port exists, so there is nothing to advertise.
+ * Typed as `net.Server` — the common base of Vite's `http.Server` and
+ * `Http2SecureServer` variants, which carries the events and `address()`.
+ */
+export declare function registerDevDiscovery(httpServer: Server | null, root: string, config?: {
+    configFile?: string | false;
+    base?: string;
+    server?: {
+        hmr?: {
+            path?: string;
+            host?: string;
+            port?: number;
+            clientPort?: number;
+            protocol?: string;
+        } | boolean;
+        ws?: {
+            path?: string;
+            host?: string;
+            port?: number;
+            clientPort?: number;
+            protocol?: string;
+        } | false;
+    };
+    webSocketToken?: string;
+}): void;
+//# sourceMappingURL=dev-discovery.d.ts.map

package/dist/plugins/dev-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-discovery.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,QAAyB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAQ/C;AA+BD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE;IACP,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EACA;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,GACvF,OAAO,CAAC;QACZ,EAAE,CAAC,EACC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,GACvF,KAAK,CAAC;KACX,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,IAAI,CAsDN"}

package/dist/plugins/dev-server.d.ts

@@ -13,7 +13,7 @@
  */
 import type { Plugin } from 'vite';
 import type { IncomingMessage } from 'node:http';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Create the timber-dev-server Vite plugin.
  *

package/dist/plugins/dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AAKjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA8C1D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA6D1D;AA8PD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAuC9D"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/plugins/dev-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAC;AAKjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoD1D;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4I1D;AA8PD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAuC9D"}

package/dist/plugins/entries.d.ts

@@ -11,7 +11,7 @@
  * Design docs: 18-build-system.md §"Entry Generation", §"Virtual Modules"
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Detect a user convention file at both root and src/.
  *

package/dist/plugins/fonts.d.ts

@@ -18,9 +18,9 @@
  * Design doc: 24-fonts.md
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
-export { FontPipeline } from '../fonts/pipeline.js';
-export { generateFontId, extractFontConfig, detectDynamicFontCall, parseGoogleFontImports, parseGoogleFontFamilies, parseLocalFontImportName, } from '../fonts/transform.js';
+import type { PluginContext } from '../plugin-context.ts';
+export { FontPipeline } from '../fonts/pipeline.ts';
+export { generateFontId, extractFontConfig, detectDynamicFontCall, parseGoogleFontImports, parseGoogleFontFamilies, parseLocalFontImportName, } from '../fonts/transform.ts';
 /**
  * Create the timber-fonts Vite plugin.
  */

package/dist/plugins/fonts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/plugins/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA2B1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA8OtD"}
+{"version":3,"file":"fonts.d.ts","sourceRoot":"","sources":["../../src/plugins/fonts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAiC,MAAM,MAAM,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA2B1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAqPtD"}

package/dist/plugins/graph-endpoint.d.ts

@@ -0,0 +1,112 @@
+/**
+ * graph-endpoint — `GET /__timber/graph` on the dev server.
+ *
+ * The fast path of design/47: when a dev server runs, the env module
+ * graphs are already resident and classification is a lookup. Serves
+ * the `timber graph` CLI (delegation lands with the fast-path ticket)
+ * and the VS Code extension, which additionally needs push updates on
+ * HMR — something a CLI cannot provide.
+ *
+ * Dev-only by construction: registered from the timber-dev-server
+ * plugin, which is `apply: 'serve'`; production builds contain none of
+ * this. Same JSON contract as the CLI, produced by the same
+ * classification module (analyze/live-graph.ts → classify/chains/
+ * poison-scan) — never a second implementation.
+ *
+ * Endpoint hygiene (§10): requests are validated against DNS rebinding
+ * consistent with Vite's own dev-endpoint protections — the Host
+ * header must be a localhost form or an allowed host (Vite's
+ * `server.allowedHosts` semantics, including leading-dot suffix
+ * entries), and a present Origin header must pass the same check. A
+ * CLI probe sends no Origin and passes; a browser on an attacker's
+ * page either fails the Host check (rebinding: Host is the attacker's
+ * domain) or the Origin check (direct cross-origin fetch).
+ *
+ * Push channel: `timber:graph-update` custom HMR events, one per
+ * project-source watcher event. The channel just emits — debounce is
+ * the consumer's concern (design/47 §"Dev-server endpoint").
+ *
+ * Design docs: 47-module-environment-tooling.md §10, 21-dev-server.md.
+ */
+import type { ViteDevServer } from 'vite';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { PluginContext } from '../plugin-context.ts';
+export declare const GRAPH_ENDPOINT_PATH = "/__timber/graph";
+/** HMR custom event name for graph-affecting file changes. */
+export declare const GRAPH_UPDATE_EVENT = "timber:graph-update";
+/**
+ * Host-header allowlist check, ported branch-for-branch from Vite's
+ * host-validation middleware (`isHostAllowedWithoutCache`) so this
+ * endpoint's reachability matches the rest of the dev server:
+ *
+ * - `allowedHosts: true` allows everything
+ * - a MISSING Host header is allowed (Vite parity — HTTP/1.0 probes)
+ * - any IP-literal host is allowed (`vite --host` LAN access sends
+ *   `Host: 192.168.x.x:port`; rejecting it would 403 this endpoint
+ *   while every other dev route works)
+ * - `localhost` and `*.localhost` are always allowed
+ * - allowedHosts entries: exact match, or `.suffix` subdomain entries
+ */
+export declare function isAllowedGraphHost(hostHeader: string | undefined, allowedHosts: true | string[] | undefined): boolean;
+/** Origin check: absent is fine (CLI probe); present must pass the host allowlist. */
+export declare function isAllowedGraphOrigin(originHeader: string | undefined, allowedHosts: true | string[] | undefined): boolean;
+/**
+ * Create the Connect middleware handling GET /__timber/graph.
+ *
+ * Query surface: `?file=<path>` (absolute or project-root-relative) or
+ * `?all=1`. Anything else is a 400 — fail loudly, like the CLI.
+ */
+export declare function createGraphEndpointMiddleware(server: ViteDevServer, ctx: PluginContext): (req: IncomingMessage, res: ServerResponse, next: () => void) => Promise<void>;
+/** What one hotUpdate invocation tells the emitter. */
+export interface GraphHotUpdate {
+    file: string;
+    /** Vite's own hotUpdate vocabulary. */
+    type: 'create' | 'update' | 'delete';
+    /** Environment the hook ran for (rsc/ssr/client). */
+    environment: string;
+}
+/** The push channel's two notification points for one edit. */
+export interface GraphUpdateChannel {
+    /** Feed from the plugin's hotUpdate hook (post graph invalidation). */
+    onHotUpdate(update: GraphHotUpdate): void;
+    /**
+     * Feed from the plugin's transform hook (module id, may carry a
+     * query suffix). Emits phase "transformed" for files with a pending
+     * invalidation, once their import edges are actually rebuilt.
+     */
+    onTransform(id: string, environment: string): void;
+}
+/**
+ * Accessor the channel uses to decide when a re-transforming module's
+ * graph data is current: Vite stores the node's `transformResult` only
+ * at the END of the transform request — after `vite:import-analysis`
+ * has rebuilt the importer edges — so a non-null result is the
+ * edges-are-current signal.
+ */
+export type IsNodeTransformed = (file: string, environment: string) => boolean;
+/**
+ * Build the push channel: `timber:graph-update` custom HMR events per
+ * project-source change. Consumers (the VS Code extension) re-query
+ * and debounce on their side; the channel just emits. Non-source noise
+ * (build output, dotdirs) is filtered by the same extension set the
+ * scanners use.
+ *
+ * Two phases per edit, because one is not enough (codex review, PR
+ * #1057): the `invalidated` event fires from the plugin's `hotUpdate`
+ * hook — after Vite clears the module's transform result, but its
+ * importer EDGES are only rebuilt when the module is next transformed.
+ * The `transformed` event fires for exactly the files with a pending
+ * invalidation, and only once the node's `transformResult` is set
+ * again — the plugin transform hook itself runs BEFORE Vite's trailing
+ * `vite:import-analysis` (which rebuilds the edges), so the hook only
+ * marks the file "settling" and a short bounded timer confirms
+ * completion via `isTransformed` before emitting. (A module nothing
+ * re-requests never re-transforms — its `transformed` event waits for
+ * the next render, which is also when the graph has new information.)
+ */
+export declare function makeGraphUpdateChannel(ctx: Pick<PluginContext, 'root' | 'config'>, send: (payload: {
+    type: 'custom';
+    event: string;
+    data: unknown;
+}) => void, isTransformed?: IsNodeTransformed, canonicalize?: (file: string) => string): GraphUpdateChannel;
+//# sourceMappingURL=graph-endpoint.d.ts.map

package/dist/plugins/graph-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-endpoint.d.ts","sourceRoot":"","sources":["../../src/plugins/graph-endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,YAAY,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,SAAS,GACxC,OAAO,CAwBT;AAqBD,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,YAAY,EAAE,IAAI,GAAG,MAAM,EAAE,GAAG,SAAS,GACxC,OAAO,CA2BT;AAsBD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,SAElE,eAAe,OAAO,cAAc,QAAQ,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC,CAkM1F;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,EAC3C,IAAI,EAAE,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,EACzE,aAAa,CAAC,EAAE,iBAAiB,EAMjC,YAAY,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuB,GACtD,kBAAkB,CA2GpB"}

package/dist/plugins/mdx.d.ts

@@ -20,7 +20,7 @@
  * Design doc: 20-content-collections.md §"The timber-mdx Plugin"
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Check if mdx-components.tsx (or .ts, .jsx, .js) exists at the project root
  * or in src/. Root takes precedence, matching Next.js behavior.

package/dist/plugins/mdx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../../src/plugins/mdx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAKnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAelE;AAqED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4HpD"}
+{"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../../src/plugins/mdx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAKnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAelE;AAqED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4HpD"}

package/dist/plugins/prebuilt-capture.d.ts

@@ -24,8 +24,8 @@
  * call timber.cache), and it only happens when the app actually declares
  * prebuilt components.
  */
-import type { PluginContext } from '../plugin-context.js';
-import type { CaptureSummary, CapturedEntry } from '../server/prebuilt-builder.js';
+import type { PluginContext } from '../plugin-context.ts';
+import type { CaptureSummary, CapturedEntry } from '../server/prebuilt-builder.ts';
 export interface PrebuiltArtifactWriter {
     write(entry: CapturedEntry): Promise<void>;
     /** Write manifest.json (if any entries exist). Returns the entry count. */

package/dist/plugins/prebuilt-options-analysis.d.ts

@@ -11,7 +11,7 @@
  * pass re-checks the real options at runtime and skips), under-inclusion
  * would silently skip prerendering.
  */
-import type { CallExpressionNode, PositionedNode } from './callsite-ast.js';
+import type { CallExpressionNode, PositionedNode } from './callsite-ast.ts';
 /** Unwrap TS expression wrappers (`as`, `satisfies`, `!`, parens). */
 export declare function unwrapExpression(node: PositionedNode): PositionedNode;
 /**

package/dist/plugins/prebuilt.d.ts

@@ -57,7 +57,7 @@
  * See TIM-1118, design/44-render-at-build-time.md, design/45-cache-lifetimes.md.
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
+import type { PluginContext } from '../plugin-context.ts';
 /**
  * Generate the stable component ID for a cache.component() call site:
  * `<sanitized-name>_<content-hash16>`. Exported for testing.

package/dist/plugins/prerender-sugar.d.ts

@@ -11,31 +11,28 @@
  * `export const prerender` to descendant pages via most-specific-wins:
  * walk the segment tree from leaf to root, first explicit value wins.
  *
- * A layout that declares `export const prerender` is ALSO wrapped — the
- * layout's flight payload is its own static shell (`children` is a
- * separate component boundary), so caching it is natural (nav, sidebar,
- * footer benefit from build-time rendering). See design/45 §Layout
- * Propagation.
+ * Layout declarations are propagation policy only. Layouts receive the real
+ * descendant React element as `children` to preserve the server-layout
+ * containment boundary, so their props are not cache-keyable and the layout
+ * itself must not be registered for capture.
  *
  * This transform runs BEFORE timber-prebuilt so the generated
  * `cache.component(...)` call is picked up by the callsite rewrite.
  */
 import type { Plugin } from 'vite';
-import type { PluginContext } from '../plugin-context.js';
-import type { SegmentNode } from '../routing/types.js';
-import { type PrerenderExportValue } from '../routing/export-detect.js';
+import type { PluginContext } from '../plugin-context.ts';
+import type { SegmentNode } from '../routing/types.ts';
+import { type PrerenderExportValue } from '../routing/export-detect.ts';
 /**
  * Walk the segment tree and resolve the effective prerender value for
- * every page and layout. Returns a map from file path to resolved value.
+ * every page. Returns a map from page file path to resolved value.
  *
  * **Pages:** walk from leaf toward root; first explicit `export const prerender`
  * wins (page > nearest layout > ... > root layout). If none, dynamic.
  *
- * **Layouts:** a layout that declares `export const prerender` is wrapped
- * directly (its own shell is a separate component boundary from `children`).
- * Layouts without their own declaration are NOT wrapped — they don't
- * inherit from ancestors, because wrapping a layout's shell without the
- * author's explicit opt-in would cache content they may expect to be dynamic.
+ * **Layouts:** declarations propagate to descendant pages but layouts are not
+ * included in the result. Their real React-element `children` preserve secure
+ * containment and deliberately make child-independent layout caching invalid.
  */
 export declare function resolvePagePrerender(root: SegmentNode): Map<string, PrerenderExportValue>;
 export declare function timberPrerenderSugar(ctx: PluginContext): Plugin;

package/dist/plugins/prerender-sugar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerender-sugar.d.ts","sourceRoot":"","sources":["../../src/plugins/prerender-sugar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAY5F;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAgCzF;AAuFD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4J/D"}
+{"version":3,"file":"prerender-sugar.d.ts","sourceRoot":"","sources":["../../src/plugins/prerender-sugar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAY5F;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CA2BzF;AAuFD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CA4J/D"}

package/dist/plugins/request-dep/analysis.d.ts

@@ -16,7 +16,7 @@
  *
  * See design/19-client-navigation.md §"Why the slot comparison ignores the query".
  */
-import type { ProgramNode } from '../callsite-ast.js';
+import type { ProgramNode } from '../callsite-ast.ts';
 /**
  * One module-graph edge introduced by an `import` or `export … from`.
  *