@erenthedeveloper0/zen-openapi 0.1.0-alpha.1

package/dist/schema.js

@@ -0,0 +1,434 @@
+import { resolveRef } from '@erenthedeveloper0/zen-core';
+// ─────────────────────────────────────────────────────────────────────────────
+// Component registry — §29.3
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Deduplication runs in three passes, cheapest and most authoritative first:
+ * schema *identity* (the same imported object used by four routes is one
+ * component), then a *declared* name (`$id` / `title`), then *structural*
+ * equality. The third pass is a backstop, not the strategy — two schemas that
+ * happen to have the same shape today are not necessarily the same concept, so
+ * structural merging only ever fires for schemas that had no name to begin with.
+ */
+export class Components {
+    #byName = new Map();
+    #byKey = new Map();
+    /** `name + shape` → the name that owns it. What makes two arrivals one component. */
+    #byIdentity = new Map();
+    /** A name that turned out to duplicate another, and the name it defers to. */
+    #aliases = new Map();
+    #reserved = new Set();
+    /**
+     * Claim a name for a shape that is already projected.
+     *
+     * `key` is the identity the caller wants deduplicated on, and it is a
+     * parameter rather than always the shape for a reason: two *named* schemas
+     * that happen to look alike today are not the same concept, so the caller
+     * folds the name into the key and they stay separate. Anonymous schemas pass
+     * the shape and do collapse. Different keys wanting the same name get `Name2`.
+     */
+    claim(preferred, schema, key, variant) {
+        const existing = this.#byKey.get(key);
+        if (existing !== undefined)
+            return existing;
+        const identity = identityOf(preferred, schema);
+        const owner = this.#byIdentity.get(identity);
+        if (owner !== undefined) {
+            this.#byKey.set(key, owner);
+            return owner;
+        }
+        const name = this.#free(preferred, variant);
+        this.#reserved.add(name);
+        this.#byName.set(name, schema);
+        this.#byKey.set(key, name);
+        this.#byIdentity.set(identity, name);
+        return name;
+    }
+    /**
+     * Reserve a name for a shape that cannot be projected yet — a `$def` whose body
+     * may refer back to itself, or refer to a sibling def not yet visited. Keyed on
+     * the *raw* schema so recursion terminates.
+     *
+     * The reservation is provisional: the same concept can arrive twice, once as a
+     * converter's `$defs` entry and once as an inline titled object, and which one
+     * is seen first depends on route order. `fill` reconciles that.
+     */
+    reserve(preferred, rawKey, variant) {
+        const existing = this.#byKey.get(rawKey);
+        if (existing !== undefined)
+            return { name: existing, fresh: false };
+        const name = this.#free(preferred, variant);
+        this.#reserved.add(name);
+        this.#byKey.set(rawKey, name);
+        return { name, fresh: true };
+    }
+    /**
+     * Attach a body to a reserved name — and collapse it onto an existing
+     * component if it turns out to be the same concept under the same name.
+     *
+     * This is the fix for a bug the first real application found: Zod hoists a
+     * schema carrying an `id` into `$defs` when it is nested, and emits it inline
+     * when it is not, so `PublicUser` arrived by both routes and the document
+     * published `PublicUser` *and* `PublicUser2`. Two names for one type in a
+     * generated client is exactly the drift this subsystem exists to prevent.
+     */
+    fill(name, schema) {
+        const identity = identityOf(name, schema);
+        const owner = this.#byIdentity.get(identity);
+        if (owner !== undefined && owner !== name) {
+            this.#aliases.set(name, owner);
+            this.#reserved.delete(name);
+            return;
+        }
+        this.#byIdentity.set(identity, name);
+        this.#byName.set(name, schema);
+    }
+    /** `duplicate → canonical`, for the final `$ref` rewrite. Empty in the common case. */
+    aliases() {
+        return this.#aliases;
+    }
+    has(name) {
+        return this.#byName.has(name);
+    }
+    get size() {
+        return this.#byName.size;
+    }
+    /** Sorted, because a document that reorders itself between runs cannot be diffed. */
+    toRecord() {
+        const out = {};
+        for (const name of [...this.#byName.keys()].sort()) {
+            if (this.#aliases.has(name))
+                continue;
+            out[name] = this.#byName.get(name);
+        }
+        return out;
+    }
+    /**
+     * `variant` is tried before the numeric fallback, and it exists for one very
+     * common case: the same named schema appears on both sides of the API, and the
+     * two are not identical — a converter describes a request body as it is
+     * *received* (extra keys tolerated) and a response as it is *emitted* (extra
+     * keys impossible, §13.3.1).
+     *
+     * They are genuinely two schemas, so they must be two components. But
+     * `OrderLine` and `OrderLineInput` tell a client author which is which, and
+     * `OrderLine` and `OrderLine2` do not.
+     */
+    #free(preferred, variant) {
+        const base = sanitizeName(preferred);
+        if (!this.#reserved.has(base))
+            return base;
+        if (variant !== undefined) {
+            const varied = `${base}${variant}`;
+            if (!this.#reserved.has(varied))
+                return varied;
+        }
+        for (let n = 2;; n++) {
+            const candidate = `${base}${n}`;
+            if (!this.#reserved.has(candidate))
+                return candidate;
+        }
+    }
+}
+/**
+ * A component's identity: its name plus its *shape*, with the top-level
+ * annotations removed.
+ *
+ * `title` and `description` are stripped because converters do not emit them
+ * consistently between an inline occurrence and a `$defs` entry for the very
+ * same schema — and two schemas with the same name and the same structure are
+ * one type whichever prose happens to be attached. Nested annotations are left
+ * alone; they are part of the shape as far as a client generator is concerned.
+ */
+function identityOf(name, schema) {
+    const { title: _title, description: _description, ...rest } = schema;
+    return `${sanitizeName(name)}::${canonical(rest)}`;
+}
+const NAME_ILLEGAL = /[^A-Za-z0-9_.-]/g;
+export function sanitizeName(raw) {
+    const cleaned = raw.replace(NAME_ILLEGAL, '_').replace(/^_+|_+$/g, '');
+    return cleaned.length > 0 ? cleaned : 'Schema';
+}
+/**
+ * Key-sorted JSON. Used for structural identity, so it must be stable across
+ * runs and across property insertion order — `{a,b}` and `{b,a}` are one shape.
+ */
+export function canonical(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'null';
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(',')}}`;
+}
+/** Keywords handled structurally; everything else is copied through verbatim. */
+const STRUCTURAL = new Set([
+    '$ref', '$defs', 'definitions', '$schema', '$id',
+    'type', 'nullable', 'properties', 'required', 'additionalProperties',
+    'items', 'prefixItems', 'anyOf', 'oneOf', 'allOf',
+]);
+export function projectSchema(raw, options) {
+    return new Projector(raw, options).walk(raw, new Set(), 0);
+}
+class Projector {
+    #root;
+    #opts;
+    /** `#/$defs/User` → component name. Populated before the body is walked. */
+    #refs = new Map();
+    /** Name suffix for the open (request) side, so both sides can coexist. */
+    #variant;
+    constructor(root, options) {
+        this.#root = root;
+        this.#opts = options;
+        this.#variant = options.closed ? undefined : 'Input';
+        this.#hoistDefs(root.$defs, '#/$defs/');
+        this.#hoistDefs(root.definitions, '#/definitions/');
+    }
+    #hoistDefs(defs, prefix) {
+        if (defs === undefined)
+            return;
+        // Names are reserved for every def first, then bodies are projected. A
+        // recursive `$def` refers to itself through a name that must already exist.
+        const pending = [];
+        for (const key of Object.keys(defs)) {
+            const schema = defs[key];
+            if (schema === undefined)
+                continue;
+            // The closure flag is part of the identity: the same raw schema projected
+            // open (a request) and closed (a response) is two different documents.
+            const rawKey = `def:${this.#opts.closed ? 'closed' : 'open'}:${canonical(schema)}`;
+            const claimed = this.#opts.components.reserve(key, rawKey, this.#variant);
+            this.#refs.set(`${prefix}${key}`, claimed.name);
+            if (claimed.fresh)
+                pending.push({ name: claimed.name, schema });
+        }
+        for (const job of pending) {
+            this.#opts.components.fill(job.name, this.walk(job.schema, new Set(), 0));
+        }
+    }
+    /**
+     * `depth` exists for one rule: **a titled subschema becomes a component
+     * wherever it appears.**
+     *
+     * A response of `{ users: PublicUser[] }` should say `$ref: PublicUser`, not
+     * inline a second copy of the same object — otherwise a generated client
+     * grows `UserListUsersItem` alongside `PublicUser` and the two drift the first
+     * time someone edits one. A `title` is the author naming a type, so it is
+     * honoured at every level. Anonymous subschemas stay inline, because hoisting
+     * those would fill `components` with `Schema1..Schema40`.
+     *
+     * Depth 0 is exempt: the caller decides whether the *root* is hoisted, since
+     * only it knows how many operations share it (§29.3).
+     */
+    walk(node, seen, depth) {
+        if (node === undefined || node === true)
+            return {};
+        if (node === false)
+            return { not: {} };
+        if (typeof node !== 'object')
+            return {};
+        if (typeof node.$ref === 'string')
+            return this.#ref(node.$ref, seen, depth);
+        const title = depth > 0 ? declaredName(node) : null;
+        if (title !== null) {
+            const body = this.#body(node, seen, depth);
+            const name = this.#opts.components.claim(title, body, `named:${title}:${canonical(body)}`, this.#variant);
+            if (name !== title && name !== `${title}${this.#variant ?? ''}`) {
+                this.#opts.diagnostics.push({
+                    severity: 'warning',
+                    code: 'ZEN_OAS_TITLE_COLLISION',
+                    message: `Two different schemas are both named "${title}"; this one was published as "${name}".`,
+                    where: this.#opts.where,
+                    hint: 'Give them distinct titles — a generated client names its types from these.',
+                });
+            }
+            return { $ref: `#/components/schemas/${name}` };
+        }
+        return this.#body(node, seen, depth);
+    }
+    #body(node, seen, depth) {
+        const out = {};
+        for (const key of Object.keys(node)) {
+            if (STRUCTURAL.has(key))
+                continue;
+            const value = node[key];
+            if (value !== undefined)
+                out[key] = value;
+        }
+        // `const` and `enum` short-circuit shape in the IR, so they do here too:
+        // closing an object that can only ever be one literal adds nothing.
+        if (node.const !== undefined || Array.isArray(node.enum)) {
+            this.#applyType(node, out);
+            return out;
+        }
+        const allOf = node.allOf;
+        if (Array.isArray(allOf) && allOf.length > 0)
+            return this.#allOf(node, allOf, out, seen, depth);
+        const union = node.oneOf ?? node.anyOf;
+        if (Array.isArray(union) && union.length > 0) {
+            const keyword = node.oneOf !== undefined ? 'oneOf' : 'anyOf';
+            out[keyword] = union.map((member) => this.walk(member, seen, depth + 1));
+            this.#applyType(node, out);
+            return out;
+        }
+        this.#applyType(node, out);
+        if (isObjectShape(node))
+            this.#object(node, out, seen, depth);
+        else if (node.items !== undefined || node.prefixItems !== undefined)
+            this.#array(node, out, seen, depth);
+        return out;
+    }
+    /** OAS 3.1 has no `nullable`; `type: [T, 'null']` is the same statement. */
+    #applyType(node, out) {
+        const declared = node.type;
+        if (declared === undefined) {
+            if (node.nullable === true)
+                out['type'] = 'null';
+            return;
+        }
+        const types = Array.isArray(declared) ? declared : [declared];
+        const withNull = node.nullable === true && !types.includes('null') ? [...types, 'null'] : types;
+        out['type'] = withNull.length === 1 ? withNull[0] : withNull;
+    }
+    #object(node, out, seen, depth) {
+        const properties = node.properties;
+        if (properties !== undefined) {
+            const projected = {};
+            for (const key of Object.keys(properties))
+                projected[key] = this.walk(properties[key], seen, depth + 1);
+            out['properties'] = projected;
+        }
+        if (node.required !== undefined && node.required.length > 0)
+            out['required'] = [...node.required];
+        const additional = node.additionalProperties;
+        if (additional === undefined) {
+            // §13.3.1 — the one deliberate deviation, written down in the document
+            // rather than left as folklore. Absent means *drop*, so the document says
+            // `false` and a generated client will not offer a field that cannot arrive.
+            if (this.#opts.closed)
+                out['additionalProperties'] = false;
+        }
+        else if (typeof additional === 'boolean') {
+            out['additionalProperties'] = additional;
+        }
+        else {
+            out['additionalProperties'] = this.walk(additional, seen, depth + 1);
+        }
+    }
+    #array(node, out, seen, depth) {
+        if (Array.isArray(node.prefixItems)) {
+            out['prefixItems'] = node.prefixItems.map((item) => this.walk(item, seen, depth + 1));
+            // Draft 2020-12: with `prefixItems`, `items` constrains the tail. `false`
+            // is how a fixed-length tuple is spelled, and the IR reads it the same way.
+            out['items'] = node.items === undefined || node.items === false ? false : this.walk(node.items, seen, depth + 1);
+            return;
+        }
+        if (node.items !== undefined)
+            out['items'] = this.walk(node.items, seen, depth + 1);
+    }
+    /**
+     * `allOf` is an intersection, and the serializer resolves it by *merging* the
+     * members into one object (§13.3, `Builder#allOf`). The document must say the
+     * same thing — and there is a second reason beyond fidelity: an `allOf` of two
+     * closed objects is unsatisfiable, because every property of one member is
+     * "additional" to the other. Emitting the merge avoids publishing a schema
+     * that nothing can validate against.
+     */
+    #allOf(node, members, out, seen, depth) {
+        if (!this.#opts.closed) {
+            out['allOf'] = members.map((member) => this.walk(member, seen, depth + 1));
+            this.#applyType(node, out);
+            return out;
+        }
+        const resolved = [];
+        for (const member of members) {
+            const target = typeof member.$ref === 'string' ? resolveRef(this.#root, member.$ref) : member;
+            if (target === null || !isObjectShape(target)) {
+                this.#opts.diagnostics.push({
+                    severity: 'info',
+                    code: 'ZEN_OAS_ALLOF_UNMERGED',
+                    message: 'allOf member is not an object schema, so the document keeps allOf rather than merging it.',
+                    where: this.#opts.where,
+                    hint: 'The serializer reports the same case as a boot diagnostic; see rfcs/0001 §13.3.',
+                });
+                out['allOf'] = members.map((m) => this.walk(m, seen, depth + 1));
+                this.#applyType(node, out);
+                return out;
+            }
+            resolved.push(target);
+        }
+        const properties = {};
+        const required = new Set();
+        let additional;
+        for (const member of [...resolved, node]) {
+            for (const [key, value] of Object.entries(member.properties ?? {}))
+                properties[key] = value;
+            for (const key of member.required ?? [])
+                required.add(key);
+            if (member.additionalProperties !== undefined)
+                additional = member.additionalProperties;
+        }
+        const merged = {
+            type: 'object',
+            properties,
+            ...(required.size > 0 ? { required: [...required] } : {}),
+            ...(additional !== undefined ? { additionalProperties: additional } : {}),
+        };
+        const projected = this.#body(merged, seen, depth);
+        return { ...out, ...projected };
+    }
+    #ref(ref, seen, depth) {
+        const hoisted = this.#refs.get(ref);
+        if (hoisted !== undefined)
+            return { $ref: `#/components/schemas/${hoisted}` };
+        // Not a `$defs` entry: resolve and inline. A pointer into `properties` is
+        // legal JSON Schema and rare, but inlining beats emitting a `$ref` that
+        // points nowhere in the published document.
+        if (seen.has(ref)) {
+            this.#opts.diagnostics.push({
+                severity: 'warning',
+                code: 'ZEN_OAS_REF_CYCLE',
+                message: `Circular $ref "${ref}" outside $defs; the document inlines it as an unconstrained schema.`,
+                where: this.#opts.where,
+                hint: 'Move the recursive schema into $defs so it can be hoisted into components.schemas.',
+            });
+            return {};
+        }
+        const target = resolveRef(this.#root, ref);
+        if (target === null) {
+            this.#opts.diagnostics.push({
+                severity: 'warning',
+                code: 'ZEN_OAS_REF_UNRESOLVED',
+                message: `Unresolvable $ref "${ref}"; the document describes this position as unconstrained.`,
+                where: this.#opts.where,
+                hint: 'Only same-document refs are supported (#/$defs/Name, #/definitions/Name).',
+            });
+            return {};
+        }
+        return this.walk(target, new Set([...seen, ref]), depth);
+    }
+}
+/** Mirrors `Builder#byType`/`#inferShape`: when does the IR build an object node? */
+export function isObjectShape(node) {
+    const declared = node.type;
+    const types = declared === undefined ? [] : Array.isArray(declared) ? declared : [declared];
+    if (types.includes('object'))
+        return true;
+    if (types.filter((t) => t !== 'null').length > 0)
+        return false;
+    return node.properties !== undefined || node.required !== undefined || node.additionalProperties !== undefined;
+}
+/** A component name to suggest for a schema that carries one. */
+export function declaredName(schema) {
+    const id = schema['$id'];
+    if (typeof id === 'string' && id.length > 0) {
+        const tail = id.split('/').pop();
+        if (tail !== undefined && tail.length > 0)
+            return tail.replace(/\.json$/, '');
+    }
+    const title = schema.title;
+    return typeof title === 'string' && title.length > 0 ? title : null;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,154 @@
+import type { JsonSchema } from '@erenthedeveloper0/zen-core';
+/**
+ * OpenAPI 3.1 document types — rfcs/0001 §29.
+ *
+ * 3.1 rather than 3.0 for one reason that matters here: 3.1's Schema Object *is*
+ * JSON Schema 2020-12, the same dialect the validation layer produces and the
+ * serializer IR consumes. Under 3.0 every schema would need lossy
+ * down-conversion (`nullable`, `exclusiveMinimum`, tuples, `const`) — which is
+ * precisely the silent drift this subsystem exists to prevent.
+ *
+ * Only the parts Zen emits are typed. A partial-but-honest type is more useful
+ * than a complete one nobody reads, and `[extension: string]` keeps `x-` fields
+ * legal without pretending to enumerate them.
+ */
+/** OAS 3.1 Schema Objects are JSON Schema 2020-12, so this is not an alias of convenience. */
+export type OpenApiSchema = JsonSchema;
+export interface OpenApiDocument {
+    readonly openapi: string;
+    readonly info: InfoObject;
+    readonly servers?: readonly ServerObject[] | undefined;
+    readonly paths: Readonly<Record<string, PathItemObject>>;
+    readonly components?: ComponentsObject | undefined;
+    readonly tags?: readonly TagObject[] | undefined;
+    readonly security?: readonly SecurityRequirement[] | undefined;
+    readonly externalDocs?: ExternalDocs | undefined;
+    readonly [extension: string]: unknown;
+}
+export interface InfoObject {
+    readonly title: string;
+    readonly version: string;
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly license?: {
+        readonly name: string;
+        readonly identifier?: string;
+        readonly url?: string;
+    } | undefined;
+    readonly contact?: {
+        readonly name?: string;
+        readonly url?: string;
+        readonly email?: string;
+    } | undefined;
+}
+export interface ServerObject {
+    readonly url: string;
+    readonly description?: string | undefined;
+    readonly variables?: Readonly<Record<string, {
+        readonly default: string;
+        readonly enum?: readonly string[];
+        readonly description?: string;
+    }>> | undefined;
+}
+export interface TagObject {
+    readonly name: string;
+    readonly description?: string | undefined;
+    readonly externalDocs?: ExternalDocs | undefined;
+}
+export interface ExternalDocs {
+    readonly url: string;
+    readonly description?: string | undefined;
+}
+export type HttpOperation = 'get' | 'put' | 'post' | 'delete' | 'options' | 'head' | 'patch' | 'trace';
+export type PathItemObject = {
+    readonly [M in HttpOperation]?: OperationObject;
+} & {
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly parameters?: readonly ParameterObject[] | undefined;
+};
+export interface OperationObject {
+    readonly operationId: string;
+    readonly summary?: string | undefined;
+    readonly description?: string | undefined;
+    readonly tags?: readonly string[] | undefined;
+    readonly deprecated?: boolean | undefined;
+    readonly parameters?: readonly ParameterObject[] | undefined;
+    readonly requestBody?: RequestBodyObject | undefined;
+    readonly responses: Readonly<Record<string, ResponseObject>>;
+    readonly security?: readonly SecurityRequirement[] | undefined;
+    readonly externalDocs?: ExternalDocs | undefined;
+    readonly [extension: string]: unknown;
+}
+export type ParameterLocation = 'path' | 'query' | 'header' | 'cookie';
+export interface ParameterObject {
+    readonly name: string;
+    readonly in: ParameterLocation;
+    readonly required?: boolean | undefined;
+    readonly description?: string | undefined;
+    readonly deprecated?: boolean | undefined;
+    readonly schema: OpenApiSchema;
+    readonly [extension: string]: unknown;
+}
+export interface RequestBodyObject {
+    readonly required?: boolean | undefined;
+    readonly description?: string | undefined;
+    readonly content: Readonly<Record<string, MediaTypeObject>>;
+}
+export interface ResponseObject {
+    readonly description: string;
+    readonly content?: Readonly<Record<string, MediaTypeObject>> | undefined;
+    readonly headers?: Readonly<Record<string, HeaderObject>> | undefined;
+}
+export interface HeaderObject {
+    readonly description?: string | undefined;
+    readonly required?: boolean | undefined;
+    readonly schema: OpenApiSchema;
+}
+export interface MediaTypeObject {
+    readonly schema: OpenApiSchema;
+    readonly example?: unknown;
+}
+export interface ComponentsObject {
+    readonly schemas?: Readonly<Record<string, OpenApiSchema>> | undefined;
+    readonly securitySchemes?: Readonly<Record<string, SecurityScheme>> | undefined;
+}
+export type SecurityRequirement = Readonly<Record<string, readonly string[]>>;
+export interface SecurityScheme {
+    readonly type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect' | 'mutualTLS';
+    readonly description?: string | undefined;
+    readonly name?: string | undefined;
+    readonly in?: 'query' | 'header' | 'cookie' | undefined;
+    readonly scheme?: string | undefined;
+    readonly bearerFormat?: string | undefined;
+    readonly openIdConnectUrl?: string | undefined;
+    readonly flows?: Readonly<Record<string, unknown>> | undefined;
+}
+/**
+ * Route metadata this generator reads — rfcs/0001 §5.1.
+ *
+ * `meta` is a free-form map on purpose, but a generator that reads undocumented
+ * keys is a generator nobody can predict. These are the keys, and they are the
+ * whole list:
+ *
+ * ```ts
+ * app.get('/users/:id<int>', {
+ *   name: 'users.show',
+ *   meta: { summary: 'Fetch one user', tags: ['users'], deprecated: true },
+ *   response: { 200: PublicUser },
+ * }, handler)
+ * ```
+ */
+export interface RouteDocMeta {
+    readonly summary?: string;
+    readonly description?: string;
+    readonly tags?: readonly string[];
+    readonly operationId?: string;
+    readonly deprecated?: boolean;
+    /** Excluded from the document entirely. The docs endpoints set this on themselves. */
+    readonly hidden?: boolean;
+    readonly security?: readonly SecurityRequirement[];
+    readonly externalDocs?: ExternalDocs;
+}
+export declare const DOC_META_KEYS: readonly ["summary", "description", "tags", "operationId", "deprecated", "hidden", "security", "externalDocs"];
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAE7D;;;;;;;;;;;;GAYG;AAEH,8FAA8F;AAC9F,MAAM,MAAM,aAAa,GAAG,UAAU,CAAA;AAEtC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAA;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAChD,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC7G,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC1G;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;CAC1J;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1C;AAED,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEtG,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,CAAC,IAAI,aAAa,CAAC,CAAC,EAAE,eAAe;CAChD,GAAG;IACF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAA;CAC7D,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,CAAA;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAA;IACpD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,SAAS,CAAA;IAC9D,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IAChD,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;CACtC;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAA;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;CAC5D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAAG,SAAS,CAAA;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,SAAS,CAAA;CACtE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,GAAG,SAAS,CAAA;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,CAAA;CAChF;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;AAE7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,eAAe,GAAG,WAAW,CAAA;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;CAC/D;AAID;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CACrC;AAED,eAAO,MAAM,aAAa,gHAE0B,CAAA"}

package/dist/types.js

@@ -0,0 +1,4 @@
+export const DOC_META_KEYS = [
+    'summary', 'description', 'tags', 'operationId', 'deprecated', 'hidden', 'security', 'externalDocs',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmKA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,cAAc;CACjD,CAAA"}

package/dist/ui.d.ts

@@ -0,0 +1,19 @@
+import type { OpenApiDocument } from './types.ts';
+/**
+ * A self-contained API reference — rfcs/0001 §29.2.
+ *
+ * Scalar, Swagger UI and Redoc are all better-looking than this, and all three
+ * are normally wired in with a `<script src="https://cdn…">`. That is a fine
+ * default for a public docs site and a bad one for a framework: it makes an
+ * internal endpoint phone a third party on every page load, it breaks behind a
+ * strict CSP, it breaks in an air-gapped deployment, and it breaks on a laptop
+ * on a train. So the built-in viewer has **no external requests at all** — the
+ * document is inlined at boot and the page is HTML, CSS and ~90 lines of script.
+ *
+ * `ui: false` turns it off; serving Scalar or Redoc instead is a five-line route
+ * in application code, and the README shows it.
+ */
+export declare function renderReference(document: OpenApiDocument, options?: {
+    jsonPath: string | null;
+}): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,GAAE;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAuB,GAAG,MAAM,CA6B5H"}