@a4ui/core 0.7.0 → 0.8.1

package/dist/ui/Calendar.d.ts

@@ -7,10 +7,10 @@ export interface CalendarProps {
     class?: string;
 }
 /**
- * Full-month calendar: a header with the month/year and prev/next navigation, a
- * row of weekday labels, and a 6×7 grid of day buttons. Days outside the shown
- * month are muted; the selected day is filled and "today" gets a ring. Clicking a
- * day calls `onChange`. Theme-agnostic (semantic tokens only), always visible.
+ * Full-month calendar: a header with month/year navigation and a 6×7 grid of
+ * day buttons. Click the month or year in the header to jump straight to a month
+ * or year picker; the double chevrons step a whole year at a time. The selected
+ * day is filled and "today" gets a ring. Theme-agnostic, always visible.
  *
  * @example
  * ```tsx

package/dist/ui/Clock.d.ts

@@ -0,0 +1,28 @@
+import { JSX } from 'solid-js';
+export interface ClockProps {
+    /** 'digital' (default) or 'analog'. */
+    variant?: 'digital' | 'analog';
+    /** Show the seconds hand / seconds digits. @default true */
+    seconds?: boolean;
+    /** 12-hour clock with AM/PM instead of 24-hour. @default false */
+    hour12?: boolean;
+    /** IANA time zone (e.g. 'America/Hermosillo'); defaults to the local zone. */
+    timeZone?: string;
+    /** Diameter in px for the analog face. @default 160 */
+    size?: number;
+    class?: string;
+}
+/**
+ * Live, self-updating clock. Ticks once per second from a single interval
+ * (started in `onMount`, cleared in `onCleanup`) and renders either a digital
+ * `HH:MM:SS` readout or an analog SVG dial. Pass `timeZone` to show a specific
+ * IANA zone instead of the viewer's local time.
+ *
+ * @example
+ * ```tsx
+ * <Clock />
+ * <Clock variant="analog" size={200} timeZone="America/Hermosillo" />
+ * <Clock hour12 seconds={false} />
+ * ```
+ */
+export declare function Clock(props: ClockProps): JSX.Element;

package/dist/ui/Countdown.d.ts

@@ -9,7 +9,8 @@ export interface CountdownProps {
 /**
  * Live countdown to `props.to`, shown as four cells (Days / Hours / Mins /
  * Secs). Updates every second and calls `props.onComplete` once when it hits
- * zero. Hours, minutes, and seconds are zero-padded to two digits.
+ * zero. Each digit rolls like an old flip clock as it changes. Hours, minutes,
+ * and seconds are zero-padded to two digits.
  *
  * @example
  * ```tsx

package/dist/ui/DateTimeField.d.ts

@@ -0,0 +1,28 @@
+import { JSX } from 'solid-js';
+export interface DateTimeFieldProps {
+    /** Selected moment as `YYYY-MM-DD HH:MM` (local), or `''` for none. */
+    value: string;
+    /** Called with the combined `YYYY-MM-DD HH:MM` (either part may be missing). */
+    onChange: (value: string) => void;
+    /** 12-hour time display with AM/PM. @default false */
+    hour12?: boolean;
+    /** Minute increment for the time options. @default 5 */
+    minuteStep?: number;
+    /** Placeholder for the date half. */
+    dateLabel?: string;
+    /** Placeholder for the time half. */
+    timeLabel?: string;
+    disabled?: boolean;
+    class?: string;
+}
+/**
+ * Date + time picker built from {@link DateField} and {@link TimeField}. Speaks a
+ * single `YYYY-MM-DD HH:MM` string; the two halves fill in independently.
+ *
+ * @example
+ * ```tsx
+ * const [when, setWhen] = createSignal('2026-07-15 09:30')
+ * <DateTimeField value={when()} onChange={setWhen} hour12 />
+ * ```
+ */
+export declare function DateTimeField(props: DateTimeFieldProps): JSX.Element;

package/dist/ui/Sortable.d.ts

@@ -0,0 +1,33 @@
+import { JSX } from 'solid-js';
+export interface SortableProps<T> {
+    /** The items to render, in current order. */
+    items: T[];
+    /** Stable unique key for an item (used for drag tracking + list keying). */
+    itemKey: (item: T) => string;
+    /** Render an item's content (the grip handle is added automatically to its left). */
+    children: (item: T) => JSX.Element;
+    /** Called with the new order after a drop. */
+    onReorder: (items: T[]) => void;
+    /** Disable dragging. */
+    disabled?: boolean;
+    class?: string;
+}
+/**
+ * Vertical list whose rows reorder by dragging a grip handle. Pointer-events
+ * driven (works with mouse and touch): the grabbed row leaves behind a dashed
+ * placeholder while a floating clone follows the pointer, and other rows shift
+ * live as the pointer crosses their midpoint. `onReorder` fires once on drop
+ * with the final order.
+ *
+ * @example
+ * ```tsx
+ * <Sortable
+ *   items={fields()}
+ *   itemKey={(f) => f.id}
+ *   onReorder={setFields}
+ * >
+ *   {(field) => <span>{field.label}</span>}
+ * </Sortable>
+ * ```
+ */
+export declare function Sortable<T>(props: SortableProps<T>): JSX.Element;

package/dist/ui/TimeField.d.ts

@@ -0,0 +1,27 @@
+import { JSX } from 'solid-js';
+export interface TimeFieldProps {
+    /** Selected time as canonical 24h "HH:MM" (e.g. "15:05"), or "" for none. */
+    value: string;
+    /** Called with the newly picked time as "HH:MM" (24h). */
+    onChange: (value: string) => void;
+    /** 12-hour display with AM/PM instead of 24-hour. @default false */
+    hour12?: boolean;
+    /** Minute increment for the options list. @default 5 */
+    minuteStep?: number;
+    /** Placeholder shown on the trigger when value is empty. */
+    label?: string;
+    disabled?: boolean;
+    class?: string;
+}
+/**
+ * Compact hand-rolled hour/minute (/ AM-PM) column picker (no Kobalte primitive
+ * covers this yet). Trigger button opens a portaled popover; closes on outside
+ * click, Escape, scroll, or resize. Speaks plain 24h `HH:MM` strings.
+ *
+ * @example
+ * ```tsx
+ * const [time, setTime] = createSignal('15:05')
+ * <TimeField value={time()} onChange={setTime} label="Start time" hour12 />
+ * ```
+ */
+export declare function TimeField(props: TimeFieldProps): JSX.Element;

package/dist/ui/internal/CalendarCore.d.ts

@@ -0,0 +1,22 @@
+import { JSX } from 'solid-js';
+export interface CalendarCoreProps {
+    /** Currently selected day (for highlight); undefined = none. */
+    selected?: Date;
+    /** Called with the newly picked day. */
+    onPick: (date: Date) => void;
+    /** 0 = Sunday-first, 1 = Monday-first. @default 0 */
+    weekStart?: 0 | 1;
+    /** Full month names, January…December order (12). */
+    months?: string[];
+    /** Weekday headers in DISPLAY order, matching `weekStart` (7). */
+    weekdays?: string[];
+    /** Month first shown (its year/month seed the view). @default today */
+    initialView?: Date;
+    class?: string;
+}
+/**
+ * The interactive calendar body: a header (year/month jumps + drill-down) and a
+ * grid that switches between day, month, and year views. Stateless about
+ * open/closed — the caller decides where it lives.
+ */
+export declare function CalendarCore(props: CalendarCoreProps): JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a4ui/core",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "A4ui — Spatial Glass design system & component library for SolidJS (Kobalte behavior + Tailwind glass tokens + motion).",
   "type": "module",
   "license": "MIT",
@@ -37,16 +37,30 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
-    "./preset": "./preset.js",
-    "./styles.css": "./dist/styles.css"
+    "./preset": {
+      "import": "./preset.js",
+      "default": "./preset.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./elements": {
+      "import": "./dist/elements.js",
+      "default": "./dist/elements.js"
+    },
+    "./elements.css": "./dist/elements.css",
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=20"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "vite build",
+    "build": "vite build && npm run build:elements",
+    "build:elements": "vite build --config vite.elements.config.ts && node scripts/build-elements-css.mjs",
     "dev": "vite build --watch",
     "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",
@@ -60,7 +74,9 @@
     "test:ui": "playwright test --ui",
     "test:a11y": "playwright test a11y --project=desktop",
     "test:report": "playwright show-report",
-    "prepublishOnly": "npm run build",
+    "test:package": "node scripts/test-package.mjs",
+    "validate": "npm run typecheck && npm run lint && npm run test:unit && npm run build",
+    "prepublishOnly": "npm run validate",
     "prepare": "husky"
   },
   "lint-staged": {
@@ -99,6 +115,7 @@
     "lint-staged": "^16.4.0",
     "playwright-core": "^1.61.1",
     "prettier": "^3.9.5",
+    "solid-element": "^1.9.2",
     "tailwindcss": "^3.4.19",
     "typescript": "^5.6.0",
     "typescript-eslint": "^8.64.0",

package/preset.js

@@ -14,7 +14,9 @@
 //     content: ['./src/**/*.{ts,tsx}', './node_modules/@a4ui/core/dist/**/*.js'],
 //   }
 
-import plugin from 'tailwindcss/plugin'
+// Explicit .js extension so the preset resolves under strict Node ESM (used by
+// our elements-css build), not just bundlers.
+import plugin from 'tailwindcss/plugin.js'
 
 // Frosted "space glass" surfaces. addComponents so they tree-shake like any
 // utility (emitted only when the class is found in scanned content — a4ui's own