@pithyjs/ui-kit 0.1.0-beta.0

package/dist/icons/registry.d.ts

@@ -0,0 +1,65 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.icon-registry",
+  "title": "Icon Sprite Registry",
+  "category": "runtime"
+}
+*/
+export interface IconMeta {
+    /** Original viewBox from the SVG (e.g. "0 0 24 24") */
+    viewBox?: string;
+    /** Search tags for the site builder icon picker */
+    tags?: string[];
+}
+/**
+ * Register an SVG sprite and its available icon names.
+ *
+ * Typically called once at app startup from the `virtual:pithy-icons` module:
+ * ```ts
+ * import { SPRITE_URL, ICON_NAMES } from "virtual:pithy-icons";
+ * import { registerIconSprite } from "@pithyjs/ui-kit/icons";
+ * registerIconSprite(SPRITE_URL, ICON_NAMES);
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"registerIconSprite","stability":"stable","signature":"(url: string, names: string[], meta?: Record<string, IconMeta>) => void"} */
+export declare function registerIconSprite(url: string, names: string[], meta?: Record<string, IconMeta>): void;
+/**
+ * Look up an icon by name and return the sprite `<use>` href.
+ *
+ * Returns `null` if the icon is not registered or no sprite has been loaded.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"lookupIcon","stability":"stable","signature":"(name: string) => { href: string; viewBox?: string } | null"} */
+export declare function lookupIcon(name: string): {
+    href: string;
+    viewBox?: string;
+} | null;
+/**
+ * Enumerate all registered icon names.
+ *
+ * Used by the site builder icon picker to populate the icon grid.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"getRegisteredIcons","stability":"stable","signature":"() => string[]"} */
+export declare function getRegisteredIcons(): string[];
+/**
+ * Get metadata for a specific icon.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"getIconMeta","stability":"stable","signature":"(name: string) => IconMeta | undefined"} */
+export declare function getIconMeta(name: string): IconMeta | undefined;
+/**
+ * Check whether a sprite has been registered.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"hasIconSprite","stability":"stable","signature":"() => boolean"} */
+export declare function hasIconSprite(): boolean;
+/**
+ * Get the registered sprite URL.
+ *
+ * Returns `null` if no sprite has been registered.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"getSpriteUrl","stability":"stable","signature":"() => string | null"} */
+export declare function getSpriteUrl(): string | null;
+/**
+ * Clear the icon registry. Primarily used for testing.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"clearIconRegistry","stability":"stable","signature":"() => void"} */
+export declare function clearIconRegistry(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/icons/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/icons/registry.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AA+BF,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD;;;;;;;;;GASG;AACH,+LAA+L;AAC/L,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC9B,IAAI,CA8BN;AAED;;;;GAIG;AACH,2KAA2K;AAC3K,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW3C;AAED;;;;GAIG;AACH,sIAAsI;AACtI,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED;;GAEG;AACH,uJAAuJ;AACvJ,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAE9D;AAED;;GAEG;AACH,gIAAgI;AAChI,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,qIAAqI;AACrI,wBAAgB,YAAY,IAAI,MAAM,GAAG,IAAI,CAE5C;AAED;;GAEG;AACH,iIAAiI;AACjI,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC"}

package/dist/icons/registry.js

@@ -0,0 +1,126 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.icon-registry",
+  "title": "Icon Sprite Registry",
+  "category": "runtime"
+}
+*/
+/**
+ * Runtime icon sprite registry.
+ *
+ * **Client-only** — uses module-level singleton state. Do NOT use in SSR
+ * request handlers as state would be shared across requests. For SSR,
+ * icons should be resolved at build time or use a per-request context.
+ *
+ * Tree-shakeable: only bundled when explicitly imported.
+ * The Vite plugin (`pithy:icons`) generates sprite assets and calls
+ * `registerIconSprite()` at app startup via the `virtual:pithy-icons` module.
+ */
+// ---------------------------------------------------------------------------
+// Internal state
+// ---------------------------------------------------------------------------
+/** Sprite URL registered via `registerIconSprite()` */
+let spriteUrl = null;
+/** Set of available icon names in the sprite */
+const registeredNames = new Set();
+/** Optional metadata per icon (viewBox, tags, etc.) */
+const iconMeta = new Map();
+// ---------------------------------------------------------------------------
+// Registration API
+// ---------------------------------------------------------------------------
+/**
+ * Register an SVG sprite and its available icon names.
+ *
+ * Typically called once at app startup from the `virtual:pithy-icons` module:
+ * ```ts
+ * import { SPRITE_URL, ICON_NAMES } from "virtual:pithy-icons";
+ * import { registerIconSprite } from "@pithyjs/ui-kit/icons";
+ * registerIconSprite(SPRITE_URL, ICON_NAMES);
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"registerIconSprite","stability":"stable","signature":"(url: string, names: string[], meta?: Record<string, IconMeta>) => void"} */
+export function registerIconSprite(url, names, meta) {
+    const trimmedUrl = url?.trim() ?? '';
+    if (!trimmedUrl) {
+        if (import.meta.env?.DEV) {
+            console.warn(`[icon-registry] registerIconSprite() called with empty URL — icons will not resolve correctly.`);
+        }
+        clearIconRegistry();
+        return;
+    }
+    spriteUrl = trimmedUrl;
+    registeredNames.clear();
+    iconMeta.clear();
+    for (const name of names) {
+        const n = name.trim();
+        if (n)
+            registeredNames.add(n);
+    }
+    if (meta) {
+        for (const [name, m] of Object.entries(meta)) {
+            const trimmedName = name.trim();
+            if (trimmedName && registeredNames.has(trimmedName)) {
+                iconMeta.set(trimmedName, m);
+            }
+        }
+    }
+}
+/**
+ * Look up an icon by name and return the sprite `<use>` href.
+ *
+ * Returns `null` if the icon is not registered or no sprite has been loaded.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"lookupIcon","stability":"stable","signature":"(name: string) => { href: string; viewBox?: string } | null"} */
+export function lookupIcon(name) {
+    const trimmed = name?.trim();
+    if (!trimmed || !spriteUrl || !registeredNames.has(trimmed)) {
+        return null;
+    }
+    const meta = iconMeta.get(trimmed);
+    return {
+        href: `${spriteUrl}#${trimmed}`,
+        viewBox: meta?.viewBox,
+    };
+}
+/**
+ * Enumerate all registered icon names.
+ *
+ * Used by the site builder icon picker to populate the icon grid.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"getRegisteredIcons","stability":"stable","signature":"() => string[]"} */
+export function getRegisteredIcons() {
+    return [...registeredNames].sort();
+}
+/**
+ * Get metadata for a specific icon.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"getIconMeta","stability":"stable","signature":"(name: string) => IconMeta | undefined"} */
+export function getIconMeta(name) {
+    return iconMeta.get(name?.trim());
+}
+/**
+ * Check whether a sprite has been registered.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"hasIconSprite","stability":"stable","signature":"() => boolean"} */
+export function hasIconSprite() {
+    return spriteUrl !== null;
+}
+/**
+ * Get the registered sprite URL.
+ *
+ * Returns `null` if no sprite has been registered.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"getSpriteUrl","stability":"stable","signature":"() => string | null"} */
+export function getSpriteUrl() {
+    return spriteUrl;
+}
+/**
+ * Clear the icon registry. Primarily used for testing.
+ */
+/** @codexApi {"parent":"pithy.ui-kit.icon-registry","name":"clearIconRegistry","stability":"stable","signature":"() => void"} */
+export function clearIconRegistry() {
+    spriteUrl = null;
+    registeredNames.clear();
+    iconMeta.clear();
+}
+//# sourceMappingURL=registry.js.map

package/dist/icons/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/icons/registry.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+export { For, type ForProps } from './structural/For';
+export { Show, type ShowProps } from './structural/Show';
+export { NavLink, type NavLinkProps } from './structural/NavLink';
+export { Lazy, type LazyProps } from './structural/Lazy';
+export { ErrorBoundary, type ErrorBoundaryProps, } from './structural/ErrorBoundary';
+export { Stack, type StackProps } from './layout/Stack';
+export { Grid, type GridProps, type ResponsiveColumns } from './layout/Grid';
+export { GridItem, type GridItemProps } from './layout/GridItem';
+export { SmartContainer, type SmartContainerProps, } from './layout/SmartContainer';
+export { PageSection, type PageSectionProps } from './layout/PageSection';
+export { Button, type ButtonProps } from './atoms/actions/button/Button';
+export { SegmentedControl, type SegmentedControlProps, type SegmentedItem, } from './atoms/actions/segmented-control/SegmentedControl';
+export { IconGroup, type IconGroupProps, type IconGroupItem, } from './atoms/actions/icon-group/IconGroup';
+export { IconButton, type IconButtonProps, } from './atoms/actions/icon-button/IconButton';
+export { Tooltip, resetTooltipIdCounter, type TooltipProps, } from './atoms/feedback/tooltip/Tooltip';
+export type { FormControlBaseProps } from './shared/types';
+export { Input, type InputProps } from './atoms/forms/input/Input';
+export { Select, type SelectProps } from './atoms/forms/select/Select';
+export type { SelectOption } from './shared/select';
+export { Textarea, type TextareaProps } from './atoms/forms/textarea/Textarea';
+export { Checkbox, type CheckboxProps } from './atoms/forms/checkbox/Checkbox';
+export { CheckboxGroup, type CheckboxGroupProps, } from './atoms/forms/checkbox/CheckboxGroup';
+export { Radio, type RadioProps } from './atoms/forms/radio/Radio';
+export { RadioGroup, type RadioGroupProps, } from './atoms/forms/radio/RadioGroup';
+export { Toggle, type ToggleProps } from './atoms/forms/toggle/Toggle';
+export { FilePicker, type FilePickerProps, } from './atoms/forms/file-picker/FilePicker';
+export { FormField, type FormFieldProps, } from './atoms/forms/form-field/FormField';
+export { createFormState, type FormState, type FormStateOptions, type ValidateOn, } from './organisms/forms/form-state';
+export { checkRule, validateField, type ValidationRule, } from './organisms/forms/validation';
+export { Form, type FormProps, type FormResult } from './organisms/forms/Form';
+export { DynamicForm, type DynamicFormProps, type FormConfig, type FieldConfig, } from './organisms/forms/DynamicForm';
+export { Navbar, type NavbarProps, type NavbarItem, } from './organisms/navigation/Navbar';
+export { Modal, type ModalProps } from './organisms/feedback/Modal';
+export { Popover, type PopoverProps } from './organisms/feedback/Popover';
+export { Card, type CardProps } from './organisms/content/Card';
+export { CARD_VARIANTS, CARD_PADDINGS, CARD_RADII, CARD_MEDIA_ASPECTS, type CardVariant, type CardPadding, type CardRadius, type CardMediaAspect, } from './shared/card';
+export { Badge, type BadgeProps } from './atoms/content/badge/Badge';
+export { Text, type TextProps } from './atoms/content/text/Text';
+export { Heading, type HeadingProps } from './atoms/content/heading/Heading';
+export { Image, type ImageProps, type ImageSource, } from './atoms/content/image/Image';
+export { Icon, type IconProps } from './atoms/content/icon/Icon';
+export { Tile, type TileProps } from './atoms/content/tile/Tile';
+export { ActionTile, type ActionTileProps, } from './atoms/content/action-tile/ActionTile';
+export { readReactive, hasReactive, bindReactive, guardClick, type Reactive, type ReactiveText, } from './shared/clickable';
+export { FOCUSABLE_SELECTOR, getFirstFocusable } from './shared/focusable';
+export { HeroSection, type HeroSectionProps, } from './sections/hero/HeroSection';
+export { FeaturesSection, type FeaturesSectionProps, type FeatureItem, } from './sections/features/FeaturesSection';
+export { CTASection, type CTASectionProps } from './sections/cta/CTASection';
+export { ContactSection, type ContactSectionProps, type ContactInfo, } from './sections/contact/ContactSection';
+export { FooterSection, type FooterSectionProps, type FooterLinkGroup, } from './sections/footer/FooterSection';
+export { observeEntrance, ENTRANCE_CLASSES, type ObserveEntranceOptions, } from './sections/entrance';
+export { resetSectionIdCounter } from './shared/section';
+export { setEntranceConfig, getEntranceConfig, type EntrancePreset, type EntranceConfig, } from './shared/entrance-config';
+export { animateIn } from './animation/animate-in';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,KAAK,YAAY,GAClB,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,SAAS,EACT,KAAK,cAAc,GACpB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,UAAU,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,SAAS,EACT,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAG1E,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACL,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACjB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,WAAW,GACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,64 @@
+// Structural components
+export { For } from './structural/For';
+export { Show } from './structural/Show';
+export { NavLink } from './structural/NavLink';
+export { Lazy } from './structural/Lazy';
+export { ErrorBoundary, } from './structural/ErrorBoundary';
+// Layout components
+export { Stack } from './layout/Stack';
+export { Grid } from './layout/Grid';
+export { GridItem } from './layout/GridItem';
+export { SmartContainer, } from './layout/SmartContainer';
+export { PageSection } from './layout/PageSection';
+// Action components
+export { Button } from './atoms/actions/button/Button';
+export { SegmentedControl, } from './atoms/actions/segmented-control/SegmentedControl';
+export { IconGroup, } from './atoms/actions/icon-group/IconGroup';
+export { IconButton, } from './atoms/actions/icon-button/IconButton';
+export { Tooltip, resetTooltipIdCounter, } from './atoms/feedback/tooltip/Tooltip';
+export { Input } from './atoms/forms/input/Input';
+export { Select } from './atoms/forms/select/Select';
+export { Textarea } from './atoms/forms/textarea/Textarea';
+export { Checkbox } from './atoms/forms/checkbox/Checkbox';
+export { CheckboxGroup, } from './atoms/forms/checkbox/CheckboxGroup';
+export { Radio } from './atoms/forms/radio/Radio';
+export { RadioGroup, } from './atoms/forms/radio/RadioGroup';
+export { Toggle } from './atoms/forms/toggle/Toggle';
+export { FilePicker, } from './atoms/forms/file-picker/FilePicker';
+export { FormField, } from './atoms/forms/form-field/FormField';
+// Form organisms
+export { createFormState, } from './organisms/forms/form-state';
+export { checkRule, validateField, } from './organisms/forms/validation';
+export { Form } from './organisms/forms/Form';
+export { DynamicForm, } from './organisms/forms/DynamicForm';
+// Navigation organisms
+export { Navbar, } from './organisms/navigation/Navbar';
+// Feedback organisms
+export { Modal } from './organisms/feedback/Modal';
+export { Popover } from './organisms/feedback/Popover';
+// Content organisms
+export { Card } from './organisms/content/Card';
+export { CARD_VARIANTS, CARD_PADDINGS, CARD_RADII, CARD_MEDIA_ASPECTS, } from './shared/card';
+// Content components
+export { Badge } from './atoms/content/badge/Badge';
+export { Text } from './atoms/content/text/Text';
+export { Heading } from './atoms/content/heading/Heading';
+export { Image, } from './atoms/content/image/Image';
+export { Icon } from './atoms/content/icon/Icon';
+export { Tile } from './atoms/content/tile/Tile';
+export { ActionTile, } from './atoms/content/action-tile/ActionTile';
+// Shared
+export { readReactive, hasReactive, bindReactive, guardClick, } from './shared/clickable';
+export { FOCUSABLE_SELECTOR, getFirstFocusable } from './shared/focusable';
+// Section templates
+export { HeroSection, } from './sections/hero/HeroSection';
+export { FeaturesSection, } from './sections/features/FeaturesSection';
+export { CTASection } from './sections/cta/CTASection';
+export { ContactSection, } from './sections/contact/ContactSection';
+export { FooterSection, } from './sections/footer/FooterSection';
+export { observeEntrance, ENTRANCE_CLASSES, } from './sections/entrance';
+export { resetSectionIdCounter } from './shared/section';
+export { setEntranceConfig, getEntranceConfig, } from './shared/entrance-config';
+// Animation
+export { animateIn } from './animation/animate-in';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/layout/Grid.d.ts

@@ -0,0 +1,78 @@
+/** @codex
+{
+  "id": "pithy.ui-kit.grid",
+  "title": "<Grid> Layout Component",
+  "category": "feature"
+}
+*/
+import { type AlignItems, type JustifyContent } from '../shared/common';
+import { type SpacingSize, type ContainerBreakpoint } from '@pithyjs/design-system';
+/** @codexApi {"parent":"pithy.ui-kit.grid","name":"ResponsiveColumns","stability":"stable","signature":"type ResponsiveColumns = { base?: number } & Partial<Record<ContainerBreakpoint, number>>"} */
+export type ResponsiveColumns = {
+    /** Base columns (mobile-first default, default: 1) */
+    base?: number;
+} & Partial<Record<ContainerBreakpoint, number>>;
+/** @codexApi {"parent":"pithy.ui-kit.grid","name":"GridProps","stability":"stable","signature":"interface GridProps"} */
+export interface GridProps {
+    /** Column configuration: number, responsive object, or "auto-fit"/"auto-fill" (default: 1) */
+    columns?: number | ResponsiveColumns | 'auto-fit' | 'auto-fill';
+    /** Number of rows (1-6, optional) */
+    rows?: number;
+    /** Gap between children — maps to u-gap-* utilities (default: "md") */
+    gap?: SpacingSize;
+    /** Override gap for rows only — maps to u-row-gap-* */
+    rowGap?: SpacingSize;
+    /** Override gap for columns only — maps to u-col-gap-* */
+    colGap?: SpacingSize;
+    /** Cross-axis alignment — maps to u-items-* utilities */
+    align?: AlignItems;
+    /** Main-axis justification — maps to u-justify-* utilities */
+    justify?: JustifyContent;
+    /** CSS value for min column width, e.g. "250px", "15rem". Used by auto-fit/fill
+     *  and as the collapse threshold for fluid fixed-column grids
+     *  (default: auto-fit/fill uses 200px, fluid uses 9.375rem) */
+    minColumnWidth?: string;
+    /** HTML tag to render (default: "div") */
+    as?: keyof HTMLElementTagNameMap;
+}
+/**
+ * Layout atom that arranges children in a CSS grid.
+ *
+ * Mobile-first: defaults to 1 column. Supports simple column counts (which
+ * are fluid-responsive by default), explicit responsive breakpoints via
+ * container queries, and intrinsic auto-fit/fill patterns.
+ *
+ * When `columns` is a number ≥ 2, the grid uses a fluid CSS formula that
+ * targets that exact column count at wide widths but gracefully collapses
+ * to fewer columns at narrow widths — no breakpoints required.
+ *
+ * @example
+ * ```html
+ * <!-- Fluid 3-column grid (collapses gracefully on mobile) -->
+ * <Grid columns="3" gap="'lg'">
+ *   <div>Cell 1</div>
+ *   <div>Cell 2</div>
+ *   <div>Cell 3</div>
+ * </Grid>
+ *
+ * <!-- Explicit responsive: 1 col mobile → 2 col tablet → 3 col desktop -->
+ * <Grid columns="{ base: 1, sm: 2, lg: 3 }">
+ *   <div>A</div>
+ *   <div>B</div>
+ *   <div>C</div>
+ * </Grid>
+ *
+ * <!-- Auto-fit with minimum 250px columns -->
+ * <Grid columns="'auto-fit'" minColumnWidth="'250px'">
+ *   <div>Card</div>
+ *   <div>Card</div>
+ *   <div>Card</div>
+ * </Grid>
+ * ```
+ */
+/** @codexApi {"parent":"pithy.ui-kit.grid","name":"Grid","stability":"stable","signature":"(props?: GridProps) => { el: HTMLElement | DocumentFragment; destroy: () => void }"} */
+export declare function Grid({ columns, rows, gap: rawGap, rowGap: rawRowGap, colGap: rawColGap, align: rawAlign, justify: rawJustify, minColumnWidth, as, }?: GridProps): {
+    el: HTMLElement | DocumentFragment;
+    destroy: () => void;
+};
+//# sourceMappingURL=Grid.d.ts.map

package/dist/layout/Grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Grid.d.ts","sourceRoot":"","sources":["../../src/layout/Grid.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAGF,OAAO,EAOL,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAIhC,uMAAuM;AACvM,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjD,yHAAyH;AACzH,MAAM,WAAW,SAAS;IACxB,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAC;IAChE,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,uDAAuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;mEAE+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,EAAE,CAAC,EAAE,MAAM,qBAAqB,CAAC;CAClC;AA0ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,mLAAmL;AACnL,wBAAgB,IAAI,CAAC,EACnB,OAAW,EACX,IAAgB,EAChB,GAAG,EAAE,MAAa,EAClB,MAAM,EAAE,SAAqB,EAC7B,MAAM,EAAE,SAAqB,EAC7B,KAAK,EAAE,QAAoB,EAC3B,OAAO,EAAE,UAAsB,EAC/B,cAA0B,EAC1B,EAAU,GACX,GAAE,SAAc,GAAG;IAClB,EAAE,EAAE,WAAW,GAAG,gBAAgB,CAAC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAiNA"}