@exponential-at/ui-solid 0.0.0-stage → 0.1.0

package/dist/types/primitives/spinner.d.ts

@@ -0,0 +1,9 @@
+import { type JSX } from "solid-js";
+declare function Spinner(props: Omit<JSX.SvgSVGAttributes<SVGSVGElement>, `children`> & {
+    size?: number;
+    /** The accessible name; the glyph itself never carries words. */
+    label?: string;
+    class?: string;
+    [data: `data-${string}`]: string | undefined;
+}): JSX.Element;
+export { Spinner };

package/dist/types/primitives/switch.d.ts

@@ -0,0 +1,14 @@
+import { type ComponentProps, type JSX } from "solid-js";
+export type SwitchProps = Omit<ComponentProps<`button`>, `value` | `onChange`> & {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+    required?: boolean;
+    name?: string;
+    value?: string;
+    form?: string;
+    disabled?: boolean;
+    size?: `sm` | `default`;
+};
+declare function Switch(props: SwitchProps): JSX.Element;
+export { Switch };

package/dist/types/primitives/table.d.ts

@@ -0,0 +1,11 @@
+import { type ComponentProps } from "solid-js";
+declare function Table(props: ComponentProps<`table`>): import("solid-js").JSX.Element;
+declare function TableHeader(props: ComponentProps<`thead`>): import("solid-js").JSX.Element;
+declare function TableBody(props: ComponentProps<`tbody`>): import("solid-js").JSX.Element;
+declare function TableFooter(props: ComponentProps<`tfoot`>): import("solid-js").JSX.Element;
+/** A selected row says so with `data-state="selected"` (shadcn's convention). */
+declare function TableRow(props: ComponentProps<`tr`>): import("solid-js").JSX.Element;
+declare function TableHead(props: ComponentProps<`th`>): import("solid-js").JSX.Element;
+declare function TableCell(props: ComponentProps<`td`>): import("solid-js").JSX.Element;
+declare function TableCaption(props: ComponentProps<`caption`>): import("solid-js").JSX.Element;
+export { Table, TableHeader, TableBody, TableFooter, TableRow, TableHead, TableCell, TableCaption };

package/dist/types/primitives/tabs.d.ts

@@ -0,0 +1,29 @@
+import { type ComponentProps, type JSX } from "solid-js";
+export { SEGMENTED_ITEM, SEGMENTED_LIST, SEGMENTED_ROW, SEGMENTED_ROW_COMPACT, SEGMENTED_TAB } from "@exponential-at/ui/web/primitives";
+type Orientation = `horizontal` | `vertical`;
+type Dir = `ltr` | `rtl`;
+export type TabsProps = Omit<ComponentProps<`div`>, `dir`> & {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    orientation?: Orientation;
+    dir?: Dir;
+    activationMode?: `automatic` | `manual`;
+};
+declare function Tabs(props: TabsProps): JSX.Element;
+export type TabsListProps = ComponentProps<`div`> & {
+    loop?: boolean;
+};
+declare function TabsList(props: TabsListProps): JSX.Element;
+export type TabsTriggerProps = Omit<ComponentProps<`button`>, `value`> & {
+    value: string;
+    disabled?: boolean;
+};
+declare function TabsTrigger(props: TabsTriggerProps): JSX.Element;
+export type TabsContentProps = Omit<ComponentProps<`div`>, `style`> & {
+    value: string;
+    forceMount?: boolean;
+    style?: JSX.CSSProperties;
+};
+declare function TabsContent(props: TabsContentProps): JSX.Element;
+export { Tabs, TabsList, TabsTrigger, TabsContent };

package/dist/types/primitives/textarea.d.ts

@@ -0,0 +1,5 @@
+import { type ComponentProps } from "solid-js";
+/** React writes a controlled `value` as the textarea's TEXT (its default
+ *  value) as well as the property: both, here too. */
+declare function Textarea(props: ComponentProps<`textarea`>): import("solid-js").JSX.Element;
+export { Textarea };

package/dist/types/primitives/toast.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentProps } from "solid-js";
+import { type ToastStore } from "@exponential-at/ui/web/primitives";
+/** The default store `toast` writes to and `<Toaster />` reads. */
+export declare const toastStore: ToastStore;
+/** `toast("…")`, `toast.success("…", { description, action })`, … on the default store. */
+export declare const toast: import("@exponential-at/ui/web/primitives").ToastFn;
+export type ToasterProps = Omit<ComponentProps<`section`>, `children`> & {
+    store?: ToastStore;
+    /** The placement input (default: the `touchMaxWidth` media query). */
+    touch?: boolean;
+    /** The close glyph's label. */
+    closeLabel?: string;
+};
+export declare function Toaster(props: ToasterProps): import("solid-js").JSX.Element;
+export { createToastStore, toastStackGeometry, toastPlacement, TOAST_CONSTANTS, TOAST_KINDS, TOAST_TOUCH_QUERY } from "@exponential-at/ui/web/primitives";
+export type { ToastKind, ToastOptions, ToastRecord, ToastStore, ToastAction, ToastPlacement } from "@exponential-at/ui/web/primitives";

package/dist/types/primitives/tooltip.d.ts

@@ -0,0 +1,34 @@
+import { type ComponentProps, type JSX } from "solid-js";
+import { type Align, type OutsideEvent, type Side } from "../behaviors/index.js";
+import { type AsProps } from "../behaviors/dialog.js";
+export interface TooltipProviderProps {
+    delayDuration?: number;
+    skipDelayDuration?: number;
+    disableHoverableContent?: boolean;
+    children?: JSX.Element;
+}
+declare function TooltipProvider(props: TooltipProviderProps): JSX.Element;
+export interface TooltipProps {
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    delayDuration?: number;
+    disableHoverableContent?: boolean;
+    children?: JSX.Element;
+}
+declare function Tooltip(props: TooltipProps): JSX.Element;
+declare function TooltipTrigger(props: AsProps): JSX.Element;
+export type TooltipContentProps = Omit<ComponentProps<`div`>, `style`> & {
+    side?: Side;
+    align?: Align;
+    sideOffset?: number;
+    alignOffset?: number;
+    collisionPadding?: number;
+    container?: HTMLElement | null;
+    style?: JSX.CSSProperties;
+    "aria-label"?: string;
+    onEscapeKeyDown?: (e: KeyboardEvent) => void;
+    onPointerDownOutside?: (e: OutsideEvent) => void;
+};
+declare function TooltipContent(props: TooltipContentProps): JSX.Element;
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider };

package/dist/types/primitives/truncate.d.ts

@@ -0,0 +1 @@
+export { middleTruncate } from "@exponential-at/ui/web/primitives";

package/dist/types/primitives/use-media-query.d.ts

@@ -0,0 +1,4 @@
+import { type Accessor } from "solid-js";
+/** Whether `query` matches right now, following changes (React's
+ *  `useMediaQuery`). Without a `window` or `matchMedia` it answers `false`. */
+export declare function createMediaQuery(query: string): Accessor<boolean>;

package/dist/types/primitives/use-mobile.d.ts

@@ -0,0 +1,4 @@
+import { type Accessor } from "solid-js";
+/** Below the mobile breakpoint (React's `useIsMobile`): read synchronously
+ *  at creation (no first-frame desktop flash), then followed. */
+export declare function createIsMobile(): Accessor<boolean>;

package/dist/types/primitives/use-sheet-drag.d.ts

@@ -0,0 +1,20 @@
+import type { JSX } from "solid-js";
+/** Did a downward drag of `dy` px over `dtMs` ms earn a dismissal? Upward
+ *  drags never do. */
+export declare function shouldDismissSheet(dy: number, dtMs: number): boolean;
+export interface SheetDragHandleProps {
+    onPointerDown: (event: PointerEvent & {
+        currentTarget: HTMLElement;
+    }) => void;
+    onPointerMove: (event: PointerEvent) => void;
+    onPointerUp: (event: PointerEvent) => void;
+    onPointerCancel: (event: PointerEvent) => void;
+    style: JSX.CSSProperties;
+}
+/** React's `useSheetDrag`: `panel()` = the sheet's panel element. */
+export declare function createSheetDrag(opts: {
+    panel: () => HTMLElement | null | undefined;
+    onDismiss: () => void;
+}): {
+    handleProps: SheetDragHandleProps;
+};

package/dist/types/style.d.ts

@@ -0,0 +1,6 @@
+export type StyleInput = Record<string, string | number | null | undefined | boolean>;
+export type SolidStyle = Record<string, string>;
+/** A React style object → Solid's (kebab-case keys, string values). */
+export declare function css(style: StyleInput | undefined | null): SolidStyle | undefined;
+/** A length prop (`width={390}` / `"100%"`) the React way. */
+export declare const px: (v: number | string) => string;

package/dist/types/surface.d.ts

@@ -0,0 +1,99 @@
+import { type JSX } from "solid-js";
+import type { ModeName, ResolvedTheme, ScrollAlign, ThemeIssue, ThemeSource, UiNode, SurfaceCommand } from "@exponential-at/ui";
+import { type DataModel } from "@exponential-at/ui/web";
+import { type SolidExtension } from "./extensions.js";
+import type { HostPlugin } from "./host.js";
+import type { SurfaceState } from "./create-surface.js";
+export type ThemeInput = ResolvedTheme | ThemeSource | string;
+/** What a host can ask of a live surface (`SurfaceCommand`, a11y.json). */
+export interface SurfaceHandle {
+    run: (command: SurfaceCommand) => void;
+    /** Focus the node (or its first focusable descendant); false if absent. */
+    focus: (id: string) => boolean;
+    announce: (text: string, live?: `polite` | `assertive`) => void;
+    scrollIntoView: (id: string) => boolean;
+    /** Item `index` (data order) of the List/Table `id` into view. */
+    scrollToIndex: (id: string, index: number, align?: ScrollAlign) => boolean;
+}
+export interface ExponentialSurfaceProps {
+    /** The state from `createSurface` (tree + data + templates)… */
+    surface?: SurfaceState;
+    /** …or a normalized tree (a fixture) with an optional data model… */
+    root?: UiNode | null;
+    /** …and its LIFTED templates (`ReduceResult.templates`). */
+    templates?: Readonly<Record<string, UiNode>>;
+    data?: DataModel;
+    /** A built-in id, a theme file (resolved against the built-ins) or a
+     *  resolved theme. */
+    theme?: ThemeInput;
+    /** `light | dark | system` (default `system`, followed live). */
+    mode?: ModeName | `system`;
+    density?: `compact` | `default` | `comfortable`;
+    contrast?: `normal` | `high` | `system`;
+    /** BCP 47 (default `en-US`). */
+    locale?: string;
+    /** IANA time zone (default the platform's). */
+    timeZone?: string;
+    /** Built-in string overrides by id (`catalog/strings.json`). */
+    strings?: Record<string, string>;
+    host?: HostPlugin;
+    extensions?: readonly SolidExtension[];
+    /** Forced interaction states on every node (the builder's recipe sheet). */
+    states?: readonly string[];
+    /** Geometry mode: leaves become fixed boxes of the returned size. */
+    measure?: (node: UiNode) => {
+        w: number;
+        h: number;
+    } | null;
+    /** Default: the locale's direction (`textDirection`). */
+    direction?: `ltr` | `rtl`;
+    /** The surface width; default = the host's box. */
+    width?: number | string;
+    /** The height of the VIEWPORT the surface is shown in (the height and
+     *  orientation conditions); default an explicit inline `style.height`,
+     *  else unknown. */
+    viewportHeight?: number;
+    /** An explicit id (defaults to `createUniqueId`); unique per page. */
+    id?: string;
+    /** Host → surface commands: called once with the surface's handle (React's
+     *  `handleRef`, as a Solid ref callback). */
+    handleRef?: (handle: SurfaceHandle) => void;
+    class?: string;
+    /** Solid's style form (kebab-case keys). */
+    style?: JSX.CSSProperties;
+    children?: JSX.Element;
+}
+/** A theme prop, resolved: the theme to paint with and why the asked one
+ *  was refused (empty when it loaded). */
+export interface ThemeResolution {
+    theme: ResolvedTheme;
+    issues: ThemeIssue[];
+}
+/** A theme prop → the resolved theme. NEVER throws (round 4). */
+export declare function resolveThemeInput(input: ThemeInput | undefined): ThemeResolution;
+/** The theme a surface runs with: density applied, then the contrast
+ *  overlays when asked (memoized per theme, so the compiled sheet is too). */
+export declare function surfaceTheme(theme: ResolvedTheme, density: `compact` | `default` | `comfortable`, highContrast: boolean): ResolvedTheme;
+/** What the surface knows of its box. */
+export interface SurfaceBox {
+    width: number;
+    /** Undefined = unknown. */
+    height: number | undefined;
+    measured: boolean;
+}
+export interface LayoutInputs {
+    breakpoints: Record<string, number>;
+    queries: readonly string[];
+    viewportHeight: number | undefined;
+    hover: boolean;
+    reducedMotion: boolean;
+}
+/** The only layout facts that reach the tree: the active breakpoint and the
+ *  matching JS-evaluated conditions (`data-xq`). */
+export declare function surfaceLayout(box: SurfaceBox, inputs: LayoutInputs): {
+    breakpoint: string | null;
+    xq: string;
+};
+/** Structural equality, short-circuiting on identity at every level. */
+export declare function sameData(a: unknown, b: unknown): boolean;
+export declare function ExponentialSurface(input: ExponentialSurfaceProps): JSX.Element;

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@exponential-at/ui-solid",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Exponential UI for SolidJS: the core A2UI catalog painted on plain elements (floating-ui, aria-hidden) with the same DOM, the same compiled stylesheet and the same runtime themes as the React renderer, run through the conformance suite and the web-parity check.",
+  "license": "Apache-2.0",
+  "homepage": "https://ui.exponential.at",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Niach/exponential.git",
+    "directory": "packages/exponential-ui-solid"
+  },
+  "keywords": [
+    "a2ui",
+    "generative-ui",
+    "exponential-ui"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./primitives": {
+      "types": "./dist/types/primitives/index.d.ts",
+      "import": "./dist/primitives.js",
+      "default": "./dist/primitives.js"
+    },
+    "./styles.css": "./dist/exponential-ui-solid.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "dependencies": {
+    "@exponential-at/ui": "^0.1.0",
+    "@floating-ui/dom": "^1.7.0",
+    "aria-hidden": "^1.2.6",
+    "lucide-solid": "0.544.0"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.9.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}