@almadar/ui 5.111.0 → 5.113.0

package/dist/runtime/OrbPreview.d.ts

@@ -1,84 +0,0 @@
-/**
- * OrbPreview Component
- *
- * Renders a live preview of an Orbital schema (.orb program).
- * Uses static imports (no lazy loading) to ensure all providers,
- * hooks, and components share the same module instances.
- *
- * Usage:
- *   <OrbPreview schema={orbJsonStringOrObject} />
- *   <OrbPreview schema={schema} serverUrl="/api/orbitals" />
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { OrbitalSchema, EntityData } from '@almadar/core';
-import { type ServerBridgeTransport } from '../providers/ServerBridge';
-export interface OrbPreviewProps {
-    /**
-     * The orbital schema. Accepts a JSON string or an `OrbitalSchema` object
-     * from `@almadar/core` (the validated `.orb` program type).
-     */
-    schema: string | OrbitalSchema;
-    /**
-     * Mock entity rows keyed by entity name. The `EntityData` type from
-     * `@almadar/core` is `Record<string, EntityRow[]>` where each row is a
-     * `{ id?: string } & Record<string, FieldValue>`. Ignored if `autoMock`
-     * is set.
-     */
-    mockData?: EntityData;
-    /**
-     * When true, run the schema through `prepareSchemaForPreview` before
-     * rendering: auto-generate mock entity rows and flip two-state INIT
-     * machines so the data state is initial. This is the same pipeline the
-     * playground uses, so consumers (docs MDX, playground) all share one path.
-     *
-     * Ignored when `serverUrl` is set — server-driven previews provide their
-     * own data.
-     */
-    autoMock?: boolean;
-    /** Preview container height. Default: '400px'. */
-    height?: string;
-    /** CSS class for the outer container. */
-    className?: string;
-    /** Server URL for dual execution (e.g. "/api/orbitals"). When set, events are forwarded to the server. */
-    serverUrl?: string;
-    /**
-     * Custom transport for in-process execution. Mutually exclusive with
-     * `serverUrl`. Used by `<BrowserPlayground>` to invoke
-     * `OrbitalServerRuntime.processOrbitalEvent` directly without HTTP.
-     */
-    transport?: ServerBridgeTransport;
-    /**
-     * Initial page path to render (e.g. `/deals`). Resolves against the
-     * schema's `pages[]` to seed `currentPage` so the right orbital's traits
-     * mount on first render. Without this the playground falls back to the
-     * schema's first page binding (gap #13 Phase 5). runtime-verify uses this
-     * to walk DealCreate, NoteCompose, etc. on their owning pages.
-     */
-    initialPagePath?: string;
-    /**
-     * Sandbox mode: the preview's event bus stays context-local and does NOT
-     * register as the global bus. Set when embedded inside a host app (e.g. the
-     * studio canvas) so preview events don't clobber the host's global bus.
-     * Default false (standalone previews own the global bridge).
-     */
-    isolated?: boolean;
-}
-/**
- * Renders a live preview of an Orbital schema.
- *
- * Uses static imports for all runtime components to ensure providers
- * and hooks share the same module instances (no context duplication).
- *
- * @example
- * ```tsx
- * <OrbPreview schema={orbJsonString} height="300px" />
- * <OrbPreview schema={schema} autoMock />
- * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
- * ```
- */
-export declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, initialPagePath, isolated, }: OrbPreviewProps): React.ReactElement;
-export declare namespace OrbPreview {
-    var displayName: string;
-}

package/dist/scripts/audit-tailwind-safelist.d.ts

@@ -1,27 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Tailwind Safelist Audit
- *
- * Scans all @almadar/ui source files for Tailwind classes that need
- * to be in the safelist (because consuming apps can't extract them
- * from compiled dist/ files). Compares against the current safelist
- * in tailwind-preset.cjs and reports missing entries.
- *
- * Classes that need safelisting:
- * 1. Arbitrary value classes: bg-[var(--color-X)], min-h-[200px], etc.
- * 2. Opacity modifiers on semantic colors: bg-primary/10, text-foreground/60
- * 3. Responsive prefixes on dynamic values: sm:grid-cols-2
- * 4. State prefixes on CSS vars: hover:bg-[var(--color-X)]
- *
- * Standard utility classes (flex, p-4, rounded-lg) are fine because
- * the shell template's tailwind.config.js includes the dist/ path in
- * content scanning. But CSS-variable-based arbitrary classes use bracket
- * notation that Tailwind can't extract from minified JS.
- *
- * Usage:
- *   npx tsx scripts/audit-tailwind-safelist.ts
- *   npx tsx scripts/audit-tailwind-safelist.ts --fix  (appends missing to preset)
- *
- * @packageDocumentation
- */
-export {};

package/dist/scripts/generate-design-system.d.ts

@@ -1,29 +0,0 @@
-/**
- * Unified Design System Generator
- *
- * Generates a complete client-specific design system from an .orb schema:
- * 1. Generates custom theme CSS
- * 2. Suggests domain-specific components
- * 3. Generates component stubs
- * 4. Builds Storybook documentation
- * 5. Exports static design system package
- */
-interface GeneratorOptions {
-    schemaPath: string;
-    outputDir: string;
-    clientName?: string;
-    buildStorybook?: boolean;
-    generateComponents?: boolean;
-    clientOnly?: boolean;
-}
-interface GeneratorResult {
-    themePath: string;
-    suggestedComponents: number;
-    generatedComponents: number;
-    storybookPath?: string;
-}
-/**
- * Main generator function
- */
-export declare function generateDesignSystem(options: GeneratorOptions): Promise<GeneratorResult>;
-export {};

package/dist/scripts/generate-theme-from-schema.d.ts

@@ -1,10 +0,0 @@
-/**
- * Theme Generator from OrbitalSchema
- *
- * Analyzes an .orb schema file and generates a client-specific theme CSS file.
- * The theme is derived from the domain, entity names, and any explicit style hints.
- */
-/**
- * Main function to generate theme from schema
- */
-export declare function generateThemeFromSchema(schemaPath: string, outputPath?: string): string;

package/dist/scripts/generate.d.ts

@@ -1,12 +0,0 @@
-#!/usr/bin/env npx tsx
-/**
- * Design System Generator
- *
- * Reads a config file from a project folder and outputs a customized
- * design system to that project.
- *
- * Usage:
- *   npx tsx generate.ts --config <path-to-config>
- *   npm run generate -- --config ../../projects/winning-11/design-system.config.ts
- */
-export {};

package/dist/scripts/suggest-components.d.ts

@@ -1,31 +0,0 @@
-/**
- * Component Suggester
- *
- * Analyzes an .orb schema and suggests domain-specific components
- * that should be added to the design system for this client.
- */
-interface ComponentSuggestion {
-    name: string;
-    description: string;
-    category: 'atoms' | 'molecules' | 'organisms' | 'templates';
-    props: Array<{
-        name: string;
-        type: string;
-        description: string;
-    }>;
-    reasoning: string;
-    priority: 'high' | 'medium' | 'low';
-    codeSketch: string;
-}
-/**
- * Suggest components based on schema analysis
- */
-export declare function suggestComponents(schemaPath: string): {
-    domains: string[];
-    suggestions: ComponentSuggestion[];
-};
-/**
- * Generate component stubs from suggestions
- */
-export declare function generateComponentStubs(suggestions: ComponentSuggestion[], outputDir: string): void;
-export {};

package/dist/scripts/types.d.ts

@@ -1,129 +0,0 @@
-/**
- * Design System Generator Types
- *
- * Input configuration for generating a customized design system
- * that gets output to a project folder.
- */
-export interface DesignSystemConfig {
-    /** Project/client name (e.g., "winning-11") */
-    projectName: string;
-    /** Output directory for the generated design system */
-    outputDir: string;
-    /** Theme configuration */
-    theme: ThemeConfig;
-    /** Custom components not in the standard library */
-    customComponents?: CustomComponentConfig[];
-    /** Which standard components to include (default: all) */
-    includeComponents?: ComponentFilter;
-    /** Storybook configuration */
-    storybook?: StorybookConfig;
-}
-export interface ThemeConfig {
-    /** Theme name (used in data-design-theme attribute) */
-    name: string;
-    /** Theme display name for documentation */
-    displayName?: string;
-    /** Design metaphor/style description */
-    metaphor?: string;
-    /** Color palette */
-    colors: {
-        primary: string;
-        primaryHover?: string;
-        primaryForeground?: string;
-        secondary: string;
-        secondaryHover?: string;
-        secondaryForeground?: string;
-        accent: string;
-        accentForeground?: string;
-        muted: string;
-        mutedForeground?: string;
-        background: string;
-        foreground: string;
-        card?: string;
-        cardForeground?: string;
-        border: string;
-        input?: string;
-        ring?: string;
-        /** Semantic colors */
-        success?: string;
-        warning?: string;
-        error?: string;
-        info?: string;
-        /** Custom domain-specific colors */
-        custom?: Record<string, string>;
-    };
-    /** Shadow style preset or custom shadows */
-    shadows?: 'soft-organic' | 'minimal' | 'corporate' | 'playful' | 'dramatic' | 'soft' | ShadowConfig;
-    /** Border radius preset or custom radii */
-    radius?: 'organic' | 'gentle' | 'sharp' | 'rounded' | 'friendly' | RadiusConfig;
-    /** Typography overrides */
-    typography?: {
-        fontFamily?: string;
-        fontWeightNormal?: number;
-        fontWeightMedium?: number;
-        fontWeightBold?: number;
-    };
-    /** Dark mode variant */
-    darkMode?: Partial<ThemeConfig['colors']>;
-}
-export interface ShadowConfig {
-    main: string;
-    sm: string;
-    lg: string;
-    hover: string;
-    inner?: string;
-    active?: string;
-}
-export interface RadiusConfig {
-    sm: string;
-    md: string;
-    lg: string;
-    xl: string;
-}
-export interface CustomComponentConfig {
-    /** Component name (PascalCase) */
-    name: string;
-    /** Component description */
-    description: string;
-    /** Category in the component library */
-    category: 'atoms' | 'molecules' | 'organisms' | 'templates';
-    /** Component props */
-    props: ComponentProp[];
-    /** Why this component is needed */
-    reasoning?: string;
-    /** Priority for implementation */
-    priority?: 'high' | 'medium' | 'low';
-    /** Optional implementation code */
-    implementation?: string;
-    /** Optional Storybook stories */
-    stories?: string;
-}
-export interface ComponentProp {
-    name: string;
-    type: string;
-    description: string;
-    required?: boolean;
-    defaultValue?: string;
-}
-export interface ComponentFilter {
-    /** Include all components (default: true) */
-    all?: boolean;
-    /** Specific categories to include */
-    categories?: ('atoms' | 'molecules' | 'organisms' | 'templates')[];
-    /** Specific components to include (by name) */
-    include?: string[];
-    /** Specific components to exclude (by name) */
-    exclude?: string[];
-}
-export interface StorybookConfig {
-    /** Build Storybook (default: true) */
-    build?: boolean;
-    /** Include Storybook source in output (default: true) */
-    includeSource?: boolean;
-    /** Custom Storybook title */
-    title?: string;
-}
-/**
- * Example configuration for Winning-11 (Garden theme)
- */
-export declare const WINNING_11_CONFIG: DesignSystemConfig;

package/dist/tsup.config.d.ts

@@ -1,3 +0,0 @@
-import { type Options } from 'tsup';
-declare const _default: Options | Options[] | ((overrideOptions: Options) => Options | Options[] | Promise<Options | Options[]>);
-export default _default;

package/dist/types/renderer-types.d.ts

@@ -1,146 +0,0 @@
-/**
- * Shared Renderer Types
- *
- * Type definitions used by both Builder and compiled shells for
- * the dual execution model. These types define the contract between
- * server and client for effect execution.
- *
- * @packageDocumentation
- */
-import type { EntityRow, FieldValue, UISlot, PatternConfig } from '@almadar/core';
-/**
- * A client effect is a tuple where the first element is the effect type
- * and the remaining elements are the arguments.
- *
- * @example
- * ['render-ui', 'main', { type: 'entity-table', ... }]
- * ['navigate', '/tasks/123']
- * ['notify', 'Task created!', { type: 'success' }]
- * ['emit', 'TASK_CREATED', { id: '123' }]
- */
-export type { UISlot, PatternConfig };
-export type ClientEffect = ['render-ui', string, PatternConfig | null] | ['navigate', string, Record<string, FieldValue>?] | ['notify', string, NotifyOptions?] | ['emit', string, FieldValue?];
-/**
- * Options for notify effect
- */
-export interface NotifyOptions {
-    type?: 'success' | 'error' | 'info' | 'warning';
-    duration?: number;
-}
-/**
- * Resolved pattern with component information from component-mapping.json
- */
-export interface MappedPattern {
-    /** Component name (e.g., 'DataTable') */
-    component: string;
-    /** Import path for the component */
-    importPath: string;
-    /** Pattern category (e.g., 'display', 'form') */
-    category: string;
-    /** Validated and normalized props */
-    validatedProps: Record<string, FieldValue>;
-}
-/**
- * Response from server after processing an event.
- * This is the unified response format for both Builder and compiled shells.
- */
-export interface EventResponse {
-    /** Whether the event was processed successfully */
-    success: boolean;
-    /** New state after transition (if transition occurred) */
-    newState?: string;
-    /** Data fetched by server effects (e.g., { Task: [...] }) */
-    data?: Record<string, EntityRow[]>;
-    /** Client effects to execute (render-ui, navigate, notify, emit) */
-    clientEffects?: ClientEffect[];
-    /** Results of individual effect executions (for debugging) */
-    effectResults?: Array<{
-        effect: string;
-        success: boolean;
-        data?: FieldValue;
-        error?: string;
-    }>;
-    /** Error message if success is false */
-    error?: string;
-}
-/**
- * Configuration for the client effect executor.
- * Provides implementations for each effect type.
- */
-export interface ClientEffectExecutorConfig {
-    /**
-     * Render a pattern to a slot.
-     * Called for 'render-ui' effects.
-     */
-    renderToSlot: (slot: string, pattern: PatternConfig | null) => void;
-    /**
-     * Navigate to a route.
-     * Called for 'navigate' effects.
-     */
-    navigate: (path: string, params?: Record<string, FieldValue>) => void;
-    /**
-     * Show a notification.
-     * Called for 'notify' effects.
-     */
-    notify: (message: string, options?: NotifyOptions) => void;
-    /**
-     * Emit an event to the event bus.
-     * Called for 'emit' effects.
-     */
-    eventBus: {
-        emit: (event: string, payload?: FieldValue) => void;
-    };
-    /**
-     * Optional: Data from server response for render-ui.
-     * Components can use this to access fetched entity data.
-     */
-    data?: Record<string, EntityRow[]>;
-    /**
-     * Optional: Callback when all effects have been executed.
-     */
-    onComplete?: () => void;
-}
-/**
- * Slot type classification
- */
-export type SlotType = 'inline' | 'portal';
-/**
- * Definition of a slot including its rendering behavior
- */
-export interface SlotDefinition {
-    /** Slot name */
-    name: UISlot;
-    /** Whether to render inline or via portal */
-    type: SlotType;
-    /** For portal slots: where to render (default: document.body) */
-    portalTarget?: string;
-    /** Z-index for portal slots */
-    zIndex?: number;
-}
-/**
- * Context for resolving entity data.
- * Supports multiple data sources with priority.
- */
-export interface DataContext {
-    /** Server-provided data (highest priority) */
-    fetchedData?: Record<string, EntityRow[]>;
-    /** In-memory mock data (for Builder preview) */
-    entityStore?: {
-        getRecords: (entityName: string) => EntityRow[];
-    };
-    /** Query singleton for filtering */
-    querySingleton?: {
-        getFilters: (queryRef: string) => Record<string, FieldValue>;
-    };
-}
-/**
- * Result of data resolution
- */
-export interface DataResolution {
-    /** Resolved data array */
-    data: EntityRow[];
-    /** Whether data is still loading */
-    loading: boolean;
-    /** Error if resolution failed */
-    error?: Error;
-}

package/dist/types/runtime-types.d.ts

@@ -1,21 +0,0 @@
-/**
- * OrbitalRuntime Types
- *
- * Re-exports IR types from @almadar/core.
- * This ensures runtime uses the same types as the compiler.
- *
- * @packageDocumentation
- */
-export type { TransitionFrom, ResolvedField, ResolvedEntity, ResolvedEntityBinding, ResolvedTraitState, ResolvedTraitEvent, ResolvedTraitTransition, ResolvedTraitGuard, ResolvedTraitTick, ResolvedTraitDataEntity, ResolvedTraitUIBinding, ResolvedTrait, ResolvedTraitBinding, ResolvedPattern, ResolvedSectionEvent, ResolvedSection, ResolvedNavigation, ResolvedPage, ResolvedIR, } from '@almadar/core';
-import type { ResolvedTraitListener as CoreResolvedTraitListener, ListenSource } from '@almadar/core';
-export type { ListenSource };
-/**
- * Extended `ResolvedTraitListener` carrying the runtime `source` scope
- * descriptor. Core's `ResolvedTraitListener` includes `source?: ListenSource`
- * starting with the version that shipped `ListenSource`; this intersection
- * keeps the field visible even if older core builds omit it.
- */
-export type ResolvedTraitListener = CoreResolvedTraitListener & {
-    source?: ListenSource;
-};
-export { createEmptyResolvedTrait, createEmptyResolvedPage, createResolvedField, inferTsType, isResolvedIR, } from '@almadar/core';

package/dist/types/slot-types.d.ts

@@ -1,49 +0,0 @@
-/**
- * Per-transition slot pattern types — shared by `useTraitStateMachine`
- * (the state-machine accumulator) and any consumer that wants to look at
- * the raw pattern + props pair before unwrap.
- *
- * Pre-consolidation these lived in `SlotsContext.tsx` together with a
- * React Provider that maintained a parallel `slots` store. That store
- * was removed in favor of consolidating onto `useUISlots`, so only the
- * structural types remain here.
- *
- * @packageDocumentation
- */
-import type { PatternConfig, EventSource, ResolvedTrait, FieldValue, SExpr } from '@almadar/core';
-import type { SlotPropValue } from '../hooks/useUISlots';
-/**
- * Slot-render observability channel. Used by `useTraitStateMachine`,
- * `OrbPreview.applyServerEffects`, and the `<SlotContentRenderer>` to
- * surface every slot write/clear at debug level. Pre-consolidation
- * lived in `SlotsContext.tsx`; consolidated here so consumers don't
- * depend on the now-removed React provider.
- */
-export declare const slotLog: import("@almadar/logger").Logger;
-/**
- * Stable per-object id used by slot-render logs to compare entity
- * references across renders (e.g. spotting the form-reset bug where
- * the same logical row arrives with a fresh ref id every transition).
- */
-export declare function refId(obj: SlotPropValue | null | undefined): number | null;
-/**
- * One pattern within a slot's accumulated render-ui set, plus any
- * caller-supplied props that should be merged on top.
- */
-export interface SlotPatternEntry {
-    pattern: PatternConfig;
-    props: Record<string, FieldValue | undefined>;
-}
-/**
- * The originating trait + state for a slot write. Embedded in the
- * `useUISlots` SlotContent's metadata so observers (verifier, debugger,
- * cross-orbital tracer) can attribute every render to the trait that
- * caused it.
- */
-export interface SlotSource extends EventSource {
-    trait: string;
-    state: string;
-    transition: string;
-    effects: SExpr[];
-    traitDefinition: ResolvedTrait;
-}

package/dist/vitest.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("vite").UserConfig;
-export default _default;