@timber-js/app 0.2.0-alpha.120 → 0.2.0-alpha.122

package/dist/_chunks/cli-schema-sync-q2wB0DyJ.js

@@ -1,358 +0,0 @@
-import { t as scanRoutes } from "./scanner-DmfoB7iK.js";
-import { join } from "node:path";
-import { createRequire } from "node:module";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { performance } from "node:perf_hooks";
-//#region src/utils/startup-timer.ts
-/**
-* Startup timer — records named phases with their durations.
-*
-* Used by the plugin system to instrument cold start and report a
-* timing breakdown in dev mode. Zero overhead in production (disabled).
-*
-* See design/18-build-system.md, TIM-155.
-*/
-/**
-* Create a startup timer that records phase durations.
-*/
-function createStartupTimer() {
-	const pending = /* @__PURE__ */ new Map();
-	const phases = [];
-	return {
-		start(phase) {
-			pending.set(phase, performance.now());
-		},
-		end(phase) {
-			const startMs = pending.get(phase);
-			if (startMs === void 0) return 0;
-			pending.delete(phase);
-			const durationMs = performance.now() - startMs;
-			phases.push({
-				name: phase,
-				startMs,
-				durationMs
-			});
-			return durationMs;
-		},
-		getPhases() {
-			return [...phases].sort((a, b) => a.startMs - b.startMs);
-		},
-		totalMs() {
-			if (phases.length === 0) return 0;
-			const sorted = this.getPhases();
-			const first = sorted[0];
-			const last = sorted[sorted.length - 1];
-			return last.startMs + last.durationMs - first.startMs;
-		},
-		formatSummary() {
-			const sorted = this.getPhases();
-			if (sorted.length === 0) return "No phases recorded.";
-			const lines = sorted.map((p) => {
-				const ms = p.durationMs.toFixed(1);
-				return `  ${p.name.padEnd(30)} ${ms.padStart(8)}ms`;
-			});
-			const total = this.totalMs().toFixed(1);
-			lines.push(`  ${"total".padEnd(30)} ${total.padStart(8)}ms`);
-			return ["[timber] startup timing:", ...lines].join("\n");
-		}
-	};
-}
-/**
-* No-op timer for production builds — all methods are empty.
-*/
-function createNoopTimer() {
-	return {
-		start() {},
-		end() {
-			return 0;
-		},
-		getPhases() {
-			return [];
-		},
-		totalMs() {
-			return 0;
-		},
-		formatSummary() {
-			return "";
-		}
-	};
-}
-//#endregion
-//#region src/plugin-context.ts
-/**
-* Plugin context — internal types and helpers for timber sub-plugins.
-*
-* These are NOT part of the user-facing API. They are consumed by
-* sub-plugins (routing, entries, shims, etc.) via relative imports.
-* The root entry point (index.ts) does not re-export them.
-*
-* Design doc: 18-build-system.md §"Shared Plugin Context"
-*/
-/**
-* Resolve `clientJavascript` into a fully resolved config.
-*/
-function resolveClientJavascript(config) {
-	if (config.clientJavascript !== void 0) {
-		if (typeof config.clientJavascript === "boolean") return {
-			disabled: !config.clientJavascript,
-			enableHMRInDev: !config.clientJavascript
-		};
-		return {
-			disabled: config.clientJavascript.disabled,
-			enableHMRInDev: config.clientJavascript.enableHMRInDev ?? config.clientJavascript.disabled
-		};
-	}
-	return {
-		disabled: false,
-		enableHMRInDev: false
-	};
-}
-/**
-* Resolve the app directory. Checks (in order):
-* 1. Explicit `configAppDir` from timber.config.ts
-* 2. `<root>/app`
-* 3. `<root>/src/app`
-*
-* Throws if none exist.
-*/
-function resolveAppDir(root, configAppDir) {
-	if (configAppDir) {
-		const explicit = join(root, configAppDir);
-		if (!existsSync(explicit)) throw new Error(`[timber] Configured appDir "${configAppDir}" does not exist at ${explicit}`);
-		return explicit;
-	}
-	const rootApp = join(root, "app");
-	if (existsSync(rootApp)) return rootApp;
-	const srcApp = join(root, "src", "app");
-	if (existsSync(srcApp)) return srcApp;
-	throw new Error(`[timber] Could not find app directory. Expected "app/" or "src/app/" in ${root}. You can set appDir in timber.config.ts to specify a custom location.`);
-}
-function createPluginContext(config, root) {
-	const projectRoot = root ?? process.cwd();
-	const resolvedConfig = { ...config };
-	return {
-		config: resolvedConfig,
-		clientJavascript: resolveClientJavascript(resolvedConfig),
-		routeTree: null,
-		appDir: join(projectRoot, "app"),
-		root: projectRoot,
-		dev: false,
-		buildManifest: null,
-		deploymentId: null,
-		timer: createStartupTimer(),
-		holdingServer: null,
-		buildDir: resolveBuildDir(projectRoot, resolvedConfig.buildDir)
-	};
-}
-/** Default build output directory (relative to root). */
-var DEFAULT_BUILD_DIR = join(".timber", "dist");
-/**
-* Resolve the build output directory.
-*
-* Priority:
-* 1. Explicit `timberBuildDir` from timber.config.ts
-* 2. Explicit `viteBuildOutDir` from Vite's build.outDir (if not the default 'dist')
-* 3. Default: `.timber/dist`
-*
-* Returns an absolute path.
-*/
-function resolveBuildDir(root, timberBuildDir, viteBuildOutDir) {
-	if (timberBuildDir) return join(root, timberBuildDir);
-	if (viteBuildOutDir && viteBuildOutDir !== "dist") return join(root, viteBuildOutDir);
-	return join(root, DEFAULT_BUILD_DIR);
-}
-/**
-* Load timber.config.ts (or .js, .mjs) from the project root.
-* Returns the config object or null if no config file is found.
-*
-* Uses require() which works for ESM modules on Node 22.12+.
-* This keeps timber() synchronous — no async config loading needed.
-*/
-function loadTimberConfigFile(root) {
-	const configNames = [
-		"timber.config.ts",
-		"timber.config.js",
-		"timber.config.mjs"
-	];
-	const req = createRequire(join(root, "package.json"));
-	for (const name of configNames) {
-		const configPath = join(root, name);
-		if (existsSync(configPath)) {
-			const mod = req(configPath);
-			return mod.default ?? mod;
-		}
-	}
-	return null;
-}
-/**
-* Detect config keys set in both inline (vite.config.ts) and file (timber.config.ts)
-* and warn the user. The `output` key is excluded because it defaults to 'server'
-* in createPluginContext and would always appear as an inline key.
-*
-* Returns the list of conflicting key names (for testing).
-*/
-function warnConfigConflicts(inline, fileConfig) {
-	const conflicts = [];
-	for (const key of Object.keys(fileConfig)) if (key in inline && inline[key] !== void 0) conflicts.push(key);
-	if (conflicts.length > 0) console.warn(`[timber] Config conflict: ${conflicts.map((k) => `"${k}"`).join(", ")} set in both vite.config.ts (inline) and timber.config.ts. Move all config to timber.config.ts to avoid confusion. The inline value from vite.config.ts will be used.`);
-	return conflicts;
-}
-/**
-* Merge file-based config into ctx.config. Inline config (already in ctx.config)
-* takes precedence — file config only fills in missing fields.
-*/
-function mergeFileConfig(ctx, fileConfig) {
-	const inline = ctx.config;
-	warnConfigConflicts(inline, fileConfig);
-	ctx.config = {
-		...fileConfig,
-		...inline,
-		...fileConfig.limits && inline.limits ? { limits: {
-			...fileConfig.limits,
-			...inline.limits
-		} } : {},
-		...fileConfig.dev && inline.dev ? { dev: {
-			...fileConfig.dev,
-			...inline.dev
-		} } : {},
-		...fileConfig.mdx && inline.mdx ? { mdx: {
-			...fileConfig.mdx,
-			...inline.mdx
-		} } : {}
-	};
-}
-//#endregion
-//#region src/cli-schema-sync.ts
-/**
-* `timber schema sync` — scan filesystem for dynamic segments and append
-* missing entries to app/schema.ts with `codec.string` defaults.
-*
-* Only adds, never removes or modifies existing entries.
-*
-* Design doc: design/41-global-params.md §Auto-Scaffolding
-*/
-/**
-* Collect all unique bracket-keyed dynamic segment names from the route tree.
-* Returns entries like '[artistSlug]', '[...slug]', '[[...topic]]'.
-*/
-function collectDynamicSegments(appDir) {
-	const tree = scanRoutes(appDir);
-	const segments = /* @__PURE__ */ new Set();
-	walkSegments(tree.root, segments);
-	return [...segments].sort();
-}
-function walkSegments(node, segments) {
-	if (node.paramName) segments.add(node.segmentName);
-	for (const child of node.children) walkSegments(child, segments);
-	for (const slot of Object.values(node.slots)) walkSegments(slot, segments);
-}
-/**
-* Parse existing bracket keys from an app/schema.ts file.
-* Uses regex to find keys in segmentParams: { '[key]': ... } blocks.
-*/
-function parseExistingSchemaKeys(content) {
-	const keys = [];
-	const re = /['"](\[{1,2}(?:\.{3})?\w+\]{1,2})['"]\s*:/g;
-	let m;
-	while ((m = re.exec(content)) !== null) keys.push(m[1]);
-	return keys;
-}
-/** Schema file extensions to check. */
-var SCHEMA_EXTENSIONS = [
-	".ts",
-	".tsx",
-	".js",
-	".jsx"
-];
-/**
-* Find the schema file path if it exists.
-*/
-function findSchemaFile(appDir) {
-	for (const ext of SCHEMA_EXTENSIONS) {
-		const p = join(appDir, `schema${ext}`);
-		if (existsSync(p)) return p;
-	}
-}
-/**
-* Generate the content for a new app/schema.ts with the given segment keys.
-*/
-function generateNewSchema(segments) {
-	const lines = [];
-	lines.push("import { defineSchema } from '@timber-js/app/params';");
-	lines.push("import { codec } from '@timber-js/app/codec';");
-	lines.push("");
-	lines.push("export default defineSchema({");
-	lines.push("  segmentParams: {");
-	for (const seg of segments) lines.push(`    '${seg}': codec.string,`);
-	lines.push("  },");
-	lines.push("});");
-	lines.push("");
-	return lines.join("\n");
-}
-/**
-* Append missing segment entries to an existing schema file.
-* Inserts new entries before the closing `}` of segmentParams.
-*/
-function appendToSchema(content, newSegments) {
-	const spIndex = content.indexOf("segmentParams");
-	if (spIndex === -1) throw new Error("[timber] Could not find segmentParams in schema file. Expected a defineSchema({ segmentParams: { ... } }) call.");
-	const openBrace = content.indexOf("{", spIndex + 13);
-	if (openBrace === -1) throw new Error("[timber] Could not find opening brace for segmentParams.");
-	let depth = 1;
-	let i = openBrace + 1;
-	while (i < content.length && depth > 0) {
-		if (content[i] === "{") depth++;
-		else if (content[i] === "}") depth--;
-		i++;
-	}
-	const closeBrace = i - 1;
-	const existingLine = content.slice(openBrace, closeBrace).match(/^(\s+)['"]\[/m);
-	const indent = existingLine ? existingLine[1] : "    ";
-	const insertion = newSegments.map((seg) => `${indent}'${seg}': codec.string,`).join("\n");
-	const before = content.slice(0, closeBrace);
-	const after = content.slice(closeBrace);
-	return before + (before.trimEnd().endsWith(",") ? "\n" : "\n") + insertion + "\n" + after;
-}
-/**
-* Run the schema sync: scan filesystem, diff against schema, append missing.
-*/
-function runSchemaSync(projectRoot) {
-	const appDir = resolveAppDir(projectRoot);
-	const filesystemSegments = collectDynamicSegments(appDir);
-	if (filesystemSegments.length === 0) return {
-		filesystemSegments: [],
-		existingSegments: [],
-		addedSegments: [],
-		created: false
-	};
-	const schemaPath = findSchemaFile(appDir);
-	if (!schemaPath) {
-		writeFileSync(join(appDir, "schema.ts"), generateNewSchema(filesystemSegments), "utf-8");
-		return {
-			filesystemSegments,
-			existingSegments: [],
-			addedSegments: filesystemSegments,
-			created: true
-		};
-	}
-	const content = readFileSync(schemaPath, "utf-8");
-	const existingSegments = parseExistingSchemaKeys(content);
-	const missing = filesystemSegments.filter((seg) => !existingSegments.includes(seg));
-	if (missing.length === 0) return {
-		filesystemSegments,
-		existingSegments,
-		addedSegments: [],
-		created: false
-	};
-	writeFileSync(schemaPath, appendToSchema(content, missing), "utf-8");
-	return {
-		filesystemSegments,
-		existingSegments,
-		addedSegments: missing,
-		created: false
-	};
-}
-//#endregion
-export { DEFAULT_BUILD_DIR as a, mergeFileConfig as c, resolveClientJavascript as d, createNoopTimer as f, runSchemaSync as i, resolveAppDir as l, findSchemaFile as n, createPluginContext as o, parseExistingSchemaKeys as r, loadTimberConfigFile as s, collectDynamicSegments as t, resolveBuildDir as u };
-
-//# sourceMappingURL=cli-schema-sync-q2wB0DyJ.js.map

package/dist/_chunks/cli-schema-sync-q2wB0DyJ.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-schema-sync-q2wB0DyJ.js","names":[],"sources":["../../src/utils/startup-timer.ts","../../src/plugin-context.ts","../../src/cli-schema-sync.ts"],"sourcesContent":["/**\n * Startup timer — records named phases with their durations.\n *\n * Used by the plugin system to instrument cold start and report a\n * timing breakdown in dev mode. Zero overhead in production (disabled).\n *\n * See design/18-build-system.md, TIM-155.\n */\n\nimport { performance } from 'node:perf_hooks';\n\nexport interface PhaseRecord {\n  name: string;\n  startMs: number;\n  durationMs: number;\n}\n\nexport interface StartupTimer {\n  /** Mark the beginning of a named phase. */\n  start(phase: string): void;\n  /** Mark the end of a named phase. Returns duration in ms. */\n  end(phase: string): number;\n  /** Get all completed phase records, ordered by start time. */\n  getPhases(): PhaseRecord[];\n  /** Total elapsed time from first start() to last end(). */\n  totalMs(): number;\n  /** Format a human-readable summary string. */\n  formatSummary(): string;\n}\n\n/**\n * Create a startup timer that records phase durations.\n */\nexport function createStartupTimer(): StartupTimer {\n  const pending = new Map<string, number>();\n  const phases: PhaseRecord[] = [];\n\n  return {\n    start(phase: string): void {\n      pending.set(phase, performance.now());\n    },\n\n    end(phase: string): number {\n      const startMs = pending.get(phase);\n      if (startMs === undefined) {\n        return 0;\n      }\n      pending.delete(phase);\n      const durationMs = performance.now() - startMs;\n      phases.push({ name: phase, startMs, durationMs });\n      return durationMs;\n    },\n\n    getPhases(): PhaseRecord[] {\n      return [...phases].sort((a, b) => a.startMs - b.startMs);\n    },\n\n    totalMs(): number {\n      if (phases.length === 0) return 0;\n      const sorted = this.getPhases();\n      const first = sorted[0];\n      const last = sorted[sorted.length - 1];\n      return last.startMs + last.durationMs - first.startMs;\n    },\n\n    formatSummary(): string {\n      const sorted = this.getPhases();\n      if (sorted.length === 0) return 'No phases recorded.';\n\n      const lines = sorted.map((p) => {\n        const ms = p.durationMs.toFixed(1);\n        return `  ${p.name.padEnd(30)} ${ms.padStart(8)}ms`;\n      });\n\n      const total = this.totalMs().toFixed(1);\n      lines.push(`  ${'total'.padEnd(30)} ${total.padStart(8)}ms`);\n\n      return ['[timber] startup timing:', ...lines].join('\\n');\n    },\n  };\n}\n\n/**\n * No-op timer for production builds — all methods are empty.\n */\nexport function createNoopTimer(): StartupTimer {\n  return {\n    start() {},\n    end() {\n      return 0;\n    },\n    getPhases() {\n      return [];\n    },\n    totalMs() {\n      return 0;\n    },\n    formatSummary() {\n      return '';\n    },\n  };\n}\n","/**\n * Plugin context — internal types and helpers for timber sub-plugins.\n *\n * These are NOT part of the user-facing API. They are consumed by\n * sub-plugins (routing, entries, shims, etc.) via relative imports.\n * The root entry point (index.ts) does not re-export them.\n *\n * Design doc: 18-build-system.md §\"Shared Plugin Context\"\n */\n\nimport { existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createRequire } from 'node:module';\nimport type { RouteTree } from './routing/types';\nimport type { BuildManifest } from './server/build-manifest';\nimport type { StartupTimer } from './utils/startup-timer';\nimport { createStartupTimer } from './utils/startup-timer';\nimport type { TimberUserConfig, ClientJavascriptConfig } from './config-types.js';\nimport type { HoldingServer } from './dev-tools/holding-server.js';\n\n// Re-export for sub-plugin convenience — they import from plugin-context.ts\nexport type { TimberUserConfig, ClientJavascriptConfig } from './config-types.js';\n\n// ── Client JavaScript config ─────────────────────────────────────────────\n\n/** Fully resolved client JavaScript configuration (no optionals). */\nexport interface ResolvedClientJavascript {\n  disabled: boolean;\n  enableHMRInDev: boolean;\n}\n\n/**\n * Resolve `clientJavascript` into a fully resolved config.\n */\nexport function resolveClientJavascript(config: TimberUserConfig): ResolvedClientJavascript {\n  if (config.clientJavascript !== undefined) {\n    if (typeof config.clientJavascript === 'boolean') {\n      return {\n        disabled: !config.clientJavascript,\n        enableHMRInDev: !config.clientJavascript,\n      };\n    }\n    return {\n      disabled: config.clientJavascript.disabled,\n      enableHMRInDev: config.clientJavascript.enableHMRInDev ?? config.clientJavascript.disabled,\n    };\n  }\n  return { disabled: false, enableHMRInDev: false };\n}\n\n// ── Plugin Context ────────────────────────────────────────────────────────\n\n/**\n * Shared context object passed to all sub-plugins via closure.\n *\n * Sub-plugins communicate through this context — not through Vite's\n * plugin API or global state.\n * See design/18-build-system.md §\"Shared Plugin Context\".\n */\nexport interface PluginContext {\n  config: TimberUserConfig;\n  /** Resolved client JavaScript configuration */\n  clientJavascript: ResolvedClientJavascript;\n  /** The scanned route tree (populated by timber-routing, consumed by timber-entries) */\n  routeTree: RouteTree | null;\n  /** Absolute path to the app/ directory */\n  appDir: string;\n  /** Absolute path to the project root */\n  root: string;\n  /** Whether the dev server is running (set by timber-root-sync in configResolved) */\n  dev: boolean;\n  /** CSS build manifest (populated by adapter after client build, null in dev) */\n  buildManifest: BuildManifest | null;\n  /** Per-build deployment ID for version skew detection (null in dev) */\n  deploymentId: string | null;\n  /** Startup timer for profiling cold start phases (active in dev, no-op in prod) */\n  timer: StartupTimer;\n  /** Holding server that binds the port during dev startup (closed in timber-dev-server) */\n  holdingServer?: HoldingServer | null;\n  /**\n   * Resolved absolute path to the build output directory.\n   *\n   * Defaults to `<root>/.timber/dist`. Can be overridden via\n   * `timber.config.ts` `buildDir` or Vite's `build.outDir`.\n   * Timber config takes precedence when both are set.\n   *\n   * Used by adapter-build and cli preview.\n   */\n  buildDir: string;\n}\n\n// ── App directory resolution ──────────────────────────────────────────────\n\n/**\n * Resolve the app directory. Checks (in order):\n * 1. Explicit `configAppDir` from timber.config.ts\n * 2. `<root>/app`\n * 3. `<root>/src/app`\n *\n * Throws if none exist.\n */\nexport function resolveAppDir(root: string, configAppDir?: string): string {\n  if (configAppDir) {\n    const explicit = join(root, configAppDir);\n    if (!existsSync(explicit)) {\n      throw new Error(`[timber] Configured appDir \"${configAppDir}\" does not exist at ${explicit}`);\n    }\n    return explicit;\n  }\n\n  const rootApp = join(root, 'app');\n  if (existsSync(rootApp)) return rootApp;\n\n  const srcApp = join(root, 'src', 'app');\n  if (existsSync(srcApp)) return srcApp;\n\n  throw new Error(\n    `[timber] Could not find app directory. Expected \"app/\" or \"src/app/\" in ${root}. ` +\n      `You can set appDir in timber.config.ts to specify a custom location.`\n  );\n}\n\n// ── Plugin context factory ────────────────────────────────────────────────\n\nexport function createPluginContext(config?: TimberUserConfig, root?: string): PluginContext {\n  const projectRoot = root ?? process.cwd();\n  const resolvedConfig: TimberUserConfig = { ...config };\n  return {\n    config: resolvedConfig,\n    clientJavascript: resolveClientJavascript(resolvedConfig),\n    routeTree: null,\n    appDir: join(projectRoot, 'app'),\n    root: projectRoot,\n    dev: false,\n    buildManifest: null,\n    deploymentId: null,\n    timer: createStartupTimer(),\n    holdingServer: null,\n    buildDir: resolveBuildDir(projectRoot, resolvedConfig.buildDir),\n  };\n}\n\n// ── Build directory resolution ────────────────────────────────────────────\n\n/** Default build output directory (relative to root). */\nexport const DEFAULT_BUILD_DIR = join('.timber', 'dist');\n\n/**\n * Resolve the build output directory.\n *\n * Priority:\n * 1. Explicit `timberBuildDir` from timber.config.ts\n * 2. Explicit `viteBuildOutDir` from Vite's build.outDir (if not the default 'dist')\n * 3. Default: `.timber/dist`\n *\n * Returns an absolute path.\n */\nexport function resolveBuildDir(\n  root: string,\n  timberBuildDir?: string,\n  viteBuildOutDir?: string\n): string {\n  if (timberBuildDir) {\n    return join(root, timberBuildDir);\n  }\n  if (viteBuildOutDir && viteBuildOutDir !== 'dist') {\n    return join(root, viteBuildOutDir);\n  }\n  return join(root, DEFAULT_BUILD_DIR);\n}\n\n// ── Config file loading ───────────────────────────────────────────────────\n\n/**\n * Load timber.config.ts (or .js, .mjs) from the project root.\n * Returns the config object or null if no config file is found.\n *\n * Uses require() which works for ESM modules on Node 22.12+.\n * This keeps timber() synchronous — no async config loading needed.\n */\nexport function loadTimberConfigFile(root: string): TimberUserConfig | null {\n  const configNames = ['timber.config.ts', 'timber.config.js', 'timber.config.mjs'];\n  const req = createRequire(join(root, 'package.json'));\n\n  for (const name of configNames) {\n    const configPath = join(root, name);\n    if (existsSync(configPath)) {\n      const mod = req(configPath);\n      return (mod.default ?? mod) as TimberUserConfig;\n    }\n  }\n  return null;\n}\n\n/**\n * Detect config keys set in both inline (vite.config.ts) and file (timber.config.ts)\n * and warn the user. The `output` key is excluded because it defaults to 'server'\n * in createPluginContext and would always appear as an inline key.\n *\n * Returns the list of conflicting key names (for testing).\n */\nexport function warnConfigConflicts(\n  inline: TimberUserConfig,\n  fileConfig: TimberUserConfig\n): string[] {\n  const conflicts: string[] = [];\n  for (const key of Object.keys(fileConfig) as (keyof TimberUserConfig)[]) {\n    if (key in inline && inline[key] !== undefined) {\n      conflicts.push(key);\n    }\n  }\n  if (conflicts.length > 0) {\n    console.warn(\n      `[timber] Config conflict: ${conflicts.map((k) => `\"${k}\"`).join(', ')} set in both ` +\n        `vite.config.ts (inline) and timber.config.ts. ` +\n        `Move all config to timber.config.ts to avoid confusion. ` +\n        `The inline value from vite.config.ts will be used.`\n    );\n  }\n  return conflicts;\n}\n\n/**\n * Merge file-based config into ctx.config. Inline config (already in ctx.config)\n * takes precedence — file config only fills in missing fields.\n */\nexport function mergeFileConfig(ctx: PluginContext, fileConfig: TimberUserConfig): void {\n  const inline = ctx.config;\n  warnConfigConflicts(inline, fileConfig);\n\n  ctx.config = {\n    ...fileConfig,\n    ...inline,\n    ...(fileConfig.limits && inline.limits\n      ? { limits: { ...fileConfig.limits, ...inline.limits } }\n      : {}),\n    ...(fileConfig.dev && inline.dev ? { dev: { ...fileConfig.dev, ...inline.dev } } : {}),\n    ...(fileConfig.mdx && inline.mdx ? { mdx: { ...fileConfig.mdx, ...inline.mdx } } : {}),\n  };\n}\n","/**\n * `timber schema sync` — scan filesystem for dynamic segments and append\n * missing entries to app/schema.ts with `codec.string` defaults.\n *\n * Only adds, never removes or modifies existing entries.\n *\n * Design doc: design/41-global-params.md §Auto-Scaffolding\n */\n\nimport { readFileSync, writeFileSync, existsSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { scanRoutes } from './routing/scanner.js';\nimport type { SegmentNode } from './routing/types.js';\nimport { resolveAppDir } from './plugin-context.js';\n\n/**\n * Collect all unique bracket-keyed dynamic segment names from the route tree.\n * Returns entries like '[artistSlug]', '[...slug]', '[[...topic]]'.\n */\nexport function collectDynamicSegments(appDir: string): string[] {\n  const tree = scanRoutes(appDir);\n  const segments = new Set<string>();\n  walkSegments(tree.root, segments);\n  return [...segments].sort();\n}\n\nfunction walkSegments(node: SegmentNode, segments: Set<string>): void {\n  if (node.paramName) {\n    // Reconstruct bracket key from segmentName (already has brackets)\n    segments.add(node.segmentName);\n  }\n  for (const child of node.children) {\n    walkSegments(child, segments);\n  }\n  for (const slot of Object.values(node.slots)) {\n    walkSegments(slot, segments);\n  }\n}\n\n/**\n * Parse existing bracket keys from an app/schema.ts file.\n * Uses regex to find keys in segmentParams: { '[key]': ... } blocks.\n */\nexport function parseExistingSchemaKeys(content: string): string[] {\n  const keys: string[] = [];\n  // Match quoted bracket keys like '[artistSlug]', '[...slug]', '[[...topic]]'\n  const re = /['\"](\\[{1,2}(?:\\.{3})?\\w+\\]{1,2})['\"]\\s*:/g;\n  let m: RegExpExecArray | null;\n  while ((m = re.exec(content)) !== null) {\n    keys.push(m[1]);\n  }\n  return keys;\n}\n\n/** Schema file extensions to check. */\nconst SCHEMA_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx'];\n\n/**\n * Find the schema file path if it exists.\n */\nexport function findSchemaFile(appDir: string): string | undefined {\n  for (const ext of SCHEMA_EXTENSIONS) {\n    const p = join(appDir, `schema${ext}`);\n    if (existsSync(p)) return p;\n  }\n  return undefined;\n}\n\n/**\n * Generate the content for a new app/schema.ts with the given segment keys.\n */\nfunction generateNewSchema(segments: string[]): string {\n  const lines: string[] = [];\n  lines.push(\"import { defineSchema } from '@timber-js/app/params';\");\n  lines.push(\"import { codec } from '@timber-js/app/codec';\");\n  lines.push('');\n  lines.push('export default defineSchema({');\n  lines.push('  segmentParams: {');\n  for (const seg of segments) {\n    lines.push(`    '${seg}': codec.string,`);\n  }\n  lines.push('  },');\n  lines.push('});');\n  lines.push('');\n  return lines.join('\\n');\n}\n\n/**\n * Append missing segment entries to an existing schema file.\n * Inserts new entries before the closing `}` of segmentParams.\n */\nfunction appendToSchema(content: string, newSegments: string[]): string {\n  // Find the closing brace of segmentParams object.\n  // Strategy: find the last entry in segmentParams block, insert after it.\n  // Look for the pattern: segmentParams: { ... }\n  // We find the closing `},` or `}` that ends segmentParams.\n\n  // Find \"segmentParams\" key position\n  const spIndex = content.indexOf('segmentParams');\n  if (spIndex === -1) {\n    throw new Error(\n      '[timber] Could not find segmentParams in schema file. ' +\n        'Expected a defineSchema({ segmentParams: { ... } }) call.'\n    );\n  }\n\n  // Find the opening brace after segmentParams\n  const openBrace = content.indexOf('{', spIndex + 'segmentParams'.length);\n  if (openBrace === -1) {\n    throw new Error('[timber] Could not find opening brace for segmentParams.');\n  }\n\n  // Count braces to find the matching close\n  let depth = 1;\n  let i = openBrace + 1;\n  while (i < content.length && depth > 0) {\n    if (content[i] === '{') depth++;\n    else if (content[i] === '}') depth--;\n    i++;\n  }\n  // i now points to just after the closing brace\n  const closeBrace = i - 1;\n\n  // Detect indentation from existing entries\n  const existingLine = content.slice(openBrace, closeBrace).match(/^(\\s+)['\"]\\[/m);\n  const indent = existingLine ? existingLine[1] : '    ';\n\n  // Build insertion text\n  const insertion = newSegments.map((seg) => `${indent}'${seg}': codec.string,`).join('\\n');\n\n  // Insert before the closing brace\n  const before = content.slice(0, closeBrace);\n  const after = content.slice(closeBrace);\n\n  // Add newline if the content before doesn't end with one\n  const separator = before.trimEnd().endsWith(',') ? '\\n' : '\\n';\n\n  return before + separator + insertion + '\\n' + after;\n}\n\nexport interface SchemaSyncResult {\n  /** Segments found in the filesystem. */\n  filesystemSegments: string[];\n  /** Segments already defined in app/schema.ts. */\n  existingSegments: string[];\n  /** Segments that were added. */\n  addedSegments: string[];\n  /** Whether a new schema file was created. */\n  created: boolean;\n}\n\n/**\n * Run the schema sync: scan filesystem, diff against schema, append missing.\n */\nexport function runSchemaSync(projectRoot: string): SchemaSyncResult {\n  const appDir = resolveAppDir(projectRoot);\n\n  const filesystemSegments = collectDynamicSegments(appDir);\n\n  if (filesystemSegments.length === 0) {\n    return {\n      filesystemSegments: [],\n      existingSegments: [],\n      addedSegments: [],\n      created: false,\n    };\n  }\n\n  const schemaPath = findSchemaFile(appDir);\n\n  if (!schemaPath) {\n    // Create new schema file\n    const newPath = join(appDir, 'schema.ts');\n    writeFileSync(newPath, generateNewSchema(filesystemSegments), 'utf-8');\n    return {\n      filesystemSegments,\n      existingSegments: [],\n      addedSegments: filesystemSegments,\n      created: true,\n    };\n  }\n\n  // Read existing schema and find missing segments\n  const content = readFileSync(schemaPath, 'utf-8');\n  const existingSegments = parseExistingSchemaKeys(content);\n  const missing = filesystemSegments.filter((seg) => !existingSegments.includes(seg));\n\n  if (missing.length === 0) {\n    return {\n      filesystemSegments,\n      existingSegments,\n      addedSegments: [],\n      created: false,\n    };\n  }\n\n  // Append missing segments\n  const updated = appendToSchema(content, missing);\n  writeFileSync(schemaPath, updated, 'utf-8');\n\n  return {\n    filesystemSegments,\n    existingSegments,\n    addedSegments: missing,\n    created: false,\n  };\n}\n"],"mappings":"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"}

package/dist/_chunks/metadata-routes-Cjmvi3rQ.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metadata-routes-Cjmvi3rQ.js","names":[],"sources":["../../src/server/metadata-routes.ts"],"sourcesContent":["/**\n * Metadata route classification for timber.js.\n *\n * Metadata routes are file-based endpoints that generate well-known URLs for\n * crawlers and browsers (sitemap.xml, robots.txt, OG images, etc.).\n *\n * These routes run through proxy.ts but NOT through middleware.ts or access.ts —\n * they are public endpoints by nature.\n *\n * See design/16-metadata.md §\"Metadata Routes\"\n */\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\n/** Classification of a metadata route file. */\nexport interface MetadataRouteInfo {\n  /** The metadata route type. */\n  type: MetadataRouteType;\n  /** The content type to serve this route with. */\n  contentType: string;\n  /** Whether this route can appear in nested segments (not just app root). */\n  nestable: boolean;\n}\n\nexport type MetadataRouteType =\n  | 'sitemap'\n  | 'robots'\n  | 'manifest'\n  | 'favicon'\n  | 'icon'\n  | 'opengraph-image'\n  | 'twitter-image'\n  | 'apple-icon';\n\n// ─── Convention Table ────────────────────────────────────────────────────────\n\n/**\n * All recognized metadata route file conventions.\n *\n * Each entry maps a base file name (without extension) to its route info.\n * The extensions determine whether the file is static or dynamic.\n *\n * Static extensions: .xml, .txt, .json, .png, .jpg, .ico, .svg\n * Dynamic extensions: .ts, .tsx\n */\nexport const METADATA_ROUTE_CONVENTIONS: Record<\n  string,\n  {\n    type: MetadataRouteType;\n    contentType: string;\n    nestable: boolean;\n    staticExtensions: string[];\n    dynamicExtensions: string[];\n    /** The URL path this file serves at (relative to segment). */\n    servePath: string;\n  }\n> = {\n  'sitemap': {\n    type: 'sitemap',\n    contentType: 'application/xml',\n    nestable: true,\n    staticExtensions: ['xml'],\n    dynamicExtensions: ['ts'],\n    servePath: 'sitemap.xml',\n  },\n  'robots': {\n    type: 'robots',\n    contentType: 'text/plain',\n    nestable: false,\n    staticExtensions: ['txt'],\n    dynamicExtensions: ['ts'],\n    servePath: 'robots.txt',\n  },\n  'manifest': {\n    type: 'manifest',\n    contentType: 'application/manifest+json',\n    nestable: false,\n    staticExtensions: ['json'],\n    dynamicExtensions: ['ts'],\n    servePath: 'manifest.webmanifest',\n  },\n  'favicon': {\n    type: 'favicon',\n    contentType: 'image/x-icon',\n    nestable: false,\n    staticExtensions: ['ico'],\n    dynamicExtensions: [],\n    servePath: 'favicon.ico',\n  },\n  'icon': {\n    type: 'icon',\n    contentType: 'image/*',\n    nestable: true,\n    staticExtensions: ['png', 'jpg', 'svg'],\n    dynamicExtensions: ['ts', 'tsx'],\n    servePath: 'icon',\n  },\n  'opengraph-image': {\n    type: 'opengraph-image',\n    contentType: 'image/*',\n    nestable: true,\n    staticExtensions: ['png', 'jpg'],\n    dynamicExtensions: ['ts', 'tsx'],\n    servePath: 'opengraph-image',\n  },\n  'twitter-image': {\n    type: 'twitter-image',\n    contentType: 'image/*',\n    nestable: true,\n    staticExtensions: ['png', 'jpg'],\n    dynamicExtensions: ['ts', 'tsx'],\n    servePath: 'twitter-image',\n  },\n  'apple-icon': {\n    type: 'apple-icon',\n    contentType: 'image/*',\n    nestable: true,\n    staticExtensions: ['png'],\n    dynamicExtensions: ['ts', 'tsx'],\n    servePath: 'apple-icon',\n  },\n};\n\n// ─── MIME Type Resolution ─────────────────────────────────────────────────────\n\n/**\n * Map of file extensions to MIME types for static metadata route files.\n * Used to resolve the generic `image/*` content type for static image files.\n */\nconst EXTENSION_MIME_TYPES: Record<string, string> = {\n  xml: 'application/xml',\n  txt: 'text/plain',\n  json: 'application/json',\n  ico: 'image/x-icon',\n  png: 'image/png',\n  jpg: 'image/jpeg',\n  jpeg: 'image/jpeg',\n  svg: 'image/svg+xml',\n  webp: 'image/webp',\n};\n\n/**\n * Resolve the concrete MIME type for a static metadata route file.\n *\n * For generic content types like `image/*`, this resolves to the actual\n * MIME type based on the file extension (e.g. `image/png` for `.png`).\n *\n * @param conventionContentType - The content type from the convention table (may be generic like `image/*`)\n * @param extension - The file extension without leading dot (e.g. \"png\", \"xml\")\n * @returns The resolved MIME type\n */\nexport function resolveStaticContentType(conventionContentType: string, extension: string): string {\n  if (conventionContentType.includes('*')) {\n    return EXTENSION_MIME_TYPES[extension] ?? 'application/octet-stream';\n  }\n  return conventionContentType;\n}\n\n/**\n * Check if a file extension represents a static (non-code) metadata route file.\n *\n * @param baseName - The base file name without extension (e.g. \"sitemap\", \"icon\")\n * @param extension - The file extension without leading dot (e.g. \"xml\", \"png\", \"ts\")\n * @returns true if this is a static file, false if dynamic or unrecognized\n */\nexport function isStaticMetadataExtension(baseName: string, extension: string): boolean {\n  const convention = METADATA_ROUTE_CONVENTIONS[baseName];\n  if (!convention) return false;\n  return convention.staticExtensions.includes(extension);\n}\n\n/**\n * Check if a file extension represents a dynamic (code) metadata route file.\n *\n * @param baseName - The base file name without extension (e.g. \"sitemap\", \"icon\")\n * @param extension - The file extension without leading dot (e.g. \"ts\", \"tsx\")\n * @returns true if this is a dynamic file, false if static or unrecognized\n */\nexport function isDynamicMetadataExtension(baseName: string, extension: string): boolean {\n  const convention = METADATA_ROUTE_CONVENTIONS[baseName];\n  if (!convention) return false;\n  return convention.dynamicExtensions.includes(extension);\n}\n\n// ─── Classification ──────────────────────────────────────────────────────────\n\n/**\n * Classify a file name as a metadata route, or return null if it's not one.\n *\n * @param fileName - The full file name including extension (e.g. \"sitemap.xml\", \"icon.tsx\")\n * @returns Classification info, or null if not a metadata route\n */\nexport function classifyMetadataRoute(fileName: string): MetadataRouteInfo | null {\n  const dotIndex = fileName.lastIndexOf('.');\n  if (dotIndex === -1) return null;\n\n  const baseName = fileName.slice(0, dotIndex);\n  const ext = fileName.slice(dotIndex + 1);\n\n  const convention = METADATA_ROUTE_CONVENTIONS[baseName];\n  if (!convention) return null;\n\n  const isStatic = convention.staticExtensions.includes(ext);\n  const isDynamic = convention.dynamicExtensions.includes(ext);\n\n  if (!isStatic && !isDynamic) return null;\n\n  return {\n    type: convention.type,\n    contentType: convention.contentType,\n    nestable: convention.nestable,\n  };\n}\n\n/**\n * Get the serve path for a metadata route type.\n *\n * @param type - The metadata route type\n * @returns The URL path fragment this route serves at\n */\nexport function getMetadataRouteServePath(type: MetadataRouteType): string {\n  for (const convention of Object.values(METADATA_ROUTE_CONVENTIONS)) {\n    if (convention.type === type) return convention.servePath;\n  }\n  throw new Error(`[timber] Unknown metadata route type: ${type}`);\n}\n\n/**\n * Get the auto-link tags to inject into <head> for metadata route files\n * discovered in a segment.\n *\n * @param type - The metadata route type\n * @param href - The resolved URL path to the metadata route\n * @returns An object with tag/attrs for the <head>, or null if no auto-link\n */\nexport function getMetadataRouteAutoLink(\n  type: MetadataRouteType,\n  href: string\n): { rel: string; href: string; type?: string } | null {\n  switch (type) {\n    case 'icon':\n      return { rel: 'icon', href };\n    case 'apple-icon':\n      return { rel: 'apple-touch-icon', href };\n    case 'manifest':\n      return { rel: 'manifest', href };\n    default:\n      return null;\n  }\n}\n"],"mappings":";;;;;;;;;;AA6CA,IAAa,6BAWT;CACF,WAAW;EACT,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,MAAM;EACzB,mBAAmB,CAAC,KAAK;EACzB,WAAW;EACZ;CACD,UAAU;EACR,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,MAAM;EACzB,mBAAmB,CAAC,KAAK;EACzB,WAAW;EACZ;CACD,YAAY;EACV,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,OAAO;EAC1B,mBAAmB,CAAC,KAAK;EACzB,WAAW;EACZ;CACD,WAAW;EACT,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,MAAM;EACzB,mBAAmB,EAAE;EACrB,WAAW;EACZ;CACD,QAAQ;EACN,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB;GAAC;GAAO;GAAO;GAAM;EACvC,mBAAmB,CAAC,MAAM,MAAM;EAChC,WAAW;EACZ;CACD,mBAAmB;EACjB,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,OAAO,MAAM;EAChC,mBAAmB,CAAC,MAAM,MAAM;EAChC,WAAW;EACZ;CACD,iBAAiB;EACf,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,OAAO,MAAM;EAChC,mBAAmB,CAAC,MAAM,MAAM;EAChC,WAAW;EACZ;CACD,cAAc;EACZ,MAAM;EACN,aAAa;EACb,UAAU;EACV,kBAAkB,CAAC,MAAM;EACzB,mBAAmB,CAAC,MAAM,MAAM;EAChC,WAAW;EACZ;CACF;;;;;;;;AAyDD,SAAgB,2BAA2B,UAAkB,WAA4B;CACvF,MAAM,aAAa,2BAA2B;AAC9C,KAAI,CAAC,WAAY,QAAO;AACxB,QAAO,WAAW,kBAAkB,SAAS,UAAU;;;;;;;;AAWzD,SAAgB,sBAAsB,UAA4C;CAChF,MAAM,WAAW,SAAS,YAAY,IAAI;AAC1C,KAAI,aAAa,GAAI,QAAO;CAE5B,MAAM,WAAW,SAAS,MAAM,GAAG,SAAS;CAC5C,MAAM,MAAM,SAAS,MAAM,WAAW,EAAE;CAExC,MAAM,aAAa,2BAA2B;AAC9C,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,WAAW,WAAW,iBAAiB,SAAS,IAAI;CAC1D,MAAM,YAAY,WAAW,kBAAkB,SAAS,IAAI;AAE5D,KAAI,CAAC,YAAY,CAAC,UAAW,QAAO;AAEpC,QAAO;EACL,MAAM,WAAW;EACjB,aAAa,WAAW;EACxB,UAAU,WAAW;EACtB;;;;;;;;AASH,SAAgB,0BAA0B,MAAiC;AACzE,MAAK,MAAM,cAAc,OAAO,OAAO,2BAA2B,CAChE,KAAI,WAAW,SAAS,KAAM,QAAO,WAAW;AAElD,OAAM,IAAI,MAAM,yCAAyC,OAAO;;;;;;;;;;AAWlE,SAAgB,yBACd,MACA,MACqD;AACrD,SAAQ,MAAR;EACE,KAAK,OACH,QAAO;GAAE,KAAK;GAAQ;GAAM;EAC9B,KAAK,aACH,QAAO;GAAE,KAAK;GAAoB;GAAM;EAC1C,KAAK,WACH,QAAO;GAAE,KAAK;GAAY;GAAM;EAClC,QACE,QAAO"}

package/dist/_chunks/resolve-schema-23Mc8aLi.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolve-schema-23Mc8aLi.js","names":[],"sources":["../../src/params/resolve-schema.ts"],"sourcesContent":["/**\n * Schema resolution — resolves the global schema's segmentParams into\n * a runtime-ready codec map keyed by bracket name (e.g. '[id]').\n *\n * Bracket keys are preserved so that `[id]`, `[...id]`, and `[[...id]]`\n * remain distinct entries. The coercion layer reconstructs bracket keys\n * from matched segment metadata to look up the correct codec.\n *\n * Design doc: design/41-global-params.md §Pipeline Integration\n */\n\nimport type { Codec } from '../codec.js';\nimport { isCodec, isStandardSchema, validateSync } from '../schema-bridge.js';\nimport type { StandardSchemaV1 } from '../schema-bridge.js';\n\n/**\n * Wrap a Standard Schema into a Codec for route params.\n * Parse throws on failure (invalid param → 404). Serialize returns string.\n */\nfunction fromParamSchema<T>(fieldName: string, schema: StandardSchemaV1<T>): Codec<T> {\n  return {\n    parse(value: string | string[] | undefined): T {\n      const result = validateSync(schema, value);\n      if (!result.issues) {\n        return result.value;\n      }\n      const messages = result.issues.map((i) => i.message).join(', ');\n      throw new Error(`[timber] Param '${fieldName}' coercion failed: ${messages}`);\n    },\n    serialize(value: T): string | null {\n      if (value === null || value === undefined) return null;\n      if (Array.isArray(value)) return value.join('/');\n      return String(value);\n    },\n  };\n}\n\n/**\n * Resolve a schema entry to a Codec. Accepts Codec<T> or StandardSchemaV1<T>.\n */\nfunction resolveCodec(fieldName: string, value: unknown): Codec<unknown> {\n  if (isCodec(value)) return value;\n  if (isStandardSchema(value)) return fromParamSchema(fieldName, value);\n  throw new Error(`[timber] Schema field '${fieldName}' is not a valid codec or Standard Schema.`);\n}\n\n/**\n * Reconstruct the bracket key for a segment from its type and param name.\n * Used by the coercion layer to look up codecs in the bracket-keyed map.\n *\n * 'dynamic'          + 'id'   → '[id]'\n * 'catch-all'        + 'slug' → '[...slug]'\n * 'optional-catch-all' + 'slug' → '[[...slug]]'\n */\nexport function toBracketKey(segmentType: string, paramName: string): string {\n  switch (segmentType) {\n    case 'catch-all':\n      return `[...${paramName}]`;\n    case 'optional-catch-all':\n      return `[[...${paramName}]]`;\n    default:\n      return `[${paramName}]`;\n  }\n}\n\n/**\n * Resolve the global schema's segmentParams into a map of bracket-keyed\n * param name → resolved Codec.\n *\n * Keys are preserved exactly as written in `app/schema.ts` so that\n * `[id]`, `[...id]`, and `[[...id]]` remain distinct entries.\n * The coercion layer in `param-coercion.ts` reconstructs bracket keys\n * from matched segment metadata to look up the correct codec.\n *\n * Input:  { '[id]': z.coerce.number(), '[...slug]': codec.string }\n * Output: { '[id]': Codec<number>, '[...slug]': Codec<string> }\n */\nexport function resolveSchemaCodecs(\n  segmentParams: Record<string, unknown>\n): Record<string, Codec<unknown>> {\n  const resolved: Record<string, Codec<unknown>> = Object.create(null);\n\n  for (const [bracketName, value] of Object.entries(segmentParams)) {\n    resolved[bracketName] = resolveCodec(bracketName, value);\n  }\n\n  return resolved;\n}\n"],"mappings":";;;;;;AAmBA,SAAS,gBAAmB,WAAmB,QAAuC;AACpF,QAAO;EACL,MAAM,OAAyC;GAC7C,MAAM,SAAS,aAAa,QAAQ,MAAM;AAC1C,OAAI,CAAC,OAAO,OACV,QAAO,OAAO;GAEhB,MAAM,WAAW,OAAO,OAAO,KAAK,MAAM,EAAE,QAAQ,CAAC,KAAK,KAAK;AAC/D,SAAM,IAAI,MAAM,mBAAmB,UAAU,qBAAqB,WAAW;;EAE/E,UAAU,OAAyB;AACjC,OAAI,UAAU,QAAQ,UAAU,KAAA,EAAW,QAAO;AAClD,OAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,KAAK,IAAI;AAChD,UAAO,OAAO,MAAM;;EAEvB;;;;;AAMH,SAAS,aAAa,WAAmB,OAAgC;AACvE,KAAI,QAAQ,MAAM,CAAE,QAAO;AAC3B,KAAI,iBAAiB,MAAM,CAAE,QAAO,gBAAgB,WAAW,MAAM;AACrE,OAAM,IAAI,MAAM,0BAA0B,UAAU,4CAA4C;;;;;;;;;;AAWlG,SAAgB,aAAa,aAAqB,WAA2B;AAC3E,SAAQ,aAAR;EACE,KAAK,YACH,QAAO,OAAO,UAAU;EAC1B,KAAK,qBACH,QAAO,QAAQ,UAAU;EAC3B,QACE,QAAO,IAAI,UAAU;;;;;;;;;;;;;;;AAgB3B,SAAgB,oBACd,eACgC;CAChC,MAAM,WAA2C,OAAO,OAAO,KAAK;AAEpE,MAAK,MAAM,CAAC,aAAa,UAAU,OAAO,QAAQ,cAAc,CAC9D,UAAS,eAAe,aAAa,aAAa,MAAM;AAG1D,QAAO"}