@svelte-atoms/core 1.0.0-alpha.41 → 1.0.0-alpha.46

package/dist/components/input/types.d.ts

@@ -1,22 +1,20 @@
-import type { HTMLInputTypeAttribute } from 'svelte/elements';
-import type { Base, HtmlAtomProps } from '../atom';
+import type { Base, HtmlAtomProps, SnippetProps } from '../atom';
 import type { Snippet } from 'svelte';
 import type { Override } from '../../types';
-/**
- * Extend this interface to add custom input root properties in your application.
- */
-export interface InputRootExtendProps {
+export interface InputSnippetProps extends SnippetProps {
 }
-/**
- * Extend this interface to add custom input control properties in your application.
- */
-export interface InputControlExtendProps {
-}
-export interface InputRootProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B>, InputRootExtendProps {
+export type InputChildren = Snippet<[InputSnippetProps]>;
+export type HourAmPmDigits = `0${number}` | `1${0 | 1 | 2}`;
+export type HourDigits = `${0 | 1}${number}` | `2${0 | 1 | 2 | 3}`;
+export type MinuteDigits = `${0 | 1 | 2 | 3 | 4 | 5}${number}`;
+export type SecondDigits = MinuteDigits;
+export type Time = `${HourAmPmDigits}:${MinuteDigits}`;
+export type TimeFull = `${HourDigits}:${MinuteDigits}`;
+export type InputControlType = 'text' | 'number' | 'email' | 'url' | 'tel' | 'file' | 'time' | 'datetime-local' | 'date' | 'color' | 'otp' | 'currency' | 'location' | null;
+export interface InputRootProps<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base> extends HtmlAtomProps<E, B, InputChildren> {
     value?: string | number | string[] | null;
     checked?: boolean;
     files?: File[] | null;
-    children?: Snippet<[]>;
 }
 interface InputControlBaseProps {
     value?: any;
@@ -25,9 +23,349 @@ interface InputControlBaseProps {
     number?: number;
     checked?: boolean;
     class?: string;
-    type?: HTMLInputTypeAttribute | null;
-    children?: Snippet<[]>;
+    type?: InputControlType | null;
+    children?: InputChildren;
+}
+export interface InputControlProps<B extends Base = Base> extends Override<HtmlAtomProps<'input', B>, InputControlBaseProps> {
+}
+export interface InputNumber12HourControlProps {
+    hourFormat: 12;
+    min?: Time;
+    max?: Time;
+}
+export interface InputNumber24HourControlProps {
+    hourFormat: 24;
+    min?: TimeFull;
+    max?: TimeFull;
+}
+export interface InputNumberControlProps {
+    /** Current numeric value */
+    number?: number;
+    /**
+     * Step increment/decrement amount
+     * @default 1
+     */
+    step?: number;
+    disabled?: boolean;
+    placeholder?: string;
+    showControls?: boolean;
+    /** Custom decrement button snippet */
+    decrement?: Snippet<[{
+        action: () => void;
+        disabled: boolean;
+    }]>;
+    /** Custom increment button snippet */
+    increment?: Snippet<[{
+        action: () => void;
+        disabled: boolean;
+    }]>;
+    onchange?: (ev?: Event, options?: {
+        number: number;
+    }) => void;
+}
+export interface InputNumberControlProps {
+    /** HH:MM or HH:MM:SS string (always 24h format internally) */
+    value?: string;
+    /** Optional Date object to sync time with (bindable) */
+    date?: Date | undefined;
+    /**
+     * Hour display format
+     * @default 24
+     */
+    hourFormat?: 12 | 24;
+    /** Show the seconds segment
+     * @default false
+     */
+    withSeconds?: boolean;
+    /** Minimum allowed time as HH:MM string (e.g. "08:00") */
+    min?: string;
+    /** Maximum allowed time as HH:MM string (e.g. "18:00") */
+    max?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+    }) => void;
+}
+export interface InputDateTimeControlProps {
+    /** datetime-local string value (YYYY-MM-DDTHH:MM or YYYY-MM-DDTHH:MM:SS) */
+    value?: string;
+    /** Parsed Date object (bindable, derived from value) */
+    date?: Date | null;
+    /** Render mode: 'datetime' shows date + time segments, 'date' shows date segments only
+     * @default 'datetime'
+     */
+    mode?: 'datetime';
+    /** Show the seconds segment
+     * @default false
+     */
+    withSeconds?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+        date: Date | null;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+        date: Date | null;
+    }) => void;
+}
+export interface InputDateControlProps {
+    /** date string value (YYYY-MM-DD) */
+    value?: string;
+    /** Parsed Date object (bindable, derived from value) */
+    date?: Date | null;
+    /** Always 'date' — set this to use date-only mode */
+    mode: 'date';
+    /** Ignored in date mode, kept for API compatibility */
+    withSeconds?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+        date: Date | null;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+        date: Date | null;
+    }) => void;
+}
+export interface InputFileControlProps {
+    /** Selected files (bindable) */
+    files?: File[];
+    /** Accepted MIME types / extensions (e.g. "image/*,.pdf") */
+    accept?: string;
+    multiple?: boolean;
+    disabled?: boolean;
+    placeholder?: string;
+    class?: string;
+    preset?: string;
+    /** Custom trigger content snippet */
+    triggerContent?: Snippet<[{
+        files: File[];
+        hasFiles: boolean;
+        open: () => void;
+    }]>;
+    onchange?: (ev: Event, options: {
+        files: File[];
+    }) => void;
+}
+export interface InputUrlControlProps {
+    /** Full URL string */
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+    }) => void;
+}
+export interface InputEmailControlProps {
+    /** Email address string */
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+    }) => void;
+}
+export interface InputTextControlProps {
+    /** Text value */
+    value?: string;
+    /**
+     * Input type. Supports `text`, `search`, and `password`.
+     * For a dedicated password control with a show/hide toggle, use `Input.PasswordControl`.
+     * @default 'text'
+     */
+    type?: 'text' | 'search' | 'password';
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+    }) => void;
 }
-export interface InputControlProps<B extends Base = Base> extends Override<HtmlAtomProps<'input', B>, InputControlBaseProps>, InputControlExtendProps {
+export interface InputLocationControlProps {
+    /**
+     * Raw string representation of the coordinate pair (e.g. "40.7128, -74.0060").
+     * Bindable — the component normalises pasted / typed input into this form.
+     */
+    value?: string;
+    /** Latitude in decimal degrees (bindable, derived from value) */
+    lat?: number;
+    /** Longitude in decimal degrees (bindable, derived from value) */
+    lng?: number;
+    /**
+     * Display / overlay format.
+     * - `"dd"`  — decimal degrees (default): `40.712800°, -74.006000°`
+     * - `"dms"` — degrees, minutes, seconds: `40°42'46.08"N, 74°00'21.60"W`
+     */
+    format?: 'dd' | 'dms';
+    /**
+     * Number of decimal places shown in `"dd"` mode.
+     * @default 6
+     */
+    precision?: number;
+    /**
+     * Show the crosshair "locate me" button (uses `navigator.geolocation`).
+     * @default true
+     */
+    locate?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        lat: number | undefined;
+        lng: number | undefined;
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        lat: number | undefined;
+        lng: number | undefined;
+        value: string;
+    }) => void;
+}
+export interface InputPhoneControlProps {
+    /** Clean digits only (no format chars). In free mode: full string. */
+    value?: string;
+    /**
+     * Input mask — `#` = required digit, `[#]` = optional digit, all other chars are literals.
+     *
+     * Optional digits and the literals between them are hidden when empty,
+     * shown as normal once filled. Digits fill left-to-right across all slots.
+     *
+     * Examples:
+     *   "(###) ###-####"               → fixed US format
+     *   "(+[#][#][#]) ### ###-####"    → 1–3 digit country code, rest fixed
+     *   "+[#][#][#] (###) ###-####"    → international with optional country digits
+     */
+    format?: string;
+    /**
+     * Optional segment color map — defines how digit slots are grouped and colored.
+     * Keys are segment names, values are digit counts.
+     * Must sum to the total number of `#` in format.
+     * Example: { country: 1, area: 3, prefix: 3, line: 4 }
+     * Available segment names: country (blue), area (bold), prefix, line, other
+     */
+    segments?: Record<string, number>;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    /**
+     * Optional snippet to render each overlay span.
+     * - `text`: the characters in this span
+     * - `class`: default Tailwind class (can be ignored)
+     * - `type`: segment type — `'country' | 'area' | 'prefix' | 'line' | 'other' | 'lit' | 'empty'`
+     * @example
+     * ```svelte
+     * {#snippet span({ text, class, type })}
+     *   <span class={type === 'country' ? 'text-green-500' : class}>{text}</span>
+     * {/snippet}
+     * ```
+     */
+    span?: Snippet<[PhoneSpan]>;
+}
+export interface InputCurrencyControlProps {
+    /** Raw decimal string value (bindable) e.g. "1234.50" */
+    value?: string;
+    /** Parsed number amount (bindable) */
+    amount?: number | undefined;
+    /** ISO 4217 currency code
+     * @default 'USD'
+     */
+    currency?: string;
+    /** BCP 47 locale for formatting
+     * @default 'en-US'
+     */
+    locale?: string;
+    /** Decimal precision
+     * @default 2
+     */
+    precision?: number;
+    /** Minimum allowed amount */
+    min?: number;
+    /** Maximum allowed amount */
+    max?: number;
+    /** Step size for arrow up/down. Defaults to 10^(-precision) */
+    step?: number;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+        amount: number | undefined;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+        amount: number | undefined;
+    }) => void;
+}
+export type { InputColorControlExtendProps, InputColorControlProps } from './color/types';
+export interface InputOtpControlProps {
+    /** Current OTP value — a string of entered characters (bindable) */
+    value?: string;
+    /** Number of slots
+     * @default 6
+     */
+    length?: number;
+    /** Character type constraint
+     * @default 'numeric'
+     */
+    type?: 'numeric' | 'alpha' | 'alphanumeric';
+    /** Group slots visually with a separator every N slots (e.g. 3 for "123—456") */
+    groupSize?: number;
+    /** Placeholder character shown in empty slots
+     * @default '·'
+     */
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    class?: string;
+    preset?: string;
+    onchange?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    oninput?: (ev: Event, options: {
+        value: string;
+    }) => void;
+    /** Fired when all slots are filled */
+    oncomplete?: (value: string) => void;
 }
-export {};

package/dist/components/kbd/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Kbd } from './kbd.svelte';
+export { default as Shortcut } from './shortcut.svelte';
+export * from './types';

package/dist/components/kbd/index.js

@@ -0,0 +1,3 @@
+export { default as Kbd } from './kbd.svelte';
+export { default as Shortcut } from './shortcut.svelte';
+export * from './types';

package/dist/components/kbd/kbd.svelte

@@ -0,0 +1,19 @@
+<script lang="ts">
+	import { HtmlAtom } from '../atom';
+	import type { KbdProps } from './types';
+
+	let { class: klass = '', children, ...restProps }: KbdProps = $props();
+</script>
+
+<HtmlAtom
+	preset="kbd"
+	as="kbd"
+	class={[
+		'kbd border-border bg-muted text-foreground inline-flex items-center justify-center rounded-md border px-1.5 py-0.5 font-mono text-xs font-medium shadow-[inset_0_-1px_0] shadow-black/10',
+		'$preset',
+		klass
+	]}
+	{...restProps}
+>
+	{@render children?.()}
+</HtmlAtom>

package/dist/components/kbd/kbd.svelte.d.ts

@@ -0,0 +1,4 @@
+import type { KbdProps } from './types';
+declare const Kbd: import("svelte").Component<KbdProps, {}, "">;
+type Kbd = ReturnType<typeof Kbd>;
+export default Kbd;

package/dist/components/kbd/shortcut.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+	import { HtmlAtom } from '../atom';
+	import Kbd from './kbd.svelte';
+	import type { ShortcutProps } from './types';
+
+	let {
+		class: klass = '',
+		keys = [],
+		separator = '+',
+		children,
+		...restProps
+	}: ShortcutProps = $props();
+
+	let content = $derived(children ?? defaultChildren)
+</script>
+
+{#snippet separatorContent()}
+	<span class="text-muted-foreground text-xs">{separator}</span>
+{/snippet}
+
+{#snippet defaultChildren()}
+	{#each keys as key, i ( key )}
+		{@const content = i > 0 ? separatorContent : null}
+	
+		{@render content?.()}
+		<Kbd>{key}</Kbd>
+	{/each}
+{/snippet}
+
+<HtmlAtom
+	preset="shortcut"
+	as="span"
+	class={['shortcut inline-flex items-center gap-1', '$preset', klass]}
+	aria-label={keys.join(' ' + separator + ' ')}
+	{...restProps}
+>
+	{@render content()}
+</HtmlAtom>

package/dist/components/kbd/shortcut.svelte.d.ts

@@ -0,0 +1,4 @@
+import type { ShortcutProps } from './types';
+declare const Shortcut: import("svelte").Component<ShortcutProps, {}, "">;
+type Shortcut = ReturnType<typeof Shortcut>;
+export default Shortcut;

package/dist/components/kbd/types.d.ts

@@ -0,0 +1,20 @@
+import type { Snippet } from 'svelte';
+import type { HtmlAtomProps } from '../atom';
+export interface KbdExtendProps {
+}
+export interface ShortcutExtendProps {
+}
+export interface KbdProps extends HtmlAtomProps<'kbd'>, KbdExtendProps {
+    children?: Snippet<[]>;
+}
+export interface ShortcutProps extends HtmlAtomProps<'span'>, ShortcutExtendProps {
+    /**
+     * Array of keys to render in sequence, e.g. ['⌘', 'K'] or ['Ctrl', 'Shift', 'P']
+     */
+    keys?: string[];
+    /**
+     * Separator between keys — default '+'
+     */
+    separator?: string;
+    children?: Snippet<[]>;
+}

package/dist/components/kbd/types.js

@@ -0,0 +1 @@
+export {};

package/dist/components/label/types.d.ts

@@ -1,11 +1,8 @@
 import type { Snippet } from 'svelte';
-import type { HtmlAtomProps, Base } from '../atom';
-/**
- * Extend this interface to add custom label properties in your application.
- */
-export interface LabelExtendProps {
+import type { HtmlAtomProps, Base, SnippetProps } from '../atom';
+export interface LabelSnippetProps extends SnippetProps {
 }
-export interface LabelProps<E extends keyof HTMLElementTagNameMap = 'label', B extends Base = Base> extends HtmlAtomProps<E, B>, LabelExtendProps {
+export type LabelChildren = Snippet<[LabelSnippetProps]>;
+export interface LabelProps<E extends keyof HTMLElementTagNameMap = 'label', B extends Base = Base> extends HtmlAtomProps<E, B, LabelChildren> {
     for?: string | null;
-    children?: Snippet<[]>;
 }

package/dist/components/layer/bond.svelte.d.ts

@@ -1,4 +1,4 @@
-import { Bond, BondState, type BondElements, type BondStateProps } from '../../shared/bond.svelte.js';
+import { Bond, BondState, type BondElements, type BondStateProps } from '../../shared/bond.svelte';
 export type LayerBondProps = BondStateProps & {
     readonly rest?: Record<string, unknown>;
 };
@@ -9,7 +9,7 @@ export type LayerBondElements = BondElements & {
 export declare class LayerBond extends Bond<LayerBondProps, LayerBondState, LayerBondElements> {
     static CONTEXT_KEY: string;
     constructor(atom: LayerBondState);
-    get targetElement(): HTMLElement | undefined;
+    get targetElement(): Element | import("@floating-ui/dom").VirtualElement | undefined;
     root(props?: Record<string, unknown>): {
         'data-kind': string;
     };

package/dist/components/layer/bond.svelte.js

@@ -1,6 +1,6 @@
 import { createAttachmentKey } from 'svelte/attachments';
 import { getContext, setContext } from 'svelte';
-import { Bond, BondState } from '../../shared/bond.svelte.js';
+import { Bond, BondState } from '../../shared/bond.svelte';
 const LAYER_ELEMENTS_KIND = {
     root: 'layer-root',
     inner: 'layer-inner'

package/dist/components/layer/index.d.ts

@@ -1,2 +1,3 @@
 export * as Layer from './atoms';
 export { LayerBond as LayerAtom, LayerBondState, type LayerBondProps } from './bond.svelte';
+export type { LayerSnippetProps, LayerChildren } from './types';

package/dist/components/layer/layer-inner.svelte

@@ -15,12 +15,6 @@
 	let {
 		class: klass = '',
 		children = undefined,
-		onmount = undefined,
-		ondestroy = undefined,
-		animate = undefined,
-		enter = undefined,
-		exit = undefined,
-		initial = undefined,
 		...restProps
 	}: HtmlAtomProps<E, B> & HTMLAttributes<Element> = $props();
 
@@ -33,12 +27,6 @@
 <HtmlAtom
 	preset="layer.inner"
 	class={['relative size-full', '$preset', klass]}
-	enter={enter?.bind(bond.state)}
-	exit={exit?.bind(bond.state)}
-	initial={initial?.bind(bond.state)}
-	animate={animate?.bind(bond.state)}
-	onmount={onmount?.bind(bond.state)}
-	ondestroy={ondestroy?.bind(bond.state)}
 	{...innerProps}
 >
 	{@render children?.()}

package/dist/components/layer/layer-inner.svelte.d.ts

@@ -1,7 +1,7 @@
 import type { HTMLAttributes } from 'svelte/elements';
 import { type ElementType, type HtmlAtomProps, type Base } from '../atom';
 declare function $$render<E extends keyof HTMLElementTagNameMap = 'div', B extends Base = Base>(): {
-    props: HtmlAtomProps<E, B> & HTMLAttributes<ElementType<E>>;
+    props: HtmlAtomProps<E, B, import("svelte").Snippet<[]>> & HTMLAttributes<ElementType<E>>;
     exports: {};
     bindings: "";
     slots: {};