@cruglobal/cornerstone-components 0.1.0

package/dist/unbundled/components/tab-group/tab-group.d.ts

@@ -0,0 +1,84 @@
+import CornerstoneElement from '../../internal/cornerstone-element.js';
+import '../button/button.js';
+import '../tab-panel/tab-panel.js';
+import '../tab/tab.js';
+/**
+ * @summary Tab groups organize related content into a single container that displays one panel at a time, with tabs for
+ *  switching between them.
+ * @documentation https://cruglobal.github.io/cornerstone-design-system/components/tab-group
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency cs-button
+ * @dependency cs-tab
+ * @dependency cs-tab-panel
+ *
+ * @slot - Used for grouping tab panels in the tab group. Must be `<cs-tab-panel>` elements.
+ * @slot nav - Used for grouping tabs in the tab group. Must be `<cs-tab>` elements. Note that `<cs-tab>` will set this
+ *  slot on itself automatically.
+ *
+ * @event {{ name: String }} cs-tab-show - Emitted when a tab is shown.
+ * @event {{ name: String }} cs-tab-hide - Emitted when a tab is hidden.
+ *
+ * @csspart tab-group - The component's outer wrapper.
+ * @csspart nav - The tab group's navigation container where tabs are slotted in.
+ * @csspart tabs - The container that wraps the tabs.
+ * @csspart body - The tab group's body where tab panels are slotted in.
+ * @csspart scroll-button - The previous/next scroll buttons that show when tabs are scrollable, a `<cs-button>`.
+ * @csspart scroll-button-start - The starting scroll button.
+ * @csspart scroll-button-end - The ending scroll button.
+ * @csspart scroll-button__button - The scroll button's exported `button` part.
+ *
+ * @cssproperty --indicator-color - The color of the active tab indicator.
+ * @cssproperty --track-color - The color of the indicator's track (the line that separates tabs from panels).
+ * @cssproperty --track-width - The width of the indicator's track (the line that separates tabs from panels).
+ *
+ * @ssr - During SSR, `<cs-tab-group>` can't access its children to determine which tab is active. To render the correct panel, manually set the `active` attribute on the matching `<cs-tab>` and `<cs-tab-panel>`.
+ */
+export default class CsTabGroup extends CornerstoneElement {
+    static css: import("lit").CSSResult;
+    private activeTab?;
+    private mutationObserver;
+    private resizeObserver;
+    private tabs;
+    private focusableTabs;
+    private panels;
+    private readonly localize;
+    tabGroup: HTMLElement;
+    /** Default slot for `<cs-tab-panel>` children (inside the `body` part container). */
+    defaultSlot: HTMLSlotElement;
+    nav: HTMLElement;
+    private hasScrollControls;
+    /** Sets the active tab. */
+    active: string;
+    /** The placement of the tabs. */
+    placement: 'top' | 'bottom' | 'start' | 'end';
+    /**
+     * When set to auto, navigating tabs with the arrow keys will instantly show the corresponding tab panel. When set to
+     * manual, the tab will receive focus but will not show until the user presses spacebar or enter.
+     */
+    activation: 'auto' | 'manual';
+    /** Disables the scroll arrows that appear when tabs overflow. */
+    withoutScrollControls: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private getAllTabs;
+    private getAllPanels;
+    private getActiveTab;
+    private handleClick;
+    private handleKeyDown;
+    private findNextFocusableTab;
+    private handleScrollToStart;
+    private handleScrollToEnd;
+    private setActiveTab;
+    private setAriaLabels;
+    private syncTabsAndPanels;
+    updateActiveTab(): void;
+    updateScrollControls(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'cs-tab-group': CsTabGroup;
+    }
+}

package/dist/unbundled/components/tab-group/tab-group.js

@@ -0,0 +1,38 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  CsTabGroup
+} from "../../chunks/chunk.3GISTVJD.js";
+import "../../chunks/chunk.CAVIMOX7.js";
+import "../../chunks/chunk.27C34IAM.js";
+import "../../chunks/chunk.C7XIOK7O.js";
+import "../../chunks/chunk.ISX2ZBYU.js";
+import "../../chunks/chunk.HZVMFY2P.js";
+import "../../chunks/chunk.7355H7JE.js";
+import "../../chunks/chunk.5SDKM5TW.js";
+import "../../chunks/chunk.6INMSSKP.js";
+import "../../chunks/chunk.4G4Y3HKX.js";
+import "../../chunks/chunk.I3LK24XZ.js";
+import "../../chunks/chunk.G2FXXPDW.js";
+import "../../chunks/chunk.MDV4MWU5.js";
+import "../../chunks/chunk.G5KWAXZV.js";
+import "../../chunks/chunk.DJGKLHDS.js";
+import "../../chunks/chunk.4BSDHHLS.js";
+import "../../chunks/chunk.DA42KEYS.js";
+import "../../chunks/chunk.T24BSOWI.js";
+import "../../chunks/chunk.ZQ7G474G.js";
+import "../../chunks/chunk.RKGCFOCD.js";
+import "../../chunks/chunk.O6L7CNGM.js";
+import "../../chunks/chunk.VXLBZXY3.js";
+import "../../chunks/chunk.3QOMHIHS.js";
+import "../../chunks/chunk.MHH4NIPT.js";
+import "../../chunks/chunk.QGC4W2JQ.js";
+import "../../chunks/chunk.EXOHZSKZ.js";
+import "../../chunks/chunk.EJSU7GFZ.js";
+import "../../chunks/chunk.FGNU55DN.js";
+import "../../chunks/chunk.GT5PEMIO.js";
+import "../../chunks/chunk.HVRBYPAL.js";
+import "../../chunks/chunk.V3WAYU6A.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  CsTabGroup as default
+};

package/dist/unbundled/components/tab-group/tab-group.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("lit").CSSResult;
+export default _default;

package/dist/unbundled/components/tab-group/tab-group.styles.js

@@ -0,0 +1,8 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  tab_group_styles_default
+} from "../../chunks/chunk.5SDKM5TW.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  tab_group_styles_default as default
+};

package/dist/unbundled/components/tab-panel/tab-panel.d.ts

@@ -0,0 +1,30 @@
+import CornerstoneElement from '../../internal/cornerstone-element.js';
+/**
+ * @summary Tab panels hold the content shown for a single tab inside a tab group.
+ * @documentation https://cruglobal.github.io/cornerstone-design-system/components/tab-panel
+ * @status stable
+ * @since 2.0
+ *
+ * @slot - The tab panel's content.
+ *
+ *
+ * @cssproperty --padding - The tab panel's padding.
+ */
+export default class CsTabPanel extends CornerstoneElement {
+    static css: import("lit").CSSResult;
+    private readonly attrId;
+    private readonly componentId;
+    /** The tab panel's name. */
+    name: string;
+    /** When true, the tab panel will be shown. */
+    active: boolean;
+    role: string;
+    connectedCallback(): void;
+    handleActiveChange(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'cs-tab-panel': CsTabPanel;
+    }
+}

package/dist/unbundled/components/tab-panel/tab-panel.js

@@ -0,0 +1,11 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  CsTabPanel
+} from "../../chunks/chunk.C7XIOK7O.js";
+import "../../chunks/chunk.ISX2ZBYU.js";
+import "../../chunks/chunk.3QOMHIHS.js";
+import "../../chunks/chunk.MHH4NIPT.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  CsTabPanel as default
+};

package/dist/unbundled/components/tab-panel/tab-panel.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("lit").CSSResult;
+export default _default;

package/dist/unbundled/components/tab-panel/tab-panel.styles.js

@@ -0,0 +1,8 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  tab_panel_styles_default
+} from "../../chunks/chunk.ISX2ZBYU.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  tab_panel_styles_default as default
+};

package/dist/unbundled/components/tag/tag.d.ts

@@ -0,0 +1,40 @@
+import CornerstoneElement from '../../internal/cornerstone-element.js';
+import '../button/button.js';
+/**
+ * @summary Tags label, categorize, or represent selections with a compact visual marker. Use them for status
+ *  indicators, filters, or removable chips.
+ * @documentation https://cruglobal.github.io/cornerstone-design-system/components/tag
+ * @status stable
+ * @since 2.0
+ *
+ * @dependency cs-button
+ *
+ * @slot - The tag's content.
+ *
+ * @event cs-remove - Emitted when the remove button is activated.
+ *
+ * @csspart content - The tag's content.
+ * @csspart remove-button - The tag's remove button, a `<cs-button>`.
+ * @csspart remove-button__button - The remove button's exported `button` part.
+ */
+export default class CsTag extends CornerstoneElement {
+    static css: import("lit").CSSResult[];
+    private readonly localize;
+    /** The tag's theme variant. Defaults to `neutral` if not within another element with a variant. */
+    variant: 'brand' | 'neutral' | 'highlight' | 'information' | 'success' | 'warning' | 'danger';
+    /** The tag's visual appearance. */
+    appearance: 'accent' | 'filled' | 'outlined' | 'filled-outlined';
+    /** The tag's size. */
+    size: 'xs' | 's' | 'm' | 'l' | 'xl';
+    /** Draws a pill-style tag with rounded edges. */
+    pill: boolean;
+    /** Makes the tag removable and shows a remove button. */
+    withRemove: boolean;
+    private handleRemoveClick;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'cs-tag': CsTag;
+    }
+}

package/dist/unbundled/components/tag/tag.js

@@ -0,0 +1,32 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  CsTag
+} from "../../chunks/chunk.VR3WL2WO.js";
+import "../../chunks/chunk.ST4TDXY6.js";
+import "../../chunks/chunk.PSWC5RFO.js";
+import "../../chunks/chunk.4G4Y3HKX.js";
+import "../../chunks/chunk.I3LK24XZ.js";
+import "../../chunks/chunk.G2FXXPDW.js";
+import "../../chunks/chunk.MDV4MWU5.js";
+import "../../chunks/chunk.G5KWAXZV.js";
+import "../../chunks/chunk.DJGKLHDS.js";
+import "../../chunks/chunk.4BSDHHLS.js";
+import "../../chunks/chunk.DA42KEYS.js";
+import "../../chunks/chunk.T24BSOWI.js";
+import "../../chunks/chunk.ZQ7G474G.js";
+import "../../chunks/chunk.RKGCFOCD.js";
+import "../../chunks/chunk.O6L7CNGM.js";
+import "../../chunks/chunk.VXLBZXY3.js";
+import "../../chunks/chunk.3QOMHIHS.js";
+import "../../chunks/chunk.MHH4NIPT.js";
+import "../../chunks/chunk.QGC4W2JQ.js";
+import "../../chunks/chunk.EXOHZSKZ.js";
+import "../../chunks/chunk.EJSU7GFZ.js";
+import "../../chunks/chunk.FGNU55DN.js";
+import "../../chunks/chunk.GT5PEMIO.js";
+import "../../chunks/chunk.HVRBYPAL.js";
+import "../../chunks/chunk.V3WAYU6A.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  CsTag as default
+};

package/dist/unbundled/components/tag/tag.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("lit").CSSResult;
+export default _default;

package/dist/unbundled/components/tag/tag.styles.js

@@ -0,0 +1,8 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  tag_styles_default
+} from "../../chunks/chunk.PSWC5RFO.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  tag_styles_default as default
+};

package/dist/unbundled/components/textarea/textarea.d.ts

@@ -0,0 +1,149 @@
+import type { PropertyValues } from 'lit';
+import { CornerstoneFormAssociatedElement } from '../../internal/cornerstone-form-associated-element.js';
+/**
+ * @summary Textareas collect multi-line text input from the user, with optional resizing and character counting.
+ * @documentation https://cruglobal.github.io/cornerstone-design-system/components/textarea
+ * @status stable
+ * @since 2.0
+ *
+ * @slot label - The textarea's label. Alternatively, you can use the `label` attribute.
+ * @slot hint - Text that describes how to use the input. Alternatively, you can use the `hint` attribute.
+ *
+ * @event blur - Emitted when the control loses focus.
+ * @event change - Emitted when an alteration to the control's value is committed by the user.
+ * @event focus - Emitted when the control gains focus.
+ * @event input - Emitted when the control receives input.
+ * @event cs-invalid - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+ *
+ * @csspart form-control-label - The label.
+ * @csspart hint - The hint's wrapper.
+ * @csspart textarea - The internal `<textarea>` control.
+ * @csspart textarea-wrapper - The component's outer wrapper.
+ * @csspart textarea-adjuster - The invisible sizer that grows the control to fit its content when `resize` is `auto`.
+ * @csspart count - The character count element, rendered when the `with-count` attribute is present.
+ *
+ * @cssstate blank - The textarea is empty.
+ */
+export default class CsTextarea extends CornerstoneFormAssociatedElement {
+    static css: import("lit").CSSResult[];
+    static get validators(): import("../../internal/cornerstone-form-associated-element.js").Validator<CornerstoneFormAssociatedElement>[];
+    assumeInteractionOn: string[];
+    private readonly hasSlotController;
+    private readonly localize;
+    private resizeObserver?;
+    private countAnnounceTimeout;
+    private announcedCountText;
+    input: HTMLTextAreaElement;
+    base: HTMLDivElement;
+    sizeAdjuster: HTMLTextAreaElement;
+    title: string;
+    /** The name of the textarea, submitted as a name/value pair with form data. */
+    name: string | null;
+    private _value;
+    /** The current value of the input, submitted as a name/value pair with form data. */
+    get value(): string | null;
+    set value(val: string | null);
+    /** The default value of the form control. Primarily used for resetting the form control. */
+    defaultValue: string;
+    /** The textarea's size. */
+    size: 'xs' | 's' | 'm' | 'l' | 'xl';
+    /** The textarea's visual appearance. */
+    appearance: 'filled' | 'outlined' | 'filled-outlined';
+    /** The textarea's label. If you need to display HTML, use the `label` slot instead. */
+    label: string;
+    /** The textarea's hint. If you need to display HTML, use the `hint` slot instead. */
+    hint: string;
+    /** Placeholder text to show as a hint when the input is empty. */
+    placeholder: string;
+    /** The number of rows to display by default. */
+    rows: number;
+    /** Controls how the textarea can be resized. */
+    resize: 'none' | 'vertical' | 'horizontal' | 'both' | 'auto';
+    /** Disables the textarea. */
+    disabled: boolean;
+    /** Makes the textarea readonly. */
+    readonly: boolean;
+    /** Makes the textarea a required field. */
+    required: boolean;
+    /** The minimum length of input that will be considered valid. */
+    minlength: number;
+    /** The maximum length of input that will be considered valid. */
+    maxlength: number;
+    /** Controls whether and how text input is automatically capitalized as it is entered by the user. */
+    autocapitalize: 'off' | 'none' | 'on' | 'sentences' | 'words' | 'characters';
+    /**
+     * Indicates whether the browser's autocorrect feature is on or off. When set as an attribute, use `"off"` or `"on"`.
+     * When set as a property, use `true` or `false`.
+     */
+    autocorrect: boolean;
+    /**
+     * Specifies what permission the browser has to provide assistance in filling out form field values. Refer to
+     * [this page on MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete) for available values.
+     */
+    autocomplete: string;
+    /** Indicates that the input should receive focus on page load. */
+    autofocus: boolean;
+    /** Used to customize the label or icon of the Enter key on virtual keyboards. */
+    enterkeyhint: 'enter' | 'done' | 'go' | 'next' | 'previous' | 'search' | 'send';
+    /** Enables spell checking on the textarea. */
+    spellcheck: boolean;
+    /**
+     * Tells the browser what type of data will be entered by the user, allowing it to display the appropriate virtual
+     * keyboard on supportive devices.
+     */
+    inputmode: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
+    /**
+     * Only required for SSR. Set to `true` if you're slotting in a `label` element so the server-rendered markup
+     * includes the label before the component hydrates on the client.
+     */
+    ssrLabel: boolean;
+    /**
+     * Only required for SSR. Set to `true` if you're slotting in a `hint` element so the server-rendered markup
+     * includes the hint before the component hydrates on the client.
+     */
+    ssrHint: boolean;
+    /** Shows a character count below the textarea. When `maxlength` is set, shows remaining characters instead. */
+    withCount: boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * @internal
+     */
+    protected updateFormValue(value: string | FormData | File | null): void;
+    private lastObservedWidth;
+    /** Creates or destroys the resize observer based on the current resize mode. */
+    private updateResizeObserver;
+    private handleBlur;
+    private handleChange;
+    private handleInput;
+    private scheduleCountAnnouncement;
+    private setTextareaDimensions;
+    handleRowsChange(): void;
+    handleValueChange(): Promise<void>;
+    updated(changedProperties: PropertyValues<this>): void;
+    /** Sets focus on the textarea. */
+    focus(options?: FocusOptions): void;
+    /** Removes focus from the textarea. */
+    blur(): void;
+    /** Selects all the text in the textarea. */
+    select(): void;
+    /** Gets or sets the textarea's scroll position. */
+    scrollPosition(position?: {
+        top?: number;
+        left?: number;
+    }): {
+        top: number;
+        left: number;
+    } | undefined;
+    /** Sets the start and end positions of the text selection (0-based). */
+    setSelectionRange(selectionStart: number, selectionEnd: number, selectionDirection?: 'forward' | 'backward' | 'none'): void;
+    /** Replaces a range of text with a new string. */
+    setRangeText(replacement: string, start?: number, end?: number, selectMode?: 'select' | 'start' | 'end' | 'preserve'): void;
+    formResetCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'cs-textarea': CsTextarea;
+    }
+}

package/dist/unbundled/components/textarea/textarea.js

@@ -0,0 +1,20 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  CsTextarea
+} from "../../chunks/chunk.GUKUJM43.js";
+import "../../chunks/chunk.US7HRJHA.js";
+import "../../chunks/chunk.PSAE6QZG.js";
+import "../../chunks/chunk.Y7YQ7MTR.js";
+import "../../chunks/chunk.3XMRDGUU.js";
+import "../../chunks/chunk.MDV4MWU5.js";
+import "../../chunks/chunk.G5KWAXZV.js";
+import "../../chunks/chunk.DJGKLHDS.js";
+import "../../chunks/chunk.4BSDHHLS.js";
+import "../../chunks/chunk.3QOMHIHS.js";
+import "../../chunks/chunk.MHH4NIPT.js";
+import "../../chunks/chunk.QGC4W2JQ.js";
+import "../../chunks/chunk.EXOHZSKZ.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  CsTextarea as default
+};

package/dist/unbundled/components/textarea/textarea.styles.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("lit").CSSResult;
+export default _default;

package/dist/unbundled/components/textarea/textarea.styles.js

@@ -0,0 +1,8 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  textarea_styles_default
+} from "../../chunks/chunk.US7HRJHA.js";
+import "../../chunks/chunk.M2YES2WV.js";
+export {
+  textarea_styles_default as default
+};

package/dist/unbundled/components/time-input/internal/time-segments.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Pure, DOM-free model for the **segmented** time input of `<cs-time-input>`. Plays the same role for time-input as
+ * `date-input/internal/segments.ts` does for date-input — only this one is wired to the generic
+ * `SegmentedFieldController` via the `timeSegmentRules()` factory below.
+ *
+ * A `<cs-time-input>` renders hour, minute, optional seconds, and optional AM/PM as discrete spinbutton segments in
+ * the user's locale order, separated by inert literal text (`:`, NBSPs, locale-specific glyphs). Each segment is edited
+ * independently: digits fill the focused segment with auto-advance, Arrow Up/Down step within bounds, and AM/PM toggles
+ * via `a`/`p` keys or arrow stepping.
+ *
+ * Wire format mirrors HTML `<input type="time">`: `HH:mm` for whole-minute steps, `HH:mm:ss` for sub-minute steps,
+ * `HH:mm:ss.sss` for fractional-second steps. The wire value is always 24-hour even when the UI is 12-hour.
+ */
+import type { SegmentLayout, SegmentRules, TypeDigitResult } from '../../../internal/segmented-field/segmented-field-controller.js';
+export type TimeField = 'hour' | 'minute' | 'second' | 'dayPeriod';
+/** Partially- or fully-entered time. `null` means the segment is empty. */
+export interface TimeSegments {
+    /** Hour in display units: 0–23 when `hour12` is false, 1–12 when true. */
+    hour: number | null;
+    minute: number | null;
+    /** Whole seconds. `null` when the seconds segment isn't shown or hasn't been entered. */
+    second: number | null;
+    /** 0 = AM, 1 = PM. `null` when the segment isn't shown or hasn't been entered. */
+    dayPeriod: 0 | 1 | null;
+}
+export interface BuildLayoutOptions {
+    hour12: boolean;
+    withSeconds: boolean;
+}
+/** Clear the layout cache (intended for tests). */
+export declare function clearTimeSegmentLayoutCache(): void;
+/**
+ * Build (and cache) the segment layout for a locale by probing `Intl.DateTimeFormat.formatToParts`. Literal parts
+ * (colons, NBSPs) are preserved verbatim so locale-specific separators render correctly. Digits are forced to Latin
+ * via `numberingSystem: 'latn'` — the wire value is always ASCII; only segment order and AM/PM glyphs vary by locale.
+ *
+ * Cache key: `${locale}|${hour12}|${withSeconds}`.
+ */
+export declare function buildTimeSegmentLayout(locale: string, opts: BuildLayoutOptions): SegmentLayout;
+/** Resolve whether a locale defaults to 12-hour clock. Used when `hourFormat='auto'`. */
+export declare function resolveHour12(locale: string): boolean;
+/** Format the localized AM/PM string for a given `dayPeriod` value (0=AM, 1=PM). Falls back to "AM"/"PM". */
+export declare function formatDayPeriod(locale: string, period: 0 | 1): string;
+export declare function timeSegmentBounds(field: TimeField, hour12: boolean): {
+    min: number;
+    max: number;
+};
+/**
+ * Step a segment by `delta` (+1 / -1). Hour, minute, second **wrap** within their bounds with **no carry** into other
+ * fields (mirrors native `<input type="time">`). DayPeriod toggles. In 12-hour mode, stepping the hour does not toggle
+ * AM/PM — matches Chrome and React Aria. Empty segments seed from `now` (or 12/0 for hour, 0 for minute/second, AM for
+ * dayPeriod).
+ */
+export declare function stepTimeSegment(segments: TimeSegments, field: TimeField, delta: -1 | 1, hour12: boolean, now?: Date): TimeSegments;
+/**
+ * Apply a digit to a time segment. Per-field rules:
+ *
+ * - **Hour (24-hour, 0–23):** empty + `3..9` commits + advances; empty + `0..2` buffers; buffer `0`/`1` + any digit
+ *   combines to `0d`/`1d` (advance); buffer `2` + `0..3` combines to `20..23` (advance); buffer `2` + `4..9` replaces.
+ *   `00` stays buffered at `0`.
+ * - **Hour (12-hour, 1–12):** same algorithm as the date-input's month (1–12).
+ * - **Minute / Second (0–59):** empty + `6..9` commits + advances; empty + `0..5` buffers; buffer + any digit combines
+ *   to `0d..59` (advance); buffer + overflow digit replaces.
+ *
+ * Returns the same `TypeDigitResult` shape the controller expects.
+ */
+export declare function typeTimeDigit(field: TimeField, buffer: string, digit: string, hour12: boolean): TypeDigitResult;
+/** Interpret a raw digit buffer as its numeric value. */
+export declare function bufferToValue(buffer: string): number | null;
+/** Set AM/PM directly via keystroke (`a`/`A`/`p`/`P`). Returns the new `dayPeriod` value or `null` for no-op. */
+export declare function dayPeriodFromKey(key: string): 0 | 1 | null;
+export declare function formatTimeSegmentText(field: TimeField, value: number | null, buffer: string, placeholder: string, locale: string): string;
+export interface WireOptions {
+    hour12: boolean;
+    withSeconds: boolean;
+}
+/** True if every required segment is filled. */
+export declare function isTimeComplete(segments: TimeSegments, opts: WireOptions): boolean;
+/** True if no segment is filled. */
+export declare function isTimeEmpty(segments: TimeSegments): boolean;
+/**
+ * Convert a display-segment group to the canonical HTML `<input type="time">` wire format:
+ *  - `HH:mm` when `withSeconds` is false.
+ *  - `HH:mm:ss` when `withSeconds` is true.
+ *
+ * Always 24-hour zero-padded. Returns `''` for incomplete groups.
+ */
+export declare function timeSegmentsToWire(segments: TimeSegments, opts: WireOptions): string;
+/**
+ * Parse the canonical HTML wire format into display segments. Accepts the spec's `HH:mm`, `HH:mm:ss`, and
+ * `HH:mm:ss.sss` forms. Returns all-null segments for an empty/invalid string. The fractional component (if any) is
+ * preserved on the seconds segment as a whole second (rounded down).
+ */
+export declare function wireToTimeSegments(wire: string | null | undefined, opts: WireOptions): TimeSegments;
+/**
+ * Resolve whether the seconds segment should be shown given a `step` value (in seconds, per HTML spec). Mirrors native
+ * `<input type="time">`: `step >= 60` and divisible by 60 → no seconds; otherwise → seconds shown. `'any'` → seconds
+ * shown (matches modern Chromium).
+ */
+export declare function withSecondsForStep(step: number | 'any'): boolean;
+/**
+ * Build the `SegmentRules` object the generic `SegmentedFieldController` expects, wired to a host's segment-store
+ * getter/setter. Lets the host say "rules: timeSegmentRules({ getSegments, setSegments, hour12, now })" and the
+ * controller handles all the rest.
+ */
+export declare function timeSegmentRules(opts: {
+    getSegments: (group: string) => TimeSegments;
+    setSegments: (group: string, next: TimeSegments) => void;
+    hour12: () => boolean;
+    now?: () => Date;
+}): SegmentRules;

package/dist/unbundled/components/time-input/internal/time-segments.js

@@ -0,0 +1,38 @@
+/*! Cornerstone Components 0.1.0 - MIT licensed. See LICENSE.md and NOTICE. */
+import {
+  bufferToValue,
+  buildTimeSegmentLayout,
+  clearTimeSegmentLayoutCache,
+  dayPeriodFromKey,
+  formatDayPeriod,
+  formatTimeSegmentText,
+  isTimeComplete,
+  isTimeEmpty,
+  resolveHour12,
+  stepTimeSegment,
+  timeSegmentBounds,
+  timeSegmentRules,
+  timeSegmentsToWire,
+  typeTimeDigit,
+  wireToTimeSegments,
+  withSecondsForStep
+} from "../../../chunks/chunk.MD7QGXV6.js";
+import "../../../chunks/chunk.M2YES2WV.js";
+export {
+  bufferToValue,
+  buildTimeSegmentLayout,
+  clearTimeSegmentLayoutCache,
+  dayPeriodFromKey,
+  formatDayPeriod,
+  formatTimeSegmentText,
+  isTimeComplete,
+  isTimeEmpty,
+  resolveHour12,
+  stepTimeSegment,
+  timeSegmentBounds,
+  timeSegmentRules,
+  timeSegmentsToWire,
+  typeTimeDigit,
+  wireToTimeSegments,
+  withSecondsForStep
+};