sourcey 2.0.2

package/dist/core/navigation.d.ts

@@ -0,0 +1,51 @@
+import type { NormalizedSpec } from "./types.js";
+import type { NavigationTab } from "../config.js";
+import type { MarkdownPage } from "./markdown-loader.js";
+export interface SiteNavigation {
+    tabs: SiteTab[];
+    activeTabSlug: string;
+    activePageSlug: string;
+}
+export interface SiteTab {
+    label: string;
+    slug: string;
+    /** Relative URL to this tab's first page (from site root) */
+    href: string;
+    kind: "spec" | "docs";
+    groups: SiteNavGroup[];
+}
+export interface SiteNavGroup {
+    label: string;
+    items: SiteNavItem[];
+}
+export interface SiteNavItem {
+    label: string;
+    /** Relative URL to this item (from site root) */
+    href: string;
+    /** Unique ID for active-state matching */
+    id: string;
+    /** HTTP method for OpenAPI operations (colored dot in sidebar) */
+    method?: string;
+}
+/**
+ * Build a navigation tab from an OpenAPI spec.
+ * Extracts the same structure currently hardcoded in Sidebar.tsx:
+ * Introduction + Authentication → tag groups with operations → Models.
+ * All hrefs are #anchor links (single-page spec rendering).
+ */
+export declare function buildNavFromSpec(spec: NormalizedSpec, tabSlug: string): SiteTab;
+/**
+ * Build a navigation tab from markdown pages.
+ * Groups come from the config; items come from loaded page data.
+ */
+export declare function buildNavFromPages(tabConfig: NavigationTab, pagesByPath: Map<string, MarkdownPage>): SiteTab;
+/**
+ * Assemble a SiteNavigation from a list of tabs.
+ * Defaults to the first tab and first page as active.
+ */
+export declare function buildSiteNavigation(tabs: SiteTab[]): SiteNavigation;
+/**
+ * Create a copy of the navigation with a specific page marked as active.
+ */
+export declare function withActivePage(nav: SiteNavigation, tabSlug: string, pageSlug: string): SiteNavigation;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/core/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/core/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,GACd,OAAO,CA+CT;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,OAAO,CA8BT;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,CASnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,cAAc,CAEhB"}

package/dist/core/navigation.js

@@ -0,0 +1,108 @@
+import { htmlId } from "../utils/html-id.js";
+// ---------------------------------------------------------------------------
+// Builders
+// ---------------------------------------------------------------------------
+/**
+ * Build a navigation tab from an OpenAPI spec.
+ * Extracts the same structure currently hardcoded in Sidebar.tsx:
+ * Introduction + Authentication → tag groups with operations → Models.
+ * All hrefs are #anchor links (single-page spec rendering).
+ */
+export function buildNavFromSpec(spec, tabSlug) {
+    const basePath = `${tabSlug}/index.html`;
+    const groups = [];
+    // Intro group
+    const introItems = [
+        { label: "Introduction", href: `${basePath}#introduction`, id: "introduction" },
+    ];
+    if (Object.keys(spec.securitySchemes).length > 0) {
+        introItems.push({
+            label: "Authentication",
+            href: `${basePath}#authentication`,
+            id: "authentication",
+        });
+    }
+    groups.push({ label: "", items: introItems });
+    // Tag groups with operations
+    for (const tag of spec.tags) {
+        if (tag.hidden)
+            continue;
+        const items = tag.operations.map((op) => ({
+            label: op.summary ?? `${op.method.toUpperCase()} ${op.path}`,
+            href: `${basePath}#operation-${htmlId(op.path)}-${htmlId(op.method)}`,
+            id: `operation-${htmlId(op.path)}-${htmlId(op.method)}`,
+            method: op.method,
+        }));
+        groups.push({ label: tag.name, items });
+    }
+    // Models group
+    const schemaNames = Object.keys(spec.schemas);
+    if (schemaNames.length > 0) {
+        const items = schemaNames.map((name) => ({
+            label: name,
+            href: `${basePath}#definition-${htmlId(name)}`,
+            id: `definition-${htmlId(name)}`,
+        }));
+        groups.push({ label: "Models", items });
+    }
+    return {
+        label: tabSlug,
+        slug: tabSlug,
+        href: basePath,
+        kind: "spec",
+        groups,
+    };
+}
+/**
+ * Build a navigation tab from markdown pages.
+ * Groups come from the config; items come from loaded page data.
+ */
+export function buildNavFromPages(tabConfig, pagesByPath) {
+    const groups = [];
+    if (tabConfig.groups) {
+        for (const groupConfig of tabConfig.groups) {
+            const items = [];
+            for (const pagePath of groupConfig.pages) {
+                const page = pagesByPath.get(pagePath);
+                if (!page)
+                    continue;
+                items.push({
+                    label: page.title,
+                    href: `${tabConfig.slug}/${page.slug}.html`,
+                    id: page.slug,
+                });
+            }
+            groups.push({ label: groupConfig.label, items });
+        }
+    }
+    // First page href for tab link
+    const firstItem = groups[0]?.items[0];
+    const href = firstItem?.href ?? `${tabConfig.slug}/`;
+    return {
+        label: tabConfig.label,
+        slug: tabConfig.slug,
+        href,
+        kind: "docs",
+        groups,
+    };
+}
+/**
+ * Assemble a SiteNavigation from a list of tabs.
+ * Defaults to the first tab and first page as active.
+ */
+export function buildSiteNavigation(tabs) {
+    const firstTab = tabs[0];
+    const firstItem = firstTab?.groups[0]?.items[0];
+    return {
+        tabs,
+        activeTabSlug: firstTab?.slug ?? "",
+        activePageSlug: firstItem?.id ?? "",
+    };
+}
+/**
+ * Create a copy of the navigation with a specific page marked as active.
+ */
+export function withActivePage(nav, tabSlug, pageSlug) {
+    return { ...nav, activeTabSlug: tabSlug, activePageSlug: pageSlug };
+}
+//# sourceMappingURL=navigation.js.map

package/dist/core/navigation.js.map

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

package/dist/core/normalizer.d.ts

@@ -0,0 +1,7 @@
+import type { ParsedSpec, NormalizedSpec } from "./types.js";
+/**
+ * Transform a fully dereferenced OpenAPI 3.x document into a NormalizedSpec.
+ * This is the single point where spec-format-specific logic lives.
+ */
+export declare function normalizeSpec(parsed: ParsedSpec): NormalizedSpec;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/core/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../src/core/normalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,UAAU,EACV,cAAc,EAqBf,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAoBhE"}

package/dist/core/normalizer.js

@@ -0,0 +1,472 @@
+const HTTP_METHODS = [
+    "get", "post", "put", "delete", "patch", "options", "head", "trace",
+];
+/**
+ * Transform a fully dereferenced OpenAPI 3.x document into a NormalizedSpec.
+ * This is the single point where spec-format-specific logic lives.
+ */
+export function normalizeSpec(parsed) {
+    const doc = parsed.document;
+    const schemas = normalizeSchemas(doc.components?.schemas);
+    const securitySchemes = normalizeSecuritySchemes(doc.components?.securitySchemes);
+    const servers = normalizeServers(doc.servers);
+    const operations = normalizeOperations(doc.paths, doc.security);
+    const webhooks = normalizeWebhooks(doc.webhooks);
+    const tags = normalizeTags(doc.tags, operations);
+    return {
+        info: normalizeInfo(doc),
+        servers,
+        tags,
+        operations,
+        schemas,
+        securitySchemes,
+        webhooks,
+        externalDocs: normalizeExternalDocs(doc.externalDocs),
+    };
+}
+// ── Info ───────────────────────────────────────────────────────────
+function normalizeInfo(doc) {
+    const info = doc.info ?? {};
+    return {
+        title: str(info.title, "Untitled API"),
+        version: str(info.version, "0.0.0"),
+        description: optStr(info.description),
+        termsOfService: optStr(info.termsOfService),
+        contact: info.contact
+            ? {
+                name: optStr(info.contact.name),
+                url: optStr(info.contact.url),
+                email: optStr(info.contact.email),
+            }
+            : undefined,
+        license: info.license
+            ? {
+                name: str(info.license.name, ""),
+                url: optStr(info.license.url),
+                identifier: optStr(info.license.identifier),
+            }
+            : undefined,
+        logo: optStr(info["x-logo"]),
+    };
+}
+// ── Servers ────────────────────────────────────────────────────────
+function normalizeServers(servers) {
+    if (!servers?.length)
+        return [{ url: "/" }];
+    return servers.map((s) => ({
+        url: str(s.url, "/"),
+        description: optStr(s.description),
+        variables: s.variables
+            ? normalizeServerVariables(s.variables)
+            : undefined,
+    }));
+}
+function normalizeServerVariables(vars) {
+    const result = {};
+    for (const [key, v] of Object.entries(vars)) {
+        result[key] = {
+            default: str(v.default, ""),
+            description: optStr(v.description),
+            enum: Array.isArray(v.enum) ? v.enum.map(String) : undefined,
+        };
+    }
+    return result;
+}
+// ── Tags ───────────────────────────────────────────────────────────
+function normalizeTags(rawTags, operations) {
+    // Build a map of defined tags
+    const tagMap = new Map();
+    if (rawTags) {
+        for (const t of rawTags) {
+            const name = str(t.name, "");
+            if (name) {
+                tagMap.set(name, {
+                    name,
+                    description: optStr(t.description),
+                    externalDocs: normalizeExternalDocs(t.externalDocs),
+                    operations: [],
+                    hidden: t["x-sourcey-hide"] === true,
+                });
+            }
+        }
+    }
+    // Assign operations to tags, creating implicit tags as needed
+    for (const op of operations) {
+        if (op.hidden)
+            continue;
+        const opTags = op.tags.length > 0 ? op.tags : ["default"];
+        for (const tagName of opTags) {
+            if (!tagMap.has(tagName)) {
+                // Implicit tag creation (legacy behavior from preprocessor.js)
+                tagMap.set(tagName, {
+                    name: tagName,
+                    operations: [],
+                });
+            }
+            tagMap.get(tagName).operations.push(op);
+        }
+    }
+    // Filter out tags with no operations (unless they have a description)
+    return Array.from(tagMap.values()).filter((t) => t.operations.length > 0 || t.description);
+}
+// ── Operations ─────────────────────────────────────────────────────
+function normalizeOperations(paths, globalSecurity) {
+    if (!paths)
+        return [];
+    const operations = [];
+    for (const [path, pathItem] of Object.entries(paths)) {
+        const pathParams = normalizeParameters(pathItem.parameters);
+        for (const method of HTTP_METHODS) {
+            const opRaw = pathItem[method];
+            if (!opRaw)
+                continue;
+            const opParams = normalizeParameters(opRaw.parameters);
+            // Merge path-level + operation-level params, deduping by name+in
+            const mergedParams = deduplicateParameters([...pathParams, ...opParams]);
+            const op = {
+                operationId: optStr(opRaw.operationId),
+                summary: optStr(opRaw.summary),
+                description: optStr(opRaw.description),
+                method,
+                path,
+                tags: Array.isArray(opRaw.tags) ? opRaw.tags.map(String) : [],
+                parameters: mergedParams,
+                requestBody: normalizeRequestBody(opRaw.requestBody),
+                responses: normalizeResponses(opRaw.responses),
+                security: normalizeSecurityRequirements(opRaw.security, globalSecurity),
+                deprecated: opRaw.deprecated === true,
+                servers: opRaw.servers
+                    ? normalizeServers(opRaw.servers)
+                    : undefined,
+                externalDocs: normalizeExternalDocs(opRaw.externalDocs),
+                callbacks: normalizeCallbacks(opRaw.callbacks),
+                hidden: opRaw["x-sourcey-hide"] === true,
+                codeSamples: normalizeCodeSamples(opRaw["x-sourcey-code-samples"], opRaw["x-code-samples"]),
+            };
+            operations.push(op);
+        }
+    }
+    return operations;
+}
+/**
+ * Deduplicate parameters by (name, in) — operation-level params
+ * override path-level params with the same identity.
+ */
+function deduplicateParameters(params) {
+    const seen = new Map();
+    // Process in order: path-level first, then operation-level.
+    // Later entries (operation-level) override earlier ones (path-level).
+    for (const p of params) {
+        seen.set(`${p.in}:${p.name}`, p);
+    }
+    return Array.from(seen.values());
+}
+function normalizeParameters(params) {
+    if (!params)
+        return [];
+    return params.map((p) => ({
+        name: str(p.name, ""),
+        in: str(p.in, "query"),
+        description: optStr(p.description),
+        required: p.required === true,
+        deprecated: p.deprecated === true,
+        schema: p.schema
+            ? normalizeSchema(p.schema)
+            : undefined,
+        example: p.example,
+        examples: p.examples
+            ? normalizeExamples(p.examples)
+            : undefined,
+    }));
+}
+function normalizeRequestBody(body) {
+    if (!body)
+        return undefined;
+    return {
+        description: optStr(body.description),
+        required: body.required === true,
+        content: normalizeContent(body.content),
+    };
+}
+function normalizeContent(content) {
+    if (!content)
+        return {};
+    const result = {};
+    for (const [mediaType, value] of Object.entries(content)) {
+        result[mediaType] = {
+            schema: value.schema
+                ? normalizeSchema(value.schema)
+                : undefined,
+            example: value.example,
+            examples: value.examples
+                ? normalizeExamples(value.examples)
+                : undefined,
+        };
+    }
+    return result;
+}
+function normalizeResponses(responses) {
+    if (!responses)
+        return [];
+    return Object.entries(responses).map(([statusCode, r]) => ({
+        statusCode,
+        description: str(r.description, ""),
+        content: r.content
+            ? normalizeContent(r.content)
+            : undefined,
+        headers: r.headers
+            ? normalizeResponseHeaders(r.headers)
+            : undefined,
+        links: r.links
+            ? normalizeLinks(r.links)
+            : undefined,
+    }));
+}
+function normalizeResponseHeaders(headers) {
+    const result = {};
+    for (const [name, h] of Object.entries(headers)) {
+        result[name] = {
+            name,
+            in: "header",
+            description: optStr(h.description),
+            required: h.required === true,
+            deprecated: h.deprecated === true,
+            schema: h.schema
+                ? normalizeSchema(h.schema)
+                : undefined,
+        };
+    }
+    return result;
+}
+function normalizeLinks(links) {
+    const result = {};
+    for (const [name, l] of Object.entries(links)) {
+        result[name] = {
+            operationId: optStr(l.operationId),
+            operationRef: optStr(l.operationRef),
+            description: optStr(l.description),
+            parameters: l.parameters,
+            requestBody: l.requestBody,
+            server: l.server
+                ? normalizeServers([l.server])[0]
+                : undefined,
+        };
+    }
+    return result;
+}
+function normalizeCallbacks(callbacks) {
+    if (!callbacks)
+        return undefined;
+    const result = {};
+    for (const [expression, pathItem] of Object.entries(callbacks)) {
+        result[expression] = {
+            expression,
+            operations: normalizeOperations({ [expression]: pathItem }),
+        };
+    }
+    return result;
+}
+function normalizeSecurityRequirements(opSecurity, globalSecurity) {
+    // Operation security overrides global
+    return (opSecurity ?? globalSecurity ?? []);
+}
+function normalizeCodeSamples(sourceySamples, genericSamples) {
+    const samples = sourceySamples ?? genericSamples;
+    if (!samples?.length)
+        return undefined;
+    return samples.map((s) => ({
+        lang: str(s.lang, "text"),
+        label: optStr(s.label),
+        source: str(s.source, ""),
+    }));
+}
+// ── Schemas ────────────────────────────────────────────────────────
+function normalizeSchemas(schemas) {
+    if (!schemas)
+        return {};
+    const result = {};
+    for (const [name, s] of Object.entries(schemas)) {
+        result[name] = normalizeSchema(s, name);
+    }
+    return result;
+}
+function normalizeSchema(schema, name) {
+    // Handle nullable: OpenAPI 3.0 uses x-nullable or nullable,
+    // OpenAPI 3.1 uses type: ["string", "null"]
+    let type = schema.type;
+    let nullable = schema.nullable === true || schema["x-nullable"] === true;
+    if (Array.isArray(type)) {
+        const nonNullTypes = type.filter((t) => t !== "null");
+        if (nonNullTypes.length < type.length) {
+            nullable = true;
+        }
+        type = nonNullTypes.length === 1 ? nonNullTypes[0] : nonNullTypes;
+    }
+    const result = {
+        name,
+        type,
+        format: optStr(schema.format),
+        title: optStr(schema.title),
+        description: optStr(schema.description),
+        default: schema.default,
+        enum: Array.isArray(schema.enum) ? schema.enum : undefined,
+        const: schema.const,
+        nullable,
+        readOnly: schema.readOnly === true,
+        writeOnly: schema.writeOnly === true,
+        deprecated: schema.deprecated === true,
+        example: schema.example,
+        examples: Array.isArray(schema.examples) ? schema.examples : undefined,
+        refName: optStr(schema["x-ref-name"]),
+    };
+    // Object properties
+    if (schema.properties) {
+        result.properties = {};
+        for (const [key, val] of Object.entries(schema.properties)) {
+            result.properties[key] = normalizeSchema(val);
+        }
+    }
+    if (schema.additionalProperties !== undefined) {
+        result.additionalProperties =
+            typeof schema.additionalProperties === "boolean"
+                ? schema.additionalProperties
+                : normalizeSchema(schema.additionalProperties);
+    }
+    if (Array.isArray(schema.required)) {
+        result.required = schema.required.map(String);
+    }
+    // Array items
+    if (schema.items) {
+        result.items = normalizeSchema(schema.items);
+    }
+    if (schema.minItems !== undefined)
+        result.minItems = Number(schema.minItems);
+    if (schema.maxItems !== undefined)
+        result.maxItems = Number(schema.maxItems);
+    if (schema.uniqueItems === true)
+        result.uniqueItems = true;
+    // Numeric constraints
+    if (schema.minimum !== undefined)
+        result.minimum = Number(schema.minimum);
+    if (schema.maximum !== undefined)
+        result.maximum = Number(schema.maximum);
+    if (schema.exclusiveMinimum !== undefined) {
+        result.exclusiveMinimum = schema.exclusiveMinimum;
+    }
+    if (schema.exclusiveMaximum !== undefined) {
+        result.exclusiveMaximum = schema.exclusiveMaximum;
+    }
+    if (schema.multipleOf !== undefined)
+        result.multipleOf = Number(schema.multipleOf);
+    // String constraints
+    if (schema.minLength !== undefined)
+        result.minLength = Number(schema.minLength);
+    if (schema.maxLength !== undefined)
+        result.maxLength = Number(schema.maxLength);
+    if (schema.pattern !== undefined)
+        result.pattern = String(schema.pattern);
+    // Composition
+    if (Array.isArray(schema.allOf)) {
+        result.allOf = schema.allOf.map((s) => normalizeSchema(s));
+    }
+    if (Array.isArray(schema.anyOf)) {
+        result.anyOf = schema.anyOf.map((s) => normalizeSchema(s));
+    }
+    if (Array.isArray(schema.oneOf)) {
+        result.oneOf = schema.oneOf.map((s) => normalizeSchema(s));
+    }
+    if (schema.not) {
+        result.not = normalizeSchema(schema.not);
+    }
+    if (schema.discriminator) {
+        const d = schema.discriminator;
+        result.discriminator = {
+            propertyName: str(d.propertyName, ""),
+            mapping: d.mapping,
+        };
+    }
+    // External docs
+    if (schema.externalDocs) {
+        result.externalDocs = normalizeExternalDocs(schema.externalDocs);
+    }
+    return result;
+}
+// ── Security Schemes ───────────────────────────────────────────────
+function normalizeSecuritySchemes(schemes) {
+    if (!schemes)
+        return {};
+    const result = {};
+    for (const [name, s] of Object.entries(schemes)) {
+        const raw = s;
+        result[name] = {
+            type: str(raw.type, "apiKey"),
+            name: optStr(raw.name),
+            description: optStr(raw.description),
+            in: optStr(raw.in),
+            scheme: optStr(raw.scheme),
+            bearerFormat: optStr(raw.bearerFormat),
+            flows: raw.flows
+                ? normalizeOAuthFlows(raw.flows)
+                : undefined,
+            openIdConnectUrl: optStr(raw.openIdConnectUrl),
+        };
+    }
+    return result;
+}
+function normalizeOAuthFlows(flows) {
+    const result = {};
+    for (const flowType of [
+        "implicit",
+        "password",
+        "clientCredentials",
+        "authorizationCode",
+    ]) {
+        if (flows[flowType]) {
+            result[flowType] = normalizeOAuthFlow(flows[flowType]);
+        }
+    }
+    return result;
+}
+function normalizeOAuthFlow(flow) {
+    return {
+        authorizationUrl: optStr(flow.authorizationUrl),
+        tokenUrl: optStr(flow.tokenUrl),
+        refreshUrl: optStr(flow.refreshUrl),
+        scopes: (flow.scopes ?? {}),
+    };
+}
+// ── Webhooks ───────────────────────────────────────────────────────
+function normalizeWebhooks(webhooks) {
+    if (!webhooks)
+        return [];
+    return normalizeOperations(webhooks);
+}
+// ── Shared ─────────────────────────────────────────────────────────
+function normalizeExternalDocs(docs) {
+    if (!docs?.url)
+        return undefined;
+    return {
+        url: str(docs.url, ""),
+        description: optStr(docs.description),
+    };
+}
+function normalizeExamples(examples) {
+    const result = {};
+    for (const [name, e] of Object.entries(examples)) {
+        result[name] = {
+            summary: optStr(e.summary),
+            description: optStr(e.description),
+            value: e.value,
+            externalValue: optStr(e.externalValue),
+        };
+    }
+    return result;
+}
+// ── Utility helpers ────────────────────────────────────────────────
+function str(value, fallback) {
+    return typeof value === "string" ? value : fallback;
+}
+function optStr(value) {
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=normalizer.js.map