@emeryld/rrroutes-contract 2.2.7 → 2.2.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/dist/docs/serializer.d.ts +1 -1
  2. package/dist/index.cjs +691 -817
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.mjs +691 -817
  5. package/dist/index.mjs.map +1 -1
  6. package/package.json +1 -1
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/crud/routesV3.crud.ts","../src/sockets/socket.index.ts","../src/docs/schemaIntrospection.ts","../src/docs/serializer.ts","../src/docs/LeafDocsPage.tsx","../src/docs/docs.ts"],"sourcesContent":["export * from './core/routesV3.builder';\nexport * from './core/routesV3.core';\nexport * from './core/routesV3.finalize';\nexport * from './crud/routesV3.crud';\nexport * from './sockets/socket.index';\nexport * from './docs/docs';","import { z } from 'zod';\nimport {\n AnyLeaf,\n Append,\n HttpMethod,\n Leaf,\n Merge,\n MergeArray,\n MethodCfg,\n NodeCfg,\n Prettify,\n} from './routesV3.core';\n\nconst defaultFeedQuerySchema = z.object({\n cursor: z.string().optional(),\n limit: z.coerce.number().min(1).max(100).default(20),\n});\n\nconst paginationField = defaultFeedQuerySchema.optional().default(defaultFeedQuerySchema.parse({}));\ntype PaginationField = typeof paginationField;\n\ntype ZodTypeAny = z.ZodTypeAny;\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{ [K in Name]: S }>;\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>;\ntype ZodObjectAny = z.ZodObject<any>;\ntype AnyZodObject = z.ZodObject<any>;\ntype MergedParamsResult<PS, Name extends string, P extends ZodTypeAny> = PS extends ZodTypeAny\n ? z.ZodIntersection<PS, ParamZod<Name, P>>\n : ParamZod<Name, P>;\n\nconst defaultFeedOutputSchema = z.object({\n items: z.array(z.unknown()),\n nextCursor: z.string().optional(),\n});\n\nfunction augmentFeedQuerySchema<Q extends ZodTypeAny | undefined>(schema: Q) {\n if (schema && !(schema instanceof z.ZodObject)) {\n console.warn('Feed queries must be a ZodObject; default pagination applied.');\n return z.object({\n pagination: paginationField,\n });\n }\n\n const base = (schema as ZodObjectAny) ?? z.object({});\n return base.extend({\n pagination: paginationField,\n });\n}\n\nfunction augmentFeedOutputSchema<O extends ZodTypeAny | undefined>(schema: O) {\n if (!schema) return defaultFeedOutputSchema;\n if (schema instanceof z.ZodArray) {\n return z.object({\n items: schema,\n nextCursor: z.string().optional(),\n });\n }\n if (schema instanceof z.ZodObject) {\n const shape = (schema as any).shape ? (schema as any).shape : (schema as any)._def?.shape?.();\n const hasItems = Boolean(shape?.items);\n if (hasItems) {\n return schema.extend({ nextCursor: z.string().optional() });\n }\n return z.object({\n items: z.array(schema as ZodTypeAny),\n nextCursor: z.string().optional(),\n });\n }\n return z.object({\n items: z.array(schema as ZodTypeAny),\n nextCursor: z.string().optional(),\n });\n}\n\n/**\n * Runtime helper that mirrors the typed merge used by the builder.\n * @param a Previously merged params schema inherited from parent segments.\n * @param b Newly introduced params schema.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nfunction mergeSchemas<A extends ZodTypeAny, B extends ZodTypeAny>(a: A, b: B): ZodTypeAny;\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A;\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B;\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined): ZodTypeAny | undefined;\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined) {\n if (a && b) return z.intersection(a as any, b as any);\n return (a ?? b) as ZodTypeAny | undefined;\n}\n\ntype FeedQuerySchema<C extends MethodCfg> = z.ZodObject<any>;\n\ntype FeedOutputSchema<C extends MethodCfg> = C['outputSchema'] extends ZodArrayAny\n ? z.ZodObject<{\n items: C['outputSchema'];\n nextCursor: z.ZodOptional<z.ZodString>;\n }>\n : C['outputSchema'] extends ZodTypeAny\n ? z.ZodObject<{\n items: z.ZodArray<C['outputSchema']>;\n nextCursor: z.ZodOptional<z.ZodString>;\n }>\n : typeof defaultFeedOutputSchema;\n\ntype BaseMethodCfg<C extends MethodCfg> = Merge<\n Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>,\n Omit<C, 'querySchema' | 'outputSchema' | 'feed'>\n>;\n\ntype FeedField<C extends MethodCfg> = C['feed'] extends true ? { feed: true } : { feed?: boolean };\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> = Q extends z.ZodObject<\n infer Shape\n>\n ? z.ZodObject<Shape & { pagination: PaginationField }>\n : z.ZodObject<{ pagination: PaginationField }>;\n\ntype FeedQueryField<C extends MethodCfg> = {\n querySchema: AddPaginationToQuery<\n C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined\n >;\n};\n\ntype NonFeedQueryField<C extends MethodCfg> = C['querySchema'] extends ZodTypeAny\n ? { querySchema: C['querySchema'] }\n : { querySchema?: undefined };\n\ntype FeedOutputField<C extends MethodCfg> = { outputSchema: FeedOutputSchema<C> };\n\ntype NonFeedOutputField<C extends MethodCfg> = C['outputSchema'] extends ZodTypeAny\n ? { outputSchema: C['outputSchema'] }\n : { outputSchema?: undefined };\n\ntype ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny\n ? { paramsSchema: C['paramsSchema'] }\n : { paramsSchema: PS };\n\ntype EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true\n ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS>\n : FeedField<C> & NonFeedQueryField<C> & NonFeedOutputField<C> & ParamsField<C, PS>;\n\ntype EffectiveCfg<C extends MethodCfg, PS> = Prettify<\n Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>\n>;\n\ntype BuiltLeaf<\n M extends HttpMethod,\n Base extends string,\n I extends NodeCfg,\n C extends MethodCfg,\n PS,\n> = Leaf<M, Base, Merge<I, EffectiveCfg<C, PS>>>;\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodTypeAny | undefined,\n> {\n // --- structure ---\n /**\n * Enter or define a static child segment.\n * Optionally accepts extra config and/or a builder to populate nested routes.\n * @param name Child segment literal (no leading slash).\n * @param cfg Optional node configuration to merge for descendants.\n * @param builder Callback to produce leaves for the child branch.\n */\n sub<Name extends string, J extends NodeCfg>(\n name: Name,\n cfg?: J,\n ): Branch<`${Base}/${Name}`, Acc, Merge<I, NonNullable<J>>, PS>;\n\n sub<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeaf[]>(\n name: Name,\n cfg: J,\n builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R,\n ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;\n\n sub<Name extends string, R extends readonly AnyLeaf[]>(\n name: Name,\n builder: (r: Branch<`${Base}/${Name}`, readonly [], I, PS>) => R,\n ): Branch<Base, MergeArray<Acc, R>, I, PS>;\n\n // --- parameterized segment (single signature) ---\n /**\n * Introduce a `:param` segment and merge its schema into downstream leaves.\n * @param name Parameter key (without leading colon).\n * @param paramsSchema Zod schema for the parameter value.\n * @param builder Callback that produces leaves beneath the parameterized segment.\n */\n routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n name: Name,\n paramsSchema: P,\n builder: (\n r: Branch<\n `${Base}/:${Name}`,\n readonly [],\n I,\n MergedParamsResult<PS, Name, P>\n >,\n ) => R,\n ): Branch<Base, MergeArray<Acc, R>, I, MergedParamsResult<PS, Name, P>>;\n\n // --- flags inheritance ---\n /**\n * Merge additional node configuration that subsequent leaves will inherit.\n * @param cfg Partial node configuration.\n */\n with<J extends NodeCfg>(cfg: J): Branch<Base, Acc, Merge<I, J>, PS>;\n\n // --- methods (return Branch to keep chaining) ---\n /**\n * Register a GET leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n get<C extends MethodCfg>(\n cfg: C,\n ): Branch<\n Base,\n Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>,\n I,\n PS\n >;\n\n /**\n * Register a POST leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n post<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'post', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n /**\n * Register a PUT leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n put<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'put', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n /**\n * Register a PATCH leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n patch<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'patch', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n /**\n * Register a DELETE leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n delete<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'delete', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n // --- finalize this subtree ---\n /**\n * Finish the branch and return the collected leaves.\n * @returns Readonly tuple of accumulated leaves.\n */\n done(): Readonly<Acc>;\n}\n\n/**\n * Start building a resource at the given base path.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Optional node configuration applied to all descendants.\n * @returns Root `Branch` instance used to compose the route tree.\n */\nexport function resource<Base extends string, I extends NodeCfg = {}>(\n base: Base,\n inherited?: I,\n): Branch<Base, readonly [], I, undefined> {\n const rootBase = base;\n const rootInherited: NodeCfg = { ...(inherited as NodeCfg) };\n\n function makeBranch<Base2 extends string, I2 extends NodeCfg, PS2 extends ZodTypeAny | undefined>(\n base2: Base2,\n inherited2: I2,\n mergedParamsSchema?: PS2,\n ) {\n const stack: AnyLeaf[] = [];\n let currentBase: string = base2;\n let inheritedCfg: NodeCfg = { ...(inherited2 as NodeCfg) };\n let currentParamsSchema: PS2 = mergedParamsSchema as PS2;\n\n function add<M extends HttpMethod, C extends MethodCfg>(method: M, cfg: C) {\n // If the method didn’t provide a paramsSchema, inject the active merged one.\n const effectiveParamsSchema = (cfg.paramsSchema ?? currentParamsSchema) as PS2 | undefined;\n const effectiveQuerySchema =\n cfg.feed === true ? augmentFeedQuerySchema(cfg.querySchema) : cfg.querySchema;\n const effectiveOutputSchema =\n cfg.feed === true ? augmentFeedOutputSchema(cfg.outputSchema) : cfg.outputSchema;\n\n const fullCfg = (\n effectiveParamsSchema\n ? {\n ...inheritedCfg,\n ...cfg,\n paramsSchema: effectiveParamsSchema,\n ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\n }\n : {\n ...inheritedCfg,\n ...cfg,\n ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\n }\n ) as any;\n\n const leaf = {\n method,\n path: currentBase as Base2,\n cfg: fullCfg,\n } as const;\n\n stack.push(leaf as unknown as AnyLeaf);\n\n // Return same runtime obj, but with Acc including this new leaf\n return api as unknown as Branch<Base2, Append<readonly [], typeof leaf>, I2, PS2>;\n }\n\n const api: any = {\n // compose a plain subpath (optional cfg) with optional builder\n sub<Name extends string, J extends NodeCfg | undefined = undefined>(\n name: Name,\n cfgOrBuilder?: J | ((r: any) => readonly AnyLeaf[]),\n maybeBuilder?: (r: any) => readonly AnyLeaf[],\n ) {\n let cfg: NodeCfg | undefined;\n let builder: ((r: any) => readonly AnyLeaf[]) | undefined;\n\n if (typeof cfgOrBuilder === 'function') {\n builder = cfgOrBuilder as any;\n } else {\n cfg = cfgOrBuilder as NodeCfg | undefined;\n builder = maybeBuilder;\n }\n\n const childBase = `${currentBase}/${name}` as const;\n const childInherited = { ...inheritedCfg, ...(cfg ?? {}) } as Merge<I2, NonNullable<J>>;\n\n if (builder) {\n // params schema PS2 flows through unchanged on plain sub\n const child = makeBranch(childBase, childInherited, currentParamsSchema);\n const leaves = builder(child) as readonly AnyLeaf[];\n for (const l of leaves) stack.push(l);\n return api as Branch<\n Base2,\n Append<readonly [], (typeof leaves)[number]>,\n typeof childInherited,\n PS2\n >;\n } else {\n currentBase = childBase;\n inheritedCfg = childInherited;\n return api as Branch<`${Base2}/${Name}`, readonly [], typeof childInherited, PS2>;\n }\n },\n\n // the single param function: name + schema + builder\n routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n name: Name,\n paramsSchema: P,\n builder: (\n r: Branch<\n `${Base2}/:${Name}`,\n readonly [],\n I2,\n MergedParamsResult<PS2, Name, P>\n >,\n ) => R,\n ) {\n const childBase = `${currentBase}/:${name}` as const;\n // Wrap the value schema under the param name before merging with inherited params schema\n const paramObj: ParamZod<Name, P> = z.object({ [name]: paramsSchema } as Record<Name, P>);\n const childParams = (currentParamsSchema\n ? mergeSchemas(currentParamsSchema, paramObj)\n : paramObj) as MergedParamsResult<PS2, Name, P>;\n const child = makeBranch(childBase, inheritedCfg as I2, childParams);\n const leaves = builder(child) as readonly AnyLeaf[];\n for (const l of leaves) stack.push(l);\n return api as Branch<\n Base2,\n Append<readonly [], (typeof leaves)[number]>,\n I2,\n MergedParamsResult<PS2, Name, P>\n >;\n },\n\n with<J extends NodeCfg>(cfg: J) {\n inheritedCfg = { ...inheritedCfg, ...cfg };\n return api as Branch<Base2, readonly [], Merge<I2, J>, PS2>;\n },\n\n // methods (inject current params schema if missing)\n get<C extends MethodCfg>(cfg: C) {\n return add('get', cfg);\n },\n post<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('post', { ...cfg, feed: false });\n },\n put<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('put', { ...cfg, feed: false });\n },\n patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('patch', { ...cfg, feed: false });\n },\n delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('delete', { ...cfg, feed: false });\n },\n\n done() {\n return stack;\n },\n };\n\n return api as Branch<Base2, readonly [], I2, PS2>;\n }\n\n // Root branch starts with no params schema (PS = undefined)\n return makeBranch(rootBase, rootInherited, undefined);\n}\n\n/**\n * Merge two readonly tuples (preserves literal tuple information).\n * @param arr1 First tuple.\n * @param arr2 Second tuple.\n * @returns New tuple containing values from both inputs.\n */\nexport const mergeArrays = <T extends readonly any[], S extends readonly any[]>(\n arr1: T,\n arr2: S,\n) => {\n return [...arr1, ...arr2] as [...T, ...S];\n};\n","import { z, ZodType } from 'zod';\n\n/** Supported HTTP verbs for the routes DSL. */\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';\n\n/** Declarative description of a multipart upload field. */\nexport type FileField = {\n /** Form field name used for uploads. */\n name: string;\n /** Maximum number of files accepted for this field. */\n maxCount: number;\n};\n\n/** Configuration that applies to an entire branch of the route tree. */\nexport type NodeCfg = {\n /** @deprecated. Does nothing. */\n authenticated?: boolean;\n};\n\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg = {\n /** Zod schema describing the request body. */\n bodySchema?: ZodType;\n /** Zod schema describing the query string. */\n querySchema?: ZodType;\n /** Zod schema describing path params (overrides inferred params). */\n paramsSchema?: ZodType;\n /** Zod schema describing the response payload. */\n outputSchema?: ZodType;\n /** Multipart upload definitions for the route. */\n bodyFiles?: FileField[];\n /** Marks the route as an infinite feed (enables cursor helpers). */\n feed?: boolean;\n\n /** Optional human-readable description for docs/debugging. */\n description?: string;\n /**\n * Short one-line summary for docs list views.\n * Shown in navigation / tables instead of the full description.\n */\n summary?: string;\n /**\n * Group name used for navigation sections in docs UIs.\n * e.g. \"Users\", \"Billing\", \"Auth\".\n */\n docsGroup?: string;\n /**\n * Tags that can be used to filter / facet in interactive docs.\n * e.g. [\"users\", \"admin\", \"internal\"].\n */\n tags?: string[];\n /**\n * Mark the route as deprecated in docs.\n * Renderers can badge this and/or hide by default.\n */\n deprecated?: boolean;\n /**\n * Optional stability information for the route.\n * Renderers can surface this prominently.\n */\n stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';\n /**\n * Hide this route from public docs while keeping it usable in code.\n */\n docsHidden?: boolean;\n /**\n * Arbitrary extra metadata for docs renderers.\n * Can be used for auth requirements, rate limits, feature flags, etc.\n */\n docsMeta?: Record<string, unknown>;\n};\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<M extends HttpMethod, P extends string, C extends MethodCfg> = {\n /** Lowercase HTTP method (get/post/...). */\n readonly method: M;\n /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n readonly path: P;\n /** Readonly snapshot of route configuration. */\n readonly cfg: Readonly<C>;\n};\n\n/** Convenience union covering all generated leaves. */\nexport type AnyLeaf = Leaf<HttpMethod, string, MethodCfg>;\n\n/** Merge two object types while keeping nice IntelliSense output. */\nexport type Merge<A, B> = Prettify<Omit<A, keyof B> & B>;\n\n/** Append a new element to a readonly tuple type. */\nexport type Append<T extends readonly unknown[], X> = [...T, X];\n\n/** Concatenate two readonly tuple types. */\nexport type MergeArray<A extends readonly unknown[], B extends readonly unknown[]> = [\n ...A,\n ...B,\n];\n\n// helpers (optional)\ntype SegmentParams<S extends string> = S extends `:${infer P}` ? P : never;\ntype Split<S extends string> = S extends ''\n ? []\n : S extends `${infer A}/${infer B}`\n ? [A, ...Split<B>]\n : [S];\ntype ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>;\n\n/** Derive a params object type from a literal route string. */\nexport type ExtractParamsFromPath<Path extends string> =\n ExtractParamNames<Path> extends never ? never : Record<ExtractParamNames<Path>, string | number>;\n\n/**\n * Interpolate `:params` in a path using the given values.\n * @param path Literal route string containing `:param` segments.\n * @param params Object of parameter values to interpolate.\n * @returns Path string with parameters substituted.\n */\nexport function compilePath<Path extends string>(path: Path, params: ExtractParamsFromPath<Path>) {\n if (!params) return path;\n return path.replace(/:([A-Za-z0-9_]+)/g, (_, k) => {\n const v = (params as any)[k];\n if (v === undefined || v === null) throw new Error(`Missing param :${k}`);\n return String(v);\n });\n}\n\n/**\n * Build a deterministic cache key for the given leaf.\n * The key matches the shape consumed by React Query helpers.\n * @param args.leaf Leaf describing the endpoint.\n * @param args.params Optional params used to build the path.\n * @param args.query Optional query payload.\n * @returns Tuple suitable for React Query cache keys.\n */\ntype SplitPath<P extends string> = P extends ''\n ? []\n : P extends `${infer A}/${infer B}`\n ? [A, ...SplitPath<B>]\n : [P];\nexport function buildCacheKey<L extends AnyLeaf>(args: {\n leaf: L;\n params?: ExtractParamsFromPath<L['path']>;\n query?: InferQuery<L>;\n}) {\n let p = args.leaf.path;\n if (args.params) {\n p = compilePath<L['path']>(p, args.params);\n }\n return [args.leaf.method, ...(p.split('/').filter(Boolean) as SplitPath<typeof p>), args.query ?? {}] as const;\n}\n\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeaf> = L['cfg']['paramsSchema'] extends ZodType\n ? z.infer<L['cfg']['paramsSchema']>\n : ExtractParamsFromPath<L['path']>;\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf> = L['cfg']['querySchema'] extends ZodType\n ? z.infer<L['cfg']['querySchema']>\n : never;\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf> = L['cfg']['bodySchema'] extends ZodType\n ? z.infer<L['cfg']['bodySchema']>\n : never;\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf> = L['cfg']['outputSchema'] extends ZodType\n ? z.infer<L['cfg']['outputSchema']>\n : unknown;\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n","// TODO:\n// * use this as a transform that infers the types from Zod, to only pass the types around instead of the full schemas -> make converters that go both ways (data to schema, schema to data)\n// * consider moving to core package\n// * update server and client side to use this type instead of raw zod schemas \nimport { AnyLeaf, HttpMethod, Prettify } from './routesV3.core';\n\n/** Build the key type for a leaf — distributive so method/path stay paired. */\nexport type KeyOf<L extends AnyLeaf> = L extends AnyLeaf\n ? `${Uppercase<L['method']>} ${L['path']}`\n : never;\n\n// From a tuple of leaves, get the union of keys (pairwise, no cartesian blow-up)\ntype KeysOf<Leaves extends readonly AnyLeaf[]> = KeyOf<Leaves[number]>;\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}` ? Lowercase<M> : never;\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}` ? P : never;\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<Leaves extends readonly AnyLeaf[], K extends string> = Extract<\n Leaves[number],\n { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>;\n\n/**\n * Freeze a leaf tuple into a registry with typed key lookups.\n * @param leaves Readonly tuple of leaves produced by the builder DSL.\n * @returns Registry containing the leaves array and a `byKey` lookup map.\n */\nexport function finalize<const L extends readonly AnyLeaf[]>(leaves: L) {\n type Keys = KeysOf<L>;\n type MapByKey = { [K in Keys]: Prettify<LeafForKey<L, K>> };\n\n const byKey = Object.fromEntries(\n leaves.map((l) => [`${l.method.toUpperCase()} ${l.path}`, l] as const),\n ) as unknown as MapByKey;\n\n const log = (logger: { system: (...args: unknown[]) => void }) => {\n logger.system('Finalized routes:');\n (Object.keys(byKey) as Keys[]).forEach((k) => {\n const leaf = byKey[k];\n logger.system(`- ${k}`);\n });\n };\n\n return { all: leaves, byKey, log };\n}\n\n/** Nominal type alias for a finalized registry. */\nexport type Registry<R extends ReturnType<typeof finalize>> = R;\n\ntype FilterRoute<\n T extends readonly AnyLeaf[],\n F extends string,\n Acc extends readonly AnyLeaf[] = [],\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n ? First extends { path: `${string}${F}${string}` }\n ? FilterRoute<Rest, F, [...Acc, First]>\n : FilterRoute<Rest, F, Acc>\n : Acc;\n\ntype UpperCase<S extends string> = S extends `${infer First}${infer Rest}`\n ? `${Uppercase<First>}${UpperCase<Rest>}`\n : S;\n\ntype Routes<T extends readonly AnyLeaf[], F extends string> = FilterRoute<T, F>;\ntype ByKey<\n T extends readonly AnyLeaf[],\n Acc extends Record<string, AnyLeaf> = {},\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n ? ByKey<Rest, Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }>\n : Acc;\n\n/**\n * Convenience helper for extracting a subset of routes by path fragment.\n * @param T Tuple of leaves produced by the DSL.\n * @param F String fragment to match against the route path.\n */\nexport type SubsetRoutes<T extends readonly AnyLeaf[], F extends string> = {\n byKey: ByKey<Routes<T, F>>;\n all: Routes<T, F>;\n};\n","// routesV3.crud.ts\n// -----------------------------------------------------------------------------\n// Add a first-class .crud() helper to the routesV3 DSL, without touching the\n// core builder. This file:\n// 1) Declares types + module augmentation to extend Branch<...> with .crud\n// 2) Provides a runtime decorator `withCrud(...)` that installs the method\n// 3) Exports a convenience `resourceWithCrud(...)` wrapper (optional)\n// -----------------------------------------------------------------------------\n\nimport { z, ZodType } from 'zod';\nimport {\n resource as baseResource,\n type Branch as _Branch, // import type so we can augment it\n} from '../core/routesV3.builder';\nimport { type AnyLeaf, type Leaf, type NodeCfg } from '../core/routesV3.core';\n\n// -----------------------------------------------------------------------------\n// Small utilities (runtime + types)\n// -----------------------------------------------------------------------------\n/** Default cursor pagination used by list (GET collection). */\nexport const CrudDefaultPagination = z.object({\n limit: z.coerce.number().min(1).max(100).default(20),\n cursor: z.string().optional(),\n});\nconst CrudPaginationField = CrudDefaultPagination.optional().default(CrudDefaultPagination.parse({}));\ntype CrudPaginationField = typeof CrudPaginationField;\ntype AnyCrudZodObject = z.ZodObject<any>;\ntype AddCrudPagination<Q extends AnyCrudZodObject | undefined> = Q extends z.ZodObject<infer Shape>\n ? z.ZodObject<Shape & { pagination: CrudPaginationField }>\n : z.ZodObject<{ pagination: CrudPaginationField }>;\n\n/**\n * Merge two Zod schemas at runtime; matches the typing pattern used in builder.\n * @param a Existing params schema inherited from parent branches.\n * @param b Schema introduced at the current branch.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nexport function mergeSchemas<A extends ZodType | undefined, B extends ZodType | undefined>(\n a: A,\n b: B,\n): A extends ZodType ? (B extends ZodType ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n if (a && b) return z.intersection(a as any, b as any) as any;\n return (a ?? b) as any;\n}\n\n/** Build { [Name]: S } Zod object at the type-level. */\nexport type ParamSchema<Name extends string, S extends ZodType> = z.ZodObject<{\n [K in Name]: S;\n}>;\n\n/** Inject active params schema into a leaf cfg (to match your Leaf typing). */\ntype WithParams<I, P> = P extends ZodType ? Omit<I, 'paramsSchema'> & { paramsSchema: P } : I;\n\n/** Resolve boolean flag: default D unless explicitly false. */\ntype Flag<E, D extends boolean> = E extends false ? false : D;\n\n// -----------------------------------------------------------------------------\n// CRUD config (few knobs, with DX comments)\n// -----------------------------------------------------------------------------\n\n/** Toggle individual CRUD methods; defaults enable all (create/update require body). */\nexport type CrudEnable = {\n /** GET /collection (feed). Defaults to true. */ list?: boolean;\n /** POST /collection. Defaults to true if `create` provided. */ create?: boolean;\n /** GET /collection/:id. Defaults to true. */ read?: boolean;\n /** PATCH /collection/:id. Defaults to true if `update` provided. */ update?: boolean;\n /** DELETE /collection/:id. Defaults to true. */ remove?: boolean;\n};\n\n/** Collection GET config. */\nexport type CrudListCfg = {\n /** Query schema (defaults to cursor pagination). */\n querySchema?: ZodType;\n /** Output schema (defaults to { items: Item[], nextCursor? }). */\n outputSchema?: ZodType;\n /** Optional description string. */\n description?: string;\n};\n\n/** Collection POST config. */\nexport type CrudCreateCfg = {\n /** Body schema for creating an item. */\n bodySchema: ZodType;\n /** Output schema (defaults to itemOutputSchema). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/** Item GET config. */\nexport type CrudReadCfg = {\n /** Output schema (defaults to itemOutputSchema). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/** Item PATCH config. */\nexport type CrudUpdateCfg = {\n /** Body schema for partial updates. */\n bodySchema: ZodType;\n /** Output schema (defaults to itemOutputSchema). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/** Item DELETE config. */\nexport type CrudRemoveCfg = {\n /** Output schema (defaults to { ok: true }). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/**\n * CRUD config for `.crud(\"resource\", cfg, extras?)`.\n *\n * It synthesizes `:[resourceName]Id` as the param key and uses `paramSchema` for the value.\n * Prefer passing a **value schema** (e.g. `z.string().uuid()`).\n * As a convenience, a ZodObject of shape `{ [resourceName]Id: schema }` is accepted at runtime too.\n */\nexport type CrudCfg<Name extends string = string> = {\n /**\n * Zod schema for the ID *value* (e.g. `z.string().uuid()`).\n * The parameter key is always `:${name}Id`.\n * (If you pass `z.object({ [name]Id: ... })`, it's accepted at runtime.)\n */\n paramSchema: ZodType;\n\n /**\n * The single-item output shape used by read/create/update by default.\n * List defaults to `{ items: z.array(itemOutputSchema), nextCursor? }`.\n */\n itemOutputSchema: ZodType;\n\n /** Per-method toggles (all enabled by default; create/update require bodies). */\n enable?: CrudEnable;\n\n /** GET /collection configuration. */ list?: CrudListCfg;\n /** POST /collection configuration (enables create). */ create?: CrudCreateCfg;\n /** GET /collection/:id configuration. */ read?: CrudReadCfg;\n /** PATCH /collection/:id configuration (enables update). */ update?: CrudUpdateCfg;\n /** DELETE /collection/:id configuration. */ remove?: CrudRemoveCfg;\n};\n\n// -----------------------------------------------------------------------------\n// Type plumbing to expose generated leaves (so finalize().byKey sees them)\n// -----------------------------------------------------------------------------\n\ntype CrudLeavesTuple<\n Base extends string,\n I extends NodeCfg,\n PS extends ZodType | undefined,\n Name extends string,\n C extends CrudCfg<Name>,\n> = `${Name}Id` extends infer IdName extends string\n ? ParamSchema<IdName, C['paramSchema']> extends infer IdParamZ extends ZodType\n ? [\n // GET /collection\n ...(Flag<\n C['enable'] extends CrudEnable ? C['enable']['list'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'get',\n `${Base}/${Name}`,\n WithParams<\n Omit<I, never> & {\n feed: true;\n querySchema: C['list'] extends CrudListCfg\n ? AddCrudPagination<\n C['list']['querySchema'] extends AnyCrudZodObject\n ? C['list']['querySchema']\n : undefined\n >\n : AddCrudPagination<undefined>;\n outputSchema: C['list'] extends CrudListCfg\n ? C['list']['outputSchema'] extends ZodType\n ? C['list']['outputSchema']\n : z.ZodObject<{\n items: z.ZodArray<C['itemOutputSchema']>;\n nextCursor: z.ZodOptional<z.ZodString>;\n }>\n : z.ZodObject<{\n items: z.ZodArray<C['itemOutputSchema']>;\n nextCursor: z.ZodOptional<z.ZodString>;\n }>;\n description?: string;\n },\n PS\n >\n >,\n ]\n : []),\n\n // POST /collection\n ...((C['create'] extends CrudCreateCfg ? true : false) extends true\n ? Flag<\n C['enable'] extends CrudEnable ? C['enable']['create'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'post',\n `${Base}/${Name}`,\n WithParams<\n Omit<I, never> & {\n bodySchema: C['create'] extends CrudCreateCfg\n ? C['create']['bodySchema']\n : never;\n outputSchema: C['create'] extends CrudCreateCfg\n ? C['create']['outputSchema'] extends ZodType\n ? C['create']['outputSchema']\n : C['itemOutputSchema']\n : never;\n description?: string;\n },\n PS\n >\n >,\n ]\n : []\n : []),\n\n // GET /collection/:id\n ...(Flag<\n C['enable'] extends CrudEnable ? C['enable']['read'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'get',\n `${Base}/${Name}/:${IdName}`,\n WithParams<\n Omit<I, never> & {\n outputSchema: C['read'] extends CrudReadCfg\n ? C['read']['outputSchema'] extends ZodType\n ? C['read']['outputSchema']\n : C['itemOutputSchema']\n : C['itemOutputSchema'];\n description?: string;\n },\n ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n >\n >,\n ]\n : []),\n\n // PATCH /collection/:id\n ...((C['update'] extends CrudUpdateCfg ? true : false) extends true\n ? Flag<\n C['enable'] extends CrudEnable ? C['enable']['update'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'patch',\n `${Base}/${Name}/:${IdName}`,\n WithParams<\n Omit<I, never> & {\n bodySchema: C['update'] extends CrudUpdateCfg\n ? C['update']['bodySchema']\n : never;\n outputSchema: C['update'] extends CrudUpdateCfg\n ? C['update']['outputSchema'] extends ZodType\n ? C['update']['outputSchema']\n : C['itemOutputSchema']\n : never;\n description?: string;\n },\n ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n >\n >,\n ]\n : []\n : []),\n\n // DELETE /collection/:id\n ...(Flag<\n C['enable'] extends CrudEnable ? C['enable']['remove'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'delete',\n `${Base}/${Name}/:${IdName}`,\n WithParams<\n Omit<I, never> & {\n outputSchema: C['remove'] extends CrudRemoveCfg\n ? C['remove']['outputSchema'] extends ZodType\n ? C['remove']['outputSchema']\n : z.ZodObject<{ ok: z.ZodLiteral<true> }>\n : z.ZodObject<{ ok: z.ZodLiteral<true> }>;\n description?: string;\n },\n ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n >\n >,\n ]\n : []),\n ]\n : never\n : never;\n\n/** Merge generated leaves + extras into the branch accumulator. */\ntype CrudResultAcc<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodType | undefined,\n Name extends string,\n C extends CrudCfg<Name>,\n Extras extends readonly AnyLeaf[],\n> = [...Acc, ...CrudLeavesTuple<Base, I, PS, Name, C>, ...Extras];\n\n// -----------------------------------------------------------------------------\n// Module augmentation: add the typed `.crud(...)` to Branch<...>\n// -----------------------------------------------------------------------------\n\ndeclare module './../core/routesV3.builder' {\n interface Branch<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodType | undefined,\n > {\n /**\n * Generate opinionated CRUD endpoints for a collection at `/.../<name>`\n * with an item at `/.../<name>/:<name>Id`.\n *\n * Creates (subject to `enable` + presence of create/update bodies):\n * - GET /<name> (feed list)\n * - POST /<name> (create)\n * - GET /<name>/:<name>Id (read item)\n * - PATCH /<name>/:<name>Id (update item)\n * - DELETE /<name>/:<name>Id (remove item)\n *\n * The `extras` callback receives live builders at both collection and item\n * levels so you can add custom subroutes; their leaves are included in the\n * returned Branch type.\n */\n crud<\n Name extends string,\n C extends CrudCfg<Name>,\n Extras extends readonly AnyLeaf[] = readonly [],\n >(\n name: Name,\n cfg: C,\n extras?: (ctx: {\n /** Builder at `/.../<name>` (collection scope). */\n collection: _Branch<`${Base}/${Name}`, readonly [], I, PS>;\n /** Builder at `/.../<name>/:<name>Id` (item scope). */\n item: _Branch<\n `${Base}/${Name}/:${`${Name}Id`}`,\n readonly [],\n I,\n ReturnType<typeof mergeSchemas<PS, ParamSchema<`${Name}Id`, C['paramSchema']>>>\n >;\n }) => Extras,\n ): _Branch<Base, CrudResultAcc<Base, Acc, I, PS, Name, C, Extras>, I, PS>;\n }\n}\n\n// -----------------------------------------------------------------------------\n// Runtime: install .crud on any Branch via decorator\n// -----------------------------------------------------------------------------\n\n/**\n * Decorate a Branch instance so `.crud(...)` is available at runtime.\n * Tip: wrap the root: `withCrud(resource('/v1'))`.\n * @param branch Branch returned by `resource(...)`.\n * @returns Same branch with `.crud(...)` installed.\n */\nexport function withCrud<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodType | undefined,\n>(branch: _Branch<Base, Acc, I, PS>): _Branch<Base, Acc, I, PS> {\n const b = branch as any;\n if (typeof b.crud === 'function') return branch;\n\n b.crud = function <\n Name extends string,\n C extends CrudCfg<Name>,\n Extras extends readonly AnyLeaf[] = readonly [],\n >(this: any, name: Name, cfg: C, extras?: (ctx: { collection: any; item: any }) => Extras) {\n // Build inside a sub-branch at `/.../<name>` and harvest its leaves.\n return this.sub(name, (collection: any) => {\n const idKey = `${name}Id`;\n\n // Accept a value schema (preferred); but if a z.object({[name]Id: ...}) is provided, use it.\n const s = cfg.paramSchema;\n const isObj =\n s &&\n typeof (s as any)._def === 'object' &&\n (s as any)._def.typeName === 'ZodObject' &&\n typeof (s as any).shape === 'function';\n\n const paramValueSchema =\n isObj && (s as any).shape()[idKey] ? ((s as any).shape()[idKey] as ZodType) : (s as ZodType);\n\n const itemOut = cfg.itemOutputSchema;\n const listOut =\n cfg.list?.outputSchema ??\n z.object({\n items: z.array(itemOut),\n nextCursor: z.string().optional(),\n });\n\n const want = {\n list: cfg.enable?.list !== false,\n create: cfg.enable?.create !== false && !!cfg.create?.bodySchema,\n read: cfg.enable?.read !== false,\n update: cfg.enable?.update !== false && !!cfg.update?.bodySchema,\n remove: cfg.enable?.remove !== false,\n } as const;\n\n // Collection routes\n if (want.list) {\n collection.get({\n feed: true,\n querySchema: cfg.list?.querySchema ?? CrudDefaultPagination,\n outputSchema: listOut,\n description: cfg.list?.description ?? 'List',\n });\n }\n\n if (want.create) {\n collection.post({\n bodySchema: cfg.create!.bodySchema,\n outputSchema: cfg.create?.outputSchema ?? itemOut,\n description: cfg.create?.description ?? 'Create',\n });\n }\n\n // Item routes via :<name>Id\n collection.routeParameter(idKey as any, paramValueSchema as any, (item: any) => {\n if (want.read) {\n item.get({\n outputSchema: cfg.read?.outputSchema ?? itemOut,\n description: cfg.read?.description ?? 'Read',\n });\n }\n if (want.update) {\n item.patch({\n bodySchema: cfg.update!.bodySchema,\n outputSchema: cfg.update?.outputSchema ?? itemOut,\n description: cfg.update?.description ?? 'Update',\n });\n }\n if (want.remove) {\n item.delete({\n outputSchema: cfg.remove?.outputSchema ?? z.object({ ok: z.literal(true) }),\n description: cfg.remove?.description ?? 'Delete',\n });\n }\n\n // Give extras fully-capable builders (decorate so extras can call .crud again)\n if (extras) extras({ collection: withCrud(collection), item: withCrud(item) });\n\n return item.done();\n });\n\n return collection.done();\n });\n };\n\n return branch;\n}\n\n// -----------------------------------------------------------------------------\n// Optional convenience: re-export a resource() that already has .crud installed\n// -----------------------------------------------------------------------------\n\n/**\n * Drop-in replacement for `resource(...)` that returns a Branch with `.crud()` installed.\n * You can either use this or call `withCrud(resource(...))`.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Node configuration merged into every leaf.\n * @returns Branch builder that already includes the CRUD helper.\n */\nexport function resourceWithCrud<Base extends string, I extends NodeCfg = {}>(\n base: Base,\n inherited: I,\n) {\n return withCrud(baseResource(base, inherited));\n}\n\n// Re-export the original in case you want both styles from this module\nexport { baseResource as resource };\n","// socket.index.ts (shared client/server)\n\nimport { z } from 'zod';\n\nexport type SocketSchema<Output =unknown> = z.ZodType & {\n __out: Output;\n};\n\nexport type SocketSchemaOutput<Schema extends z.ZodTypeAny> = Schema extends {\n __out: infer Out;\n} ? Out : z.output<Schema>;\n\nexport type SocketEvent<Out = unknown> = {\n message: z.ZodTypeAny;\n /** phantom field, only for typing; not meant to be used at runtime */\n __out: Out;\n};\n\nexport type EventMap = Record<string, SocketEvent<any>>;\n\n/**\n * System event names – shared so server and client\n * don't drift on naming.\n */\nexport type SysEventName = 'sys:connect' | 'sys:disconnect' | 'sys:reconnect' | 'sys:connect_error' | 'sys:ping' | 'sys:pong' | 'sys:room_join' | 'sys:room_leave';\nexport function defineSocketEvents<const C extends SocketConnectionConfig, const Schemas extends Record<string, {\n message: z.ZodTypeAny;\n}>>(config: C, events: Schemas): {\n config: {\n [K in keyof C]: SocketSchema<z.output<C[K]>>;\n };\n events: {\n [K in keyof Schemas]: SocketEvent<z.output<Schemas[K]['message']>>;\n };\n};\n\nexport function defineSocketEvents(config: any, events: any) {\n return { config, events };\n}\n\n\n\nexport type Payload<T extends EventMap, K extends keyof T> = T[K] extends SocketEvent<infer Out> ? Out : never;\nexport type SocketConnectionConfig = {\n joinMetaMessage: z.ZodTypeAny;\n leaveMetaMessage: z.ZodTypeAny;\n pingPayload: z.ZodTypeAny;\n pongPayload: z.ZodTypeAny;\n};\n\nexport type SocketConnectionConfigOutput = {\n joinMetaMessage: SocketSchema<any>;\n leaveMetaMessage: SocketSchema<any>;\n pingPayload: SocketSchema<any>;\n pongPayload: SocketSchema<any>;\n}","// schemaIntrospection.ts\nimport * as z from \"zod\";\n\nexport type SerializableSchemaNode = {\n kind: string; // \"object\" | \"string\" | \"number\" | ...\n optional?: boolean;\n nullable?: boolean;\n description?: string;\n\n // object\n properties?: Record<string, SerializableSchemaNode>;\n // array\n element?: SerializableSchemaNode;\n // union\n union?: SerializableSchemaNode[];\n // literal\n literal?: unknown;\n // enum\n enumValues?: string[];\n};\n\ntype ZodAny = z.ZodTypeAny;\n\n/**\n * Zod 3 uses `schema._def`, Zod 4 uses `schema._zod.def`.\n */\nfunction getDef(schema: unknown): any | undefined {\n if (!schema || typeof schema !== \"object\") return undefined;\n const anySchema = schema as any;\n return anySchema._zod?.def ?? anySchema._def;\n}\n\n/**\n * Try to get a human-readable description.\n * Zod 4: use metadata/registry; fallback to internal def.description.\n * Zod 3: only internal def.description exists.\n */\nfunction getDescription(schema: ZodAny): string | undefined {\n const anyZ: any = z as any;\n\n // Zod 4 global registry metadata, if present\n const registry = anyZ.globalRegistry?.get\n ? anyZ.globalRegistry.get(schema)\n : undefined;\n if (registry && typeof registry.description === \"string\") {\n return registry.description;\n }\n\n // Legacy / internal description\n const def = getDef(schema);\n if (def && typeof def.description === \"string\") {\n return def.description;\n }\n\n return undefined;\n}\n\n/**\n * Peel off wrappers (effects, optional, nullable, default) and\n * return the inner schema + flags.\n *\n * Supports:\n * - Zod 3: ZodEffects, ZodOptional, ZodNullable, ZodDefault\n * - Zod 4: ZodOptional, ZodNullable, ZodDefault\n */\nfunction unwrap(schema: ZodAny): {\n base: ZodAny;\n optional: boolean;\n nullable: boolean;\n} {\n let s: ZodAny = schema;\n let optional = false;\n let nullable = false;\n\n // Zod 3 only (undefined in Zod 4)\n const ZodEffectsCtor: any = (z as any).ZodEffects;\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n // Zod 3: ZodEffects wrapper\n if (ZodEffectsCtor && s instanceof ZodEffectsCtor) {\n const def = getDef(s) || {};\n const sourceType =\n typeof (s as any).sourceType === \"function\"\n ? (s as any).sourceType()\n : def.schema;\n if (!sourceType) break;\n s = sourceType;\n continue;\n }\n\n // Zod 3 + 4: optional/nullable/default wrappers\n if (s instanceof z.ZodOptional) {\n optional = true;\n const def = getDef(s);\n s = (def && def.innerType) || s; // innerType exists in both 3 & 4\n continue;\n }\n\n if (s instanceof z.ZodNullable) {\n nullable = true;\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n if (s instanceof z.ZodDefault) {\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n break;\n }\n\n return { base: s, optional, nullable };\n}\n\nexport function introspectSchema(\n schema: ZodAny | undefined\n): SerializableSchemaNode | undefined {\n if (!schema) return undefined;\n\n const { base, optional, nullable } = unwrap(schema);\n const def = getDef(base);\n\n const node: SerializableSchemaNode = {\n kind: inferKind(base),\n optional: optional || undefined,\n nullable: nullable || undefined,\n description: getDescription(base),\n };\n\n // OBJECT\n if (base instanceof z.ZodObject) {\n // Zod 3: _def.shape() (function)\n // Zod 4: .shape getter returns an object\n const rawShape: any =\n (base as any).shape ?? (def && typeof def.shape === \"function\"\n ? def.shape()\n : def?.shape);\n\n const shape =\n typeof rawShape === \"function\" ? rawShape() : rawShape ?? {};\n\n const props: Record<string, SerializableSchemaNode> = {};\n for (const key of Object.keys(shape)) {\n const child = shape[key] as ZodAny;\n const childNode = introspectSchema(child);\n if (childNode) props[key] = childNode;\n }\n node.properties = props;\n }\n\n // ARRAY\n if (base instanceof z.ZodArray) {\n // Zod 3: def.type is inner schema\n // Zod 4: def.element is inner schema\n const inner =\n (def && (def.element as ZodAny)) ||\n (def && (def.type as ZodAny)) ||\n undefined;\n if (inner) {\n node.element = introspectSchema(inner);\n }\n }\n\n // UNION\n if (base instanceof z.ZodUnion) {\n const options: ZodAny[] = (def && def.options) || [];\n node.union = options\n .map((opt) => introspectSchema(opt))\n .filter(Boolean) as SerializableSchemaNode[];\n }\n\n // LITERAL\n if (base instanceof z.ZodLiteral) {\n if (def) {\n // Zod 4: def.values (multi-literal)\n if (Array.isArray(def.values)) {\n node.literal =\n def.values.length === 1 ? def.values[0] : def.values.slice();\n } else {\n // Zod 3: def.value\n node.literal = def.value;\n }\n }\n }\n\n // ENUM\n if (base instanceof z.ZodEnum) {\n if (def) {\n if (Array.isArray(def.values)) {\n // Zod 3\n node.enumValues = def.values.slice();\n } else if (def.entries && typeof def.entries === \"object\") {\n // Zod 4: entries is a { key: value } map\n node.enumValues = Object.values(def.entries).map((v: unknown) =>\n String(v)\n );\n }\n }\n }\n\n return node;\n}\n\nfunction inferKind(schema: ZodAny): string {\n // This path still uses instanceof; it works with Zod 4 Classic\n // (importing from \"zod\"). Anything unknown falls back to \"unknown\".\n if (schema instanceof z.ZodString) return \"string\";\n if (schema instanceof z.ZodNumber) return \"number\";\n if (schema instanceof z.ZodBoolean) return \"boolean\";\n if (schema instanceof z.ZodBigInt) return \"bigint\";\n if (schema instanceof z.ZodDate) return \"date\";\n if (schema instanceof z.ZodArray) return \"array\";\n if (schema instanceof z.ZodObject) return \"object\";\n if (schema instanceof z.ZodUnion) return \"union\";\n if (schema instanceof z.ZodLiteral) return \"literal\";\n if (schema instanceof z.ZodEnum) return \"enum\";\n if (schema instanceof z.ZodRecord) return \"record\";\n if (schema instanceof z.ZodTuple) return \"tuple\";\n if (schema instanceof z.ZodUnknown) return \"unknown\";\n if (schema instanceof z.ZodAny) return \"any\";\n\n return \"unknown\";\n}\n","// serializer.ts\nimport { AnyLeaf, MethodCfg } from \"../core/routesV3.core\";\nimport { introspectSchema, SerializableSchemaNode } from \"./schemaIntrospection\";\n\ntype SerializableMethodCfg = Pick<\n MethodCfg,\n | \"description\"\n | \"summary\"\n | \"docsGroup\"\n | \"tags\"\n | \"deprecated\"\n | \"stability\"\n | \"feed\"\n | \"docsMeta\"\n> & {\n hasBody: boolean;\n hasQuery: boolean;\n hasParams: boolean;\n hasOutput: boolean;\n\n // NEW: full Zod ASTs\n bodySchema?: SerializableSchemaNode;\n querySchema?: SerializableSchemaNode;\n paramsSchema?: SerializableSchemaNode;\n outputSchema?: SerializableSchemaNode;\n};\n\nexport type SerializableLeaf = {\n method: string;\n path: string;\n cfg: SerializableMethodCfg;\n};\n\nexport function serializeLeaf(leaf: AnyLeaf): SerializableLeaf {\n const cfg = leaf.cfg;\n\n const tags = Array.isArray(cfg.tags) ? cfg.tags.slice() : [];\n\n return {\n method: leaf.method, // 'get' | 'post' | ...\n path: leaf.path,\n cfg: {\n description: cfg.description,\n summary: cfg.summary,\n docsGroup: cfg.docsGroup,\n tags,\n deprecated: cfg.deprecated,\n stability: cfg.stability,\n feed: !!cfg.feed,\n docsMeta: cfg.docsMeta,\n hasBody: !!cfg.bodySchema || !!cfg.bodyFiles?.length,\n hasQuery: !!cfg.querySchema,\n hasParams: !!cfg.paramsSchema,\n hasOutput: !!cfg.outputSchema,\n\n bodySchema: introspectSchema(cfg.bodySchema),\n querySchema: introspectSchema(cfg.querySchema),\n paramsSchema: introspectSchema(cfg.paramsSchema),\n outputSchema: introspectSchema(cfg.outputSchema),\n },\n };\n}\n","import { AnyLeaf } from \"../core/routesV3.core\";\nimport { serializeLeaf } from \"./serializer\";\n\ninterface RenderOptions {\n cspNonce?: string;\n inlineCss?: string;\n inlineClientScript?: string;\n}\n\n/**\n * Updated CSS including pastel tag generation,\n * refined header layouts, and sticky overview integration.\n */\nconst CSS_STYLES = `:root {\n --bg-root: #020617;\n --bg-card: rgba(15, 23, 42, 0.6);\n --bg-card-hover: rgba(30, 41, 59, 0.7);\n --bg-glass: rgba(15, 23, 42, 0.90);\n --border-subtle: rgba(148, 163, 184, 0.2);\n\n --text-main: #f8fafc;\n --text-muted: #94a3b8;\n --text-accent: #c4b5fd;\n\n --accent-primary: #a855f7;\n --accent-glow: rgba(168, 85, 247, 0.25);\n\n /* Method Colors */\n --method-get: #4ade80; --method-get-bg: rgba(34, 197, 94, 0.15);\n --method-post: #60a5fa; --method-post-bg: rgba(59, 130, 246, 0.15);\n --method-put: #facc15; --method-put-bg: rgba(234, 179, 8, 0.15);\n --method-patch: #2dd4bf; --method-patch-bg: rgba(45, 212, 191, 0.15);\n --method-delete: #f87171; --method-delete-bg: rgba(248, 113, 113, 0.15);\n\n --radius-card: 12px;\n --shadow-card: 0 4px 20px rgba(0, 0, 0, 0.4);\n\n --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;\n\n /* Tag Pastel Palette */\n --tag-0-bg: rgba(254, 202, 202, 0.2); --tag-0-fg: #fca5a5; /* Red */\n --tag-1-bg: rgba(253, 230, 138, 0.2); --tag-1-fg: #fcd34d; /* Amber */\n --tag-2-bg: rgba(187, 247, 208, 0.2); --tag-2-fg: #86efac; /* Green */\n --tag-3-bg: rgba(165, 243, 252, 0.2); --tag-3-fg: #67e8f9; /* Cyan */\n --tag-4-bg: rgba(191, 219, 254, 0.2); --tag-4-fg: #93c5fd; /* Blue */\n --tag-5-bg: rgba(233, 213, 255, 0.2); --tag-5-fg: #d8b4fe; /* Purple */\n --tag-6-bg: rgba(251, 207, 232, 0.2); --tag-6-fg: #f9a8d4; /* Pink */\n}\n\n* { box-sizing: border-box; }\n\nhtml, body {\n height: 100%;\n margin: 0;\n padding: 0;\n background-color: var(--bg-root);\n color: var(--text-main);\n font-family: system-ui, -apple-system, sans-serif;\n -webkit-font-smoothing: antialiased;\n}\n\nbody {\n background-image:\n radial-gradient(circle at 15% 10%, rgba(88, 28, 135, 0.15), transparent 40%),\n radial-gradient(circle at 85% 80%, rgba(15, 23, 42, 1), transparent 40%);\n background-attachment: fixed;\n}\n\n.page {\n min-height: 100vh;\n padding: 20px 40px 60px;\n max-width: 1600px;\n margin: 0 auto;\n display: flex;\n flex-direction: column;\n gap: 24px;\n}\n\n/* --- Header --- */\n.header {\n display: flex;\n justify-content: space-between;\n align-items: flex-end;\n padding-bottom: 10px;\n border-bottom: 1px solid var(--border-subtle);\n}\n.header-title h1 {\n font-size: 28px;\n margin: 0;\n font-weight: 700;\n letter-spacing: -0.02em;\n background: linear-gradient(to right, #e2e8f0, #a855f7);\n -webkit-background-clip: text;\n -webkit-text-fill-color: transparent;\n}\n\n/* --- Sticky Controls & Overview --- */\n.controls-container {\n position: sticky;\n top: 0;\n z-index: 50;\n background: var(--bg-glass);\n backdrop-filter: blur(16px);\n border: 1px solid var(--border-subtle);\n border-radius: var(--radius-card);\n padding: 12px 16px;\n display: flex;\n flex-direction: column;\n gap: 12px;\n box-shadow: 0 10px 30px -10px rgba(0,0,0,0.5);\n}\n\n.schema-indent {\n display: inline-block;\n}\n\n.schema-branch {\n opacity: 0.6;\n font-family: var(--font-mono);\n margin-right: 2px;\n}\n\n.schema-meta code {\n font-family: var(--font-mono);\n font-size: 11px;\n}\n\n/* Top Row: Filters */\n.filters-row {\n display: flex;\n align-items: flex-start;\n gap: 16px;\n width: 100%;\n}\n\n/* New Wrapper for Search and Methods */\n.left-column {\n display: flex;\n flex-direction: column;\n gap: 16px;\n flex-basis: 300px;\n min-width: 250px;\n}\n\n.search-box {\n width: 100%;\n position: relative;\n}\n\n/* Tag Filter Group */\n.filter-group.tag-filters-container {\n flex: 1;\n min-width: 200px;\n}\n\n/* Method Filter Group */\n.filter-group.method-filters-container {\n}\n\n.search-input {\n width: 100%;\n background: rgba(2, 6, 23, 0.6);\n border: 1px solid var(--border-subtle);\n color: var(--text-main);\n padding: 8px 12px 8px 32px;\n border-radius: 6px;\n font-size: 13px;\n transition: all 0.2s;\n}\n.search-input:focus {\n outline: none;\n border-color: var(--accent-primary);\n box-shadow: 0 0 0 2px var(--accent-glow);\n}\n.search-icon {\n position: absolute;\n left: 10px;\n top: 50%;\n transform: translateY(-50%);\n color: var(--text-muted);\n pointer-events: none;\n font-size: 12px;\n}\n\n.filter-group {\n display: flex;\n flex-direction: column;\n gap: 6px;\n}\n.filter-label {\n font-size: 10px;\n text-transform: uppercase;\n letter-spacing: 0.05em;\n color: var(--text-muted);\n font-weight: 700;\n}\n.checkbox-group {\n display: flex;\n flex-wrap: wrap;\n gap: 6px;\n}\n\n/* Bottom Row: Group Overview Chips */\n.overview-row {\n display: flex;\n flex-wrap: wrap;\n gap: 8px;\n padding-top: 8px;\n border-top: 1px solid var(--border-subtle);\n align-items: center;\n}\n.overview-label {\n font-size: 10px;\n text-transform: uppercase;\n color: var(--text-muted);\n font-weight: 700;\n margin-right: 4px;\n}\n.schema-indent {\n display: inline-block;\n}\n\n.schema-branch {\n opacity: 0.6;\n font-family: var(--font-mono);\n margin-right: 2px;\n}\n\n/* Chips/Pills */\n.pill-checkbox { cursor: pointer; user-select: none; }\n.pill-checkbox input { display: none; }\n.pill-checkbox span {\n display: inline-block;\n padding: 3px 8px;\n border-radius: 4px;\n font-size: 11px;\n font-weight: 600;\n background: rgba(30, 41, 59, 0.5);\n color: var(--text-muted);\n border: 1px solid transparent;\n transition: all 0.15s;\n}\n.pill-checkbox input:checked + span {\n background: rgba(168, 85, 247, 0.15);\n color: var(--accent-primary);\n border-color: var(--accent-primary);\n}\n\n/* Tag filter pills */\n.tag-filter-pill {\n display: inline-block;\n padding: 3px 8px;\n border-radius: 4px;\n font-size: 11px;\n font-weight: 600;\n background: rgba(30, 41, 59, 0.5);\n color: var(--text-muted);\n border: 1px solid transparent;\n transition: all 0.15s;\n}\n.pill-checkbox.colored-tag input:checked + .tag-filter-pill {\n border-color: var(--accent-primary);\n box-shadow: 0 0 0 1px var(--accent-glow);\n}\n\n/* Group Jump Links */\n.group-chip {\n font-size: 11px;\n text-decoration: none;\n color: var(--text-accent);\n background: rgba(168, 85, 247, 0.08);\n padding: 3px 8px;\n border-radius: 4px;\n transition: all 0.2s;\n border: 1px solid transparent;\n}\n.group-chip:hover {\n background: rgba(168, 85, 247, 0.2);\n border-color: var(--accent-primary);\n color: #fff;\n}\n\n/* --- Main Content --- */\n.api-group { margin-bottom: 40px; scroll-margin-top: 180px; }\n.group-header {\n display: flex;\n align-items: center;\n justify-content: space-between;\n margin-bottom: 16px;\n padding-bottom: 8px;\n border-bottom: 1px solid var(--border-subtle);\n}\n.group-title {\n font-size: 20px;\n font-weight: 600;\n color: var(--text-main);\n margin: 0;\n}\n.group-actions button {\n background: transparent;\n border: 1px solid var(--border-subtle);\n color: var(--text-muted);\n font-size: 11px;\n padding: 4px 10px;\n border-radius: 4px;\n cursor: pointer;\n margin-left: 8px;\n transition: all 0.2s;\n}\n.group-actions button:hover {\n color: var(--text-main);\n background: rgba(255,255,255,0.05);\n}\n\n.cards-list { display: flex; flex-direction: column; gap: 12px; }\n\n/* --- Endpoint Card --- */\n.endpoint-card {\n background: var(--bg-card);\n border: 1px solid var(--border-subtle);\n border-radius: var(--radius-card);\n overflow: hidden;\n transition: all 0.2s ease;\n cursor: pointer;\n backdrop-filter: blur(10px);\n}\n.endpoint-card:hover {\n background: var(--bg-card-hover);\n border-color: rgba(148, 163, 184, 0.4);\n box-shadow: var(--shadow-card);\n}\n.endpoint-card[data-expanded=\"true\"] {\n background: rgba(30, 41, 59, 0.6);\n border-color: var(--accent-primary);\n box-shadow: 0 0 0 1px var(--accent-glow), var(--shadow-card);\n}\n\n/* Card Header */\n.card-header {\n padding: 12px 16px;\n display: flex;\n align-items: center;\n gap: 12px;\n flex-wrap: wrap;\n}\n\n/* Item 1: Method */\n.method-badge {\n font-size: 11px;\n font-weight: 800;\n text-transform: uppercase;\n padding: 4px 8px;\n border-radius: 4px;\n min-width: 55px;\n text-align: center;\n letter-spacing: 0.05em;\n flex-shrink: 0;\n}\n.m-GET { background: var(--method-get-bg); color: var(--method-get); border: 1px solid rgba(74, 222, 128, 0.3); }\n.m-POST { background: var(--method-post-bg); color: var(--method-post); border: 1px solid rgba(96, 165, 250, 0.3); }\n.m-PUT { background: var(--method-put-bg); color: var(--method-put); border: 1px solid rgba(250, 204, 21, 0.3); }\n.m-PATCH { background: var(--method-patch-bg); color: var(--method-patch); border: 1px solid rgba(45, 212, 191, 0.3); }\n.m-DELETE { background: var(--method-delete-bg); color: var(--method-delete); border: 1px solid rgba(248, 113, 113, 0.3); }\n\n/* Item 2: Path */\n.path-container {\n font-family: var(--font-mono);\n font-size: 13px;\n color: var(--text-main);\n display: inline-flex;\n align-items: center;\n gap: 8px;\n cursor: pointer;\n padding: 2px 6px;\n border-radius: 4px;\n transition: background 0.2s;\n}\n.path-container:hover {\n background: rgba(255,255,255,0.05);\n}\n.path-text {\n font-weight: 500;\n}\n.copy-icon {\n opacity: 0;\n color: var(--text-muted);\n font-size: 10px;\n transition: opacity 0.2s;\n}\n.path-container:hover .copy-icon { opacity: 1; }\n\n/* Item 3: Tags */\n.tags-container {\n display: flex;\n align-items: center;\n gap: 6px;\n flex-wrap: wrap;\n}\n.status-badge {\n font-size: 9px;\n text-transform: uppercase;\n padding: 2px 6px;\n border-radius: 3px;\n border: 1px solid transparent;\n font-weight: 600;\n letter-spacing: 0.03em;\n}\n/* Tag Colors mapped via JS classes */\n.tag-0 { background: var(--tag-0-bg); color: var(--tag-0-fg); border-color: var(--tag-0-fg); }\n.tag-1 { background: var(--tag-1-bg); color: var(--tag-1-fg); border-color: var(--tag-1-fg); }\n.tag-2 { background: var(--tag-2-bg); color: var(--tag-2-fg); border-color: var(--tag-2-fg); }\n.tag-3 { background: var(--tag-3-bg); color: var(--tag-3-fg); border-color: var(--tag-3-fg); }\n.tag-4 { background: var(--tag-4-bg); color: var(--tag-4-fg); border-color: var(--tag-4-fg); }\n.tag-5 { background: var(--tag-5-bg); color: var(--tag-5-fg); border-color: var(--tag-5-fg); }\n.tag-6 { background: var(--tag-6-bg); color: var(--tag-6-fg); border-color: var(--tag-6-fg); }\n\n.not-implemented { border-color: var(--method-delete); color: var(--method-delete); background: var(--method-delete-bg); }\n\n/* Spacer to push expand icon to right */\n.header-spacer { flex: 1; }\n\n.expand-icon {\n color: var(--text-muted);\n transition: transform 0.3s ease;\n font-size: 10px;\n margin-left: 8px;\n}\n.endpoint-card[data-expanded=\"true\"] .expand-icon {\n transform: rotate(180deg);\n color: var(--text-main);\n}\n\n/* Card Body */\n.card-body {\n display: none;\n padding: 0 16px 16px;\n border-top: 1px solid var(--border-subtle);\n margin-top: 4px;\n cursor: default;\n}\n.endpoint-card[data-expanded=\"true\"] .card-body {\n display: block;\n animation: slideDown 0.2s ease-out;\n}\n@keyframes slideDown {\n from { opacity: 0; transform: translateY(-5px); }\n to { opacity: 1; transform: translateY(0); }\n}\n\n.section-block { margin-top: 18px; }\n.section-title {\n font-size: 11px;\n text-transform: uppercase;\n letter-spacing: 0.1em;\n color: var(--text-muted);\n margin-bottom: 8px;\n border-bottom: 1px solid var(--border-subtle);\n padding-bottom: 4px;\n}\n.summary-text { font-size: 14px; color: var(--text-main); line-height: 1.5; }\n\n.description-text {\n font-size: 12px;\n opacity: 0.7;\n}\n\n/* Tables */\n.schema-table { width: 100%; border-collapse: collapse; font-size: 12px; }\n.schema-table th {\n text-align: left; color: var(--text-muted); font-weight: 600;\n padding: 6px 8px; border-bottom: 1px solid var(--border-subtle); background: rgba(0,0,0,0.2);\n}\n.schema-table td {\n padding: 6px 8px; border-bottom: 1px solid var(--border-subtle); vertical-align: top; color: var(--text-muted);\n}\n.col-name { font-family: var(--font-mono); color: var(--text-accent) !important; width: 20%; }\n.col-type { font-family: var(--font-mono); color: #93c5fd !important; width: 15%; }\n.req-badge { font-size: 9px; text-transform: uppercase; padding: 2px 4px; border-radius: 2px; }\n.req-true { color: #4ade80; background: rgba(74, 222, 128, 0.1); }\n.req-false { color: #94a3b8; background: rgba(148, 163, 184, 0.1); }\n\n.schema-subtitle {\n font-size: 11px;\n font-weight: 600;\n margin-bottom: 4px;\n color: #64748b;\n}\n\n.empty-message { text-align: center; padding: 40px; color: var(--text-muted); }\n`;\n\n/**\n * Client-side logic (no inline styles or inline event handlers).\n */\nconst DOCS_JS = `\n(function() {\n let leaves = [];\n try {\n leaves = JSON.parse(document.getElementById('leaf-data').textContent || '[]');\n } catch(e) { console.error('Failed to parse docs', e); }\n\n // State\n const filters = {\n search: '',\n methods: new Set(),\n tags: new Set()\n };\n\n // DOM Elements\n const elRouteList = document.getElementById('routeList');\n const elOverview = document.getElementById('overviewList');\n const elSearch = document.getElementById('searchInput');\n const elMethodFilters = document.getElementById('methodFilters');\n const elTagFilters = document.getElementById('tagFilters');\n\n // Constants\n const PALETTE_SIZE = 7; // matches .tag-0 to .tag-6 CSS\n\n // Initialization\n function init() {\n populateFilters();\n setupGlobalListeners();\n render();\n }\n\n // Tag Coloring Logic\n function getTagColorClass(tagName) {\n if (tagName === 'not-implemented') return 'not-implemented';\n let hash = 0;\n for (let i = 0; i < tagName.length; i++) {\n hash = tagName.charCodeAt(i) + ((hash << 5) - hash);\n }\n const index = Math.abs(hash % PALETTE_SIZE);\n return 'tag-' + index;\n }\n\n // Custom Group Sort: Alpha, but UNGROUPED last\n function sortGroups(a, b) {\n const nameA = a.toUpperCase();\n const nameB = b.toUpperCase();\n if (nameA === 'UNGROUPED') return 1;\n if (nameB === 'UNGROUPED') return -1;\n return nameA.localeCompare(nameB);\n }\n\n function populateFilters() {\n if (!elMethodFilters || !elTagFilters) return;\n\n // Extract unique values\n const allMethods = new Set(leaves.map(l => (l.method || 'GET').toUpperCase()));\n const allTags = new Set(leaves.flatMap(l => (l.cfg && l.cfg.tags) ? l.cfg.tags : []));\n\n // Setup Method Checkboxes\n const sortedMethods = Array.from(allMethods).sort();\n elMethodFilters.innerHTML = sortedMethods.map(m => (\n '<label class=\"pill-checkbox\">' +\n '<input type=\"checkbox\" value=\"' + escapeAttr(m) + '\" checked>' +\n '<span>' + escapeHtml(m) + '</span>' +\n '</label>'\n )).join('');\n sortedMethods.forEach(m => filters.methods.add(m));\n\n // Attach listeners to method checkboxes\n elMethodFilters.querySelectorAll('input[type=\"checkbox\"]').forEach(function(cb) {\n cb.addEventListener('change', updateFilters);\n });\n\n // Setup Tag Checkboxes\n if (allTags.size > 0) {\n elTagFilters.innerHTML = Array.from(allTags).sort().map(t => {\n const colorClass = getTagColorClass(t);\n return (\n '<label class=\"pill-checkbox colored-tag\">' +\n '<input type=\"checkbox\" value=\"' + escapeAttr(t) + '\">' +\n '<span class=\"tag-filter-pill ' + colorClass + '\">' + escapeHtml(t) + '</span>' +\n '</label>'\n );\n }).join('');\n\n // Attach listeners to tag checkboxes\n elTagFilters.querySelectorAll('input[type=\"checkbox\"]').forEach(function(cb) {\n cb.addEventListener('change', updateFilters);\n });\n }\n }\n\n function updateFilters() {\n if (elSearch) {\n filters.search = elSearch.value.toLowerCase();\n }\n\n filters.methods.clear();\n if (elMethodFilters) {\n elMethodFilters.querySelectorAll('input[type=\"checkbox\"]:checked').forEach(function(cb) {\n filters.methods.add(cb.value);\n });\n }\n\n filters.tags.clear();\n if (elTagFilters) {\n elTagFilters.querySelectorAll('input[type=\"checkbox\"]:checked').forEach(function(cb) {\n filters.tags.add(cb.value);\n });\n }\n\n render();\n }\n\n function setupGlobalListeners() {\n if (elSearch) {\n elSearch.addEventListener('input', updateFilters);\n }\n }\n\n // Core Render Logic\n function render() {\n if (!elRouteList || !elOverview) return;\n\n // 1. Filter Data\n const filtered = leaves.filter(function(leaf) {\n const m = (leaf.method || 'GET').toUpperCase();\n const t = (leaf.cfg && leaf.cfg.tags) ? leaf.cfg.tags : [];\n const path = (leaf.path || '').toLowerCase();\n const summary = (leaf.cfg && leaf.cfg.summary || '').toLowerCase();\n\n if (!filters.methods.has(m)) return false;\n if (filters.tags.size > 0 && !t.some(function(tag) { return filters.tags.has(tag); })) return false;\n if (filters.search && !path.includes(filters.search) && !summary.includes(filters.search)) return false;\n\n return true;\n });\n\n if (filtered.length === 0) {\n elRouteList.innerHTML = '<div class=\"empty-message\">No endpoints match your filters.</div>';\n elOverview.innerHTML = '';\n return;\n }\n\n // 2. Group Data\n const groups = {};\n filtered.forEach(function(leaf) {\n const gName = (leaf.cfg && leaf.cfg.docsGroup) ? leaf.cfg.docsGroup : 'UNGROUPED';\n if (!groups[gName]) groups[gName] = [];\n groups[gName].push(leaf);\n });\n\n const sortedGroupNames = Object.keys(groups).sort(sortGroups);\n\n // 3. Render Overview Chips\n elOverview.innerHTML = (\n '<span class=\"overview-label\">JUMP TO:</span>' +\n sortedGroupNames.map(function(gName) {\n return (\n '<a href=\"#group-' + escapeAttr(gName) + '\" ' +\n 'class=\"group-chip\" data-group=\"' + escapeAttr(gName) + '\">' +\n escapeHtml(gName) +\n '</a>'\n );\n }).join('')\n );\n\n // 4. Render Groups & Cards\n const html = sortedGroupNames.map(function(gName) {\n const routes = groups[gName];\n routes.sort(function(a, b) {\n const pA = a.path || '';\n const pB = b.path || '';\n if (pA < pB) return -1;\n if (pA > pB) return 1;\n return (a.method || '').localeCompare(b.method || '');\n });\n\n return (\n '<div class=\"api-group\" id=\"group-' + escapeAttr(gName) + '\">' +\n '<div class=\"group-header\">' +\n '<h2 class=\"group-title\">' + escapeHtml(gName) + '</h2>' +\n '<div class=\"group-actions\">' +\n '<button type=\"button\" data-group=\"' + escapeAttr(gName) + '\" data-action=\"expand\">Expand All</button>' +\n '<button type=\"button\" data-group=\"' + escapeAttr(gName) + '\" data-action=\"collapse\">Collapse All</button>' +\n '</div>' +\n '</div>' +\n '<div class=\"cards-list\">' +\n routes.map(renderCard).join('') +\n '</div>' +\n '</div>'\n );\n }).join('');\n\n elRouteList.innerHTML = html;\n\n // Wire up interactions that depend on rendered DOM\n wireOverviewInteractions();\n wireCardInteractions();\n }\n\n // Card Renderer\n function renderCard(leaf) {\n const method = (leaf.method || 'GET').toUpperCase();\n const path = leaf.path || '/';\n const cfg = leaf.cfg || {};\n const summary = cfg.summary || '';\n const description = cfg.description || '';\n const tags = cfg.tags || [];\n\n const tagBadges = tags.map(function(t) {\n const cClass = getTagColorClass(t);\n return '<span class=\"status-badge ' + cClass + '\">' + escapeHtml(t) + '</span>';\n }).join('');\n\n const headerHtml =\n '<div class=\"card-header\">' +\n '<span class=\"method-badge m-' + escapeAttr(method) + '\">' + escapeHtml(method) + '</span>' +\n '<div class=\"path-container\" data-path=\"' + escapeAttr(path) + '\" title=\"Click to copy path\">' +\n '<span class=\"path-text\">' + escapeHtml(path) + '</span>' +\n '<span class=\"copy-icon\">📋</span>' +\n '</div>' +\n '<div class=\"tags-container\">' +\n tagBadges +\n '</div>' +\n '<div class=\"header-spacer\"></div>' +\n '<div class=\"expand-icon\">▼</div>' +\n '</div>';\n\n let contentHtml =\n '<div class=\"section-block\"><div class=\"summary-text\">' +\n '<strong>' + escapeHtml(summary) + '</strong>' +\n (description\n ? '<br><span class=\"description-text\">' + escapeHtml(description) + '</span>'\n : ''\n ) +\n '</div></div>';\n\n if (cfg.paramsSchema || cfg.querySchema) {\n contentHtml += '<div class=\"section-block\"><div class=\"section-title\">Parameters</div>';\n if (cfg.paramsSchema) contentHtml += renderSchemaTable(cfg.paramsSchema, 'Path Parameters');\n if (cfg.querySchema) contentHtml += renderSchemaTable(cfg.querySchema, 'Query Parameters');\n contentHtml += '</div>';\n }\n\n if (cfg.bodySchema) {\n contentHtml +=\n '<div class=\"section-block\">' +\n '<div class=\"section-title\">Request Body ' + (cfg.hasBody ? '' : '(Optional)') + '</div>' +\n renderSchemaTable(cfg.bodySchema) +\n '</div>';\n }\n\n if (cfg.outputSchema) {\n contentHtml +=\n '<div class=\"section-block\">' +\n '<div class=\"section-title\">Response Schema</div>' +\n renderSchemaTable(cfg.outputSchema) +\n '</div>';\n }\n\n return (\n '<article class=\"endpoint-card\" data-expanded=\"false\">' +\n headerHtml +\n '<div class=\"card-body\">' +\n contentHtml +\n '</div>' +\n '</article>'\n );\n }\n\n// Recursive schema renderer with proper depth-based indentation.\n\nfunction renderSchemaTable(node, title) {\n let rows = '';\n\n if (node.kind === 'object' && node.properties) {\n // Start at depth -1 so first level of properties shows at depth 0\n rows = renderObjectChildren(node, -1);\n } else {\n rows = renderNodeRow('(root)', node, 0);\n }\n\n return (\n (title\n ? '<div class=\"schema-subtitle\">' + escapeHtml(title) + '</div>'\n : '') +\n '<table class=\"schema-table\">' +\n rows +\n '</table>'\n );\n}\n\nfunction renderObjectChildren(node, depth) {\n if (!node.properties) return '';\n\n let rows = '';\n Object.keys(node.properties).forEach(function (key) {\n rows += renderNodeRow(key, node.properties[key], depth + 1);\n });\n return rows;\n}\n\nfunction renderNodeRow(name, node, depth) {\n const reqClass = node.optional ? 'req-false' : 'req-true';\n const reqText = node.optional ? 'OPT' : 'REQ';\n\n const indentPx = depth * 16; // increase this if you want more spacing per level\n const nameCell =\n '<span class=\"schema-indent\" style=\"padding-left:' +\n indentPx +\n 'px;\"></span>' +\n (depth > 0 ? '<span class=\"schema-branch\">└─ </span>' : '') +\n escapeHtml(name);\n\n const typeLabel = getTypeLabel(node);\n const descriptionHtml = renderNodeDescription(node);\n\n let rows =\n '<tr>' +\n '<td class=\"col-name\">' + nameCell + '</td>' +\n '<td class=\"col-type\">' + escapeHtml(typeLabel) + '</td>' +\n '<td><span class=\"req-badge ' + reqClass + '\">' + reqText + '</span></td>' +\n '<td>' + descriptionHtml + '</td>' +\n '</tr>';\n\n // 1) Object properties\n if (node.kind === 'object' && node.properties) {\n rows += renderObjectChildren(node, depth);\n }\n\n // 2) Array element type\n if (node.kind === 'array' && node.element) {\n const element = node.element;\n if (isComplexNode(element)) {\n // element rendered one level deeper than the array itself\n rows += renderNodeRow('[items]', element, depth + 1);\n }\n }\n\n // 3) Union variants\n if (node.kind === 'union' && Array.isArray(node.union)) {\n node.union.forEach(function (variant, index) {\n rows += renderNodeRow('option ' + (index + 1), variant, depth + 1);\n });\n }\n\n return rows;\n}\n\n/**\n * Decide if a node is “complex” enough to warrant a nested expansion row.\n */\nfunction isComplexNode(node) {\n return (\n node.kind === 'object' ||\n node.kind === 'array' ||\n node.kind === 'union' ||\n node.kind === 'record' ||\n node.kind === 'tuple'\n );\n}\n\n/**\n * Helper: simple vs complex node, for compact type labels.\n */\nfunction isSimpleNode(node) {\n return !isComplexNode(node);\n}\n\n/**\n * Type label shown in the \"Type\" column.\n */\nfunction getTypeLabel(node) {\n let base;\n\n switch (node.kind) {\n case 'object':\n base = 'object';\n break;\n\n case 'array':\n if (!node.element) {\n base = 'array';\n } else if (isSimpleNode(node.element)) {\n base = 'array<' + getTypeLabel(node.element) + '>';\n } else {\n base = 'array<object>';\n }\n break;\n\n case 'union':\n if (node.union && node.union.length) {\n const parts = node.union.map(function (u) {\n return isSimpleNode(u) ? getTypeLabel(u) : 'object';\n });\n base = parts.join(' | ');\n } else {\n base = 'union';\n }\n break;\n\n case 'literal':\n base = 'literal';\n break;\n\n case 'enum':\n base = 'enum';\n break;\n\n case 'record':\n base = 'record';\n break;\n\n case 'tuple':\n base = 'tuple';\n break;\n\n default:\n base = node.kind || 'unknown';\n break;\n }\n\n if (node.nullable) {\n base = base + ' | null';\n }\n return base;\n}\n\n/**\n * Description cell content:\n * - main description text\n * - for enum: allowed values\n * - for literal: literal value\n */\nfunction renderNodeDescription(node) {\n const parts = [];\n\n if (node.description) {\n parts.push(escapeHtml(node.description));\n }\n\n if (node.kind === 'enum' && node.enumValues && node.enumValues.length) {\n const values = node.enumValues\n .map(function (v) {\n return '<code>' + escapeHtml(String(v)) + '</code>';\n })\n .join(' | ');\n parts.push('<div class=\"schema-meta\">Allowed: ' + values + '</div>');\n }\n\n if (node.kind === 'literal' && typeof node.literal !== 'undefined') {\n const valueStr = escapeHtml(JSON.stringify(node.literal));\n parts.push(\n '<div class=\"schema-meta\">Literal: <code>' + valueStr + '</code></div>'\n );\n }\n\n return parts.join('<br>');\n}\n\n/**\n * Escape HTML helper.\n */\nfunction escapeHtml(str) {\n return String(str)\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&#39;');\n}\n\n\n function getTypeLabel(node) {\n if (!node) return 'any';\n if (node.kind === 'array') return getTypeLabel(node.element) + '[]';\n if (node.enumValues) return 'enum(' + node.enumValues.join('|') + ')';\n return node.kind || 'any';\n }\n\n // Interactions\n\n function wireOverviewInteractions() {\n if (!elOverview || !elRouteList) return;\n\n // group chips\n elOverview.querySelectorAll('.group-chip').forEach(function(chip) {\n chip.addEventListener('click', function(e) {\n e.preventDefault();\n const gName = chip.getAttribute('data-group');\n if (gName) scrollToGroup(gName);\n });\n });\n\n // expand/collapse buttons\n elRouteList.querySelectorAll('.group-actions button').forEach(function(btn) {\n btn.addEventListener('click', function() {\n const gName = btn.getAttribute('data-group');\n const action = btn.getAttribute('data-action');\n if (!gName || !action) return;\n toggleGroup(gName, action === 'expand');\n });\n });\n }\n\n function wireCardInteractions() {\n if (!elRouteList) return;\n\n // card expand/collapse\n elRouteList.querySelectorAll('.endpoint-card').forEach(function(card) {\n card.addEventListener('click', function(e) {\n var target = e.target;\n if (target && target.closest && target.closest('.path-container')) {\n // handled separately for copy\n return;\n }\n toggleCard(card);\n });\n });\n\n // copy path\n elRouteList.querySelectorAll('.path-container').forEach(function(pc) {\n pc.addEventListener('click', function(e) {\n e.stopPropagation();\n const text = pc.getAttribute('data-path') || '';\n copyText(text);\n });\n });\n }\n\n function toggleCard(card) {\n const isExpanded = card.getAttribute('data-expanded') === 'true';\n card.setAttribute('data-expanded', String(!isExpanded));\n }\n\n function toggleGroup(gName, expand) {\n const group = document.getElementById('group-' + gName);\n if (!group) return;\n group.querySelectorAll('.endpoint-card').forEach(function(c) {\n c.setAttribute('data-expanded', String(!!expand));\n });\n }\n\n function copyText(text) {\n if (!navigator.clipboard || !text) return;\n navigator.clipboard.writeText(text).catch(function() {\n // ignore\n });\n }\n\n function scrollToGroup(gName) {\n const el = document.getElementById('group-' + gName);\n if (el) window.scrollTo({ top: el.offsetTop - 220, behavior: 'smooth' });\n }\n\n // Escaping helpers\n function escapeHtml(str) {\n if (!str && str !== 0) return '';\n return String(str)\n .replace(/&/g, '&amp;')\n .replace(/</g, '&lt;')\n .replace(/>/g, '&gt;')\n .replace(/\"/g, '&quot;')\n .replace(/'/g, '&#39;');\n }\n\n function escapeAttr(str) {\n return escapeHtml(str);\n }\n\n init();\n})();\n`;\n\nexport function renderLeafDocsHTML(\n leaves: AnyLeaf[],\n options: RenderOptions = {}\n): string {\n const leavesJson = JSON.stringify(leaves.map(serializeLeaf));\n const nonceAttr = options.cspNonce ? ` nonce=\"${options.cspNonce}\"` : \"\";\n\n return `\n<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>API Documentation</title>\n\n <style${nonceAttr}>${CSS_STYLES}</style>\n ${options.inlineCss ? `<style${nonceAttr}>${options.inlineCss}</style>` : \"\"}\n</head>\n<body>\n <div class=\"page\">\n <header class=\"header\">\n <div class=\"header-title\">\n <h1>API Reference</h1>\n </div>\n </header>\n\n <div class=\"controls-container\">\n <div class=\"filters-row\">\n <div class=\"left-column\">\n <div class=\"filter-group method-filters-container\">\n <div class=\"filter-label\">Search</div>\n <div class=\"search-box\">\n <span class=\"search-icon\">🔍</span>\n <input type=\"text\" id=\"searchInput\" class=\"search-input\" placeholder=\"Filter endpoints...\">\n </div>\n </div>\n\n <div class=\"filter-group method-filters-container\">\n <div class=\"filter-label\">Methods</div>\n <div class=\"checkbox-group\" id=\"methodFilters\"></div>\n </div>\n </div>\n\n <div class=\"filter-group tag-filters-container\" id=\"tagFilterContainer\">\n <div class=\"filter-label\">Tags</div>\n <div class=\"checkbox-group\" id=\"tagFilters\"></div>\n </div>\n </div>\n\n <div class=\"overview-row\" id=\"overviewList\"></div>\n </div>\n\n <main id=\"routeList\">\n <div style=\"text-align:center; padding:40px; color:#64748b\">Loading API definition...</div>\n </main>\n </div>\n\n <script id=\"leaf-data\" type=\"application/json\">${leavesJson}</script>\n <script${nonceAttr}>${DOCS_JS}</script>\n ${options.inlineClientScript ? `<script${nonceAttr}>${options.inlineClientScript}</script>` : \"\"}\n</body>\n</html>\n `;\n}\n","// renderLeafDocsHTML.ts\nimport { AnyLeaf } from \"../core/routesV3.core\";\nimport { renderLeafDocsHTML as LeafDocsPage } from \"./LeafDocsPage\";\n\ninterface RenderOptions {\n cspNonce?: string;\n inlineCss?: string;\n inlineClientScript?: string;\n}\n\nexport function renderLeafDocsHTML(\n leaves: AnyLeaf[],\n options: RenderOptions = {}\n): string {\n return LeafDocsPage(leaves, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAAA;AAAA,EAAA,0BAAAC;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,iBAAkB;AAalB,IAAM,yBAAyB,aAAE,OAAO;AAAA,EACtC,QAAQ,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,OAAO,aAAE,OAAO,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AACrD,CAAC;AAED,IAAM,kBAAkB,uBAAuB,SAAS,EAAE,QAAQ,uBAAuB,MAAM,CAAC,CAAC,CAAC;AAYlG,IAAM,0BAA0B,aAAE,OAAO;AAAA,EACvC,OAAO,aAAE,MAAM,aAAE,QAAQ,CAAC;AAAA,EAC1B,YAAY,aAAE,OAAO,EAAE,SAAS;AAClC,CAAC;AAED,SAAS,uBAAyD,QAAW;AAC3E,MAAI,UAAU,EAAE,kBAAkB,aAAE,YAAY;AAC9C,YAAQ,KAAK,+DAA+D;AAC5E,WAAO,aAAE,OAAO;AAAA,MACd,YAAY;AAAA,IACd,CAAC;AAAA,EACH;AAEA,QAAM,OAAQ,UAA2B,aAAE,OAAO,CAAC,CAAC;AACpD,SAAO,KAAK,OAAO;AAAA,IACjB,YAAY;AAAA,EACd,CAAC;AACH;AAEA,SAAS,wBAA0D,QAAW;AAC5E,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI,kBAAkB,aAAE,UAAU;AAChC,WAAO,aAAE,OAAO;AAAA,MACd,OAAO;AAAA,MACP,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,IAClC,CAAC;AAAA,EACH;AACA,MAAI,kBAAkB,aAAE,WAAW;AACjC,UAAM,QAAS,OAAe,QAAS,OAAe,QAAS,OAAe,MAAM,QAAQ;AAC5F,UAAM,WAAW,QAAQ,OAAO,KAAK;AACrC,QAAI,UAAU;AACZ,aAAO,OAAO,OAAO,EAAE,YAAY,aAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,IAC5D;AACA,WAAO,aAAE,OAAO;AAAA,MACd,OAAO,aAAE,MAAM,MAAoB;AAAA,MACnC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,IAClC,CAAC;AAAA,EACH;AACA,SAAO,aAAE,OAAO;AAAA,IACd,OAAO,aAAE,MAAM,MAAoB;AAAA,IACnC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAClC,CAAC;AACH;AAYA,SAAS,aAAa,GAA2B,GAA2B;AAC1E,MAAI,KAAK,EAAG,QAAO,aAAE,aAAa,GAAU,CAAQ;AACpD,SAAQ,KAAK;AACf;AAuNO,SAAS,SACd,MACA,WACyC;AACzC,QAAM,WAAW;AACjB,QAAM,gBAAyB,EAAE,GAAI,UAAsB;AAE3D,WAAS,WACP,OACA,YACA,oBACA;AACA,UAAM,QAAmB,CAAC;AAC1B,QAAI,cAAsB;AAC1B,QAAI,eAAwB,EAAE,GAAI,WAAuB;AACzD,QAAI,sBAA2B;AAE/B,aAAS,IAA+C,QAAW,KAAQ;AAEzE,YAAM,wBAAyB,IAAI,gBAAgB;AACnD,YAAM,uBACJ,IAAI,SAAS,OAAO,uBAAuB,IAAI,WAAW,IAAI,IAAI;AACpE,YAAM,wBACJ,IAAI,SAAS,OAAO,wBAAwB,IAAI,YAAY,IAAI,IAAI;AAEtE,YAAM,UACJ,wBACI;AAAA,QACE,GAAG;AAAA,QACH,GAAG;AAAA,QACH,cAAc;AAAA,QACd,GAAI,uBAAuB,EAAE,aAAa,qBAAqB,IAAI,CAAC;AAAA,QACpE,GAAI,wBAAwB,EAAE,cAAc,sBAAsB,IAAI,CAAC;AAAA,MACzE,IACA;AAAA,QACE,GAAG;AAAA,QACH,GAAG;AAAA,QACH,GAAI,uBAAuB,EAAE,aAAa,qBAAqB,IAAI,CAAC;AAAA,QACpE,GAAI,wBAAwB,EAAE,cAAc,sBAAsB,IAAI,CAAC;AAAA,MACzE;AAGN,YAAM,OAAO;AAAA,QACX;AAAA,QACA,MAAM;AAAA,QACN,KAAK;AAAA,MACP;AAEA,YAAM,KAAK,IAA0B;AAGrC,aAAO;AAAA,IACT;AAEA,UAAM,MAAW;AAAA;AAAA,MAEf,IACE,MACA,cACA,cACA;AACA,YAAI;AACJ,YAAI;AAEJ,YAAI,OAAO,iBAAiB,YAAY;AACtC,oBAAU;AAAA,QACZ,OAAO;AACL,gBAAM;AACN,oBAAU;AAAA,QACZ;AAEA,cAAM,YAAY,GAAG,WAAW,IAAI,IAAI;AACxC,cAAM,iBAAiB,EAAE,GAAG,cAAc,GAAI,OAAO,CAAC,EAAG;AAEzD,YAAI,SAAS;AAEX,gBAAM,QAAQ,WAAW,WAAW,gBAAgB,mBAAmB;AACvE,gBAAM,SAAS,QAAQ,KAAK;AAC5B,qBAAW,KAAK,OAAQ,OAAM,KAAK,CAAC;AACpC,iBAAO;AAAA,QAMT,OAAO;AACL,wBAAc;AACd,yBAAe;AACf,iBAAO;AAAA,QACT;AAAA,MACF;AAAA;AAAA,MAGA,eACE,MACA,cACA,SAQA;AACA,cAAM,YAAY,GAAG,WAAW,KAAK,IAAI;AAEzC,cAAM,WAA8B,aAAE,OAAO,EAAE,CAAC,IAAI,GAAG,aAAa,CAAoB;AACxF,cAAM,cAAe,sBACjB,aAAa,qBAAqB,QAAQ,IAC1C;AACJ,cAAM,QAAQ,WAAW,WAAW,cAAoB,WAAW;AACnE,cAAM,SAAS,QAAQ,KAAK;AAC5B,mBAAW,KAAK,OAAQ,OAAM,KAAK,CAAC;AACpC,eAAO;AAAA,MAMT;AAAA,MAEA,KAAwB,KAAQ;AAC9B,uBAAe,EAAE,GAAG,cAAc,GAAG,IAAI;AACzC,eAAO;AAAA,MACT;AAAA;AAAA,MAGA,IAAyB,KAAQ;AAC/B,eAAO,IAAI,OAAO,GAAG;AAAA,MACvB;AAAA,MACA,KAAwC,KAAQ;AAC9C,eAAO,IAAI,QAAQ,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC5C;AAAA,MACA,IAAuC,KAAQ;AAC7C,eAAO,IAAI,OAAO,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC3C;AAAA,MACA,MAAyC,KAAQ;AAC/C,eAAO,IAAI,SAAS,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC7C;AAAA,MACA,OAA0C,KAAQ;AAChD,eAAO,IAAI,UAAU,EAAE,GAAG,KAAK,MAAM,MAAM,CAAC;AAAA,MAC9C;AAAA,MAEA,OAAO;AACL,eAAO;AAAA,MACT;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAGA,SAAO,WAAW,UAAU,eAAe,MAAS;AACtD;AAQO,IAAM,cAAc,CACzB,MACA,SACG;AACH,SAAO,CAAC,GAAG,MAAM,GAAG,IAAI;AAC1B;;;ACjWO,SAAS,YAAiC,MAAY,QAAqC;AAChG,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,KAAK,QAAQ,qBAAqB,CAAC,GAAG,MAAM;AACjD,UAAM,IAAK,OAAe,CAAC;AAC3B,QAAI,MAAM,UAAa,MAAM,KAAM,OAAM,IAAI,MAAM,kBAAkB,CAAC,EAAE;AACxE,WAAO,OAAO,CAAC;AAAA,EACjB,CAAC;AACH;AAeO,SAAS,cAAiC,MAI9C;AACD,MAAI,IAAI,KAAK,KAAK;AAClB,MAAI,KAAK,QAAQ;AACf,QAAI,YAAuB,GAAG,KAAK,MAAM;AAAA,EAC3C;AACA,SAAO,CAAC,KAAK,KAAK,QAAQ,GAAI,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,GAA2B,KAAK,SAAS,CAAC,CAAC;AACtG;;;ACvHO,SAAS,SAA6C,QAAW;AAItE,QAAM,QAAQ,OAAO;AAAA,IACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,YAAY,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAU;AAAA,EACvE;AAEA,QAAM,MAAM,CAAC,WAAqD;AAChE,WAAO,OAAO,mBAAmB;AACjC,IAAC,OAAO,KAAK,KAAK,EAAa,QAAQ,CAAC,MAAM;AAC5C,YAAM,OAAO,MAAM,CAAC;AACpB,aAAO,OAAO,KAAK,CAAC,EAAE;AAAA,IACxB,CAAC;AAAA,EACH;AAEA,SAAO,EAAE,KAAK,QAAQ,OAAO,IAAI;AACnC;;;ACrCA,IAAAC,cAA2B;AAWpB,IAAM,wBAAwB,cAAE,OAAO;AAAA,EAC5C,OAAO,cAAE,OAAO,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AAAA,EACnD,QAAQ,cAAE,OAAO,EAAE,SAAS;AAC9B,CAAC;AACD,IAAM,sBAAsB,sBAAsB,SAAS,EAAE,QAAQ,sBAAsB,MAAM,CAAC,CAAC,CAAC;AAa7F,SAASC,cACd,GACA,GAC2F;AAC3F,MAAI,KAAK,EAAG,QAAO,cAAE,aAAa,GAAU,CAAQ;AACpD,SAAQ,KAAK;AACf;AA4UO,SAAS,SAKd,QAA8D;AAC9D,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,SAAS,WAAY,QAAO;AAEzC,IAAE,OAAO,SAII,MAAY,KAAQ,QAA0D;AAEzF,WAAO,KAAK,IAAI,MAAM,CAAC,eAAoB;AACzC,YAAM,QAAQ,GAAG,IAAI;AAGrB,YAAM,IAAI,IAAI;AACd,YAAM,QACJ,KACA,OAAQ,EAAU,SAAS,YAC1B,EAAU,KAAK,aAAa,eAC7B,OAAQ,EAAU,UAAU;AAE9B,YAAM,mBACJ,SAAU,EAAU,MAAM,EAAE,KAAK,IAAM,EAAU,MAAM,EAAE,KAAK,IAAiB;AAEjF,YAAM,UAAU,IAAI;AACpB,YAAM,UACJ,IAAI,MAAM,gBACV,cAAE,OAAO;AAAA,QACP,OAAO,cAAE,MAAM,OAAO;AAAA,QACtB,YAAY,cAAE,OAAO,EAAE,SAAS;AAAA,MAClC,CAAC;AAEH,YAAM,OAAO;AAAA,QACX,MAAM,IAAI,QAAQ,SAAS;AAAA,QAC3B,QAAQ,IAAI,QAAQ,WAAW,SAAS,CAAC,CAAC,IAAI,QAAQ;AAAA,QACtD,MAAM,IAAI,QAAQ,SAAS;AAAA,QAC3B,QAAQ,IAAI,QAAQ,WAAW,SAAS,CAAC,CAAC,IAAI,QAAQ;AAAA,QACtD,QAAQ,IAAI,QAAQ,WAAW;AAAA,MACjC;AAGA,UAAI,KAAK,MAAM;AACb,mBAAW,IAAI;AAAA,UACb,MAAM;AAAA,UACN,aAAa,IAAI,MAAM,eAAe;AAAA,UACtC,cAAc;AAAA,UACd,aAAa,IAAI,MAAM,eAAe;AAAA,QACxC,CAAC;AAAA,MACH;AAEA,UAAI,KAAK,QAAQ;AACf,mBAAW,KAAK;AAAA,UACd,YAAY,IAAI,OAAQ;AAAA,UACxB,cAAc,IAAI,QAAQ,gBAAgB;AAAA,UAC1C,aAAa,IAAI,QAAQ,eAAe;AAAA,QAC1C,CAAC;AAAA,MACH;AAGA,iBAAW,eAAe,OAAc,kBAAyB,CAAC,SAAc;AAC9E,YAAI,KAAK,MAAM;AACb,eAAK,IAAI;AAAA,YACP,cAAc,IAAI,MAAM,gBAAgB;AAAA,YACxC,aAAa,IAAI,MAAM,eAAe;AAAA,UACxC,CAAC;AAAA,QACH;AACA,YAAI,KAAK,QAAQ;AACf,eAAK,MAAM;AAAA,YACT,YAAY,IAAI,OAAQ;AAAA,YACxB,cAAc,IAAI,QAAQ,gBAAgB;AAAA,YAC1C,aAAa,IAAI,QAAQ,eAAe;AAAA,UAC1C,CAAC;AAAA,QACH;AACA,YAAI,KAAK,QAAQ;AACf,eAAK,OAAO;AAAA,YACV,cAAc,IAAI,QAAQ,gBAAgB,cAAE,OAAO,EAAE,IAAI,cAAE,QAAQ,IAAI,EAAE,CAAC;AAAA,YAC1E,aAAa,IAAI,QAAQ,eAAe;AAAA,UAC1C,CAAC;AAAA,QACH;AAGA,YAAI,OAAQ,QAAO,EAAE,YAAY,SAAS,UAAU,GAAG,MAAM,SAAS,IAAI,EAAE,CAAC;AAE7E,eAAO,KAAK,KAAK;AAAA,MACnB,CAAC;AAED,aAAO,WAAW,KAAK;AAAA,IACzB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAaO,SAAS,iBACd,MACA,WACA;AACA,SAAO,SAAS,SAAa,MAAM,SAAS,CAAC;AAC/C;;;ACrcO,SAAS,mBAAmB,QAAa,QAAa;AAC3D,SAAO,EAAE,QAAQ,OAAO;AAC1B;;;ACrCA,IAAAC,KAAmB;AAyBnB,SAAS,OAAO,QAAkC;AAChD,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SAAO,UAAU,MAAM,OAAO,UAAU;AAC1C;AAOA,SAAS,eAAe,QAAoC;AAC1D,QAAM,OAAYA;AAGlB,QAAM,WAAW,KAAK,gBAAgB,MAClC,KAAK,eAAe,IAAI,MAAM,IAC9B;AACJ,MAAI,YAAY,OAAO,SAAS,gBAAgB,UAAU;AACxD,WAAO,SAAS;AAAA,EAClB;AAGA,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,OAAO,OAAO,IAAI,gBAAgB,UAAU;AAC9C,WAAO,IAAI;AAAA,EACb;AAEA,SAAO;AACT;AAUA,SAAS,OAAO,QAId;AACA,MAAI,IAAY;AAChB,MAAI,WAAW;AACf,MAAI,WAAW;AAGf,QAAM,iBAAiC;AAGvC,SAAO,MAAM;AAEX,QAAI,kBAAkB,aAAa,gBAAgB;AACjD,YAAM,MAAM,OAAO,CAAC,KAAK,CAAC;AAC1B,YAAM,aACJ,OAAQ,EAAU,eAAe,aAC5B,EAAU,WAAW,IACtB,IAAI;AACV,UAAI,CAAC,WAAY;AACjB,UAAI;AACJ;AAAA,IACF;AAGA,QAAI,aAAe,gBAAa;AAC9B,iBAAW;AACX,YAAM,MAAM,OAAO,CAAC;AACpB,UAAK,OAAO,IAAI,aAAc;AAC9B;AAAA,IACF;AAEA,QAAI,aAAe,gBAAa;AAC9B,iBAAW;AACX,YAAM,MAAM,OAAO,CAAC;AACpB,UAAK,OAAO,IAAI,aAAc;AAC9B;AAAA,IACF;AAEA,QAAI,aAAe,eAAY;AAC7B,YAAM,MAAM,OAAO,CAAC;AACpB,UAAK,OAAO,IAAI,aAAc;AAC9B;AAAA,IACF;AAEA;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,GAAG,UAAU,SAAS;AACvC;AAEO,SAAS,iBACd,QACoC;AACpC,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,EAAE,MAAM,UAAU,SAAS,IAAI,OAAO,MAAM;AAClD,QAAM,MAAM,OAAO,IAAI;AAEvB,QAAM,OAA+B;AAAA,IACnC,MAAM,UAAU,IAAI;AAAA,IACpB,UAAU,YAAY;AAAA,IACtB,UAAU,YAAY;AAAA,IACtB,aAAa,eAAe,IAAI;AAAA,EAClC;AAGA,MAAI,gBAAkB,cAAW;AAG/B,UAAM,WACH,KAAa,UAAU,OAAO,OAAO,IAAI,UAAU,aAChD,IAAI,MAAM,IACV,KAAK;AAEX,UAAM,QACJ,OAAO,aAAa,aAAa,SAAS,IAAI,YAAY,CAAC;AAE7D,UAAM,QAAgD,CAAC;AACvD,eAAW,OAAO,OAAO,KAAK,KAAK,GAAG;AACpC,YAAM,QAAQ,MAAM,GAAG;AACvB,YAAM,YAAY,iBAAiB,KAAK;AACxC,UAAI,UAAW,OAAM,GAAG,IAAI;AAAA,IAC9B;AACA,SAAK,aAAa;AAAA,EACpB;AAGA,MAAI,gBAAkB,aAAU;AAG9B,UAAM,QACH,OAAQ,IAAI,WACZ,OAAQ,IAAI,QACb;AACF,QAAI,OAAO;AACT,WAAK,UAAU,iBAAiB,KAAK;AAAA,IACvC;AAAA,EACF;AAGA,MAAI,gBAAkB,aAAU;AAC9B,UAAM,UAAqB,OAAO,IAAI,WAAY,CAAC;AACnD,SAAK,QAAQ,QACV,IAAI,CAAC,QAAQ,iBAAiB,GAAG,CAAC,EAClC,OAAO,OAAO;AAAA,EACnB;AAGA,MAAI,gBAAkB,eAAY;AAChC,QAAI,KAAK;AAEP,UAAI,MAAM,QAAQ,IAAI,MAAM,GAAG;AAC7B,aAAK,UACH,IAAI,OAAO,WAAW,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,MAAM;AAAA,MAC/D,OAAO;AAEL,aAAK,UAAU,IAAI;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAGA,MAAI,gBAAkB,YAAS;AAC7B,QAAI,KAAK;AACP,UAAI,MAAM,QAAQ,IAAI,MAAM,GAAG;AAE7B,aAAK,aAAa,IAAI,OAAO,MAAM;AAAA,MACrC,WAAW,IAAI,WAAW,OAAO,IAAI,YAAY,UAAU;AAEzD,aAAK,aAAa,OAAO,OAAO,IAAI,OAAO,EAAE;AAAA,UAAI,CAAC,MAChD,OAAO,CAAC;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,UAAU,QAAwB;AAGzC,MAAI,kBAAoB,aAAW,QAAO;AAC1C,MAAI,kBAAoB,aAAW,QAAO;AAC1C,MAAI,kBAAoB,cAAY,QAAO;AAC3C,MAAI,kBAAoB,aAAW,QAAO;AAC1C,MAAI,kBAAoB,WAAS,QAAO;AACxC,MAAI,kBAAoB,YAAU,QAAO;AACzC,MAAI,kBAAoB,aAAW,QAAO;AAC1C,MAAI,kBAAoB,YAAU,QAAO;AACzC,MAAI,kBAAoB,cAAY,QAAO;AAC3C,MAAI,kBAAoB,WAAS,QAAO;AACxC,MAAI,kBAAoB,aAAW,QAAO;AAC1C,MAAI,kBAAoB,YAAU,QAAO;AACzC,MAAI,kBAAoB,cAAY,QAAO;AAC3C,MAAI,kBAAoB,UAAQ,QAAO;AAEvC,SAAO;AACT;;;ACjMO,SAAS,cAAc,MAAiC;AAC7D,QAAM,MAAM,KAAK;AAEjB,QAAM,OAAO,MAAM,QAAQ,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC;AAE3D,SAAO;AAAA,IACL,QAAQ,KAAK;AAAA;AAAA,IACb,MAAM,KAAK;AAAA,IACX,KAAK;AAAA,MACH,aAAa,IAAI;AAAA,MACjB,SAAS,IAAI;AAAA,MACb,WAAW,IAAI;AAAA,MACf;AAAA,MACA,YAAY,IAAI;AAAA,MAChB,WAAW,IAAI;AAAA,MACf,MAAM,CAAC,CAAC,IAAI;AAAA,MACZ,UAAU,IAAI;AAAA,MACd,SAAS,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,IAAI,WAAW;AAAA,MAC9C,UAAU,CAAC,CAAC,IAAI;AAAA,MAChB,WAAW,CAAC,CAAC,IAAI;AAAA,MACjB,WAAW,CAAC,CAAC,IAAI;AAAA,MAEjB,YAAY,iBAAiB,IAAI,UAAU;AAAA,MAC3C,aAAa,iBAAiB,IAAI,WAAW;AAAA,MAC7C,cAAc,iBAAiB,IAAI,YAAY;AAAA,MAC/C,cAAc,iBAAiB,IAAI,YAAY;AAAA,IACjD;AAAA,EACF;AACF;;;AChDA,IAAM,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAienB,IAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA+jBT,SAAS,mBACd,QACA,UAAyB,CAAC,GAClB;AACR,QAAM,aAAa,KAAK,UAAU,OAAO,IAAI,aAAa,CAAC;AAC3D,QAAM,YAAY,QAAQ,WAAW,WAAW,QAAQ,QAAQ,MAAM;AAEtE,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAQC,SAAS,IAAI,UAAU;AAAA,IAC7B,QAAQ,YAAY,SAAS,SAAS,IAAI,QAAQ,SAAS,aAAa,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mDAyC3B,UAAU;AAAA,WAClD,SAAS,IAAI,OAAO;AAAA,IAC3B,QAAQ,qBAAqB,UAAU,SAAS,IAAI,QAAQ,kBAAkB,cAAc,EAAE;AAAA;AAAA;AAAA;AAIlG;;;AClmCO,SAASC,oBACd,QACA,UAAyB,CAAC,GAClB;AACR,SAAO,mBAAa,QAAQ,OAAO;AACrC;","names":["mergeSchemas","renderLeafDocsHTML","import_zod","mergeSchemas","z","renderLeafDocsHTML"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/core/routesV3.builder.ts","../src/core/routesV3.core.ts","../src/core/routesV3.finalize.ts","../src/crud/routesV3.crud.ts","../src/sockets/socket.index.ts","../src/docs/schemaIntrospection.ts","../src/docs/serializer.ts","../src/docs/LeafDocsPage.tsx","../src/docs/docs.ts"],"sourcesContent":["export * from './core/routesV3.builder';\nexport * from './core/routesV3.core';\nexport * from './core/routesV3.finalize';\nexport * from './crud/routesV3.crud';\nexport * from './sockets/socket.index';\nexport * from './docs/docs';","import { z } from 'zod';\nimport {\n AnyLeaf,\n Append,\n HttpMethod,\n Leaf,\n Merge,\n MergeArray,\n MethodCfg,\n NodeCfg,\n Prettify,\n} from './routesV3.core';\n\nconst defaultFeedQuerySchema = z.object({\n cursor: z.string().optional(),\n limit: z.coerce.number().min(1).max(100).default(20),\n});\n\nconst paginationField = defaultFeedQuerySchema.optional().default(defaultFeedQuerySchema.parse({}));\ntype PaginationField = typeof paginationField;\n\ntype ZodTypeAny = z.ZodTypeAny;\ntype ParamZod<Name extends string, S extends ZodTypeAny> = z.ZodObject<{ [K in Name]: S }>;\ntype ZodArrayAny = z.ZodArray<ZodTypeAny>;\ntype ZodObjectAny = z.ZodObject<any>;\ntype AnyZodObject = z.ZodObject<any>;\ntype MergedParamsResult<PS, Name extends string, P extends ZodTypeAny> = PS extends ZodTypeAny\n ? z.ZodIntersection<PS, ParamZod<Name, P>>\n : ParamZod<Name, P>;\n\nconst defaultFeedOutputSchema = z.object({\n items: z.array(z.unknown()),\n nextCursor: z.string().optional(),\n});\n\nfunction augmentFeedQuerySchema<Q extends ZodTypeAny | undefined>(schema: Q) {\n if (schema && !(schema instanceof z.ZodObject)) {\n console.warn('Feed queries must be a ZodObject; default pagination applied.');\n return z.object({\n pagination: paginationField,\n });\n }\n\n const base = (schema as ZodObjectAny) ?? z.object({});\n return base.extend({\n pagination: paginationField,\n });\n}\n\nfunction augmentFeedOutputSchema<O extends ZodTypeAny | undefined>(schema: O) {\n if (!schema) return defaultFeedOutputSchema;\n if (schema instanceof z.ZodArray) {\n return z.object({\n items: schema,\n nextCursor: z.string().optional(),\n });\n }\n if (schema instanceof z.ZodObject) {\n const shape = (schema as any).shape ? (schema as any).shape : (schema as any)._def?.shape?.();\n const hasItems = Boolean(shape?.items);\n if (hasItems) {\n return schema.extend({ nextCursor: z.string().optional() });\n }\n return z.object({\n items: z.array(schema as ZodTypeAny),\n nextCursor: z.string().optional(),\n });\n }\n return z.object({\n items: z.array(schema as ZodTypeAny),\n nextCursor: z.string().optional(),\n });\n}\n\n/**\n * Runtime helper that mirrors the typed merge used by the builder.\n * @param a Previously merged params schema inherited from parent segments.\n * @param b Newly introduced params schema.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nfunction mergeSchemas<A extends ZodTypeAny, B extends ZodTypeAny>(a: A, b: B): ZodTypeAny;\nfunction mergeSchemas<A extends ZodTypeAny>(a: A, b: undefined): A;\nfunction mergeSchemas<B extends ZodTypeAny>(a: undefined, b: B): B;\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined): ZodTypeAny | undefined;\nfunction mergeSchemas(a: ZodTypeAny | undefined, b: ZodTypeAny | undefined) {\n if (a && b) return z.intersection(a as any, b as any);\n return (a ?? b) as ZodTypeAny | undefined;\n}\n\ntype FeedQuerySchema<C extends MethodCfg> = z.ZodObject<any>;\n\ntype FeedOutputSchema<C extends MethodCfg> = C['outputSchema'] extends ZodArrayAny\n ? z.ZodObject<{\n items: C['outputSchema'];\n nextCursor: z.ZodOptional<z.ZodString>;\n }>\n : C['outputSchema'] extends ZodTypeAny\n ? z.ZodObject<{\n items: z.ZodArray<C['outputSchema']>;\n nextCursor: z.ZodOptional<z.ZodString>;\n }>\n : typeof defaultFeedOutputSchema;\n\ntype BaseMethodCfg<C extends MethodCfg> = Merge<\n Omit<MethodCfg, 'querySchema' | 'outputSchema' | 'feed'>,\n Omit<C, 'querySchema' | 'outputSchema' | 'feed'>\n>;\n\ntype FeedField<C extends MethodCfg> = C['feed'] extends true ? { feed: true } : { feed?: boolean };\n\ntype AddPaginationToQuery<Q extends AnyZodObject | undefined> = Q extends z.ZodObject<\n infer Shape\n>\n ? z.ZodObject<Shape & { pagination: PaginationField }>\n : z.ZodObject<{ pagination: PaginationField }>;\n\ntype FeedQueryField<C extends MethodCfg> = {\n querySchema: AddPaginationToQuery<\n C['querySchema'] extends AnyZodObject ? C['querySchema'] : undefined\n >;\n};\n\ntype NonFeedQueryField<C extends MethodCfg> = C['querySchema'] extends ZodTypeAny\n ? { querySchema: C['querySchema'] }\n : { querySchema?: undefined };\n\ntype FeedOutputField<C extends MethodCfg> = { outputSchema: FeedOutputSchema<C> };\n\ntype NonFeedOutputField<C extends MethodCfg> = C['outputSchema'] extends ZodTypeAny\n ? { outputSchema: C['outputSchema'] }\n : { outputSchema?: undefined };\n\ntype ParamsField<C extends MethodCfg, PS> = C['paramsSchema'] extends ZodTypeAny\n ? { paramsSchema: C['paramsSchema'] }\n : { paramsSchema: PS };\n\ntype EffectiveFeedFields<C extends MethodCfg, PS> = C['feed'] extends true\n ? FeedField<C> & FeedQueryField<C> & FeedOutputField<C> & ParamsField<C, PS>\n : FeedField<C> & NonFeedQueryField<C> & NonFeedOutputField<C> & ParamsField<C, PS>;\n\ntype EffectiveCfg<C extends MethodCfg, PS> = Prettify<\n Merge<MethodCfg, BaseMethodCfg<C> & EffectiveFeedFields<C, PS>>\n>;\n\ntype BuiltLeaf<\n M extends HttpMethod,\n Base extends string,\n I extends NodeCfg,\n C extends MethodCfg,\n PS,\n> = Leaf<M, Base, Merge<I, EffectiveCfg<C, PS>>>;\n\n/** Builder surface used by `resource(...)` to accumulate leaves. */\nexport interface Branch<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodTypeAny | undefined,\n> {\n // --- structure ---\n /**\n * Enter or define a static child segment.\n * Optionally accepts extra config and/or a builder to populate nested routes.\n * @param name Child segment literal (no leading slash).\n * @param cfg Optional node configuration to merge for descendants.\n * @param builder Callback to produce leaves for the child branch.\n */\n sub<Name extends string, J extends NodeCfg>(\n name: Name,\n cfg?: J,\n ): Branch<`${Base}/${Name}`, Acc, Merge<I, NonNullable<J>>, PS>;\n\n sub<Name extends string, J extends NodeCfg | undefined, R extends readonly AnyLeaf[]>(\n name: Name,\n cfg: J,\n builder: (r: Branch<`${Base}/${Name}`, readonly [], Merge<I, NonNullable<J>>, PS>) => R,\n ): Branch<Base, Append<Acc, R[number]>, Merge<I, NonNullable<J>>, PS>;\n\n sub<Name extends string, R extends readonly AnyLeaf[]>(\n name: Name,\n builder: (r: Branch<`${Base}/${Name}`, readonly [], I, PS>) => R,\n ): Branch<Base, MergeArray<Acc, R>, I, PS>;\n\n // --- parameterized segment (single signature) ---\n /**\n * Introduce a `:param` segment and merge its schema into downstream leaves.\n * @param name Parameter key (without leading colon).\n * @param paramsSchema Zod schema for the parameter value.\n * @param builder Callback that produces leaves beneath the parameterized segment.\n */\n routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n name: Name,\n paramsSchema: P,\n builder: (\n r: Branch<\n `${Base}/:${Name}`,\n readonly [],\n I,\n MergedParamsResult<PS, Name, P>\n >,\n ) => R,\n ): Branch<Base, MergeArray<Acc, R>, I, MergedParamsResult<PS, Name, P>>;\n\n // --- flags inheritance ---\n /**\n * Merge additional node configuration that subsequent leaves will inherit.\n * @param cfg Partial node configuration.\n */\n with<J extends NodeCfg>(cfg: J): Branch<Base, Acc, Merge<I, J>, PS>;\n\n // --- methods (return Branch to keep chaining) ---\n /**\n * Register a GET leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n get<C extends MethodCfg>(\n cfg: C,\n ): Branch<\n Base,\n Append<Acc, Prettify<BuiltLeaf<'get', Base, I, C, PS>>>,\n I,\n PS\n >;\n\n /**\n * Register a POST leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n post<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'post', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n /**\n * Register a PUT leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n put<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'put', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n /**\n * Register a PATCH leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n patch<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'patch', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n /**\n * Register a DELETE leaf at the current path.\n * @param cfg Method configuration (schemas, flags, descriptions, etc).\n */\n delete<C extends Omit<MethodCfg, 'feed'>>(\n cfg: C,\n ): Branch<\n Base,\n Append<\n Acc,\n Prettify<BuiltLeaf<'delete', Base, I, Merge<C, { feed: false }>, PS>>\n >,\n I,\n PS\n >;\n\n // --- finalize this subtree ---\n /**\n * Finish the branch and return the collected leaves.\n * @returns Readonly tuple of accumulated leaves.\n */\n done(): Readonly<Acc>;\n}\n\n/**\n * Start building a resource at the given base path.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Optional node configuration applied to all descendants.\n * @returns Root `Branch` instance used to compose the route tree.\n */\nexport function resource<Base extends string, I extends NodeCfg = {}>(\n base: Base,\n inherited?: I,\n): Branch<Base, readonly [], I, undefined> {\n const rootBase = base;\n const rootInherited: NodeCfg = { ...(inherited as NodeCfg) };\n\n function makeBranch<Base2 extends string, I2 extends NodeCfg, PS2 extends ZodTypeAny | undefined>(\n base2: Base2,\n inherited2: I2,\n mergedParamsSchema?: PS2,\n ) {\n const stack: AnyLeaf[] = [];\n let currentBase: string = base2;\n let inheritedCfg: NodeCfg = { ...(inherited2 as NodeCfg) };\n let currentParamsSchema: PS2 = mergedParamsSchema as PS2;\n\n function add<M extends HttpMethod, C extends MethodCfg>(method: M, cfg: C) {\n // If the method didn’t provide a paramsSchema, inject the active merged one.\n const effectiveParamsSchema = (cfg.paramsSchema ?? currentParamsSchema) as PS2 | undefined;\n const effectiveQuerySchema =\n cfg.feed === true ? augmentFeedQuerySchema(cfg.querySchema) : cfg.querySchema;\n const effectiveOutputSchema =\n cfg.feed === true ? augmentFeedOutputSchema(cfg.outputSchema) : cfg.outputSchema;\n\n const fullCfg = (\n effectiveParamsSchema\n ? {\n ...inheritedCfg,\n ...cfg,\n paramsSchema: effectiveParamsSchema,\n ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\n }\n : {\n ...inheritedCfg,\n ...cfg,\n ...(effectiveQuerySchema ? { querySchema: effectiveQuerySchema } : {}),\n ...(effectiveOutputSchema ? { outputSchema: effectiveOutputSchema } : {}),\n }\n ) as any;\n\n const leaf = {\n method,\n path: currentBase as Base2,\n cfg: fullCfg,\n } as const;\n\n stack.push(leaf as unknown as AnyLeaf);\n\n // Return same runtime obj, but with Acc including this new leaf\n return api as unknown as Branch<Base2, Append<readonly [], typeof leaf>, I2, PS2>;\n }\n\n const api: any = {\n // compose a plain subpath (optional cfg) with optional builder\n sub<Name extends string, J extends NodeCfg | undefined = undefined>(\n name: Name,\n cfgOrBuilder?: J | ((r: any) => readonly AnyLeaf[]),\n maybeBuilder?: (r: any) => readonly AnyLeaf[],\n ) {\n let cfg: NodeCfg | undefined;\n let builder: ((r: any) => readonly AnyLeaf[]) | undefined;\n\n if (typeof cfgOrBuilder === 'function') {\n builder = cfgOrBuilder as any;\n } else {\n cfg = cfgOrBuilder as NodeCfg | undefined;\n builder = maybeBuilder;\n }\n\n const childBase = `${currentBase}/${name}` as const;\n const childInherited = { ...inheritedCfg, ...(cfg ?? {}) } as Merge<I2, NonNullable<J>>;\n\n if (builder) {\n // params schema PS2 flows through unchanged on plain sub\n const child = makeBranch(childBase, childInherited, currentParamsSchema);\n const leaves = builder(child) as readonly AnyLeaf[];\n for (const l of leaves) stack.push(l);\n return api as Branch<\n Base2,\n Append<readonly [], (typeof leaves)[number]>,\n typeof childInherited,\n PS2\n >;\n } else {\n currentBase = childBase;\n inheritedCfg = childInherited;\n return api as Branch<`${Base2}/${Name}`, readonly [], typeof childInherited, PS2>;\n }\n },\n\n // the single param function: name + schema + builder\n routeParameter<Name extends string, P extends ZodTypeAny, R extends readonly AnyLeaf[]>(\n name: Name,\n paramsSchema: P,\n builder: (\n r: Branch<\n `${Base2}/:${Name}`,\n readonly [],\n I2,\n MergedParamsResult<PS2, Name, P>\n >,\n ) => R,\n ) {\n const childBase = `${currentBase}/:${name}` as const;\n // Wrap the value schema under the param name before merging with inherited params schema\n const paramObj: ParamZod<Name, P> = z.object({ [name]: paramsSchema } as Record<Name, P>);\n const childParams = (currentParamsSchema\n ? mergeSchemas(currentParamsSchema, paramObj)\n : paramObj) as MergedParamsResult<PS2, Name, P>;\n const child = makeBranch(childBase, inheritedCfg as I2, childParams);\n const leaves = builder(child) as readonly AnyLeaf[];\n for (const l of leaves) stack.push(l);\n return api as Branch<\n Base2,\n Append<readonly [], (typeof leaves)[number]>,\n I2,\n MergedParamsResult<PS2, Name, P>\n >;\n },\n\n with<J extends NodeCfg>(cfg: J) {\n inheritedCfg = { ...inheritedCfg, ...cfg };\n return api as Branch<Base2, readonly [], Merge<I2, J>, PS2>;\n },\n\n // methods (inject current params schema if missing)\n get<C extends MethodCfg>(cfg: C) {\n return add('get', cfg);\n },\n post<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('post', { ...cfg, feed: false });\n },\n put<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('put', { ...cfg, feed: false });\n },\n patch<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('patch', { ...cfg, feed: false });\n },\n delete<C extends Omit<MethodCfg, 'feed'>>(cfg: C) {\n return add('delete', { ...cfg, feed: false });\n },\n\n done() {\n return stack;\n },\n };\n\n return api as Branch<Base2, readonly [], I2, PS2>;\n }\n\n // Root branch starts with no params schema (PS = undefined)\n return makeBranch(rootBase, rootInherited, undefined);\n}\n\n/**\n * Merge two readonly tuples (preserves literal tuple information).\n * @param arr1 First tuple.\n * @param arr2 Second tuple.\n * @returns New tuple containing values from both inputs.\n */\nexport const mergeArrays = <T extends readonly any[], S extends readonly any[]>(\n arr1: T,\n arr2: S,\n) => {\n return [...arr1, ...arr2] as [...T, ...S];\n};\n","import { z, ZodType } from 'zod';\n\n/** Supported HTTP verbs for the routes DSL. */\nexport type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';\n\n/** Declarative description of a multipart upload field. */\nexport type FileField = {\n /** Form field name used for uploads. */\n name: string;\n /** Maximum number of files accepted for this field. */\n maxCount: number;\n};\n\n/** Configuration that applies to an entire branch of the route tree. */\nexport type NodeCfg = {\n /** @deprecated. Does nothing. */\n authenticated?: boolean;\n};\n\n/** Per-method configuration merged with inherited node config. */\nexport type MethodCfg = {\n /** Zod schema describing the request body. */\n bodySchema?: ZodType;\n /** Zod schema describing the query string. */\n querySchema?: ZodType;\n /** Zod schema describing path params (overrides inferred params). */\n paramsSchema?: ZodType;\n /** Zod schema describing the response payload. */\n outputSchema?: ZodType;\n /** Multipart upload definitions for the route. */\n bodyFiles?: FileField[];\n /** Marks the route as an infinite feed (enables cursor helpers). */\n feed?: boolean;\n\n /** Optional human-readable description for docs/debugging. */\n description?: string;\n /**\n * Short one-line summary for docs list views.\n * Shown in navigation / tables instead of the full description.\n */\n summary?: string;\n /**\n * Group name used for navigation sections in docs UIs.\n * e.g. \"Users\", \"Billing\", \"Auth\".\n */\n docsGroup?: string;\n /**\n * Tags that can be used to filter / facet in interactive docs.\n * e.g. [\"users\", \"admin\", \"internal\"].\n */\n tags?: string[];\n /**\n * Mark the route as deprecated in docs.\n * Renderers can badge this and/or hide by default.\n */\n deprecated?: boolean;\n /**\n * Optional stability information for the route.\n * Renderers can surface this prominently.\n */\n stability?: 'experimental' | 'beta' | 'stable' | 'deprecated';\n /**\n * Hide this route from public docs while keeping it usable in code.\n */\n docsHidden?: boolean;\n /**\n * Arbitrary extra metadata for docs renderers.\n * Can be used for auth requirements, rate limits, feature flags, etc.\n */\n docsMeta?: Record<string, unknown>;\n};\n\n/** Immutable representation of a single HTTP route in the tree. */\nexport type Leaf<M extends HttpMethod, P extends string, C extends MethodCfg> = {\n /** Lowercase HTTP method (get/post/...). */\n readonly method: M;\n /** Concrete path for the route (e.g. `/v1/users/:userId`). */\n readonly path: P;\n /** Readonly snapshot of route configuration. */\n readonly cfg: Readonly<C>;\n};\n\n/** Convenience union covering all generated leaves. */\nexport type AnyLeaf = Leaf<HttpMethod, string, MethodCfg>;\n\n/** Merge two object types while keeping nice IntelliSense output. */\nexport type Merge<A, B> = Prettify<Omit<A, keyof B> & B>;\n\n/** Append a new element to a readonly tuple type. */\nexport type Append<T extends readonly unknown[], X> = [...T, X];\n\n/** Concatenate two readonly tuple types. */\nexport type MergeArray<A extends readonly unknown[], B extends readonly unknown[]> = [\n ...A,\n ...B,\n];\n\n// helpers (optional)\ntype SegmentParams<S extends string> = S extends `:${infer P}` ? P : never;\ntype Split<S extends string> = S extends ''\n ? []\n : S extends `${infer A}/${infer B}`\n ? [A, ...Split<B>]\n : [S];\ntype ExtractParamNames<Path extends string> = SegmentParams<Split<Path>[number]>;\n\n/** Derive a params object type from a literal route string. */\nexport type ExtractParamsFromPath<Path extends string> =\n ExtractParamNames<Path> extends never ? never : Record<ExtractParamNames<Path>, string | number>;\n\n/**\n * Interpolate `:params` in a path using the given values.\n * @param path Literal route string containing `:param` segments.\n * @param params Object of parameter values to interpolate.\n * @returns Path string with parameters substituted.\n */\nexport function compilePath<Path extends string>(path: Path, params: ExtractParamsFromPath<Path>) {\n if (!params) return path;\n return path.replace(/:([A-Za-z0-9_]+)/g, (_, k) => {\n const v = (params as any)[k];\n if (v === undefined || v === null) throw new Error(`Missing param :${k}`);\n return String(v);\n });\n}\n\n/**\n * Build a deterministic cache key for the given leaf.\n * The key matches the shape consumed by React Query helpers.\n * @param args.leaf Leaf describing the endpoint.\n * @param args.params Optional params used to build the path.\n * @param args.query Optional query payload.\n * @returns Tuple suitable for React Query cache keys.\n */\ntype SplitPath<P extends string> = P extends ''\n ? []\n : P extends `${infer A}/${infer B}`\n ? [A, ...SplitPath<B>]\n : [P];\nexport function buildCacheKey<L extends AnyLeaf>(args: {\n leaf: L;\n params?: ExtractParamsFromPath<L['path']>;\n query?: InferQuery<L>;\n}) {\n let p = args.leaf.path;\n if (args.params) {\n p = compilePath<L['path']>(p, args.params);\n }\n return [args.leaf.method, ...(p.split('/').filter(Boolean) as SplitPath<typeof p>), args.query ?? {}] as const;\n}\n\n/** Infer params either from the explicit params schema or from the path literal. */\nexport type InferParams<L extends AnyLeaf> = L['cfg']['paramsSchema'] extends ZodType\n ? z.infer<L['cfg']['paramsSchema']>\n : ExtractParamsFromPath<L['path']>;\n\n/** Infer query shape from a Zod schema when present. */\nexport type InferQuery<L extends AnyLeaf> = L['cfg']['querySchema'] extends ZodType\n ? z.infer<L['cfg']['querySchema']>\n : never;\n\n/** Infer request body shape from a Zod schema when present. */\nexport type InferBody<L extends AnyLeaf> = L['cfg']['bodySchema'] extends ZodType\n ? z.infer<L['cfg']['bodySchema']>\n : never;\n\n/** Infer handler output shape from a Zod schema. Defaults to unknown. */\nexport type InferOutput<L extends AnyLeaf> = L['cfg']['outputSchema'] extends ZodType\n ? z.infer<L['cfg']['outputSchema']>\n : unknown;\n\n/** Render a type as if it were a simple object literal. */\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n","// TODO:\n// * use this as a transform that infers the types from Zod, to only pass the types around instead of the full schemas -> make converters that go both ways (data to schema, schema to data)\n// * consider moving to core package\n// * update server and client side to use this type instead of raw zod schemas \nimport { AnyLeaf, HttpMethod, Prettify } from './routesV3.core';\n\n/** Build the key type for a leaf — distributive so method/path stay paired. */\nexport type KeyOf<L extends AnyLeaf> = L extends AnyLeaf\n ? `${Uppercase<L['method']>} ${L['path']}`\n : never;\n\n// From a tuple of leaves, get the union of keys (pairwise, no cartesian blow-up)\ntype KeysOf<Leaves extends readonly AnyLeaf[]> = KeyOf<Leaves[number]>;\n\n// Parse method & path out of a key\ntype MethodFromKey<K extends string> = K extends `${infer M} ${string}` ? Lowercase<M> : never;\ntype PathFromKey<K extends string> = K extends `${string} ${infer P}` ? P : never;\n\n// Given Leaves and a Key, pick the exact leaf that matches method+path\ntype LeafForKey<Leaves extends readonly AnyLeaf[], K extends string> = Extract<\n Leaves[number],\n { method: MethodFromKey<K> & HttpMethod; path: PathFromKey<K> }\n>;\n\n/**\n * Freeze a leaf tuple into a registry with typed key lookups.\n * @param leaves Readonly tuple of leaves produced by the builder DSL.\n * @returns Registry containing the leaves array and a `byKey` lookup map.\n */\nexport function finalize<const L extends readonly AnyLeaf[]>(leaves: L) {\n type Keys = KeysOf<L>;\n type MapByKey = { [K in Keys]: Prettify<LeafForKey<L, K>> };\n\n const byKey = Object.fromEntries(\n leaves.map((l) => [`${l.method.toUpperCase()} ${l.path}`, l] as const),\n ) as unknown as MapByKey;\n\n const log = (logger: { system: (...args: unknown[]) => void }) => {\n logger.system('Finalized routes:');\n (Object.keys(byKey) as Keys[]).forEach((k) => {\n const leaf = byKey[k];\n logger.system(`- ${k}`);\n });\n };\n\n return { all: leaves, byKey, log };\n}\n\n/** Nominal type alias for a finalized registry. */\nexport type Registry<R extends ReturnType<typeof finalize>> = R;\n\ntype FilterRoute<\n T extends readonly AnyLeaf[],\n F extends string,\n Acc extends readonly AnyLeaf[] = [],\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n ? First extends { path: `${string}${F}${string}` }\n ? FilterRoute<Rest, F, [...Acc, First]>\n : FilterRoute<Rest, F, Acc>\n : Acc;\n\ntype UpperCase<S extends string> = S extends `${infer First}${infer Rest}`\n ? `${Uppercase<First>}${UpperCase<Rest>}`\n : S;\n\ntype Routes<T extends readonly AnyLeaf[], F extends string> = FilterRoute<T, F>;\ntype ByKey<\n T extends readonly AnyLeaf[],\n Acc extends Record<string, AnyLeaf> = {},\n> = T extends readonly [infer First extends AnyLeaf, ...infer Rest extends AnyLeaf[]]\n ? ByKey<Rest, Acc & { [K in `${UpperCase<First['method']>} ${First['path']}`]: First }>\n : Acc;\n\n/**\n * Convenience helper for extracting a subset of routes by path fragment.\n * @param T Tuple of leaves produced by the DSL.\n * @param F String fragment to match against the route path.\n */\nexport type SubsetRoutes<T extends readonly AnyLeaf[], F extends string> = {\n byKey: ByKey<Routes<T, F>>;\n all: Routes<T, F>;\n};\n","// routesV3.crud.ts\n// -----------------------------------------------------------------------------\n// Add a first-class .crud() helper to the routesV3 DSL, without touching the\n// core builder. This file:\n// 1) Declares types + module augmentation to extend Branch<...> with .crud\n// 2) Provides a runtime decorator `withCrud(...)` that installs the method\n// 3) Exports a convenience `resourceWithCrud(...)` wrapper (optional)\n// -----------------------------------------------------------------------------\n\nimport { z, ZodType } from 'zod';\nimport {\n resource as baseResource,\n type Branch as _Branch, // import type so we can augment it\n} from '../core/routesV3.builder';\nimport { type AnyLeaf, type Leaf, type NodeCfg } from '../core/routesV3.core';\n\n// -----------------------------------------------------------------------------\n// Small utilities (runtime + types)\n// -----------------------------------------------------------------------------\n/** Default cursor pagination used by list (GET collection). */\nexport const CrudDefaultPagination = z.object({\n limit: z.coerce.number().min(1).max(100).default(20),\n cursor: z.string().optional(),\n});\nconst CrudPaginationField = CrudDefaultPagination.optional().default(CrudDefaultPagination.parse({}));\ntype CrudPaginationField = typeof CrudPaginationField;\ntype AnyCrudZodObject = z.ZodObject<any>;\ntype AddCrudPagination<Q extends AnyCrudZodObject | undefined> = Q extends z.ZodObject<infer Shape>\n ? z.ZodObject<Shape & { pagination: CrudPaginationField }>\n : z.ZodObject<{ pagination: CrudPaginationField }>;\n\n/**\n * Merge two Zod schemas at runtime; matches the typing pattern used in builder.\n * @param a Existing params schema inherited from parent branches.\n * @param b Schema introduced at the current branch.\n * @returns Intersection of schemas when both exist, otherwise whichever is defined.\n */\nexport function mergeSchemas<A extends ZodType | undefined, B extends ZodType | undefined>(\n a: A,\n b: B,\n): A extends ZodType ? (B extends ZodType ? ReturnType<typeof z.intersection<A, B>> : A) : B {\n if (a && b) return z.intersection(a as any, b as any) as any;\n return (a ?? b) as any;\n}\n\n/** Build { [Name]: S } Zod object at the type-level. */\nexport type ParamSchema<Name extends string, S extends ZodType> = z.ZodObject<{\n [K in Name]: S;\n}>;\n\n/** Inject active params schema into a leaf cfg (to match your Leaf typing). */\ntype WithParams<I, P> = P extends ZodType ? Omit<I, 'paramsSchema'> & { paramsSchema: P } : I;\n\n/** Resolve boolean flag: default D unless explicitly false. */\ntype Flag<E, D extends boolean> = E extends false ? false : D;\n\n// -----------------------------------------------------------------------------\n// CRUD config (few knobs, with DX comments)\n// -----------------------------------------------------------------------------\n\n/** Toggle individual CRUD methods; defaults enable all (create/update require body). */\nexport type CrudEnable = {\n /** GET /collection (feed). Defaults to true. */ list?: boolean;\n /** POST /collection. Defaults to true if `create` provided. */ create?: boolean;\n /** GET /collection/:id. Defaults to true. */ read?: boolean;\n /** PATCH /collection/:id. Defaults to true if `update` provided. */ update?: boolean;\n /** DELETE /collection/:id. Defaults to true. */ remove?: boolean;\n};\n\n/** Collection GET config. */\nexport type CrudListCfg = {\n /** Query schema (defaults to cursor pagination). */\n querySchema?: ZodType;\n /** Output schema (defaults to { items: Item[], nextCursor? }). */\n outputSchema?: ZodType;\n /** Optional description string. */\n description?: string;\n};\n\n/** Collection POST config. */\nexport type CrudCreateCfg = {\n /** Body schema for creating an item. */\n bodySchema: ZodType;\n /** Output schema (defaults to itemOutputSchema). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/** Item GET config. */\nexport type CrudReadCfg = {\n /** Output schema (defaults to itemOutputSchema). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/** Item PATCH config. */\nexport type CrudUpdateCfg = {\n /** Body schema for partial updates. */\n bodySchema: ZodType;\n /** Output schema (defaults to itemOutputSchema). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/** Item DELETE config. */\nexport type CrudRemoveCfg = {\n /** Output schema (defaults to { ok: true }). */\n outputSchema?: ZodType;\n /** Optional description. */\n description?: string;\n};\n\n/**\n * CRUD config for `.crud(\"resource\", cfg, extras?)`.\n *\n * It synthesizes `:[resourceName]Id` as the param key and uses `paramSchema` for the value.\n * Prefer passing a **value schema** (e.g. `z.string().uuid()`).\n * As a convenience, a ZodObject of shape `{ [resourceName]Id: schema }` is accepted at runtime too.\n */\nexport type CrudCfg<Name extends string = string> = {\n /**\n * Zod schema for the ID *value* (e.g. `z.string().uuid()`).\n * The parameter key is always `:${name}Id`.\n * (If you pass `z.object({ [name]Id: ... })`, it's accepted at runtime.)\n */\n paramSchema: ZodType;\n\n /**\n * The single-item output shape used by read/create/update by default.\n * List defaults to `{ items: z.array(itemOutputSchema), nextCursor? }`.\n */\n itemOutputSchema: ZodType;\n\n /** Per-method toggles (all enabled by default; create/update require bodies). */\n enable?: CrudEnable;\n\n /** GET /collection configuration. */ list?: CrudListCfg;\n /** POST /collection configuration (enables create). */ create?: CrudCreateCfg;\n /** GET /collection/:id configuration. */ read?: CrudReadCfg;\n /** PATCH /collection/:id configuration (enables update). */ update?: CrudUpdateCfg;\n /** DELETE /collection/:id configuration. */ remove?: CrudRemoveCfg;\n};\n\n// -----------------------------------------------------------------------------\n// Type plumbing to expose generated leaves (so finalize().byKey sees them)\n// -----------------------------------------------------------------------------\n\ntype CrudLeavesTuple<\n Base extends string,\n I extends NodeCfg,\n PS extends ZodType | undefined,\n Name extends string,\n C extends CrudCfg<Name>,\n> = `${Name}Id` extends infer IdName extends string\n ? ParamSchema<IdName, C['paramSchema']> extends infer IdParamZ extends ZodType\n ? [\n // GET /collection\n ...(Flag<\n C['enable'] extends CrudEnable ? C['enable']['list'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'get',\n `${Base}/${Name}`,\n WithParams<\n Omit<I, never> & {\n feed: true;\n querySchema: C['list'] extends CrudListCfg\n ? AddCrudPagination<\n C['list']['querySchema'] extends AnyCrudZodObject\n ? C['list']['querySchema']\n : undefined\n >\n : AddCrudPagination<undefined>;\n outputSchema: C['list'] extends CrudListCfg\n ? C['list']['outputSchema'] extends ZodType\n ? C['list']['outputSchema']\n : z.ZodObject<{\n items: z.ZodArray<C['itemOutputSchema']>;\n nextCursor: z.ZodOptional<z.ZodString>;\n }>\n : z.ZodObject<{\n items: z.ZodArray<C['itemOutputSchema']>;\n nextCursor: z.ZodOptional<z.ZodString>;\n }>;\n description?: string;\n },\n PS\n >\n >,\n ]\n : []),\n\n // POST /collection\n ...((C['create'] extends CrudCreateCfg ? true : false) extends true\n ? Flag<\n C['enable'] extends CrudEnable ? C['enable']['create'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'post',\n `${Base}/${Name}`,\n WithParams<\n Omit<I, never> & {\n bodySchema: C['create'] extends CrudCreateCfg\n ? C['create']['bodySchema']\n : never;\n outputSchema: C['create'] extends CrudCreateCfg\n ? C['create']['outputSchema'] extends ZodType\n ? C['create']['outputSchema']\n : C['itemOutputSchema']\n : never;\n description?: string;\n },\n PS\n >\n >,\n ]\n : []\n : []),\n\n // GET /collection/:id\n ...(Flag<\n C['enable'] extends CrudEnable ? C['enable']['read'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'get',\n `${Base}/${Name}/:${IdName}`,\n WithParams<\n Omit<I, never> & {\n outputSchema: C['read'] extends CrudReadCfg\n ? C['read']['outputSchema'] extends ZodType\n ? C['read']['outputSchema']\n : C['itemOutputSchema']\n : C['itemOutputSchema'];\n description?: string;\n },\n ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n >\n >,\n ]\n : []),\n\n // PATCH /collection/:id\n ...((C['update'] extends CrudUpdateCfg ? true : false) extends true\n ? Flag<\n C['enable'] extends CrudEnable ? C['enable']['update'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'patch',\n `${Base}/${Name}/:${IdName}`,\n WithParams<\n Omit<I, never> & {\n bodySchema: C['update'] extends CrudUpdateCfg\n ? C['update']['bodySchema']\n : never;\n outputSchema: C['update'] extends CrudUpdateCfg\n ? C['update']['outputSchema'] extends ZodType\n ? C['update']['outputSchema']\n : C['itemOutputSchema']\n : never;\n description?: string;\n },\n ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n >\n >,\n ]\n : []\n : []),\n\n // DELETE /collection/:id\n ...(Flag<\n C['enable'] extends CrudEnable ? C['enable']['remove'] : undefined,\n true\n > extends true\n ? [\n Leaf<\n 'delete',\n `${Base}/${Name}/:${IdName}`,\n WithParams<\n Omit<I, never> & {\n outputSchema: C['remove'] extends CrudRemoveCfg\n ? C['remove']['outputSchema'] extends ZodType\n ? C['remove']['outputSchema']\n : z.ZodObject<{ ok: z.ZodLiteral<true> }>\n : z.ZodObject<{ ok: z.ZodLiteral<true> }>;\n description?: string;\n },\n ReturnType<typeof mergeSchemas<PS, IdParamZ>>\n >\n >,\n ]\n : []),\n ]\n : never\n : never;\n\n/** Merge generated leaves + extras into the branch accumulator. */\ntype CrudResultAcc<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodType | undefined,\n Name extends string,\n C extends CrudCfg<Name>,\n Extras extends readonly AnyLeaf[],\n> = [...Acc, ...CrudLeavesTuple<Base, I, PS, Name, C>, ...Extras];\n\n// -----------------------------------------------------------------------------\n// Module augmentation: add the typed `.crud(...)` to Branch<...>\n// -----------------------------------------------------------------------------\n\ndeclare module './../core/routesV3.builder' {\n interface Branch<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodType | undefined,\n > {\n /**\n * Generate opinionated CRUD endpoints for a collection at `/.../<name>`\n * with an item at `/.../<name>/:<name>Id`.\n *\n * Creates (subject to `enable` + presence of create/update bodies):\n * - GET /<name> (feed list)\n * - POST /<name> (create)\n * - GET /<name>/:<name>Id (read item)\n * - PATCH /<name>/:<name>Id (update item)\n * - DELETE /<name>/:<name>Id (remove item)\n *\n * The `extras` callback receives live builders at both collection and item\n * levels so you can add custom subroutes; their leaves are included in the\n * returned Branch type.\n */\n crud<\n Name extends string,\n C extends CrudCfg<Name>,\n Extras extends readonly AnyLeaf[] = readonly [],\n >(\n name: Name,\n cfg: C,\n extras?: (ctx: {\n /** Builder at `/.../<name>` (collection scope). */\n collection: _Branch<`${Base}/${Name}`, readonly [], I, PS>;\n /** Builder at `/.../<name>/:<name>Id` (item scope). */\n item: _Branch<\n `${Base}/${Name}/:${`${Name}Id`}`,\n readonly [],\n I,\n ReturnType<typeof mergeSchemas<PS, ParamSchema<`${Name}Id`, C['paramSchema']>>>\n >;\n }) => Extras,\n ): _Branch<Base, CrudResultAcc<Base, Acc, I, PS, Name, C, Extras>, I, PS>;\n }\n}\n\n// -----------------------------------------------------------------------------\n// Runtime: install .crud on any Branch via decorator\n// -----------------------------------------------------------------------------\n\n/**\n * Decorate a Branch instance so `.crud(...)` is available at runtime.\n * Tip: wrap the root: `withCrud(resource('/v1'))`.\n * @param branch Branch returned by `resource(...)`.\n * @returns Same branch with `.crud(...)` installed.\n */\nexport function withCrud<\n Base extends string,\n Acc extends readonly AnyLeaf[],\n I extends NodeCfg,\n PS extends ZodType | undefined,\n>(branch: _Branch<Base, Acc, I, PS>): _Branch<Base, Acc, I, PS> {\n const b = branch as any;\n if (typeof b.crud === 'function') return branch;\n\n b.crud = function <\n Name extends string,\n C extends CrudCfg<Name>,\n Extras extends readonly AnyLeaf[] = readonly [],\n >(this: any, name: Name, cfg: C, extras?: (ctx: { collection: any; item: any }) => Extras) {\n // Build inside a sub-branch at `/.../<name>` and harvest its leaves.\n return this.sub(name, (collection: any) => {\n const idKey = `${name}Id`;\n\n // Accept a value schema (preferred); but if a z.object({[name]Id: ...}) is provided, use it.\n const s = cfg.paramSchema;\n const isObj =\n s &&\n typeof (s as any)._def === 'object' &&\n (s as any)._def.typeName === 'ZodObject' &&\n typeof (s as any).shape === 'function';\n\n const paramValueSchema =\n isObj && (s as any).shape()[idKey] ? ((s as any).shape()[idKey] as ZodType) : (s as ZodType);\n\n const itemOut = cfg.itemOutputSchema;\n const listOut =\n cfg.list?.outputSchema ??\n z.object({\n items: z.array(itemOut),\n nextCursor: z.string().optional(),\n });\n\n const want = {\n list: cfg.enable?.list !== false,\n create: cfg.enable?.create !== false && !!cfg.create?.bodySchema,\n read: cfg.enable?.read !== false,\n update: cfg.enable?.update !== false && !!cfg.update?.bodySchema,\n remove: cfg.enable?.remove !== false,\n } as const;\n\n // Collection routes\n if (want.list) {\n collection.get({\n feed: true,\n querySchema: cfg.list?.querySchema ?? CrudDefaultPagination,\n outputSchema: listOut,\n description: cfg.list?.description ?? 'List',\n });\n }\n\n if (want.create) {\n collection.post({\n bodySchema: cfg.create!.bodySchema,\n outputSchema: cfg.create?.outputSchema ?? itemOut,\n description: cfg.create?.description ?? 'Create',\n });\n }\n\n // Item routes via :<name>Id\n collection.routeParameter(idKey as any, paramValueSchema as any, (item: any) => {\n if (want.read) {\n item.get({\n outputSchema: cfg.read?.outputSchema ?? itemOut,\n description: cfg.read?.description ?? 'Read',\n });\n }\n if (want.update) {\n item.patch({\n bodySchema: cfg.update!.bodySchema,\n outputSchema: cfg.update?.outputSchema ?? itemOut,\n description: cfg.update?.description ?? 'Update',\n });\n }\n if (want.remove) {\n item.delete({\n outputSchema: cfg.remove?.outputSchema ?? z.object({ ok: z.literal(true) }),\n description: cfg.remove?.description ?? 'Delete',\n });\n }\n\n // Give extras fully-capable builders (decorate so extras can call .crud again)\n if (extras) extras({ collection: withCrud(collection), item: withCrud(item) });\n\n return item.done();\n });\n\n return collection.done();\n });\n };\n\n return branch;\n}\n\n// -----------------------------------------------------------------------------\n// Optional convenience: re-export a resource() that already has .crud installed\n// -----------------------------------------------------------------------------\n\n/**\n * Drop-in replacement for `resource(...)` that returns a Branch with `.crud()` installed.\n * You can either use this or call `withCrud(resource(...))`.\n * @param base Root path for the resource (e.g. `/v1`).\n * @param inherited Node configuration merged into every leaf.\n * @returns Branch builder that already includes the CRUD helper.\n */\nexport function resourceWithCrud<Base extends string, I extends NodeCfg = {}>(\n base: Base,\n inherited: I,\n) {\n return withCrud(baseResource(base, inherited));\n}\n\n// Re-export the original in case you want both styles from this module\nexport { baseResource as resource };\n","// socket.index.ts (shared client/server)\n\nimport { z } from 'zod';\n\nexport type SocketSchema<Output =unknown> = z.ZodType & {\n __out: Output;\n};\n\nexport type SocketSchemaOutput<Schema extends z.ZodTypeAny> = Schema extends {\n __out: infer Out;\n} ? Out : z.output<Schema>;\n\nexport type SocketEvent<Out = unknown> = {\n message: z.ZodTypeAny;\n /** phantom field, only for typing; not meant to be used at runtime */\n __out: Out;\n};\n\nexport type EventMap = Record<string, SocketEvent<any>>;\n\n/**\n * System event names – shared so server and client\n * don't drift on naming.\n */\nexport type SysEventName = 'sys:connect' | 'sys:disconnect' | 'sys:reconnect' | 'sys:connect_error' | 'sys:ping' | 'sys:pong' | 'sys:room_join' | 'sys:room_leave';\nexport function defineSocketEvents<const C extends SocketConnectionConfig, const Schemas extends Record<string, {\n message: z.ZodTypeAny;\n}>>(config: C, events: Schemas): {\n config: {\n [K in keyof C]: SocketSchema<z.output<C[K]>>;\n };\n events: {\n [K in keyof Schemas]: SocketEvent<z.output<Schemas[K]['message']>>;\n };\n};\n\nexport function defineSocketEvents(config: any, events: any) {\n return { config, events };\n}\n\n\n\nexport type Payload<T extends EventMap, K extends keyof T> = T[K] extends SocketEvent<infer Out> ? Out : never;\nexport type SocketConnectionConfig = {\n joinMetaMessage: z.ZodTypeAny;\n leaveMetaMessage: z.ZodTypeAny;\n pingPayload: z.ZodTypeAny;\n pongPayload: z.ZodTypeAny;\n};\n\nexport type SocketConnectionConfigOutput = {\n joinMetaMessage: SocketSchema<any>;\n leaveMetaMessage: SocketSchema<any>;\n pingPayload: SocketSchema<any>;\n pongPayload: SocketSchema<any>;\n}","// schemaIntrospection.ts\nimport * as z from \"zod\";\n\nexport type SerializableSchemaNode = {\n kind: string; // \"object\" | \"string\" | \"number\" | ...\n optional?: boolean;\n nullable?: boolean;\n description?: string;\n\n // object\n properties?: Record<string, SerializableSchemaNode>;\n // array\n element?: SerializableSchemaNode;\n // union\n union?: SerializableSchemaNode[];\n // literal\n literal?: unknown;\n // enum\n enumValues?: string[];\n};\n\ntype ZodAny = z.ZodTypeAny;\n\n/**\n * Zod 3 uses `schema._def`, Zod 4 uses `schema._zod.def`.\n */\nfunction getDef(schema: unknown): any | undefined {\n if (!schema || typeof schema !== \"object\") return undefined;\n const anySchema = schema as any;\n return anySchema._zod?.def ?? anySchema._def;\n}\n\n/**\n * Try to get a human-readable description.\n * Zod 4: use metadata/registry; fallback to internal def.description.\n * Zod 3: only internal def.description exists.\n */\nfunction getDescription(schema: ZodAny): string | undefined {\n const anyZ: any = z as any;\n\n // Zod 4 global registry metadata, if present\n const registry = anyZ.globalRegistry?.get\n ? anyZ.globalRegistry.get(schema)\n : undefined;\n if (registry && typeof registry.description === \"string\") {\n return registry.description;\n }\n\n // Legacy / internal description\n const def = getDef(schema);\n if (def && typeof def.description === \"string\") {\n return def.description;\n }\n\n return undefined;\n}\n\n/**\n * Peel off wrappers (effects, optional, nullable, default) and\n * return the inner schema + flags.\n *\n * Supports:\n * - Zod 3: ZodEffects, ZodOptional, ZodNullable, ZodDefault\n * - Zod 4: ZodOptional, ZodNullable, ZodDefault\n */\nfunction unwrap(schema: ZodAny): {\n base: ZodAny;\n optional: boolean;\n nullable: boolean;\n} {\n let s: ZodAny = schema;\n let optional = false;\n let nullable = false;\n\n // Zod 3 only (undefined in Zod 4)\n const ZodEffectsCtor: any = (z as any).ZodEffects;\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n // Zod 3: ZodEffects wrapper\n if (ZodEffectsCtor && s instanceof ZodEffectsCtor) {\n const def = getDef(s) || {};\n const sourceType =\n typeof (s as any).sourceType === \"function\"\n ? (s as any).sourceType()\n : def.schema;\n if (!sourceType) break;\n s = sourceType;\n continue;\n }\n\n // Zod 3 + 4: optional/nullable/default wrappers\n if (s instanceof z.ZodOptional) {\n optional = true;\n const def = getDef(s);\n s = (def && def.innerType) || s; // innerType exists in both 3 & 4\n continue;\n }\n\n if (s instanceof z.ZodNullable) {\n nullable = true;\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n if (s instanceof z.ZodDefault) {\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n break;\n }\n\n return { base: s, optional, nullable };\n}\n\nexport function introspectSchema(\n schema: ZodAny | undefined\n): SerializableSchemaNode | undefined {\n if (!schema) return undefined;\n\n const { base, optional, nullable } = unwrap(schema);\n const def = getDef(base);\n\n const node: SerializableSchemaNode = {\n kind: inferKind(base),\n optional: optional || undefined,\n nullable: nullable || undefined,\n description: getDescription(base),\n };\n\n // OBJECT\n if (base instanceof z.ZodObject) {\n // Zod 3: _def.shape() (function)\n // Zod 4: .shape getter returns an object\n const rawShape: any =\n (base as any).shape ?? (def && typeof def.shape === \"function\"\n ? def.shape()\n : def?.shape);\n\n const shape =\n typeof rawShape === \"function\" ? rawShape() : rawShape ?? {};\n\n const props: Record<string, SerializableSchemaNode> = {};\n for (const key of Object.keys(shape)) {\n const child = shape[key] as ZodAny;\n const childNode = introspectSchema(child);\n if (childNode) props[key] = childNode;\n }\n node.properties = props;\n }\n\n // ARRAY\n if (base instanceof z.ZodArray) {\n // Zod 3: def.type is inner schema\n // Zod 4: def.element is inner schema\n const inner =\n (def && (def.element as ZodAny)) ||\n (def && (def.type as ZodAny)) ||\n undefined;\n if (inner) {\n node.element = introspectSchema(inner);\n }\n }\n\n // UNION\n if (base instanceof z.ZodUnion) {\n const options: ZodAny[] = (def && def.options) || [];\n node.union = options\n .map((opt) => introspectSchema(opt))\n .filter(Boolean) as SerializableSchemaNode[];\n }\n\n // LITERAL\n if (base instanceof z.ZodLiteral) {\n if (def) {\n // Zod 4: def.values (multi-literal)\n if (Array.isArray(def.values)) {\n node.literal =\n def.values.length === 1 ? def.values[0] : def.values.slice();\n } else {\n // Zod 3: def.value\n node.literal = def.value;\n }\n }\n }\n\n // ENUM\n if (base instanceof z.ZodEnum) {\n if (def) {\n if (Array.isArray(def.values)) {\n // Zod 3\n node.enumValues = def.values.slice();\n } else if (def.entries && typeof def.entries === \"object\") {\n // Zod 4: entries is a { key: value } map\n node.enumValues = Object.values(def.entries).map((v: unknown) =>\n String(v)\n );\n }\n }\n }\n\n return node;\n}\n\nfunction inferKind(schema: ZodAny): string {\n // This path still uses instanceof; it works with Zod 4 Classic\n // (importing from \"zod\"). Anything unknown falls back to \"unknown\".\n if (schema instanceof z.ZodString) return \"string\";\n if (schema instanceof z.ZodNumber) return \"number\";\n if (schema instanceof z.ZodBoolean) return \"boolean\";\n if (schema instanceof z.ZodBigInt) return \"bigint\";\n if (schema instanceof z.ZodDate) return \"date\";\n if (schema instanceof z.ZodArray) return \"array\";\n if (schema instanceof z.ZodObject) return \"object\";\n if (schema instanceof z.ZodUnion) return \"union\";\n if (schema instanceof z.ZodLiteral) return \"literal\";\n if (schema instanceof z.ZodEnum) return \"enum\";\n if (schema instanceof z.ZodRecord) return \"record\";\n if (schema instanceof z.ZodTuple) return \"tuple\";\n if (schema instanceof z.ZodUnknown) return \"unknown\";\n if (schema instanceof z.ZodAny) return \"any\";\n\n return \"unknown\";\n}\n","// serializer.ts\nimport { AnyLeaf, MethodCfg } from \"../core/routesV3.core\";\nimport { introspectSchema, SerializableSchemaNode } from \"./schemaIntrospection.js\";\n\ntype SerializableMethodCfg = Pick<\n MethodCfg,\n | \"description\"\n | \"summary\"\n | \"docsGroup\"\n | \"tags\"\n | \"deprecated\"\n | \"stability\"\n | \"feed\"\n | \"docsMeta\"\n> & {\n hasBody: boolean;\n hasQuery: boolean;\n hasParams: boolean;\n hasOutput: boolean;\n\n // NEW: full Zod ASTs\n bodySchema?: SerializableSchemaNode;\n querySchema?: SerializableSchemaNode;\n paramsSchema?: SerializableSchemaNode;\n outputSchema?: SerializableSchemaNode;\n};\n\nexport type SerializableLeaf = {\n method: string;\n path: string;\n cfg: SerializableMethodCfg;\n};\n\nexport function serializeLeaf(leaf: AnyLeaf): SerializableLeaf {\n const cfg = leaf.cfg;\n\n const tags = Array.isArray(cfg.tags) ? cfg.tags.slice() : [];\n\n return {\n method: leaf.method, // 'get' | 'post' | ...\n path: leaf.path,\n cfg: {\n description: cfg.description,\n summary: cfg.summary,\n docsGroup: cfg.docsGroup,\n tags,\n deprecated: cfg.deprecated,\n stability: cfg.stability,\n feed: !!cfg.feed,\n docsMeta: cfg.docsMeta,\n hasBody: !!cfg.bodySchema || !!cfg.bodyFiles?.length,\n hasQuery: !!cfg.querySchema,\n hasParams: !!cfg.paramsSchema,\n hasOutput: !!cfg.outputSchema,\n\n bodySchema: introspectSchema(cfg.bodySchema),\n querySchema: introspectSchema(cfg.querySchema),\n paramsSchema: introspectSchema(cfg.paramsSchema),\n outputSchema: introspectSchema(cfg.outputSchema),\n },\n };\n}\n","import { AnyLeaf } from \"../core/routesV3.core\";\nimport { serializeLeaf } from \"./serializer.js\";\n\ninterface RenderOptions {\n cspNonce?: string;\n inlineCss?: string;\n inlineClientScript?: string;\n}\n\n/**\n * Updated CSS with Playground, JSON Tree, and Interactive Schema styles.\n */\nconst CSS_STYLES = `:root {\n --bg-root: #020617;\n --bg-card: rgba(15, 23, 42, 0.6);\n --bg-card-hover: rgba(30, 41, 59, 0.7);\n --bg-glass: rgba(15, 23, 42, 0.90);\n --bg-panel: #0f172a;\n --border-subtle: rgba(148, 163, 184, 0.2);\n\n --text-main: #f8fafc;\n --text-muted: #94a3b8;\n --text-accent: #c4b5fd;\n\n --accent-primary: #a855f7;\n --accent-glow: rgba(168, 85, 247, 0.25);\n --accent-success: #4ade80;\n --accent-error: #f87171;\n\n /* Method Colors */\n --method-get: #4ade80; --method-get-bg: rgba(34, 197, 94, 0.15);\n --method-post: #60a5fa; --method-post-bg: rgba(59, 130, 246, 0.15);\n --method-put: #facc15; --method-put-bg: rgba(234, 179, 8, 0.15);\n --method-patch: #2dd4bf; --method-patch-bg: rgba(45, 212, 191, 0.15);\n --method-delete: #f87171; --method-delete-bg: rgba(248, 113, 113, 0.15);\n\n --radius-card: 12px;\n --shadow-card: 0 4px 20px rgba(0, 0, 0, 0.4);\n --shadow-panel: -5px 0 30px rgba(0,0,0,0.5);\n\n --font-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;\n\n /* Tag Pastel Palette */\n --tag-0-bg: rgba(254, 202, 202, 0.2); --tag-0-fg: #fca5a5;\n --tag-1-bg: rgba(253, 230, 138, 0.2); --tag-1-fg: #fcd34d;\n --tag-2-bg: rgba(187, 247, 208, 0.2); --tag-2-fg: #86efac;\n --tag-3-bg: rgba(165, 243, 252, 0.2); --tag-3-fg: #67e8f9;\n --tag-4-bg: rgba(191, 219, 254, 0.2); --tag-4-fg: #93c5fd;\n --tag-5-bg: rgba(233, 213, 255, 0.2); --tag-5-fg: #d8b4fe;\n --tag-6-bg: rgba(251, 207, 232, 0.2); --tag-6-fg: #f9a8d4;\n}\n\n* { box-sizing: border-box; }\n\nhtml, body {\n height: 100%; margin: 0; padding: 0;\n background-color: var(--bg-root);\n color: var(--text-main);\n font-family: system-ui, -apple-system, sans-serif;\n}\n\nbody {\n background-image:\n radial-gradient(circle at 15% 10%, rgba(88, 28, 135, 0.15), transparent 40%),\n radial-gradient(circle at 85% 80%, rgba(15, 23, 42, 1), transparent 40%);\n background-attachment: fixed;\n}\n\n.page {\n min-height: 100vh; padding: 20px 40px 60px; max-width: 1600px;\n margin: 0 auto; display: flex; flex-direction: column; gap: 24px;\n}\n\n/* Header */\n.header { display: flex; justify-content: space-between; padding-bottom: 10px; border-bottom: 1px solid var(--border-subtle); }\n.header-title h1 {\n font-size: 28px; margin: 0; font-weight: 700; letter-spacing: -0.02em;\n background: linear-gradient(to right, #e2e8f0, #a855f7); -webkit-background-clip: text; -webkit-text-fill-color: transparent;\n}\n\n/* Controls */\n.controls-container {\n position: sticky; top: 0; z-index: 50;\n background: var(--bg-glass); backdrop-filter: blur(16px);\n border: 1px solid var(--border-subtle); border-radius: var(--radius-card);\n padding: 12px 16px; display: flex; flex-direction: column; gap: 12px;\n box-shadow: 0 10px 30px -10px rgba(0,0,0,0.5);\n}\n.filters-row { display: flex; align-items: flex-start; gap: 16px; width: 100%; }\n.left-column { display: flex; flex-direction: column; gap: 16px; flex-basis: 300px; min-width: 250px; }\n.search-box { width: 100%; position: relative; }\n.search-input {\n width: 100%; background: rgba(2, 6, 23, 0.6); border: 1px solid var(--border-subtle);\n color: var(--text-main); padding: 8px 12px 8px 32px; border-radius: 6px; font-size: 13px;\n}\n.search-input:focus { outline: none; border-color: var(--accent-primary); }\n.search-icon { position: absolute; left: 10px; top: 50%; transform: translateY(-50%); color: var(--text-muted); font-size: 12px; }\n.filter-group { display: flex; flex-direction: column; gap: 6px; }\n.filter-label { font-size: 10px; text-transform: uppercase; color: var(--text-muted); font-weight: 700; }\n.checkbox-group { display: flex; flex-wrap: wrap; gap: 6px; }\n\n/* Pills */\n.pill-checkbox input { display: none; }\n.pill-checkbox span {\n display: inline-block; padding: 3px 8px; border-radius: 4px; font-size: 11px; font-weight: 600;\n background: rgba(30, 41, 59, 0.5); color: var(--text-muted); border: 1px solid transparent; cursor: pointer;\n}\n.pill-checkbox input:checked + span { background: rgba(168, 85, 247, 0.15); color: var(--accent-primary); border-color: var(--accent-primary); }\n.pill-checkbox.colored-tag input:checked + .tag-filter-pill { border-color: var(--accent-primary); box-shadow: 0 0 0 1px var(--accent-glow); }\n\n/* Overview */\n.overview-row { display: flex; flex-wrap: wrap; gap: 8px; padding-top: 8px; border-top: 1px solid var(--border-subtle); align-items: center; }\n.overview-label { font-size: 10px; text-transform: uppercase; color: var(--text-muted); font-weight: 700; }\n.group-chip {\n font-size: 11px; text-decoration: none; color: var(--text-accent); background: rgba(168, 85, 247, 0.08);\n padding: 3px 8px; border-radius: 4px; border: 1px solid transparent;\n}\n.group-chip:hover { background: rgba(168, 85, 247, 0.2); border-color: var(--accent-primary); color: #fff; }\n\n/* Endpoint Cards */\n.api-group { margin-bottom: 40px; scroll-margin-top: 180px; }\n.group-header { display: flex; align-items: center; justify-content: space-between; margin-bottom: 16px; border-bottom: 1px solid var(--border-subtle); }\n.group-title { font-size: 20px; font-weight: 600; margin: 0; padding-bottom: 8px; }\n.group-actions button {\n background: transparent; border: 1px solid var(--border-subtle); color: var(--text-muted);\n font-size: 11px; padding: 4px 10px; border-radius: 4px; cursor: pointer; margin-left: 8px;\n}\n.endpoint-card {\n background: var(--bg-card); border: 1px solid var(--border-subtle); border-radius: var(--radius-card);\n overflow: hidden; transition: all 0.2s ease; margin-bottom: 12px;\n}\n.endpoint-card:hover { border-color: rgba(148, 163, 184, 0.4); box-shadow: var(--shadow-card); }\n.card-header { padding: 12px 16px; display: flex; align-items: center; gap: 12px; flex-wrap: wrap; cursor: pointer; }\n.header-spacer { flex: 1; }\n.card-body { display: none; padding: 0 16px 16px; border-top: 1px solid var(--border-subtle); margin-top: 4px; }\n.endpoint-card[data-expanded=\"true\"] .card-body { display: block; animation: slideDown 0.2s ease-out; }\n.endpoint-card[data-expanded=\"true\"] .expand-icon { transform: rotate(180deg); color: var(--text-main); }\n@keyframes slideDown { from { opacity: 0; transform: translateY(-5px); } to { opacity: 1; transform: translateY(0); } }\n\n/* Method Badges */\n.method-badge { font-size: 11px; font-weight: 800; text-transform: uppercase; padding: 4px 8px; border-radius: 4px; min-width: 55px; text-align: center; }\n.m-GET { background: var(--method-get-bg); color: var(--method-get); border: 1px solid rgba(74, 222, 128, 0.3); }\n.m-POST { background: var(--method-post-bg); color: var(--method-post); border: 1px solid rgba(96, 165, 250, 0.3); }\n.m-PUT { background: var(--method-put-bg); color: var(--method-put); border: 1px solid rgba(250, 204, 21, 0.3); }\n.m-PATCH { background: var(--method-patch-bg); color: var(--method-patch); border: 1px solid rgba(45, 212, 191, 0.3); }\n.m-DELETE { background: var(--method-delete-bg); color: var(--method-delete); border: 1px solid rgba(248, 113, 113, 0.3); }\n\n.path-container { font-family: var(--font-mono); font-size: 13px; display: inline-flex; align-items: center; gap: 8px; padding: 2px 6px; border-radius: 4px; }\n.path-container:hover { background: rgba(255,255,255,0.05); }\n.copy-icon { opacity: 0; font-size: 10px; }\n.path-container:hover .copy-icon { opacity: 1; }\n.tags-container { display: flex; gap: 6px; }\n.status-badge { font-size: 9px; text-transform: uppercase; padding: 2px 6px; border-radius: 3px; font-weight: 600; }\n/* Tag colors */\n.tag-0 { background: var(--tag-0-bg); color: var(--tag-0-fg); border-color: var(--tag-0-fg); }\n.tag-1 { background: var(--tag-1-bg); color: var(--tag-1-fg); border-color: var(--tag-1-fg); }\n.tag-2 { background: var(--tag-2-bg); color: var(--tag-2-fg); border-color: var(--tag-2-fg); }\n.tag-3 { background: var(--tag-3-bg); color: var(--tag-3-fg); border-color: var(--tag-3-fg); }\n.tag-4 { background: var(--tag-4-bg); color: var(--tag-4-fg); border-color: var(--tag-4-fg); }\n.tag-5 { background: var(--tag-5-bg); color: var(--tag-5-fg); border-color: var(--tag-5-fg); }\n.tag-6 { background: var(--tag-6-bg); color: var(--tag-6-fg); border-color: var(--tag-6-fg); }\n.not-implemented { border-color: var(--method-delete); color: var(--method-delete); background: var(--method-delete-bg); }\n\n/* Use Endpoint Button */\n.btn-try-it {\n background: rgba(168, 85, 247, 0.1); border: 1px solid rgba(168, 85, 247, 0.4);\n color: var(--text-accent); font-size: 11px; font-weight: 600; padding: 4px 12px;\n border-radius: 12px; cursor: pointer; transition: all 0.2s; margin-right: 12px;\n display: flex; align-items: center; gap: 6px;\n}\n.btn-try-it:hover { background: rgba(168, 85, 247, 0.25); color: #fff; box-shadow: 0 0 10px var(--accent-glow); }\n.btn-try-it .play-icon { font-size: 10px; }\n\n/* Section Titles */\n.section-block { margin-top: 18px; }\n.section-title { font-size: 11px; text-transform: uppercase; letter-spacing: 0.1em; color: var(--text-muted); margin-bottom: 8px; border-bottom: 1px solid var(--border-subtle); padding-bottom: 4px; }\n\n/* Tables & Schema */\n.schema-table { width: 100%; border-collapse: collapse; font-size: 12px; }\n.schema-table th { text-align: left; color: var(--text-muted); font-weight: 600; padding: 6px 8px; border-bottom: 1px solid var(--border-subtle); background: rgba(0,0,0,0.2); }\n.schema-table td { padding: 6px 8px; border-bottom: 1px solid var(--border-subtle); vertical-align: top; color: var(--text-muted); }\n.col-name { font-family: var(--font-mono); color: var(--text-accent) !important; width: 25%; }\n.col-type { font-family: var(--font-mono); color: #93c5fd !important; width: 15%; }\n.req-badge { font-size: 9px; text-transform: uppercase; padding: 2px 4px; border-radius: 2px; }\n.req-true { color: #4ade80; background: rgba(74, 222, 128, 0.1); }\n.req-false { color: #94a3b8; background: rgba(148, 163, 184, 0.1); }\n.schema-toggle {\n background: none; border: none; color: var(--text-muted); cursor: pointer; font-size: 10px;\n padding: 0 4px; margin-right: 4px; width: 16px; text-align: center;\n}\n.schema-toggle:hover { color: var(--text-main); }\ntr[data-hidden=\"true\"] { display: none; }\n\n/* --- Playground Panel --- */\n.playground-overlay {\n position: fixed; top: 0; right: 0; bottom: 0; width: 600px; max-width: 90vw;\n background: var(--bg-panel); border-left: 1px solid var(--border-subtle);\n box-shadow: var(--shadow-panel); z-index: 100;\n transform: translateX(100%); transition: transform 0.3s cubic-bezier(0.16, 1, 0.3, 1);\n display: flex; flex-direction: column;\n}\n.playground-overlay.open { transform: translateX(0); }\n\n.pg-header {\n padding: 16px; border-bottom: 1px solid var(--border-subtle);\n display: flex; justify-content: space-between; align-items: center;\n background: var(--bg-glass);\n}\n.pg-title { font-size: 16px; font-weight: 700; color: var(--text-main); }\n.pg-close { background: transparent; border: none; color: var(--text-muted); font-size: 20px; cursor: pointer; }\n.pg-close:hover { color: var(--text-main); }\n\n.pg-content { flex: 1; overflow-y: auto; padding: 20px; display: flex; flex-direction: column; gap: 24px; }\n\n.pg-section { display: flex; flex-direction: column; gap: 8px; }\n.pg-label { font-size: 11px; text-transform: uppercase; color: var(--text-muted); font-weight: 700; letter-spacing: 0.05em; }\n.pg-input, .pg-textarea {\n background: rgba(2, 6, 23, 0.4); border: 1px solid var(--border-subtle);\n color: var(--text-main); padding: 8px; border-radius: 6px; font-family: var(--font-mono); font-size: 12px;\n}\n.pg-input:focus, .pg-textarea:focus { outline: none; border-color: var(--accent-primary); }\n.pg-textarea { min-height: 150px; resize: vertical; }\n\n/* Param Grid */\n.param-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; }\n.param-row { display: contents; }\n\n.pg-footer {\n padding: 16px; border-top: 1px solid var(--border-subtle); background: var(--bg-glass);\n display: flex; justify-content: flex-end; gap: 12px;\n}\n.btn-send {\n background: var(--accent-primary); color: white; border: none; padding: 8px 24px;\n border-radius: 6px; font-weight: 600; cursor: pointer; transition: opacity 0.2s;\n}\n.btn-send:hover { opacity: 0.9; }\n.btn-send:disabled { opacity: 0.5; cursor: not-allowed; }\n\n/* Response View */\n.response-box { background: rgba(0,0,0,0.3); border-radius: 8px; border: 1px solid var(--border-subtle); overflow: hidden; }\n.response-meta {\n background: rgba(255,255,255,0.05); padding: 8px 12px;\n display: flex; gap: 12px; font-size: 11px; font-family: var(--font-mono); border-bottom: 1px solid var(--border-subtle);\n}\n.meta-item { display: flex; align-items: center; gap: 4px; }\n.status-ok { color: var(--accent-success); }\n.status-err { color: var(--accent-error); }\n.response-body { padding: 12px; overflow-x: auto; font-family: var(--font-mono); font-size: 12px; }\n\n/* JSON Tree */\n.json-tree { font-family: var(--font-mono); line-height: 1.6; }\n.jt-obj, .jt-arr { margin-left: 14px; }\n.jt-key { color: #93c5fd; margin-right: 4px; }\n.jt-str { color: #86efac; }\n.jt-num { color: #fca5a5; }\n.jt-bool { color: #fcd34d; }\n.jt-null { color: #94a3b8; }\n.jt-toggle {\n display: inline-block; width: 12px; text-align: center; cursor: pointer; color: var(--text-muted);\n user-select: none; margin-left: -14px;\n}\n.jt-toggle:hover { color: var(--text-main); }\n.jt-collapsed .jt-content { display: none; }\n.jt-collapsed::after { content: \" ... \"; color: var(--text-muted); font-size: 10px; }\n`;\n\n/**\n * Logic for Docs, Request Builder, Schema toggles, and Response visualization.\n */\nconst DOCS_JS = `\n(function() {\n let leaves = [];\n let activeLeaf = null;\n let activeRequest = {\n pathParams: {},\n queryParams: {},\n body: ''\n };\n\n // --- Initialization ---\n try {\n leaves = JSON.parse(document.getElementById('leaf-data').textContent || '[]');\n } catch(e) { console.error('Failed to parse docs', e); }\n\n const filters = { search: '', methods: new Set(), tags: new Set() };\n\n // Elements\n const elRouteList = document.getElementById('routeList');\n const elOverview = document.getElementById('overviewList');\n const elSearch = document.getElementById('searchInput');\n const elMethodFilters = document.getElementById('methodFilters');\n const elTagFilters = document.getElementById('tagFilters');\n\n // Playground Elements\n let elPlayground, elPgTitle, elPgContent, elPgClose, elPgSend, elPgMethod, elPgUrlPreview, elPgBaseUrl;\n\n function init() {\n injectPlaygroundHTML();\n populateFilters();\n setupGlobalListeners();\n setupPlaygroundListeners();\n render();\n }\n\n function injectPlaygroundHTML() {\n const div = document.createElement('div');\n div.className = 'playground-overlay';\n div.id = 'playgroundPanel';\n div.innerHTML =\n '<div class=\"pg-header\">' +\n '<div class=\"pg-title\"><span id=\"pgMethod\" class=\"method-badge\">GET</span> <span id=\"pgTitle\">Endpoint</span></div>' +\n '<button class=\"pg-close\" id=\"pgClose\">&times;</button>' +\n '</div>' +\n '<div class=\"pg-content\" id=\"pgContent\">' +\n // Dynamic content goes here\n '</div>' +\n '<div class=\"pg-footer\">' +\n '<button class=\"btn-send\" id=\"pgSend\">Send Request</button>' +\n '</div>';\n document.body.appendChild(div);\n\n elPlayground = document.getElementById('playgroundPanel');\n elPgTitle = document.getElementById('pgTitle');\n elPgContent = document.getElementById('pgContent');\n elPgClose = document.getElementById('pgClose');\n elPgSend = document.getElementById('pgSend');\n elPgMethod = document.getElementById('pgMethod');\n }\n\n // --- Filtering & Rendering ---\n\n function populateFilters() {\n if (!elMethodFilters || !elTagFilters) return;\n const allMethods = new Set(leaves.map(l => (l.method || 'GET').toUpperCase()));\n const allTags = new Set(leaves.flatMap(l => (l.cfg && l.cfg.tags) ? l.cfg.tags : []));\n\n const sortedMethods = Array.from(allMethods).sort();\n elMethodFilters.innerHTML = sortedMethods.map(m =>\n '<label class=\"pill-checkbox\"><input type=\"checkbox\" value=\"'+escapeAttr(m)+'\" checked><span>'+escapeHtml(m)+'</span></label>'\n ).join('');\n sortedMethods.forEach(m => filters.methods.add(m));\n\n if (allTags.size > 0) {\n elTagFilters.innerHTML = Array.from(allTags).sort().map(t =>\n '<label class=\"pill-checkbox colored-tag\"><input type=\"checkbox\" value=\"'+escapeAttr(t)+'\"><span class=\"tag-filter-pill '+getTagColorClass(t)+'\">'+escapeHtml(t)+'</span></label>'\n ).join('');\n }\n\n document.querySelectorAll('#methodFilters input, #tagFilters input').forEach(cb =>\n cb.addEventListener('change', updateFilters)\n );\n }\n\n function updateFilters() {\n if (elSearch) filters.search = elSearch.value.toLowerCase();\n filters.methods.clear();\n elMethodFilters.querySelectorAll('input:checked').forEach(cb => filters.methods.add(cb.value));\n filters.tags.clear();\n elTagFilters.querySelectorAll('input:checked').forEach(cb => filters.tags.add(cb.value));\n render();\n }\n\n function setupGlobalListeners() {\n if (elSearch) elSearch.addEventListener('input', updateFilters);\n\n // Event Delegation for Card interactions\n document.body.addEventListener('click', function(e) {\n const target = e.target;\n\n // Try It Button\n const btnTry = target.closest('.btn-try-it');\n if (btnTry) {\n e.preventDefault(); e.stopPropagation();\n const index = parseInt(btnTry.getAttribute('data-index'), 10);\n openPlayground(leaves[index]);\n return;\n }\n\n // Expand/Collapse Card\n const cardHeader = target.closest('.card-header');\n if (cardHeader) {\n // Don't toggle if clicked on path (copy) or tags\n if (target.closest('.path-container') || target.closest('.tags-container')) return;\n const card = cardHeader.closest('.endpoint-card');\n const expanded = card.getAttribute('data-expanded') === 'true';\n card.setAttribute('data-expanded', String(!expanded));\n return;\n }\n\n // Schema Toggles\n const toggleBtn = target.closest('.schema-toggle');\n if (toggleBtn) {\n e.preventDefault(); e.stopPropagation();\n toggleSchemaRow(toggleBtn);\n return;\n }\n\n // Schema Expand All / Collapse All\n if (target.matches('.schema-actions button')) {\n e.preventDefault(); e.stopPropagation();\n const table = target.closest('.section-block').querySelector('table');\n const action = target.getAttribute('data-action');\n toggleAllSchema(table, action === 'expand');\n return;\n }\n\n // Copy Path\n const pathContainer = target.closest('.path-container');\n if (pathContainer) {\n e.preventDefault(); e.stopPropagation();\n copyText(pathContainer.getAttribute('data-path'));\n return;\n }\n\n // Group Chips\n if (target.matches('.group-chip')) {\n e.preventDefault();\n scrollToGroup(target.getAttribute('data-group'));\n return;\n }\n\n // Group Expand/Collapse\n if (target.matches('.group-actions button')) {\n toggleGroup(target.getAttribute('data-group'), target.getAttribute('data-action') === 'expand');\n return;\n }\n\n // JSON Tree Toggles\n if (target.classList.contains('jt-toggle')) {\n e.stopPropagation();\n target.parentElement.classList.toggle('jt-collapsed');\n target.textContent = target.parentElement.classList.contains('jt-collapsed') ? '▶' : '▼';\n }\n });\n }\n\n function render() {\n if (!elRouteList || !elOverview) return;\n\n const filtered = leaves.map((leaf, idx) => ({ ...leaf, originalIndex: idx })).filter(leaf => {\n const m = (leaf.method || 'GET').toUpperCase();\n const t = (leaf.cfg.tags || []);\n const path = (leaf.path || '').toLowerCase();\n const summary = (leaf.cfg.summary || '').toLowerCase();\n\n if (!filters.methods.has(m)) return false;\n if (filters.tags.size > 0 && !t.some(tag => filters.tags.has(tag))) return false;\n if (filters.search && !path.includes(filters.search) && !summary.includes(filters.search)) return false;\n return true;\n });\n\n if (filtered.length === 0) {\n elRouteList.innerHTML = '<div style=\"text-align:center; padding:40px; color:var(--text-muted)\">No endpoints match filters.</div>';\n elOverview.innerHTML = '';\n return;\n }\n\n const groups = {};\n filtered.forEach(leaf => {\n const g = leaf.cfg.docsGroup || 'UNGROUPED';\n if (!groups[g]) groups[g] = [];\n groups[g].push(leaf);\n });\n\n const sortedGroups = Object.keys(groups).sort((a,b) => {\n if (a === 'UNGROUPED') return 1; if (b === 'UNGROUPED') return -1;\n return a.localeCompare(b);\n });\n\n // Render Overview\n elOverview.innerHTML = '<span class=\"overview-label\">JUMP TO:</span>' +\n sortedGroups.map(g => '<a href=\"#group-'+escapeAttr(g)+'\" class=\"group-chip\" data-group=\"'+escapeAttr(g)+'\">'+escapeHtml(g)+'</a>').join('');\n\n // Render Cards\n elRouteList.innerHTML = sortedGroups.map(g => {\n const routes = groups[g].sort((a,b) => (a.path||'').localeCompare(b.path||''));\n return '<div class=\"api-group\" id=\"group-'+escapeAttr(g)+'\">' +\n '<div class=\"group-header\"><h2 class=\"group-title\">'+escapeHtml(g)+'</h2>' +\n '<div class=\"group-actions\"><button data-group=\"'+escapeAttr(g)+'\" data-action=\"expand\">Expand All</button><button data-group=\"'+escapeAttr(g)+'\" data-action=\"collapse\">Collapse All</button></div></div>' +\n '<div class=\"cards-list\">' + routes.map(renderCard).join('') + '</div></div>';\n }).join('');\n }\n\n function renderCard(leaf) {\n const { method, path, cfg, originalIndex } = leaf;\n const tags = cfg.tags || [];\n const methodUc = (method || 'GET').toUpperCase();\n\n const tagBadges = tags.map(t => '<span class=\"status-badge '+getTagColorClass(t)+'\">'+escapeHtml(t)+'</span>').join('');\n\n return '<article class=\"endpoint-card\" data-expanded=\"false\">' +\n '<div class=\"card-header\">' +\n '<span class=\"method-badge m-'+escapeAttr(methodUc)+'\">'+escapeHtml(methodUc)+'</span>' +\n '<div class=\"path-container\" data-path=\"'+escapeAttr(path)+'\"><span class=\"path-text\">'+escapeHtml(path)+'</span><span class=\"copy-icon\">📋</span></div>' +\n '<div class=\"tags-container\">'+tagBadges+'</div>' +\n '<div class=\"header-spacer\"></div>' +\n '<button class=\"btn-try-it\" data-index=\"'+originalIndex+'\"><span class=\"play-icon\">▶</span> Use endpoint</button>' +\n '<div class=\"expand-icon\">▼</div>' +\n '</div>' +\n '<div class=\"card-body\">' +\n '<div class=\"section-block\"><div class=\"summary-text\"><strong>'+escapeHtml(cfg.summary||'')+'</strong><br><span class=\"description-text\">'+escapeHtml(cfg.description||'')+'</span></div></div>' +\n (cfg.paramsSchema || cfg.querySchema ? renderSection('Parameters', cfg.paramsSchema, cfg.querySchema) : '') +\n (cfg.bodySchema ? renderSection('Request Body ' + (cfg.hasBody?'':'(Optional)'), cfg.bodySchema) : '') +\n (cfg.outputSchema ? renderSection('Response Schema', cfg.outputSchema) : '') +\n '</div></article>';\n }\n\n function renderSection(title, schema1, schema2) {\n return '<div class=\"section-block\">' +\n '<div style=\"display:flex; justify-content:space-between; align-items:flex-end; border-bottom:1px solid var(--border-subtle); margin-bottom:8px;\">' +\n '<div class=\"section-title\" style=\"border:none; margin:0;\">'+title+'</div>' +\n '<div class=\"schema-actions\" style=\"margin-bottom:4px;\"><button data-action=\"expand\" style=\"background:none;border:none;color:var(--text-accent);cursor:pointer;font-size:10px;\">Exp All</button> <button data-action=\"collapse\" style=\"background:none;border:none;color:var(--text-muted);cursor:pointer;font-size:10px;\">Col All</button></div>' +\n '</div>' +\n (schema1 ? renderSchemaTable(schema1) : '') +\n (schema2 ? renderSchemaTable(schema2) : '') +\n '</div>';\n }\n\n // --- Schema Table Logic (Flattened with Depth) ---\n\n function renderSchemaTable(node) {\n let rows = '';\n // Start rendering. Root node usually doesn't need a row unless it's not an object.\n if (node.kind === 'object' && node.properties) {\n rows = renderObjectChildren(node, 0);\n } else {\n rows = renderNodeRow('(root)', node, 0);\n }\n return '<table class=\"schema-table\">' +\n '<tr><th class=\"col-name\">Field</th><th class=\"col-type\">Type</th><th>Req</th><th>Description</th></tr>' +\n rows + '</table>';\n }\n\n// Returns HTML string for rows\n function renderNodeRow(name, node, depth, parentPath) {\n const hasChildren = isComplexNode(node) && ((node.properties && Object.keys(node.properties).length > 0) || (node.element && isComplexNode(node.element)) || (node.union));\n const currentPath = (parentPath ? parentPath + '.' : '') + name;\n const indent = depth * 16;\n\n // NEW: Collapse by default. Hide deeply nested rows (depth > 0) initially.\n const isExpanded = false;\n const isHidden = depth > 0;\n\n const styleAttr = isHidden ? 'style=\"display:none\"' : '';\n const rowAttrs = 'data-depth=\"'+depth+'\" data-path=\"'+escapeAttr(currentPath)+'\" '+styleAttr + (hasChildren ? ' data-has-children=\"true\" data-expanded=\"'+isExpanded+'\"' : '');\n\n const toggleHtml = hasChildren\n ? '<button class=\"schema-toggle\">' + (isExpanded ? '▼' : '▶') + '</button>'\n : '<span style=\"width:20px; display:inline-block;\"></span>';\n\n const nameCell = '<div style=\"padding-left:'+indent+'px; display:flex; align-items:center;\">' +\n toggleHtml + '<span style=\"opacity:0.8\">'+escapeHtml(name)+'</span></div>';\n\n let html = '<tr '+rowAttrs+'>' +\n '<td class=\"col-name\">' + nameCell + '</td>' +\n '<td class=\"col-type\">' + escapeHtml(getTypeLabel(node)) + '</td>' +\n '<td><span class=\"req-badge '+(node.optional?'req-false':'req-true')+'\">'+(node.optional?'OPT':'REQ')+'</span></td>' +\n '<td>' + renderNodeDescription(node) + '</td>' +\n '</tr>';\n\n if (hasChildren) {\n if (node.kind === 'object' && node.properties) {\n html += renderObjectChildren(node, depth + 1, currentPath);\n }\n else if (node.kind === 'array' && node.element) {\n // ARRAY FIX: If array element is an object, render its properties directly (removing [item] layer)\n if (node.element.kind === 'object' && node.element.properties) {\n html += renderObjectChildren(node.element, depth + 1, currentPath);\n } else {\n html += renderNodeRow('[item]', node.element, depth + 1, currentPath);\n }\n }\n else if (node.kind === 'union' && node.union) {\n node.union.forEach((u, i) => { html += renderNodeRow('OneOf ('+i+')', u, depth + 1, currentPath); });\n }\n }\n return html;\n }\n\n function renderObjectChildren(node, depth, parentPath) {\n if (!node.properties) return '';\n return Object.keys(node.properties).map(key => renderNodeRow(key, node.properties[key], depth, parentPath)).join('');\n }\n\n // Schema Toggling Logic (JS)\n function toggleSchemaRow(btn) {\n const tr = btn.closest('tr');\n const wasExpanded = tr.getAttribute('data-expanded') === 'true';\n const isNowExpanded = !wasExpanded;\n const currentDepth = parseInt(tr.getAttribute('data-depth'), 10);\n\n // Update State UI\n tr.setAttribute('data-expanded', String(isNowExpanded));\n btn.textContent = isNowExpanded ? '▼' : '▶';\n\n // Process Siblings\n let sibling = tr.nextElementSibling;\n while (sibling) {\n const sibDepth = parseInt(sibling.getAttribute('data-depth'), 10);\n // Stop if we hit a row with equal or less depth (next sibling or uncle)\n if (isNaN(sibDepth) || sibDepth <= currentDepth) break;\n\n if (isNowExpanded) {\n // EXPANDING: We only show this child if its immediate parent is also expanded.\n checkVisibility(sibling);\n } else {\n // COLLAPSING: Hide all descendants regardless of their state\n sibling.style.display = 'none';\n }\n sibling = sibling.nextElementSibling;\n }\n }\n\n function checkVisibility(row) {\n // Walk up previous siblings to find parent and check its expansion state\n const myDepth = parseInt(row.getAttribute('data-depth'), 10);\n let prev = row.previousElementSibling;\n while (prev) {\n const pDepth = parseInt(prev.getAttribute('data-depth'), 10);\n if (pDepth < myDepth) {\n // Found parent\n // If parent is expanded AND visible, then I should be visible.\n if (prev.getAttribute('data-expanded') === 'true' && prev.style.display !== 'none') {\n row.style.display = '';\n } else {\n row.style.display = 'none';\n }\n return;\n }\n prev = prev.previousElementSibling;\n }\n // No parent found (depth 0), always visible\n row.style.display = '';\n }\n\n function toggleAllSchema(table, expand) {\n if (!table) return;\n const rows = table.querySelectorAll('tr[data-has-children=\"true\"]');\n rows.forEach(row => {\n row.setAttribute('data-expanded', String(expand));\n const btn = row.querySelector('.schema-toggle');\n if(btn) btn.textContent = expand ? '▼' : '▶';\n });\n // Update visibility for all rows\n const allRows = table.querySelectorAll('tr[data-depth]');\n allRows.forEach(row => {\n if(parseInt(row.getAttribute('data-depth')) === 0) return;\n checkVisibility(row);\n });\n }\n\n // --- Playground Logic ---\n\n function setupPlaygroundListeners() {\n if(elPgClose) elPgClose.addEventListener('click', closePlayground);\n if(elPgSend) elPgSend.addEventListener('click', executeRequest);\n }\n\n function closePlayground() {\n elPlayground.classList.remove('open');\n }\n\n function openPlayground(leaf) {\n activeLeaf = leaf;\n elPgTitle.textContent = leaf.path;\n elPgMethod.textContent = (leaf.method || 'GET').toUpperCase();\n elPgMethod.className = 'method-badge m-' + elPgMethod.textContent;\n\n // Reset request state\n activeRequest = { pathParams: {}, queryParams: {}, body: '' };\n\n renderPlaygroundForm(leaf);\n elPlayground.classList.add('open');\n }\n\n function renderPlaygroundForm(leaf) {\n // 1. Base URL\n let html = '<div class=\"pg-section\"><div class=\"pg-label\">Base URL</div>' +\n '<input class=\"pg-input\" id=\"pgBaseUrl\" value=\"'+window.location.origin+'\"></div>';\n\n // 2. Path Params\n // Extract :param or {param} from path\n const pathParamRegex = /[:{]([a-zA-Z0-9_]+)}?/g;\n const matches = [...leaf.path.matchAll(pathParamRegex)];\n\n if (matches.length > 0) {\n html += '<div class=\"pg-section\"><div class=\"pg-label\">Path Variables</div><div class=\"param-grid\">';\n matches.forEach(m => {\n const key = m[1];\n html += '<div class=\"param-row\">' +\n '<input class=\"pg-input\" placeholder=\"'+key+'\" disabled value=\"'+key+'\" style=\"opacity:0.7\">' +\n '<input class=\"pg-input pg-path-input\" data-key=\"'+key+'\" placeholder=\"value\">' +\n '</div>';\n });\n html += '</div></div>';\n }\n\n // 3. Query Params\n // We check leaf.cfg.querySchema or just provide a generic adder\n html += '<div class=\"pg-section\"><div class=\"pg-label\">Query Parameters</div>' +\n '<div class=\"param-grid\" id=\"pgQueryGrid\"></div>' +\n '<button type=\"button\" id=\"pgAddQuery\" style=\"font-size:11px;background:none;border:1px dashed var(--border-subtle);color:var(--text-muted);padding:4px;cursor:pointer;\">+ Add Parameter</button>' +\n '</div>';\n\n // 4. Body\n if (['POST','PUT','PATCH'].includes((leaf.method||'').toUpperCase())) {\n html += '<div class=\"pg-section\"><div class=\"pg-label\">Request Body (JSON)</div>' +\n '<textarea class=\"pg-textarea\" id=\"pgBodyInput\" placeholder=\"{ ... }\"></textarea>' +\n '</div>';\n }\n\n // 5. Response Container\n html += '<div class=\"pg-section\" id=\"pgResponseContainer\" style=\"display:none;\">' +\n '<div class=\"pg-label\">Response</div>' +\n '<div class=\"response-box\">' +\n '<div class=\"response-meta\" id=\"pgResponseMeta\"></div>' +\n '<div class=\"response-body\" id=\"pgResponseBody\"></div>' +\n '</div></div>';\n\n elPgContent.innerHTML = html;\n\n // Setup listeners for the dynamic form\n const btnAddQuery = document.getElementById('pgAddQuery');\n if(btnAddQuery) btnAddQuery.addEventListener('click', () => addQueryRow());\n\n // Pre-fill query rows if schema exists\n if (leaf.cfg.querySchema && leaf.cfg.querySchema.properties) {\n Object.keys(leaf.cfg.querySchema.properties).forEach(k => addQueryRow(k));\n } else {\n addQueryRow();\n }\n }\n\n function addQueryRow(key = '') {\n const container = document.getElementById('pgQueryGrid');\n const div = document.createElement('div');\n div.className = 'param-row';\n div.innerHTML = '<input class=\"pg-input pg-query-key\" placeholder=\"Name\" value=\"'+key+'\"><input class=\"pg-input pg-query-val\" placeholder=\"Value\">';\n container.appendChild(div);\n }\n\n // --- Execution ---\n\n async function executeRequest() {\n const btn = document.getElementById('pgSend');\n const resContainer = document.getElementById('pgResponseContainer');\n const metaEl = document.getElementById('pgResponseMeta');\n const bodyEl = document.getElementById('pgResponseBody');\n const baseUrlInput = document.getElementById('pgBaseUrl');\n\n btn.disabled = true;\n btn.textContent = 'Sending...';\n resContainer.style.display = 'none';\n\n try {\n // Build URL\n let url = (baseUrlInput.value || window.location.origin).replace(/\\\\/$/, '') + activeLeaf.path;\n\n // Sub Path Params\n document.querySelectorAll('.pg-path-input').forEach(input => {\n const k = input.getAttribute('data-key');\n const v = input.value.trim();\n url = url.replace(':'+k, v).replace('{'+k+'}', v);\n });\n\n // Build Query\n const queryParts = [];\n document.querySelectorAll('.pgQueryGrid .param-row, .param-grid .param-row').forEach(row => {\n const k = row.querySelector('.pg-query-key');\n const v = row.querySelector('.pg-query-val');\n if(k && v && k.value.trim()) {\n queryParts.push(encodeURIComponent(k.value.trim()) + '=' + encodeURIComponent(v.value.trim()));\n }\n });\n if(queryParts.length) url += '?' + queryParts.join('&');\n\n // Build Body\n const method = (activeLeaf.method || 'GET').toUpperCase();\n const headers = {};\n let body = null;\n\n const bodyInput = document.getElementById('pgBodyInput');\n if (bodyInput && bodyInput.value.trim()) {\n try {\n // Validate JSON\n const j = JSON.parse(bodyInput.value);\n body = JSON.stringify(j);\n headers['Content-Type'] = 'application/json';\n } catch(e) {\n alert('Invalid JSON in request body');\n btn.disabled = false; btn.textContent = 'Send Request';\n return;\n }\n }\n\n const start = performance.now();\n const res = await fetch(url, { method, headers, body });\n const time = (performance.now() - start).toFixed(0);\n\n // Read response\n const status = res.status;\n const statusText = res.statusText;\n let resData;\n const contentType = res.headers.get('content-type') || '';\n\n if (contentType.includes('application/json')) {\n resData = await res.json();\n } else {\n resData = await res.text();\n }\n\n // Render Response\n resContainer.style.display = 'block';\n const statusClass = (status >= 200 && status < 300) ? 'status-ok' : 'status-err';\n metaEl.innerHTML = '<div class=\"meta-item '+statusClass+'\">⬤ '+status+' '+statusText+'</div><div class=\"meta-item\">⏱ '+time+'ms</div>';\n\n bodyEl.innerHTML = '';\n if (typeof resData === 'object' && resData !== null) {\n bodyEl.appendChild(renderJsonTree(resData));\n } else {\n const pre = document.createElement('pre');\n pre.style.margin = 0;\n pre.textContent = resData;\n bodyEl.appendChild(pre);\n }\n\n } catch (err) {\n resContainer.style.display = 'block';\n metaEl.innerHTML = '<div class=\"meta-item status-err\">Network Error</div>';\n bodyEl.textContent = err.message;\n } finally {\n btn.disabled = false;\n btn.textContent = 'Send Request';\n }\n }\n\n // --- JSON Tree Renderer ---\n\n function renderJsonTree(data) {\n // Recursive DOM generator\n if (data === null) return createSpan('null', 'jt-null');\n if (typeof data === 'number') return createSpan(String(data), 'jt-num');\n if (typeof data === 'boolean') return createSpan(String(data), 'jt-bool');\n if (typeof data === 'string') return createSpan('\"'+data+'\"', 'jt-str');\n\n const isArr = Array.isArray(data);\n const container = document.createElement('div');\n container.className = 'json-tree ' + (isArr ? 'jt-arr' : 'jt-obj');\n\n const toggle = document.createElement('span');\n toggle.className = 'jt-toggle';\n toggle.textContent = '▼';\n\n const content = document.createElement('div');\n content.className = 'jt-content';\n\n const keys = Object.keys(data);\n if (keys.length === 0) {\n container.textContent = isArr ? '[]' : '{}';\n return container;\n }\n\n container.appendChild(toggle);\n container.appendChild(document.createTextNode(isArr ? '[' : '{'));\n container.appendChild(content);\n\n keys.forEach((k, i) => {\n const line = document.createElement('div');\n line.style.paddingLeft = '16px';\n\n if (!isArr) {\n const keySpan = createSpan('\"'+k+'\": ', 'jt-key');\n line.appendChild(keySpan);\n }\n\n line.appendChild(renderJsonTree(data[k]));\n if (i < keys.length - 1) line.appendChild(document.createTextNode(','));\n content.appendChild(line);\n });\n\n container.appendChild(document.createTextNode(isArr ? ']' : '}'));\n return container;\n }\n\n function createSpan(text, cls) {\n const s = document.createElement('span');\n s.className = cls;\n s.textContent = text;\n return s;\n }\n\n // --- Utilities ---\n\n function getTagColorClass(tagName) {\n if (tagName === 'not-implemented') return 'not-implemented';\n let hash = 0;\n for (let i = 0; i < tagName.length; i++) hash = tagName.charCodeAt(i) + ((hash << 5) - hash);\n return 'tag-' + Math.abs(hash % 7);\n }\n\n function getTypeLabel(node) {\n if (!node) return 'any';\n if (node.kind === 'array') {\n if(!node.element) return 'array';\n return 'array<' + getTypeLabel(node.element) + '>';\n }\n if (node.kind === 'union' && node.union) return node.union.map(getTypeLabel).join(' | ');\n if (node.kind === 'literal') return 'literal';\n if (node.kind === 'enum') return 'enum';\n return node.kind || 'any';\n }\n\n function renderNodeDescription(node) {\n let desc = [];\n if (node.description) desc.push(escapeHtml(node.description));\n if (node.kind === 'enum' && node.enumValues) desc.push('Allowed: ' + node.enumValues.map(v=>'<code>'+v+'</code>').join(' | '));\n if (node.kind === 'literal' && node.literal !== undefined) desc.push('Value: <code>'+JSON.stringify(node.literal)+'</code>');\n return desc.join('<br>');\n }\n\n function isComplexNode(node) {\n return ['object','array','union','record','tuple'].includes(node.kind);\n }\n\n function toggleGroup(gName, expand) {\n const g = document.getElementById('group-'+gName);\n if(g) g.querySelectorAll('.endpoint-card').forEach(c => c.setAttribute('data-expanded', String(!!expand)));\n }\n\n function scrollToGroup(gName) {\n const el = document.getElementById('group-'+gName);\n if (el) window.scrollTo({ top: el.offsetTop - 100, behavior: 'smooth' });\n }\n\n function copyText(text) {\n if (navigator.clipboard && text) navigator.clipboard.writeText(text);\n }\n\n function escapeHtml(str) {\n if (str === null || str === undefined) return '';\n return String(str).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\"/g, '&quot;');\n }\n function escapeAttr(str) { return escapeHtml(str); }\n\n init();\n})();\n`;\n\nexport function renderLeafDocsHTML(\n leaves: AnyLeaf[],\n options: RenderOptions = {}\n): string {\n const leavesJson = JSON.stringify(leaves.map(serializeLeaf));\n const nonceAttr = options.cspNonce ? ` nonce=\"${options.cspNonce}\"` : \"\";\n\n return `\n<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>API Reference</title>\n <style${nonceAttr}>${CSS_STYLES}</style>\n ${options.inlineCss ? `<style${nonceAttr}>${options.inlineCss}</style>` : \"\"}\n</head>\n<body>\n <div class=\"page\">\n <header class=\"header\">\n <div class=\"header-title\"><h1>API Reference</h1></div>\n </header>\n\n <div class=\"controls-container\">\n <div class=\"filters-row\">\n <div class=\"left-column\">\n <div class=\"filter-group\">\n <div class=\"filter-label\">Search</div>\n <div class=\"search-box\">\n <span class=\"search-icon\">🔍</span>\n <input type=\"text\" id=\"searchInput\" class=\"search-input\" placeholder=\"Filter endpoints...\">\n </div>\n </div>\n <div class=\"filter-group\">\n <div class=\"filter-label\">Methods</div>\n <div class=\"checkbox-group\" id=\"methodFilters\"></div>\n </div>\n </div>\n <div class=\"filter-group tag-filters-container\">\n <div class=\"filter-label\">Tags</div>\n <div class=\"checkbox-group\" id=\"tagFilters\"></div>\n </div>\n </div>\n <div class=\"overview-row\" id=\"overviewList\"></div>\n </div>\n\n <main id=\"routeList\">\n <div style=\"text-align:center; padding:40px; color:#64748b\">Loading API definition...</div>\n </main>\n </div>\n\n <script id=\"leaf-data\" type=\"application/json\">${leavesJson}</script>\n <script${nonceAttr}>${DOCS_JS}</script>\n ${options.inlineClientScript ? `<script${nonceAttr}>${options.inlineClientScript}</script>` : \"\"}\n</body>\n</html>\n `;\n}\n","// renderLeafDocsHTML.ts\nimport { AnyLeaf } from \"../core/routesV3.core\";\nimport { renderLeafDocsHTML as LeafDocsPage } from \"./LeafDocsPage.js\";\n\ninterface RenderOptions {\n cspNonce?: string;\n inlineCss?: string;\n inlineClientScript?: string;\n}\n\nexport function renderLeafDocsHTML(\n leaves: AnyLeaf[],\n options: RenderOptions = {}\n): string {\n return LeafDocsPage(leaves, options)\n}\n"],"mappings":"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A;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiQnB,IAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuqBT,SAAS,mBACd,QACA,UAAyB,CAAC,GAClB;AACR,QAAM,aAAa,KAAK,UAAU,OAAO,IAAI,aAAa,CAAC;AAC3D,QAAM,YAAY,QAAQ,WAAW,WAAW,QAAQ,QAAQ,MAAM;AAEtE,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAOC,SAAS,IAAI,UAAU;AAAA,IAC7B,QAAQ,YAAY,SAAS,SAAS,IAAI,QAAQ,SAAS,aAAa,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mDAoC3B,UAAU;AAAA,WAClD,SAAS,IAAI,OAAO;AAAA,IAC3B,QAAQ,qBAAqB,UAAU,SAAS,IAAI,QAAQ,kBAAkB,cAAc,EAAE;AAAA;AAAA;AAAA;AAIlG;;;ACn+BO,SAASC,oBACd,QACA,UAAyB,CAAC,GAClB;AACR,SAAO,mBAAa,QAAQ,OAAO;AACrC;","names":["mergeSchemas","renderLeafDocsHTML","import_zod","mergeSchemas","z","renderLeafDocsHTML"]}