@signalflare-ai/ui 0.5.0

package/dist/src/blocks/resource-list/resource-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-list.d.ts","sourceRoot":"","sources":["../../../../src/blocks/resource-list/resource-list.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iBAAiB,CAAC,EAAE,SAAS,CAAC;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,WAAW,EACX,IAAI,EACJ,KAAK,EACL,iBAAiB,EACjB,QAAQ,EACR,SAAS,GACV,EAAE,qBAAqB,2CAoCvB"}

package/dist/src/blocks/resource-list/resource-list.test.tsx

@@ -0,0 +1,27 @@
+import { ResourceListPage } from "./resource-list";
+
+describe(ResourceListPage, () => {
+  it("should be defined", () => {
+    expect(ResourceListPage).toBeDefined();
+  });
+
+  it("should accept required props", () => {
+    const props = {
+      children: "Test content",
+    };
+    expect(() => ResourceListPage(props)).not.toThrow();
+  });
+
+  it("should accept all optional props", () => {
+    const props = {
+      title: "Test Title",
+      description: "Test Description",
+      icon: "Icon",
+      usage: "Usage",
+      additionalContent: "Additional",
+      children: "Content",
+      className: "custom-class",
+    };
+    expect(() => ResourceListPage(props)).not.toThrow();
+  });
+});

package/dist/src/blocks/resource-list/resource-list.tsx

@@ -0,0 +1,65 @@
+import type { ReactNode } from "react";
+
+import { cn } from "../../utils/cn";
+
+export interface ResourceListPageProps {
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+  usage?: ReactNode;
+  additionalContent?: ReactNode;
+  children: ReactNode;
+  className?: string;
+}
+
+/**
+ * ResourceListPage - A layout component for resource list pages
+ *
+ * Layouts are page-level components that provide consistent structure
+ * for common page patterns like resource lists, dashboards, and settings.
+ */
+export function ResourceListPage({
+  title,
+  description,
+  icon,
+  usage,
+  additionalContent,
+  children,
+  className,
+}: ResourceListPageProps) {
+  return (
+    <div className={cn("h-full min-h-screen w-full bg-sf-overlay", className)}>
+      <div className="mx-auto flex max-w-[1400px] flex-col p-6 md:gap-4 md:p-8 lg:px-10 lg:py-9 xl:gap-6">
+        <div className="flex flex-col">
+          <div className="mb-1.5 flex items-center gap-1.5">
+            {icon}
+            <h1 className="font-heading m-0 p-0 text-3xl font-semibold">
+              {title}
+            </h1>
+          </div>
+          <p className="hidden p-0 text-lg leading-normal text-pretty text-sf-strong md:block">
+            {description}
+          </p>
+        </div>
+
+        <div className="flex flex-col-reverse gap-6 xl:flex-row xl:gap-8">
+          <div className="min-w-0 grow">{children}</div>
+
+          {(usage || additionalContent) && (
+            <div
+              className={`top-22 flex h-fit w-full shrink-0 flex-col gap-4 xl:sticky xl:w-[380px]`}
+            >
+              {usage}
+
+              <div className={cn("hidden xl:block", usage ? "mt-6" : "")}>
+                {additionalContent}
+              </div>
+            </div>
+          )}
+        </div>
+
+        <div className="mt-6 xl:hidden">{additionalContent}</div>
+      </div>
+    </div>
+  );
+}

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

@@ -0,0 +1,75 @@
+import { SFCatalog, CatalogConfig, UIElement } from './types';
+interface SchemasModule {
+    SF_COMPONENT_NAMES: readonly string[];
+    UIElementBaseSchema: {
+        safeParse: (data: unknown) => {
+            success: boolean;
+            data?: unknown;
+            error?: {
+                issues: Array<{
+                    message: string;
+                    path: (string | number)[];
+                }>;
+            };
+        };
+    };
+    validateElementProps: (element: UIElement) => {
+        success: boolean;
+        error?: {
+            issues: Array<{
+                message: string;
+                path: (string | number)[];
+            }>;
+        };
+    };
+    validateUITree: (tree: unknown) => {
+        success: boolean;
+        data?: unknown;
+        error?: {
+            issues: Array<{
+                message: string;
+                path: (string | number)[];
+            }>;
+        };
+    };
+}
+/**
+ * Load the generated schemas module.
+ * This is called automatically when needed.
+ */
+export declare function loadSchemas(): Promise<SchemasModule>;
+/**
+ * Create a SF catalog for runtime validation.
+ *
+ * The catalog:
+ * - Uses auto-generated Zod schemas from component-registry.json
+ * - Validates UI elements and trees at runtime
+ * - Generates AI prompts describing available components
+ *
+ * @example
+ * import { createSFCatalog, initCatalog } from '@signalflare-ai/ui/catalog';
+ *
+ * const catalog = createSFCatalog({
+ *   actions: {
+ *     submit_form: { description: 'Submit the form' },
+ *     delete_item: { description: 'Delete selected item' },
+ *   },
+ * });
+ *
+ * // Initialize schemas (required before sync validation)
+ * await initCatalog(catalog);
+ *
+ * // Validate AI-generated tree
+ * const result = catalog.validateTree(aiGeneratedJson);
+ * if (result.success) {
+ *   // Render the tree
+ * }
+ */
+export declare function createSFCatalog(config?: CatalogConfig): SFCatalog;
+/**
+ * Initialize the catalog by loading schemas.
+ * Call this before using synchronous validation methods.
+ */
+export declare function initCatalog(catalog: SFCatalog): Promise<void>;
+export {};
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/catalog/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EAIb,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,UAAU,aAAa;IACrB,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,mBAAmB,EAAE;QACnB,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;YAC5B,OAAO,EAAE,OAAO,CAAC;YACjB,IAAI,CAAC,EAAE,OAAO,CAAC;YACf,KAAK,CAAC,EAAE;gBAAE,MAAM,EAAE,KAAK,CAAC;oBAAE,OAAO,EAAE,MAAM,CAAC;oBAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;iBAAE,CAAC,CAAA;aAAE,CAAC;SAC3E,CAAC;KACH,CAAC;IACF,oBAAoB,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK;QAC5C,OAAO,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC3E,CAAC;IACF,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK;QACjC,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,CAAC,EAAE;YAAE,MAAM,EAAE,KAAK,CAAC;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC3E,CAAC;CACH;AAMD;;;GAGG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAU1D;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,aAAkB,GAAG,SAAS,CA8KrE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnE"}

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

@@ -0,0 +1,44 @@
+import { DataModel, DynamicValue } from './types';
+/**
+ * Get a value from an object by JSON Pointer path.
+ *
+ * @example
+ * const data = { user: { name: "John", profile: { age: 30 } } };
+ * getByPath(data, "/user/name") // "John"
+ * getByPath(data, "/user/profile/age") // 30
+ * getByPath(data, "/missing") // undefined
+ */
+export declare function getByPath(obj: unknown, path: string): unknown;
+/**
+ * Set a value in an object by JSON Pointer path.
+ * Creates intermediate objects as needed.
+ *
+ * @example
+ * const data = {};
+ * setByPath(data, "/user/name", "John");
+ * // data is now { user: { name: "John" } }
+ */
+export declare function setByPath(obj: Record<string, unknown>, path: string, value: unknown): void;
+/**
+ * Check if a value is a dynamic path reference.
+ */
+export declare function isDynamicPath(value: unknown): value is {
+    path: string;
+};
+/**
+ * Resolve a dynamic value against a data model.
+ * If the value is a path reference, look it up in the data model.
+ * Otherwise, return the literal value.
+ *
+ * @example
+ * const data = { user: { name: "John" } };
+ * resolveDynamicValue("Hello", data) // "Hello"
+ * resolveDynamicValue({ path: "/user/name" }, data) // "John"
+ */
+export declare function resolveDynamicValue<T>(value: DynamicValue<T>, dataModel: DataModel): T | undefined;
+/**
+ * Resolve all dynamic values in an object.
+ * Recursively resolves any { path: string } references.
+ */
+export declare function resolveProps(props: Record<string, unknown>, dataModel: DataModel): Record<string, unknown>;
+//# sourceMappingURL=data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/catalog/data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAwB7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAOvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,SAAS,EAAE,SAAS,GACnB,CAAC,GAAG,SAAS,CAUf;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,SAAS,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}

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

@@ -0,0 +1,35 @@
+/**
+ * SF Catalog Module — json-render integration
+ *
+ * Provides SignalFlare AI component definitions and renderers for use with
+ * the json-render generative UI framework.
+ *
+ * @see https://github.com/vercel-labs/json-render
+ *
+ * @example
+ * ```ts
+ * import { sfComponentDefinitions, sfComponents } from "@signalflare-ai/ui/catalog";
+ * import { defineCatalog, schema } from "@json-render/core";
+ * import { defineRegistry, Renderer } from "@json-render/react";
+ *
+ * // 1. Create a catalog
+ * const catalog = defineCatalog(schema, {
+ *   components: sfComponentDefinitions,
+ * });
+ *
+ * // 2. Create a registry with component renderers
+ * const { registry } = defineRegistry(catalog, {
+ *   components: sfComponents,
+ * });
+ *
+ * // 3. Render a spec
+ * <Renderer spec={spec} registry={registry} />
+ * ```
+ */
+export { sfComponentDefinitions } from './sf-components';
+export { sfComponents } from './sf-registry';
+export { defineCatalog, buildUserPrompt, validateSpec, autoFixSpec, evaluateVisibility, createStateStore, getByPath, setByPath, resolveDynamicValue, deepMergeSpec, diffToPatches, } from '@json-render/core';
+export type { Catalog, Spec, UIElement, FlatElement, DynamicValue, VisibilityCondition, StateStore, StateModel, ActionBinding, ActionConfirm, PromptOptions, JsonSchemaOptions, SpecValidationResult, VisibilityContext, InferCatalogComponents, InferCatalogActions, InferComponentProps, InferActionParams, } from '@json-render/core';
+export { schema, defineRegistry, createRenderer, Renderer, JSONUIProvider, useUIStream, useChatUI, useJsonRenderMessage, useBoundProp, StateProvider, VisibilityProvider, ActionProvider, ValidationProvider, } from '@json-render/react';
+export type { BaseComponentProps, ComponentFn, Components, ActionFn, Actions, EventHandle, SetState, ComponentContext, DefineRegistryResult, CreateRendererProps, ComponentMap, ComponentRenderProps, ComponentRenderer, ComponentRegistry, JSONUIProviderProps, RendererProps, UseUIStreamOptions, UseUIStreamReturn, UseChatUIOptions, UseChatUIReturn, ChatMessage, } from '@json-render/react';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,OAAO,EACP,IAAI,EACJ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,UAAU,EACV,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,MAAM,EACN,cAAc,EACd,cAAc,EACd,QAAQ,EACR,cAAc,EACd,WAAW,EACX,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,EACP,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/src/catalog/sf-components.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const sfComponentDefinitions: Record<string, {
+    props: z.ZodTypeAny;
+    slots?: string[];
+    description: string;
+    example?: Record<string, unknown>;
+}>;
+//# sourceMappingURL=sf-components.d.ts.map

package/dist/src/catalog/sf-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sf-components.d.ts","sourceRoot":"","sources":["../../../src/catalog/sf-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,MAAM,EACN;IACE,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAuZF,CAAC"}

package/dist/src/catalog/sf-registry.d.ts

@@ -0,0 +1,4 @@
+import { BaseComponentProps } from '@json-render/react';
+import { default as React } from 'react';
+export declare const sfComponents: Record<string, (bp: BaseComponentProps) => React.ReactNode>;
+//# sourceMappingURL=sf-registry.d.ts.map

package/dist/src/catalog/sf-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sf-registry.d.ts","sourceRoot":"","sources":["../../../src/catalog/sf-registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAe7D,OAAO,KAAK,MAAM,OAAO,CAAC;AAmL1B,eAAO,MAAM,YAAY,EAAE,MAAM,CAC/B,MAAM,EACN,CAAC,EAAE,EAAE,kBAAkB,KAAK,KAAK,CAAC,SAAS,CA8T5C,CAAC"}

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

@@ -0,0 +1,226 @@
+/**
+ * Runtime types for SF 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 createSFCatalog.
+ */
+export interface CatalogConfig {
+    /** Action definitions (optional) */
+    actions?: Record<string, ActionDefinition>;
+}
+/**
+ * Runtime catalog instance.
+ */
+export interface SFCatalog {
+    /** 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;AAGH,OAAO,KAAK,EACV,mBAAmB,EAEnB,SAAS,EACT,SAAS,EACV,MAAM,SAAS,CAAC;AAEjB;;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/command-line/build-cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+/**
+ * Build script for the SF CLI.
+ * Bundles the single public CLI entrypoint to dist/command-line/cli.js.
+ */
+export {};
+//# sourceMappingURL=build-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-cli.d.ts","sourceRoot":"","sources":["../../../src/command-line/build-cli.ts"],"names":[],"mappings":";AACA;;;GAGG"}

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

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * SF CLI - Component registry and blocks distribution
+ *
+ * Usage:
+ *   sf init                 Initialize sf.json configuration
+ *   sf ls                   List all components
+ *   sf doc <name>           Get documentation for a component
+ *   sf docs                 Get documentation for all components
+ *   sf help                 Show this help message
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/command-line/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}

package/dist/src/command-line/commands/add.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Add a SF block to the project
+ * Usage: sf add <block-name>
+ */
+/**
+ * Add a block to the project
+ */
+export declare function add(blockName: string | undefined): Promise<void>;
+//# sourceMappingURL=add.d.ts.map

package/dist/src/command-line/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/add.ts"],"names":[],"mappings":";AACA;;;GAGG;AAkGH;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkJtE"}

package/dist/src/command-line/commands/ai.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Output AI usage guide for @signalflare-ai/ui
+ * Usage: sf ai
+ */
+/**
+ * Print the AI usage guide to stdout
+ */
+export declare function ai(): void;
+//# sourceMappingURL=ai.d.ts.map

package/dist/src/command-line/commands/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/ai.ts"],"names":[],"mappings":";AACA;;;GAGG;AAMH;;GAEG;AACH,wBAAgB,EAAE,IAAI,IAAI,CAczB"}

package/dist/src/command-line/commands/blocks.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * List all SF blocks available for CLI installation
+ * Usage: sf blocks
+ */
+/**
+ * List all blocks grouped by category
+ */
+export declare function blocks(): void;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/src/command-line/commands/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/blocks.ts"],"names":[],"mappings":";AACA;;;GAGG;AAsCH;;GAEG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAmD7B"}

package/dist/src/command-line/commands/doc.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Get documentation for a specific SF component
+ * Usage: sf doc <ComponentName>
+ */
+/**
+ * Output documentation for all components
+ */
+export declare function docs(): void;
+/**
+ * Get documentation for a specific component
+ */
+export declare function doc(componentName?: string): void;
+//# sourceMappingURL=doc.d.ts.map

package/dist/src/command-line/commands/doc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/doc.ts"],"names":[],"mappings":";AACA;;;GAGG;AAoMH;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAsB3B;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CA+BhD"}