@a4ui/core 0.1.1 → 0.3.0

package/dist/ui/Toggle.d.ts

@@ -1,8 +1,20 @@
 import { JSX, ParentProps } from 'solid-js';
 interface ToggleProps extends ParentProps {
+    /** Whether the toggle is pressed/"on". Controlled — pair with `onChange`. */
     pressed: boolean;
     onChange: (pressed: boolean) => void;
     class?: string;
 }
+/**
+ * Two-state toggle button (e.g. bold/italic, mute, favorite), built on
+ * Kobalte's ToggleButton primitive. `children` is the button's content
+ * (icon and/or text).
+ *
+ * @example
+ * ```tsx
+ * const [pressed, setPressed] = createSignal(false)
+ * <Toggle pressed={pressed()} onChange={setPressed}><StarIcon /></Toggle>
+ * ```
+ */
 export declare function Toggle(props: ToggleProps): JSX.Element;
 export {};

package/dist/ui/ToggleGroup.d.ts

@@ -1,13 +1,33 @@
 import { JSX } from 'solid-js';
+/** One option in a {@link ToggleGroup}: its `value` and visible `label`. */
 export interface ToggleGroupOption {
     value: string;
     label: string;
 }
 interface ToggleGroupProps {
+    /** Currently selected option's `value`, or `null` if none is selected. Controlled — pair with `onChange`. */
     value: string | null;
     onChange: (value: string | null) => void;
+    /** Options to render, in order, as segmented buttons. */
     options: ToggleGroupOption[];
     class?: string;
 }
+/**
+ * Single-select segmented button row, built on Kobalte's ToggleGroup
+ * primitive — for exclusive-choice controls like view mode or alignment.
+ *
+ * @example
+ * ```tsx
+ * const [align, setAlign] = createSignal<string | null>('left')
+ * <ToggleGroup
+ *   value={align()}
+ *   onChange={setAlign}
+ *   options={[
+ *     { value: 'left', label: 'Left' },
+ *     { value: 'center', label: 'Center' },
+ *   ]}
+ * />
+ * ```
+ */
 export declare function ToggleGroup(props: ToggleGroupProps): JSX.Element;
 export {};

package/dist/ui/Tooltip.d.ts

@@ -1,7 +1,20 @@
 import { JSX, ParentProps } from 'solid-js';
 interface TooltipProps extends ParentProps {
+    /** Content shown inside the tooltip popover. */
     content: JSX.Element;
+    /** Applied to the tooltip popover (`KTooltip.Content`), not the trigger. */
     class?: string;
 }
+/**
+ * Hover/focus tooltip, built on Kobalte's Tooltip primitive. `children` is
+ * the trigger element; `content` is rendered in a portal on hover/focus.
+ *
+ * @example
+ * ```tsx
+ * <Tooltip content="Delete this item">
+ *   <IconButton icon={<TrashIcon />} aria-label="Delete" />
+ * </Tooltip>
+ * ```
+ */
 export declare function Tooltip(props: TooltipProps): JSX.Element;
 export {};

package/dist/ui/VirtualList.d.ts

@@ -11,5 +11,19 @@ interface VirtualListProps<T> {
     /** Row renderer. `index` is an accessor so it stays reactive as rows recycle. */
     children: (item: T, index: Accessor<number>) => JSX.Element;
 }
+/**
+ * Virtualized list built on `@tanstack/solid-virtual` — renders only the
+ * visible rows (plus `overscan`) so lists of any length mount and scroll
+ * instantly. The scroll container's height MUST be constrained via `class`
+ * (e.g. `"h-[65vh]"`); virtualization requires a fixed viewport to measure
+ * against.
+ *
+ * @example
+ * ```tsx
+ * <VirtualList each={rows()} estimateSize={40} class="h-[65vh]">
+ *   {(row, index) => <div>{index()}: {row.name}</div>}
+ * </VirtualList>
+ * ```
+ */
 export declare function VirtualList<T>(props: VirtualListProps<T>): JSX.Element;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a4ui/core",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "A4ui — Spatial Glass design system & component library for SolidJS (Kobalte behavior + Tailwind glass tokens + motion).",
   "type": "module",
   "license": "MIT",
@@ -48,8 +48,9 @@
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",
-    "preview": "vite --config vite.preview.config.ts",
-    "preview:build": "vite build --config vite.preview.config.ts",
+    "preview": "node scripts/gen-llms.mjs && vite --config vite.preview.config.ts",
+    "preview:build": "node scripts/gen-llms.mjs && vite build --config vite.preview.config.ts",
+    "gen:llms": "node scripts/gen-llms.mjs",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src",
     "test": "playwright test",