@cloudraker/reki 2.6.1

package/dist/src/catalog/types.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Runtime types for Reki catalog module.
+ *
+ * These types extend the registry types with runtime capabilities
+ * like visibility conditions, actions, and data binding.
+ */
+export type { ComponentRegistry, ComponentSchema, PropSchema, SubComponentSchema, } from '../registry/types';
+/**
+ * A value that can either be a literal or a reference to the data model.
+ * When { path: string }, the value is resolved from the data model at runtime.
+ *
+ * @example
+ * // Literal value
+ * const title: DynamicValue<string> = "Hello World";
+ *
+ * // Dynamic reference
+ * const title: DynamicValue<string> = { path: "/user/name" };
+ */
+export type DynamicValue<T = unknown> = T | {
+    path: string;
+};
+export type DynamicString = DynamicValue<string>;
+export type DynamicNumber = DynamicValue<number>;
+export type DynamicBoolean = DynamicValue<boolean>;
+/**
+ * Logic expression for complex visibility conditions.
+ * Supports boolean logic (and, or, not) and comparisons.
+ */
+export type LogicExpression = {
+    and: LogicExpression[];
+} | {
+    or: LogicExpression[];
+} | {
+    not: LogicExpression;
+} | {
+    path: string;
+} | {
+    eq: [DynamicValue, DynamicValue];
+} | {
+    neq: [DynamicValue, DynamicValue];
+} | {
+    gt: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    gte: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    lt: [DynamicValue<number>, DynamicValue<number>];
+} | {
+    lte: [DynamicValue<number>, DynamicValue<number>];
+};
+/**
+ * Visibility condition for conditional rendering.
+ *
+ * @example
+ * // Always visible
+ * visible: true
+ *
+ * // Visible when data path is truthy
+ * visible: { path: "/user/isAdmin" }
+ *
+ * // Visible when user is signed in
+ * visible: { auth: "signedIn" }
+ *
+ * // Complex condition
+ * visible: { and: [{ path: "/user/isAdmin" }, { auth: "signedIn" }] }
+ */
+export type VisibilityCondition = boolean | {
+    path: string;
+} | {
+    auth: "signedIn" | "signedOut";
+} | LogicExpression;
+/**
+ * Confirmation dialog configuration for destructive actions.
+ */
+export interface ActionConfirm {
+    title: string;
+    message: string;
+    variant?: "default" | "danger";
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+/**
+ * Action that can be triggered by a component.
+ * AI declares the intent, your handlers execute the logic.
+ *
+ * @example
+ * {
+ *   name: "delete_item",
+ *   params: {
+ *     itemId: { path: "/selected/id" }
+ *   },
+ *   confirm: {
+ *     title: "Delete Item",
+ *     message: "Are you sure?",
+ *     variant: "danger"
+ *   }
+ * }
+ */
+export interface Action {
+    /** Action name (must be registered in catalog) */
+    name: string;
+    /** Parameters to pass to the action handler */
+    params?: Record<string, DynamicValue>;
+    /** Confirmation dialog before executing */
+    confirm?: ActionConfirm;
+    /** Data updates on successful execution */
+    onSuccess?: {
+        set: Record<string, DynamicValue>;
+    };
+    /** Data updates on error */
+    onError?: {
+        set: Record<string, DynamicValue>;
+    };
+}
+/**
+ * A single UI element in the tree.
+ * Represents one component with its props and relationships.
+ */
+export interface UIElement<TType extends string = string, TProps = Record<string, unknown>> {
+    /** Unique key for reconciliation */
+    key: string;
+    /** Component type from the catalog */
+    type: TType;
+    /** Component props (may include dynamic values) */
+    props: TProps;
+    /** Child element keys (flat structure for streaming) */
+    children?: string[];
+    /** Parent element key (null for root) */
+    parentKey?: string | null;
+    /** Visibility condition */
+    visible?: VisibilityCondition;
+    /** Action to trigger on interaction */
+    action?: Action;
+}
+/**
+ * Flat UI tree structure optimized for LLM generation and streaming.
+ *
+ * The flat structure allows:
+ * - Progressive rendering as elements stream in
+ * - Easy updates without deep tree traversal
+ * - Simple serialization/deserialization
+ *
+ * @example
+ * {
+ *   root: "card-1",
+ *   elements: {
+ *     "card-1": { key: "card-1", type: "Surface", props: { variant: "card" }, children: ["text-1"] },
+ *     "text-1": { key: "text-1", type: "Text", props: { children: "Hello" }, parentKey: "card-1" }
+ *   }
+ * }
+ */
+export interface UITree {
+    /** Root element key */
+    root: string;
+    /** Flat map of elements by key */
+    elements: Record<string, UIElement>;
+}
+/**
+ * Authentication state for visibility evaluation.
+ */
+export interface AuthState {
+    isSignedIn: boolean;
+    user?: Record<string, unknown>;
+}
+/**
+ * Data model that backs dynamic values.
+ * Values are accessed via JSON Pointer paths (e.g., "/user/name").
+ */
+export type DataModel = Record<string, unknown>;
+/**
+ * Action handler function signature.
+ */
+export type ActionHandler = (params: Record<string, unknown>) => void | Promise<void>;
+/**
+ * Map of action names to their handlers.
+ */
+export type ActionHandlers = Record<string, ActionHandler>;
+/**
+ * Action definition for the catalog.
+ */
+export interface ActionDefinition {
+    /** Description for AI generation */
+    description: string;
+    /** Parameter schema (optional, for validation) */
+    params?: Record<string, {
+        type: string;
+        description?: string;
+    }>;
+}
+/**
+ * Catalog configuration for createRekiCatalog.
+ */
+export interface CatalogConfig {
+    /** Action definitions (optional) */
+    actions?: Record<string, ActionDefinition>;
+}
+/**
+ * Runtime catalog instance.
+ */
+export interface RekiCatalog {
+    /** Component names in the catalog */
+    readonly componentNames: readonly string[];
+    /** Action names in the catalog */
+    readonly actionNames: readonly string[];
+    /** Check if component type exists */
+    hasComponent(type: string): boolean;
+    /** Check if action exists */
+    hasAction(name: string): boolean;
+    /** Validate a UI element */
+    validateElement(element: unknown): ValidationResult;
+    /** Validate a complete UI tree */
+    validateTree(tree: unknown): ValidationResult<UITree>;
+    /** Generate a prompt describing the catalog for AI */
+    generatePrompt(): string;
+}
+/**
+ * Validation result from schema validation.
+ */
+export interface ValidationResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        message: string;
+        path: (string | number)[];
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/catalog/types.d.ts.map

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

package/dist/src/catalog/visibility.d.ts

@@ -0,0 +1,37 @@
+import { VisibilityCondition, DataModel, AuthState } from './types';
+/**
+ * Context for evaluating visibility conditions.
+ */
+export interface VisibilityContext {
+    /** Data model for path resolution */
+    data: DataModel;
+    /** Authentication state */
+    auth: AuthState;
+}
+/**
+ * Evaluate a visibility condition.
+ *
+ * @example
+ * // Boolean
+ * evaluateVisibility(true, ctx) // true
+ *
+ * // Path check
+ * evaluateVisibility({ path: "/user/isAdmin" }, ctx) // depends on data
+ *
+ * // Auth check
+ * evaluateVisibility({ auth: "signedIn" }, ctx) // depends on auth state
+ *
+ * // Complex logic
+ * evaluateVisibility({
+ *   and: [
+ *     { path: "/user/isAdmin" },
+ *     { auth: "signedIn" }
+ *   ]
+ * }, ctx)
+ */
+export declare function evaluateVisibility(condition: VisibilityCondition | undefined, ctx: VisibilityContext): boolean;
+/**
+ * Create a default visibility context.
+ */
+export declare function createVisibilityContext(data?: DataModel, auth?: Partial<AuthState>): VisibilityContext;
+//# sourceMappingURL=visibility.d.ts.map

package/dist/src/catalog/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/catalog/visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAEnB,SAAS,EACT,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,2BAA2B;IAC3B,IAAI,EAAE,SAAS,CAAC;CACjB;AA+FD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,mBAAmB,GAAG,SAAS,EAC1C,GAAG,EAAE,iBAAiB,GACrB,OAAO,CA8BT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,SAAc,EACpB,IAAI,GAAE,OAAO,CAAC,SAAS,CAAM,GAC5B,iBAAiB,CAQnB"}

package/dist/src/code/code-highlighted.d.ts

@@ -0,0 +1,32 @@
+import { default as React } from 'react';
+import { CodeHighlightedProps } from './types';
+/**
+ * Syntax-highlighted code block powered by Shiki.
+ *
+ * Must be used within a ShikiProvider. While Shiki is loading,
+ * displays code as plain text (no layout shift, immediately readable).
+ *
+ * Uses hardcoded themes: `github-light` for light mode, `vesper` for dark mode.
+ *
+ * @example
+ * ```tsx
+ * import { ShikiProvider, CodeHighlighted } from "@cloudraker/reki/code";
+ *
+ * <ShikiProvider
+ *   engine="javascript"
+ *   languages={['tsx', 'bash']}
+ * >
+ *   <CodeHighlighted
+ *     code={`const greeting = "Hello!";`}
+ *     lang="tsx"
+ *     showLineNumbers
+ *     showCopyButton
+ *   />
+ * </ShikiProvider>
+ * ```
+ */
+export declare function CodeHighlighted({ code, lang, showLineNumbers, highlightLines, showCopyButton, labels: labelOverrides, className, }: CodeHighlightedProps): React.JSX.Element;
+export declare namespace CodeHighlighted {
+    var displayName: string;
+}
+//# sourceMappingURL=code-highlighted.d.ts.map

package/dist/src/code/code-highlighted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-highlighted.d.ts","sourceRoot":"","sources":["../../../src/code/code-highlighted.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAI9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,IAAI,EACJ,eAAuB,EACvB,cAAc,EACd,cAAsB,EACtB,MAAM,EAAE,cAAc,EACtB,SAAS,GACV,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqI1C;yBA7Ie,eAAe"}

package/dist/src/code/context.d.ts

@@ -0,0 +1,16 @@
+import { HighlighterCore } from 'shiki/core';
+import { SupportedLanguage, CodeHighlightedLabels } from './types';
+export interface ShikiContextValue {
+    /** The initialized Shiki highlighter instance */
+    highlighter: HighlighterCore | null;
+    /** True while Shiki is loading */
+    isLoading: boolean;
+    /** Error if initialization failed */
+    error: Error | null;
+    /** Configured languages */
+    languages: SupportedLanguage[];
+    /** Localized labels for UI elements */
+    labels: CodeHighlightedLabels;
+}
+export declare const ShikiContext: import('react').Context<ShikiContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/code/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/code/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,WAAW,EAAE,eAAe,GAAG,IAAI,CAAC;IAEpC,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IAEnB,qCAAqC;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,2BAA2B;IAC3B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAE/B,uCAAuC;IACvC,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,eAAO,MAAM,YAAY,mDAAgD,CAAC"}

package/dist/src/code/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shiki-powered syntax highlighting for Reki.
+ *
+ * This module is intentionally separate from the main `@cloudraker/reki` export
+ * to avoid bundling Shiki (~65-250KB) for consumers who don't need it.
+ *
+ * Uses hardcoded themes: `github-light` for light mode, `vesper` for dark mode.
+ *
+ * @example
+ * ```tsx
+ * import { ShikiProvider, CodeHighlighted } from "@cloudraker/reki/code";
+ *
+ * function App() {
+ *   return (
+ *     <ShikiProvider
+ *       engine="javascript"
+ *       languages={['tsx', 'bash', 'json']}
+ *     >
+ *       <CodeHighlighted code="const x = 1;" lang="tsx" />
+ *     </ShikiProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ShikiProvider, normalizeLanguage } from './provider';
+export { CodeHighlighted } from './code-highlighted';
+export { useShikiHighlighter } from './use-shiki-highlighter';
+export { LANGUAGE_ALIASES } from './types';
+export type { ShikiProviderProps, CodeHighlightedProps, UseShikiHighlighterResult, ShikiEngine, BundledLanguage, LanguageAlias, LanguageInput, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3C,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/src/code/provider.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { ShikiProviderProps, SupportedLanguage } from './types';
+/**
+ * Normalize a language identifier to its canonical SupportedLanguage name.
+ * Returns the canonical name if the input is a known alias or already canonical,
+ * otherwise returns null.
+ */
+export declare function normalizeLanguage(lang: string): SupportedLanguage | null;
+export declare function ShikiProvider({ engine, languages, labels, children, }: ShikiProviderProps): React.JSX.Element;
+export declare namespace ShikiProvider {
+    var displayName: string;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/code/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/code/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAG5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAiB,MAAM,SAAS,CAAC;AA8BpF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAIxE;AAgCD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,SAAS,EACT,MAAM,EACN,QAAQ,GACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2GxC;yBAhHe,aAAa"}

package/dist/src/code/server.d.ts

@@ -0,0 +1,95 @@
+import { ShikiEngine, SupportedLanguage } from './types';
+import { ReactNode } from 'react';
+export interface HighlightCodeOptions {
+    /** Highlighting engine (default: "javascript") */
+    engine?: ShikiEngine;
+}
+export interface CreateHighlighterOptions {
+    /** Highlighting engine (default: "javascript") */
+    engine?: ShikiEngine;
+    /** Languages to support */
+    languages: SupportedLanguage[];
+}
+export interface ServerHighlighter {
+    /** Highlight code and return HTML string */
+    highlight: (code: string, lang: SupportedLanguage) => string;
+    /** Dispose the highlighter when done */
+    dispose: () => void;
+}
+/**
+ * One-off highlighting for a single code snippet.
+ *
+ * Creates a highlighter, highlights the code, and disposes.
+ * For multiple highlights, use `createServerHighlighter` instead.
+ *
+ * Uses hardcoded themes: `github-light` for light mode, `vesper` for dark mode.
+ *
+ * @example
+ * ```tsx
+ * const html = await highlightCode(code, "tsx");
+ * ```
+ */
+export declare function highlightCode(code: string, lang: SupportedLanguage, options?: HighlightCodeOptions): Promise<string>;
+/**
+ * Create a reusable highlighter for multiple code snippets.
+ *
+ * More efficient than `highlightCode` when highlighting multiple snippets.
+ * Remember to call `dispose()` when done.
+ *
+ * Uses hardcoded themes: `github-light` for light mode, `vesper` for dark mode.
+ *
+ * @example
+ * ```tsx
+ * const highlighter = await createServerHighlighter({
+ *   languages: ["tsx", "bash", "json"],
+ * });
+ *
+ * const html1 = highlighter.highlight(code1, "tsx");
+ * const html2 = highlighter.highlight(code2, "bash");
+ *
+ * highlighter.dispose();
+ * ```
+ */
+export declare function createServerHighlighter(options: CreateHighlighterOptions): Promise<ServerHighlighter>;
+/**
+ * Props for the CodeBlock component.
+ */
+export interface CodeBlockProps {
+    /** Pre-rendered HTML from highlightCode() or createServerHighlighter().highlight() */
+    html: string;
+    /** Additional CSS classes for the container */
+    className?: string;
+}
+/**
+ * Server component that wraps highlighted code HTML with proper styling.
+ *
+ * Use this with `highlightCode()` or `createServerHighlighter().highlight()`
+ * to render syntax-highlighted code blocks with consistent Reki styling.
+ *
+ * @example
+ * ```tsx
+ * import { highlightCode, CodeBlock } from "@cloudraker/reki/code/server";
+ *
+ * export default async function Page() {
+ *   const html = await highlightCode(`const x = 1;`, "tsx");
+ *   return <CodeBlock html={html} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With createServerHighlighter for multiple blocks
+ * const highlighter = await createServerHighlighter({ languages: ["tsx", "bash"] });
+ *
+ * return (
+ *   <>
+ *     <CodeBlock html={highlighter.highlight(code1, "tsx")} />
+ *     <CodeBlock html={highlighter.highlight(code2, "bash")} />
+ *   </>
+ * );
+ *
+ * highlighter.dispose();
+ * ```
+ */
+export declare function CodeBlock({ html, className }: CodeBlockProps): ReactNode;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/code/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/code/server.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AA8BvC,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,2BAA2B;IAC3B,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,KAAK,MAAM,CAAC;IAC7D,wCAAwC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,EACvB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAiD5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,SAAS,CAexE"}

package/dist/src/code/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Supported languages for syntax highlighting.
+ *
+ * Reki bundles a curated subset of Shiki languages to keep bundle size small.
+ * These cover the most common use cases for documentation and code snippets.
+ *
+ * If you need additional languages, use Shiki directly with fine-grained imports.
+ */
+export type SupportedLanguage = "javascript" | "typescript" | "jsx" | "tsx" | "json" | "jsonc" | "html" | "css" | "python" | "yaml" | "markdown" | "graphql" | "sql" | "bash" | "shell" | "diff" | "hcl" | "toml";
+/**
+ * Common language aliases mapped to their canonical SupportedLanguage names.
+ *
+ * Markdown code fences often use short aliases (e.g., `js`, `ts`, `sh`) that
+ * don't match the canonical grammar names but should resolve to them.
+ *
+ * Note: `mdx` is intentionally omitted because it has a distinct grammar
+ * (Markdown + JSX) that would lose JSX highlighting if mapped to `markdown`.
+ */
+export declare const LANGUAGE_ALIASES: {
+    readonly js: "javascript";
+    readonly cjs: "javascript";
+    readonly mjs: "javascript";
+    readonly ts: "typescript";
+    readonly cts: "typescript";
+    readonly mts: "typescript";
+    readonly sh: "bash";
+    readonly zsh: "bash";
+    readonly yml: "yaml";
+    readonly py: "python";
+    readonly md: "markdown";
+    readonly gql: "graphql";
+};
+/** A known alias that maps to a SupportedLanguage. */
+export type LanguageAlias = keyof typeof LANGUAGE_ALIASES;
+/** Any language identifier accepted by ShikiProvider and highlight(). */
+export type LanguageInput = SupportedLanguage | LanguageAlias;
+/**
+ * Shiki engine choice for syntax highlighting.
+ * - `"javascript"` — Smaller bundle (~50KB), slightly less accurate
+ * - `"wasm"` — Larger bundle (~180KB), VS Code-accurate highlighting
+ */
+export type ShikiEngine = "javascript" | "wasm";
+/**
+ * Localized labels for the copy button.
+ */
+export interface CodeHighlightedLabels {
+    /** Label for copy button (default: "Copy") */
+    copy?: string;
+    /** Label shown after copying (default: "Copied!") */
+    copied?: string;
+}
+/**
+ * Props for ShikiProvider component.
+ */
+export interface ShikiProviderProps {
+    /**
+     * Highlighting engine choice.
+     * - `"javascript"` — Smaller, faster to load (~50KB gzipped)
+     * - `"wasm"` — Larger but more accurate (~180KB gzipped)
+     */
+    engine: ShikiEngine;
+    /**
+     * Languages to support. Only these languages will be loaded.
+     * Accepts canonical names (`'javascript'`) or common aliases (`'js'`).
+     * @example ['tsx', 'ts', 'bash', 'json']
+     */
+    languages: LanguageInput[];
+    /**
+     * Localized labels for UI elements (copy button, etc.).
+     * Can be overridden at the component level.
+     * @example { copy: "Copier", copied: "Copié!" }
+     */
+    labels?: CodeHighlightedLabels;
+    /** React children */
+    children: React.ReactNode;
+}
+/**
+ * Return value from useShikiHighlighter hook.
+ */
+export interface UseShikiHighlighterResult {
+    /**
+     * Highlight code and return HTML string.
+     * Returns `null` if highlighter is not ready or highlighting fails.
+     * When `null` is returned, render the code as plain text.
+     *
+     * Accepts language aliases (e.g., 'js', 'ts', 'sh') which are automatically
+     * normalized to their canonical SupportedLanguage names.
+     */
+    highlight: (code: string, lang: LanguageInput | (string & {})) => string | null;
+    /** True while Shiki is loading */
+    isLoading: boolean;
+    /** True when highlight() is safe to call */
+    isReady: boolean;
+    /** Error if Shiki initialization failed */
+    error: Error | null;
+    /** Localized labels from provider */
+    labels: CodeHighlightedLabels;
+}
+/**
+ * Props for CodeHighlighted component.
+ */
+export interface CodeHighlightedProps {
+    /** Source code to display */
+    code: string;
+    /**
+     * Language identifier for syntax highlighting.
+     * Accepts canonical names or common aliases (e.g., 'js', 'ts').
+     * Must be included in the ShikiProvider's `languages` array.
+     */
+    lang: LanguageInput | (string & {});
+    /** Display line numbers */
+    showLineNumbers?: boolean;
+    /**
+     * Lines to visually emphasize (1-indexed).
+     * @example [1, 5, 6]
+     */
+    highlightLines?: number[];
+    /** Show copy-to-clipboard button */
+    showCopyButton?: boolean;
+    /**
+     * Override provider labels for this instance.
+     * @example { copy: "Copy code", copied: "Done!" }
+     */
+    labels?: CodeHighlightedLabels;
+    /** Additional CSS classes */
+    className?: string;
+}
+/** @deprecated Use SupportedLanguage instead */
+export type BundledLanguage = SupportedLanguage;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/code/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/code/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,YAAY,GACZ,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,GACT,KAAK,GACL,MAAM,GACN,OAAO,GACP,MAAM,GACN,KAAK,GACL,MAAM,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAayB,CAAC;AAEvD,sDAAsD;AACtD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE1D,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAE9D;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,EAAE,WAAW,CAAC;IAEpB;;;;OAIG;IACH,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAE/B,qBAAqB;IACrB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;IAEhF,kCAAkC;IAClC,SAAS,EAAE,OAAO,CAAC;IAEnB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IAEjB,2CAA2C;IAC3C,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,qCAAqC;IACrC,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,IAAI,EAAE,aAAa,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAEpC,2BAA2B;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,oCAAoC;IACpC,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAE/B,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAGD,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC"}

package/dist/src/code/use-shiki-highlighter.d.ts

@@ -0,0 +1,36 @@
+import { UseShikiHighlighterResult } from './types';
+/**
+ * Hook for accessing Shiki highlighting in custom implementations.
+ *
+ * Must be used within a ShikiProvider.
+ *
+ * Uses hardcoded themes: `github-light` for light mode, `vesper` for dark mode.
+ *
+ * @example
+ * ```tsx
+ * import { useShikiHighlighter } from "@cloudraker/reki/code";
+ *
+ * function CustomCodeBlock({ code, lang }) {
+ *   const { highlight, isLoading, isReady, error } = useShikiHighlighter();
+ *
+ *   if (error) {
+ *     return <div>Failed to load highlighter</div>;
+ *   }
+ *
+ *   if (isLoading) {
+ *     return <pre><code>{code}</code></pre>;
+ *   }
+ *
+ *   const html = highlight(code, lang);
+ *
+ *   // null means highlighting failed — render plain text
+ *   if (html === null) {
+ *     return <pre><code>{code}</code></pre>;
+ *   }
+ *
+ *   return <pre dangerouslySetInnerHTML={{ __html: html }} />;
+ * }
+ * ```
+ */
+export declare function useShikiHighlighter(): UseShikiHighlighterResult;
+//# sourceMappingURL=use-shiki-highlighter.d.ts.map

package/dist/src/code/use-shiki-highlighter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-shiki-highlighter.d.ts","sourceRoot":"","sources":["../../../src/code/use-shiki-highlighter.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,mBAAmB,IAAI,yBAAyB,CA4D/D"}

package/dist/src/command-line/build-cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Build script for the Reki CLI
+ * Compiles TypeScript CLI files to JavaScript in dist/command-line/
+ */
+export {};
+//# sourceMappingURL=build-cli.d.ts.map