@specglass/core 0.0.2

package/dist/openapi/transformer.js

@@ -0,0 +1,294 @@
+/**
+ * OpenAPI document transformer.
+ *
+ * Converts a raw (dereferenced) OpenAPI document into the typed
+ * `ParsedOpenApiSpec` data model. Each operation is transformed into
+ * an `ApiEndpoint`; failures on individual endpoints produce
+ * `ApiEndpointError` objects instead of aborting the entire spec (FR40).
+ *
+ * @module
+ */
+/** HTTP methods recognised in OpenAPI path items */
+const HTTP_METHODS = [
+    "get",
+    "post",
+    "put",
+    "delete",
+    "patch",
+    "options",
+    "head",
+    "trace",
+];
+/**
+ * Transform a raw dereferenced OpenAPI document into a `ParsedOpenApiSpec`.
+ *
+ * @param document - The parsed OpenAPI document from @redocly/openapi-core
+ * @returns Structured spec with endpoints, errors, security schemes, and servers
+ */
+export function transformSpec(document) {
+    const info = extractInfo(document);
+    const servers = extractServers(document);
+    const securitySchemes = extractSecuritySchemes(document);
+    const globalSecurity = extractSecurityRequirements(document.security, securitySchemes);
+    const endpoints = [];
+    const errors = [];
+    const paths = (document.paths ?? {});
+    for (const [path, pathItem] of Object.entries(paths)) {
+        // Path-level parameters apply to all operations on this path
+        const pathParams = extractParameters(pathItem.parameters);
+        for (const method of HTTP_METHODS) {
+            const operation = pathItem[method];
+            if (!operation)
+                continue;
+            try {
+                const endpoint = transformOperation(path, method, operation, pathParams, globalSecurity, securitySchemes);
+                endpoints.push(endpoint);
+            }
+            catch (error) {
+                errors.push({
+                    path,
+                    method,
+                    reason: error instanceof Error ? error.message : "Unknown transformation error",
+                    rawSpec: operation,
+                });
+            }
+        }
+    }
+    return { info, endpoints, errors, securitySchemes, servers };
+}
+// ─── Extraction helpers ──────────────────────────────────────────────
+function extractInfo(document) {
+    const info = (document.info ?? {});
+    return {
+        title: String(info.title ?? "Untitled API"),
+        version: String(info.version ?? "0.0.0"),
+        description: info.description ? String(info.description) : undefined,
+    };
+}
+function extractServers(document) {
+    const raw = document.servers;
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((s) => ({
+        url: String(s.url ?? ""),
+        description: s.description ? String(s.description) : undefined,
+    }));
+}
+function extractSecuritySchemes(document) {
+    const components = (document.components ?? {});
+    const raw = (components.securitySchemes ?? {});
+    const result = {};
+    for (const [name, scheme] of Object.entries(raw)) {
+        result[name] = {
+            schemeName: name,
+            scopes: [],
+            type: String(scheme.type ?? "apiKey"),
+            name: scheme.name ? String(scheme.name) : undefined,
+            in: scheme.in ? String(scheme.in) : undefined,
+            scheme: scheme.scheme ? String(scheme.scheme) : undefined,
+        };
+    }
+    return result;
+}
+function extractSecurityRequirements(security, schemes) {
+    if (!Array.isArray(security))
+        return [];
+    return security.flatMap((req) => Object.entries(req).map(([schemeName, scopes]) => ({
+        ...(schemes[schemeName] ?? {
+            schemeName,
+            type: "apiKey",
+        }),
+        schemeName,
+        scopes: scopes ?? [],
+    })));
+}
+// ─── Operation transformation ────────────────────────────────────────
+function transformOperation(path, method, operation, pathLevelParams, globalSecurity, securitySchemes) {
+    // Merge path-level and operation-level parameters.
+    // Operation-level params override path-level params with the same name+in.
+    const operationParams = extractParameters(operation.parameters);
+    const mergedParams = mergeParameters(pathLevelParams, operationParams);
+    // Security: operation-level overrides global
+    const security = operation.security
+        ? extractSecurityRequirements(operation.security, securitySchemes)
+        : globalSecurity;
+    return {
+        method: method.toUpperCase(),
+        path,
+        operationId: operation.operationId
+            ? String(operation.operationId)
+            : undefined,
+        summary: operation.summary ? String(operation.summary) : undefined,
+        description: operation.description
+            ? String(operation.description)
+            : undefined,
+        tags: Array.isArray(operation.tags)
+            ? operation.tags.map(String)
+            : [],
+        deprecated: Boolean(operation.deprecated),
+        parameters: mergedParams,
+        requestBody: extractRequestBody(operation.requestBody),
+        responses: extractResponses(operation.responses),
+        security,
+    };
+}
+// ─── Parameter handling ──────────────────────────────────────────────
+function extractParameters(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((p) => {
+        const param = p;
+        return {
+            name: String(param.name ?? ""),
+            in: String(param.in ?? "query"),
+            required: Boolean(param.required),
+            description: param.description ? String(param.description) : undefined,
+            schema: extractSchema(param.schema),
+            example: param.example,
+        };
+    });
+}
+/**
+ * Merge path-level and operation-level parameters.
+ * Operation-level parameters override path-level ones with the same name+in.
+ */
+function mergeParameters(pathParams, operationParams) {
+    const merged = new Map();
+    // Path-level first
+    for (const p of pathParams) {
+        merged.set(`${p.in}:${p.name}`, p);
+    }
+    // Operation-level overrides
+    for (const p of operationParams) {
+        merged.set(`${p.in}:${p.name}`, p);
+    }
+    return Array.from(merged.values());
+}
+// ─── Request body ────────────────────────────────────────────────────
+function extractRequestBody(raw) {
+    if (!raw)
+        return undefined;
+    const content = {};
+    const rawContent = (raw.content ?? {});
+    for (const [mediaType, mediaSpec] of Object.entries(rawContent)) {
+        content[mediaType] = extractMediaType(mediaSpec);
+    }
+    return {
+        required: Boolean(raw.required),
+        description: raw.description ? String(raw.description) : undefined,
+        content,
+    };
+}
+function extractMediaType(raw) {
+    return {
+        schema: extractSchema(raw.schema),
+        example: raw.example,
+        examples: raw.examples
+            ? extractExamples(raw.examples)
+            : undefined,
+    };
+}
+function extractExamples(raw) {
+    const result = {};
+    for (const [name, example] of Object.entries(raw)) {
+        result[name] = {
+            summary: example.summary ? String(example.summary) : undefined,
+            description: example.description
+                ? String(example.description)
+                : undefined,
+            value: example.value,
+        };
+    }
+    return result;
+}
+// ─── Response handling ───────────────────────────────────────────────
+function extractResponses(raw) {
+    if (!raw)
+        return [];
+    return Object.entries(raw).map(([statusCode, response]) => {
+        const content = response.content
+            ? Object.fromEntries(Object.entries(response.content).map(([mediaType, mediaSpec]) => [
+                mediaType,
+                extractMediaType(mediaSpec),
+            ]))
+            : undefined;
+        // Extract response headers
+        const headers = response.headers
+            ? Object.fromEntries(Object.entries(response.headers).map(([headerName, headerSpec]) => [
+                headerName,
+                {
+                    name: headerName,
+                    in: "header",
+                    required: Boolean(headerSpec.required),
+                    description: headerSpec.description
+                        ? String(headerSpec.description)
+                        : undefined,
+                    schema: extractSchema(headerSpec.schema),
+                    example: headerSpec.example,
+                },
+            ]))
+            : undefined;
+        return {
+            statusCode,
+            description: String(response.description ?? ""),
+            content,
+            headers,
+        };
+    });
+}
+// ─── Schema extraction ──────────────────────────────────────────────
+function extractSchema(raw) {
+    if (!raw)
+        return {};
+    const schema = {};
+    if (raw.type)
+        schema.type = String(raw.type);
+    if (raw.format)
+        schema.format = String(raw.format);
+    if (raw.description)
+        schema.description = String(raw.description);
+    if (raw.nullable)
+        schema.nullable = Boolean(raw.nullable);
+    if (raw.$ref)
+        schema.ref = String(raw.$ref);
+    // Enum values
+    if (Array.isArray(raw.enum)) {
+        schema.enum = raw.enum;
+    }
+    // Required fields
+    if (Array.isArray(raw.required)) {
+        schema.required = raw.required.map(String);
+    }
+    // Nested properties
+    if (raw.properties && typeof raw.properties === "object") {
+        schema.properties = {};
+        for (const [key, value] of Object.entries(raw.properties)) {
+            schema.properties[key] = extractSchema(value);
+        }
+    }
+    // Array items
+    if (raw.items && typeof raw.items === "object") {
+        schema.items = extractSchema(raw.items);
+    }
+    // additionalProperties
+    if (raw.additionalProperties !== undefined) {
+        if (typeof raw.additionalProperties === "boolean") {
+            schema.additionalProperties = raw.additionalProperties;
+        }
+        else if (typeof raw.additionalProperties === "object") {
+            schema.additionalProperties = extractSchema(raw.additionalProperties);
+        }
+    }
+    // Composition keywords — preserve as arrays, do NOT deep merge
+    if (Array.isArray(raw.allOf)) {
+        schema.allOf = raw.allOf.map((s) => extractSchema(s));
+    }
+    if (Array.isArray(raw.oneOf)) {
+        schema.oneOf = raw.oneOf.map((s) => extractSchema(s));
+    }
+    if (Array.isArray(raw.anyOf)) {
+        schema.anyOf = raw.anyOf.map((s) => extractSchema(s));
+    }
+    return schema;
+}
+//# sourceMappingURL=transformer.js.map

package/dist/openapi/transformer.js.map

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

package/dist/openapi/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * TypeScript types for the parsed OpenAPI specification data model.
+ *
+ * These types define the intermediate representation between the raw
+ * OpenAPI document (parsed by @redocly/openapi-core) and the final
+ * content entries consumed by the Astro Content Layer and theme components.
+ *
+ * @module
+ */
+/** JSON Schema subset used for parameter, request body, and response schemas */
+export interface ApiSchema {
+    type?: string;
+    format?: string;
+    properties?: Record<string, ApiSchema>;
+    items?: ApiSchema;
+    required?: string[];
+    enum?: unknown[];
+    description?: string;
+    /** Original $ref path, preserved for display (e.g., "#/components/schemas/Pet") */
+    ref?: string;
+    allOf?: ApiSchema[];
+    oneOf?: ApiSchema[];
+    anyOf?: ApiSchema[];
+    nullable?: boolean;
+    additionalProperties?: boolean | ApiSchema;
+}
+/** An example value associated with a media type */
+export interface ApiExample {
+    summary?: string;
+    description?: string;
+    value: unknown;
+}
+/** A single media type entry (e.g., application/json) in a request body or response */
+export interface ApiMediaType {
+    schema: ApiSchema;
+    example?: unknown;
+    examples?: Record<string, ApiExample>;
+}
+/** An API endpoint parameter (path, query, header, or cookie) */
+export interface ApiParameter {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    required: boolean;
+    description?: string;
+    schema: ApiSchema;
+    example?: unknown;
+}
+/** Request body definition for an API endpoint */
+export interface ApiRequestBody {
+    required: boolean;
+    description?: string;
+    content: Record<string, ApiMediaType>;
+}
+/** A single HTTP response definition */
+export interface ApiResponse {
+    statusCode: string;
+    description: string;
+    content?: Record<string, ApiMediaType>;
+    headers?: Record<string, ApiParameter>;
+}
+/** A security requirement referencing a security scheme */
+export interface ApiSecurityRequirement {
+    schemeName: string;
+    scopes: string[];
+    type: "apiKey" | "http" | "oauth2" | "openIdConnect";
+    name?: string;
+    in?: string;
+    scheme?: string;
+}
+/** A single API endpoint (one HTTP method on one path) */
+export interface ApiEndpoint {
+    method: string;
+    path: string;
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags: string[];
+    deprecated: boolean;
+    parameters: ApiParameter[];
+    requestBody?: ApiRequestBody;
+    responses: ApiResponse[];
+    security: ApiSecurityRequirement[];
+}
+/**
+ * Per-endpoint error produced during transformation.
+ * Allows graceful fallback: the rest of the spec is still usable (FR40).
+ */
+export interface ApiEndpointError {
+    path: string;
+    method: string;
+    reason: string;
+    rawSpec: unknown;
+}
+/** The fully parsed and transformed OpenAPI specification */
+export interface ParsedOpenApiSpec {
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+    };
+    endpoints: ApiEndpoint[];
+    errors: ApiEndpointError[];
+    securitySchemes: Record<string, ApiSecurityRequirement>;
+    servers: Array<{
+        url: string;
+        description?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/openapi/types.d.ts.map

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

package/dist/openapi/types.js

@@ -0,0 +1,11 @@
+/**
+ * TypeScript types for the parsed OpenAPI specification data model.
+ *
+ * These types define the intermediate representation between the raw
+ * OpenAPI document (parsed by @redocly/openapi-core) and the final
+ * content entries consumed by the Astro Content Layer and theme components.
+ *
+ * @module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/openapi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/openapi/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/openapi/utils.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared OpenAPI utilities for route/slug generation.
+ *
+ * Used by the API reference route page and theme navigation component
+ * to ensure consistent URL generation.
+ *
+ * @module
+ */
+import type { ApiEndpoint } from "./types.js";
+/**
+ * Build a URL-friendly slug for an API endpoint.
+ *
+ * Format: `{tag}/{method}-{sanitized-path}`
+ *
+ * @example
+ * buildEndpointSlug({ method: "get", path: "/pets/{petId}", tags: ["pets"] })
+ * // → "pets/get-pets-petId"
+ */
+export declare function buildEndpointSlug(endpoint: ApiEndpoint): string;
+/**
+ * Build a unique identifier for an endpoint (used for active-state matching).
+ *
+ * Format: `{method}-{path}`
+ */
+export declare function buildEndpointId(endpoint: ApiEndpoint): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/openapi/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/openapi/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAE7D"}

package/dist/openapi/utils.js

@@ -0,0 +1,34 @@
+/**
+ * Shared OpenAPI utilities for route/slug generation.
+ *
+ * Used by the API reference route page and theme navigation component
+ * to ensure consistent URL generation.
+ *
+ * @module
+ */
+/**
+ * Build a URL-friendly slug for an API endpoint.
+ *
+ * Format: `{tag}/{method}-{sanitized-path}`
+ *
+ * @example
+ * buildEndpointSlug({ method: "get", path: "/pets/{petId}", tags: ["pets"] })
+ * // → "pets/get-pets-petId"
+ */
+export function buildEndpointSlug(endpoint) {
+    const tag = endpoint.tags?.[0] ?? "default";
+    const sanitizedPath = endpoint.path
+        .replace(/^\//, "")
+        .replace(/\//g, "-")
+        .replace(/[{}]/g, "");
+    return `${tag}/${endpoint.method}-${sanitizedPath}`;
+}
+/**
+ * Build a unique identifier for an endpoint (used for active-state matching).
+ *
+ * Format: `{method}-{path}`
+ */
+export function buildEndpointId(endpoint) {
+    return `${endpoint.method}-${endpoint.path}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/openapi/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/openapi/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI;SAChC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACxB,OAAO,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,aAAa,EAAE,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAqB;IACnD,OAAO,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC"}

package/dist/types/config.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import { configSchema } from "../config/schema.js";
+/** Fully resolved specglass configuration object. */
+export type SpecglassConfig = z.infer<typeof configSchema>;
+/** Deep partial version of SpecglassConfig for user input to defineConfig. */
+export type SpecglassUserConfig = z.input<typeof configSchema>;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,qDAAqD;AACrD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAE3D,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/navigation.d.ts

@@ -0,0 +1,62 @@
+/**
+ * A single navigation item in the sidebar tree.
+ *
+ * - `"page"` — a content page (MDX/MD file)
+ * - `"section"` — a directory containing child items
+ * - `"external-link"` — an external URL defined in `_meta.json`
+ */
+export interface NavItem {
+    /** Display title for the sidebar */
+    title: string;
+    /** URL slug (relative path from content root, without extension) */
+    slug: string;
+    /** Discriminator for the item kind */
+    type: "page" | "section" | "external-link";
+    /** Child items (only meaningful for sections) */
+    children?: NavItem[];
+    /** Whether the section is collapsed by default */
+    collapsed?: boolean;
+    /** Optional icon (emoji or symbol) */
+    icon?: string;
+    /** External URL (only for type "external-link") */
+    href?: string;
+    /** If true, item is excluded from the rendered tree */
+    hidden?: boolean;
+}
+/**
+ * The complete sidebar navigation tree.
+ */
+export interface NavigationTree {
+    items: NavItem[];
+}
+/**
+ * Raw entry parsed from a `_meta.json` file.
+ *
+ * String values are shorthand for `{ title: "value" }`.
+ * Object values support extended configuration.
+ */
+export type MetaJsonEntryValue = string | {
+    title: string;
+    collapsed?: boolean;
+    icon?: string;
+    href?: string;
+    hidden?: boolean;
+};
+/**
+ * A single parsed entry from `_meta.json`, preserving key order.
+ */
+export interface MetaJsonEntry {
+    /** Filename without extension (the JSON key) */
+    key: string;
+    /** Resolved title */
+    title: string;
+    /** Whether this section is collapsed by default */
+    collapsed?: boolean;
+    /** Optional icon */
+    icon?: string;
+    /** External link URL */
+    href?: string;
+    /** Whether to hide from navigation */
+    hidden?: boolean;
+}
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/types/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC;IAC3C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN;IACE,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/navigation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=navigation.js.map

package/dist/types/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/types/navigation.ts"],"names":[],"mappings":""}

package/dist/virtual/modules.d.ts

@@ -0,0 +1,34 @@
+import type { SpecglassConfig } from "../types/config.js";
+import type { NavigationTree } from "../types/navigation.js";
+import type { ParsedOpenApiSpec } from "../openapi/types.js";
+/** Identifier for the specglass config virtual module */
+export declare const VIRTUAL_MODULE_ID = "virtual:specglass/config";
+/** Identifier for the specglass navigation virtual module */
+export declare const NAVIGATION_MODULE_ID = "virtual:specglass/navigation";
+/** Identifier for the specglass OpenAPI data virtual module */
+export declare const OPENAPI_DATA_MODULE_ID = "virtual:specglass/openapi-data";
+/**
+ * Generate the JavaScript module content for `virtual:specglass/config`.
+ * Serializes the resolved config object into an exportable module string.
+ *
+ * @param config - The fully resolved and validated SpecglassConfig
+ * @returns JavaScript module source code exporting `config`
+ */
+export declare function generateConfigModuleContent(config: SpecglassConfig): string;
+/**
+ * Generate the JavaScript module content for `virtual:specglass/navigation`.
+ *
+ * @param tree - The computed navigation tree to serialize into the virtual module.
+ *              Defaults to an empty tree if not provided.
+ * @returns JavaScript module source code exporting `navigation`
+ */
+export declare function generateNavigationModuleContent(tree?: NavigationTree): string;
+/**
+ * Generate the JavaScript module content for `virtual:specglass/openapi-data`.
+ *
+ * @param data - Array of parsed OpenAPI specs to serialize.
+ *              Defaults to an empty array if not provided.
+ * @returns JavaScript module source code exporting `openApiData`
+ */
+export declare function generateOpenApiDataModuleContent(data?: ParsedOpenApiSpec[]): string;
+//# sourceMappingURL=modules.d.ts.map

package/dist/virtual/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../src/virtual/modules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAEnE,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,mCAAmC,CAAC;AAGvE;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,GAAE,cAA8B,GACnC,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,IAAI,GAAE,iBAAiB,EAAO,GAC7B,MAAM,CAER"}