raffel 0.1.2

package/dist/ui/core/registry.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Registry - Handler Registration
+ *
+ * Stores and retrieves handlers for procedures, streams, and events.
+ * Provides introspection for adapters to generate schemas/routes.
+ */
+import type { ProcedureHandler, StreamHandler, EventHandler, HandlerMeta, RegisteredHandler, Interceptor, DeliveryGuarantee, RetryPolicy, StreamDirection, GraphQLMeta, HttpMethod, JsonRpcMeta, GrpcMeta } from '../types/handlers.js';
+/**
+ * Procedure registration options
+ */
+export interface ProcedureOptions {
+    summary?: string;
+    description?: string;
+    /** Tags for OpenAPI grouping */
+    tags?: string[];
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    graphql?: GraphQLMeta;
+    httpPath?: string;
+    httpMethod?: HttpMethod;
+    jsonrpc?: JsonRpcMeta;
+    grpc?: GrpcMeta;
+    interceptors?: Interceptor[];
+}
+/**
+ * Stream registration options
+ */
+export interface StreamOptions {
+    description?: string;
+    direction?: StreamDirection;
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    interceptors?: Interceptor[];
+}
+/**
+ * Event registration options
+ */
+export interface EventOptions {
+    description?: string;
+    delivery?: DeliveryGuarantee;
+    retryPolicy?: RetryPolicy;
+    deduplicationWindow?: number;
+    /** Content type shorthand */
+    contentType?: string;
+    /** Content type configuration */
+    contentTypes?: {
+        default?: string;
+        supported?: string[];
+    };
+    interceptors?: Interceptor[];
+}
+/**
+ * Registry interface
+ */
+export interface Registry {
+    /** Register a procedure handler */
+    procedure<TInput, TOutput>(name: string, handler: ProcedureHandler<TInput, TOutput>, options?: ProcedureOptions): void;
+    /** Register a stream handler */
+    stream<TInput, TOutput>(name: string, handler: StreamHandler<TInput, TOutput>, options?: StreamOptions): void;
+    /** Register an event handler */
+    event<TPayload>(name: string, handler: EventHandler<TPayload>, options?: EventOptions): void;
+    /** Get a procedure handler by name */
+    getProcedure(name: string): RegisteredHandler<ProcedureHandler> | undefined;
+    /** Get a stream handler by name */
+    getStream(name: string): RegisteredHandler<StreamHandler> | undefined;
+    /** Get an event handler by name */
+    getEvent(name: string): RegisteredHandler<EventHandler> | undefined;
+    /** Check if a handler exists */
+    has(name: string): boolean;
+    /** List all registered handlers */
+    list(): HandlerMeta[];
+    /** List procedures only */
+    listProcedures(): HandlerMeta[];
+    /** List streams only */
+    listStreams(): HandlerMeta[];
+    /** List events only */
+    listEvents(): HandlerMeta[];
+}
+/**
+ * Create a new Registry
+ */
+export declare function createRegistry(): Registry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/ui/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,QAAQ,EACT,MAAM,sBAAsB,CAAA;AAE7B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IACzD,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IACzD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iCAAiC;IACjC,YAAY,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IACzD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IAGvB,mCAAmC;IACnC,SAAS,CAAC,MAAM,EAAE,OAAO,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAAA;IAEP,gCAAgC;IAChC,MAAM,CAAC,MAAM,EAAE,OAAO,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAAA;IAEP,gCAAgC;IAChC,KAAK,CAAC,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC/B,OAAO,CAAC,EAAE,YAAY,GACrB,IAAI,CAAA;IAIP,sCAAsC;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAAA;IAE3E,mCAAmC;IACnC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,aAAa,CAAC,GAAG,SAAS,CAAA;IAErE,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IAEnE,gCAAgC;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAI1B,mCAAmC;IACnC,IAAI,IAAI,WAAW,EAAE,CAAA;IAErB,2BAA2B;IAC3B,cAAc,IAAI,WAAW,EAAE,CAAA;IAE/B,wBAAwB;IACxB,WAAW,IAAI,WAAW,EAAE,CAAA;IAE5B,uBAAuB;IACvB,UAAU,IAAI,WAAW,EAAE,CAAA;CAC5B;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CA6HzC"}

package/dist/ui/core/router.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Router - Envelope Dispatch
+ *
+ * Routes incoming envelopes to the correct handler, executing
+ * interceptors in an onion model.
+ */
+import type { Envelope, Interceptor, RaffelStream } from '../types/index.js';
+import type { Registry } from './registry.js';
+import { type EventDeliveryOptions } from './event-delivery.js';
+/**
+ * Raffel error - thrown by handlers to signal known errors
+ *
+ * Contains both a string code (e.g., 'NOT_FOUND') and a numeric status (e.g., 404)
+ * for interoperability across protocols.
+ */
+export declare class RaffelError extends Error {
+    /** String error code (e.g., 'NOT_FOUND', 'VALIDATION_ERROR') */
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    /**
+     * Numeric status code (HTTP-compatible)
+     *
+     * - 400-499: Client errors
+     * - 500-599: Server errors
+     */
+    readonly status: number;
+    constructor(
+    /** String error code (e.g., 'NOT_FOUND', 'VALIDATION_ERROR') */
+    code: string, message: string, details?: unknown | undefined, 
+    /** Optional explicit status override */
+    status?: number);
+    /**
+     * Convert to plain object for serialization
+     */
+    toJSON(): {
+        code: string;
+        status: number;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * Router result - envelope or stream of envelopes
+ */
+export type RouterResult = Envelope | RaffelStream<Envelope> | AsyncIterable<Envelope>;
+/**
+ * Router options
+ */
+export interface RouterOptions {
+    /** Global interceptors (run for all handlers) */
+    interceptors?: Interceptor[];
+    /** Event delivery configuration */
+    eventDelivery?: EventDeliveryOptions;
+}
+/**
+ * Router interface
+ */
+export interface Router {
+    /** Handle an incoming envelope */
+    handle(envelope: Envelope): Promise<RouterResult>;
+    /** Add a global interceptor */
+    use(interceptor: Interceptor): void;
+    /** Stop background tasks (timers, retries) */
+    stop(): void;
+}
+/**
+ * Create a new Router
+ */
+export declare function createRouter(registry: Registry, options?: RouterOptions): Router;
+//# sourceMappingURL=router.d.ts.map

package/dist/ui/core/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/router.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EAGX,YAAY,EAGb,MAAM,mBAAmB,CAAA;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,qBAAqB,CAAA;AAI5B;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAUlC,gEAAgE;aAChD,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;IAZnC;;;;;OAKG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAA;;IAG5B,gEAAgE;IAChD,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA;IACjC,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM;IAOjB;;OAEG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;CAQ/E;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,mCAAmC;IACnC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAEjD,+BAA+B;IAC/B,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAEnC,8CAA8C;IAC9C,IAAI,IAAI,IAAI,CAAA;CACb;AAyGD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAoNpF"}

package/dist/ui/docs/openapi/generator.d.ts

@@ -0,0 +1,164 @@
+/**
+ * OpenAPI Schema Generator
+ *
+ * Generates OpenAPI 3.0 specification from Raffel Registry and SchemaRegistry.
+ */
+import type { Registry } from '../../core/registry.js';
+import type { SchemaRegistry } from '../../validation/index.js';
+/**
+ * OpenAPI 3.0 Document structure
+ */
+export interface OpenAPIDocument {
+    openapi: '3.0.0' | '3.0.3' | '3.1.0';
+    info: OpenAPIInfo;
+    servers?: OpenAPIServer[];
+    paths: Record<string, OpenAPIPathItem>;
+    components?: {
+        schemas?: Record<string, unknown>;
+        securitySchemes?: Record<string, OpenAPISecurityScheme>;
+    };
+    security?: Array<Record<string, string[]>>;
+    tags?: OpenAPITag[];
+}
+export interface OpenAPIInfo {
+    title: string;
+    description?: string;
+    version: string;
+    contact?: {
+        name?: string;
+        url?: string;
+        email?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+}
+export interface OpenAPIServer {
+    url: string;
+    description?: string;
+}
+export interface OpenAPIPathItem {
+    summary?: string;
+    description?: string;
+    get?: OpenAPIOperation;
+    post?: OpenAPIOperation;
+    put?: OpenAPIOperation;
+    delete?: OpenAPIOperation;
+    patch?: OpenAPIOperation;
+}
+export interface OpenAPIOperation {
+    operationId?: string;
+    summary?: string;
+    description?: string;
+    tags?: string[];
+    parameters?: Array<{
+        name: string;
+        in: 'path' | 'query' | 'header' | 'cookie';
+        required?: boolean;
+        schema: unknown;
+        description?: string;
+    }>;
+    requestBody?: {
+        description?: string;
+        required?: boolean;
+        content: Record<string, {
+            schema: unknown;
+        }>;
+    };
+    responses: Record<string, OpenAPIResponse>;
+    security?: Array<Record<string, string[]>>;
+}
+export interface OpenAPIResponse {
+    description: string;
+    content?: Record<string, {
+        schema: unknown;
+    }>;
+    headers?: Record<string, {
+        schema: unknown;
+        description?: string;
+    }>;
+}
+export interface OpenAPISecurityScheme {
+    type: 'apiKey' | 'http' | 'oauth2' | 'openIdConnect';
+    description?: string;
+    name?: string;
+    in?: 'query' | 'header' | 'cookie';
+    scheme?: string;
+    bearerFormat?: string;
+}
+export interface OpenAPITag {
+    name: string;
+    description?: string;
+}
+/**
+ * REST Route definition (minimal interface for OpenAPI generation)
+ */
+export interface OpenAPIRestRoute {
+    /** HTTP method (GET, POST, PUT, PATCH, DELETE) */
+    method: string;
+    /** URL path (e.g., /users, /users/:id) */
+    path: string;
+    /** Operation name (list, get, create, update, patch, delete) */
+    operation: string;
+    /** Input schema (Zod) */
+    inputSchema?: unknown;
+    /** Output schema (Zod) */
+    outputSchema?: unknown;
+    /** Auth requirement */
+    auth?: 'none' | 'required' | 'optional' | string;
+    /** Operation ID for OpenAPI */
+    operationId?: string;
+}
+/**
+ * REST Resource definition (minimal interface for OpenAPI generation)
+ */
+export interface OpenAPIRestResource {
+    /** Resource name */
+    name: string;
+    /** Schema for the resource entity */
+    schema?: unknown;
+    /** Generated routes */
+    routes: OpenAPIRestRoute[];
+}
+/**
+ * Generator options
+ */
+export interface GeneratorOptions {
+    /** OpenAPI info section */
+    info: OpenAPIInfo;
+    /** OpenAPI version to generate */
+    openApiVersion?: '3.0.0' | '3.0.3' | '3.1.0';
+    /** Server URLs */
+    servers?: OpenAPIServer[];
+    /** Base path for procedures (default: '/') */
+    basePath?: string;
+    /** Path prefix for streams (default: '/streams') */
+    streamPath?: string;
+    /** Path prefix for events (default: '/events') */
+    eventPath?: string;
+    /** Include security schemes */
+    securitySchemes?: Record<string, OpenAPISecurityScheme>;
+    /** Default security requirement */
+    security?: Array<Record<string, string[]>>;
+    /** Group handlers by tag (e.g., 'users.create' -> tag 'users') */
+    groupByNamespace?: boolean;
+    /** Include examples from schemas */
+    includeExamples?: boolean;
+    /** REST resources for proper RESTful path generation */
+    restResources?: OpenAPIRestResource[];
+}
+/**
+ * Generate OpenAPI document from Registry and SchemaRegistry
+ */
+export declare function generateOpenAPI(registry: Registry, schemaRegistry?: SchemaRegistry, options?: GeneratorOptions): OpenAPIDocument;
+/**
+ * Generate OpenAPI JSON string
+ */
+export declare function generateOpenAPIJson(registry: Registry, schemaRegistry?: SchemaRegistry, options?: GeneratorOptions): string;
+/**
+ * Generate OpenAPI YAML string
+ * Note: Requires external YAML library for proper YAML output
+ */
+export declare function generateOpenAPIYaml(registry: Registry, schemaRegistry?: SchemaRegistry, options?: GeneratorOptions): string;
+//# sourceMappingURL=generator.d.ts.map

package/dist/ui/docs/openapi/generator.d.ts.map

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

package/dist/ui/docs/openapi/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OpenAPI Module
+ *
+ * Generates OpenAPI 3.0 specification from Raffel Registry and SchemaRegistry.
+ */
+export { generateOpenAPI, generateOpenAPIJson, generateOpenAPIYaml, type OpenAPIDocument, type OpenAPIInfo, type OpenAPIServer, type OpenAPIPathItem, type OpenAPIOperation, type OpenAPIResponse, type OpenAPISecurityScheme, type OpenAPITag, type GeneratorOptions, type OpenAPIRestResource, type OpenAPIRestRoute, } from './generator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/docs/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/docs/openapi/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA"}

package/dist/ui/docs/ui/html-builder.d.ts

@@ -0,0 +1,19 @@
+/**
+ * USD Documentation UI HTML Builder
+ *
+ * Generates the complete HTML for the USD documentation UI.
+ * This module assembles all parts: HTML structure, CSS styles, and embedded JavaScript.
+ *
+ * Security Note: The embedded JavaScript uses innerHTML for rendering documentation
+ * from trusted server-generated spec data. User-provided strings are escaped via esc().
+ * This is safe because:
+ * 1. The spec object is generated by our code (not user input)
+ * 2. All user-visible text is escaped before rendering
+ * 3. JSON data is escaped for script embedding to prevent XSS
+ */
+import type { UIGeneratorOptions } from './types.js';
+/**
+ * Generate HTML for USD documentation UI
+ */
+export declare function generateUIHTML(options: UIGeneratorOptions): string;
+//# sourceMappingURL=html-builder.d.ts.map

package/dist/ui/docs/ui/html-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../../../src/docs/ui/html-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAY,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAI9D;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CA+ClE"}

package/dist/ui/docs/ui/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * USD Documentation UI
+ *
+ * Exports the main HTML builder for the documentation UI.
+ */
+export { generateUIHTML } from './html-builder.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/docs/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/docs/ui/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,mBAAmB,YAAY,CAAA"}

package/dist/ui/docs/ui/styles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * USD Documentation UI Styles
+ *
+ * Generates CSS for the USD documentation UI.
+ */
+export interface StylesConfig {
+    primaryColor: string;
+    heroBackgroundCSS: string;
+}
+/**
+ * Generate CSS styles for the USD documentation UI
+ */
+export declare function generateStyles(config: StylesConfig): string;
+//# sourceMappingURL=styles.d.ts.map

package/dist/ui/docs/ui/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/docs/ui/styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA0qE3D"}

package/dist/ui/docs/ui/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * UI Types
+ *
+ * Type definitions for the USD documentation UI.
+ */
+/**
+ * UI configuration options
+ */
+export interface UIConfig {
+    theme?: 'light' | 'dark' | 'auto';
+    primaryColor?: string;
+    logo?: string;
+    favicon?: string;
+    tryItOut?: boolean;
+    codeGeneration?: {
+        enabled?: boolean;
+        languages?: ('typescript' | 'python' | 'go' | 'curl')[];
+    };
+    hero?: HeroConfig;
+    sidebar?: SidebarConfig;
+}
+/**
+ * Hero section configuration
+ */
+export interface HeroConfig {
+    title?: string;
+    tagline?: string;
+    background?: 'gradient' | 'solid' | 'pattern' | 'image';
+    backgroundImage?: string;
+    buttons?: Array<{
+        text: string;
+        href?: string;
+        primary?: boolean;
+    }>;
+    quickLinks?: Array<{
+        title: string;
+        description?: string;
+        href: string;
+        icon?: string;
+    }>;
+}
+/**
+ * Sidebar configuration
+ */
+export interface SidebarConfig {
+    search?: boolean;
+    expandAll?: boolean;
+    showCounts?: boolean;
+}
+/**
+ * Tag group for hierarchical organization
+ */
+export interface TagGroup {
+    name: string;
+    tags: string[];
+    description?: string;
+    expanded?: boolean;
+}
+/**
+ * Options for generating UI HTML
+ */
+export interface UIGeneratorOptions {
+    doc: any;
+    basePath: string;
+    ui?: UIConfig;
+    tagGroups?: TagGroup[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/docs/ui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/docs/ui/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,SAAS,CAAC,EAAE,CAAC,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAA;KACxD,CAAA;IACD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IACvD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB"}

package/dist/ui/docs/ui/utils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * UI Utilities
+ *
+ * Helper functions for the USD documentation UI.
+ */
+/**
+ * Escape HTML special characters to prevent XSS
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Escape JSON for embedding in script tag (prevents XSS)
+ */
+export declare function escapeJsonForScript(obj: unknown): string;
+/**
+ * Adjust color brightness
+ * @param color - Hex color string (e.g., '#6366f1')
+ * @param amount - Positive to lighten, negative to darken
+ */
+export declare function adjustColor(color: string, amount: number): string;
+/**
+ * Generate hero background CSS based on configuration
+ */
+export declare function generateHeroBackgroundCSS(primaryColor: string, background?: 'gradient' | 'solid' | 'pattern' | 'image', backgroundImage?: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/ui/docs/ui/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/docs/ui/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO9C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKxD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,EACvD,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CAaR"}