origam 2.15.0 → 2.16.0

package/dist/src/types/Chart/chart.type.d.ts

@@ -1,5 +1,5 @@
 import type { CHART_STACKING } from '../../enums';
-import { CHART_TYPE } from '../../enums';
+import { CHART_SMOOTHING, CHART_TYPE } from '../../enums';
 import { OrigamChart } from '../../components';
 /**
  * Loose item shape accepted by chart data arrays — either a raw
@@ -26,7 +26,7 @@ export type TChartItem = string | number | {
  * staircase is a different topology (right-angle connections),
  * not a curve choice. See `TChartCartesianKind`.
  */
-export type TChartSmoothing = 'none' | 'curve' | 'monotone';
+export type TChartSmoothing = `${CHART_SMOOTHING}`;
 /**
  * Stacking strategy for bar / column / area charts.
  *
@@ -42,3 +42,15 @@ export type TChartStacking = `${CHART_STACKING}`;
  */
 export type TChartType = `${CHART_TYPE}`;
 export type TOrigamChart = InstanceType<typeof OrigamChart>;
+/**
+ * A pre-scaled `[x, y]` coordinate pair (pixels in the SVG viewBox),
+ * as consumed by the path builders in `src/utils/Chart/path.util.ts`.
+ *
+ * Deliberately a TUPLE, not the object-shaped `TPoint` (`{ x, y }`)
+ * from `types/Commons/point.type.ts`: the path helpers build strings
+ * from long lists of coordinates on every render, and the tuple form
+ * both destructures positionally (`const [x, y] = p`) and keeps the
+ * call sites readable (`linePath([[0, 0], [10, 10]])`). The two are not
+ * interchangeable and neither replaces the other.
+ */
+export type TPathPoint = [number, number];

package/dist/src/types/Code/code.type.d.ts

@@ -3,3 +3,22 @@ import { OrigamCode } from '../../components';
 export type TOrigamCode = InstanceType<typeof OrigamCode>;
 export type TCodeLang = `${CODE_LANG}`;
 export type TCodeTheme = `${CODE_THEME}`;
+/**
+ * The slice of shiki's highlighter API that `useCode()` actually calls.
+ *
+ * `shiki` is an OPTIONAL peer dependency, so the DS must not `import
+ * type` from it — that would make shiki's own types a hard build
+ * requirement for every consumer, including those who never install it.
+ * Declaring the one method we use keeps the dynamic-import fallback
+ * path type-safe with zero dependency on the package being present.
+ */
+export type TShikiHighlighter = {
+    codeToHtml: (code: string, opts: {
+        lang: string;
+        themes?: {
+            light: string;
+            dark: string;
+        };
+        defaultColor?: false | string;
+    }) => string;
+};

package/dist/src/types/Commons/align.type.d.ts

@@ -1,2 +1,7 @@
-import { ALIGN } from '../../enums';
+import { ALIGN, TEXT_ALIGN } from '../../enums';
 export type TAlign = `${ALIGN}`;
+/**
+ * Physical text alignment (`text-align`). See {@link TAlign} for the
+ * logical box-alignment vocabulary — the two are distinct on purpose.
+ */
+export type TTextAlign = `${TEXT_ALIGN}`;

package/dist/src/types/Commons/border.type.d.ts

@@ -1,4 +1,4 @@
-import { BORDER_STYLE } from '../../enums';
+import { BORDER_LOGICAL_AXIS, BORDER_STYLE } from '../../enums';
 export type TBorderStyle = `${BORDER_STYLE}`;
 /**
  * CSS logical border axes (`border-block` / `border-inline`), as opposed
@@ -9,4 +9,4 @@ export type TBorderStyle = `${BORDER_STYLE}`;
  * the correct physical edges per the current writing mode (no manual
  * LTR/RTL translation needed on our side).
  */
-export type TBorderLogicalAxis = 'block' | 'inline';
+export type TBorderLogicalAxis = `${BORDER_LOGICAL_AXIS}`;

package/dist/src/types/Commons/color.type.d.ts

@@ -1,3 +1,4 @@
+import { BG_FG_ROLE } from '../../enums';
 import type { IGradient } from '../../interfaces/Commons/gradient.interface';
 /**
  * Accepted shapes for the `color` / `bgColor` / `textColor` props.
@@ -51,4 +52,4 @@ export type TColorType = string | number | THSVA | TRGBA | THSLA;
  *   • `active`   → cascading `var(bgActive, color-mix(bg, black 30%))`
  *   • `disabled` → resting `bgDisabled` token (per-intent)
  */
-export type TBgFgRole = 'default' | 'hover' | 'active' | 'disabled';
+export type TBgFgRole = `${BG_FG_ROLE}`;

package/dist/src/types/Commons/css-support.type.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/types/Commons/css-support.type.d.ts

@@ -0,0 +1,26 @@
+import { FEATURE_QUERIES } from '../../consts/CssSupport/css-support.const';
+/**
+ * Name of a feature in the monitored CSS support matrix.
+ *
+ * Derived from `FEATURE_QUERIES` rather than restated, so adding an
+ * entry to that `as const satisfies` literal is the single edit needed
+ * to widen the matrix — the type follows automatically.
+ *
+ * FILED UNDER `Commons/`, NOT `CssSupport/`
+ * ----------------------------------------
+ * `useCssSupport()` is the DS's single feature-detection layer, consumed
+ * across the catalogue to pick a CSS-first path over a JS fallback — it
+ * is a cross-cutting subsystem, not a component's prop surface, which is
+ * exactly what `types/Commons/` is for (and why the `file-naming` guard
+ * exempts that directory: a file there is deliberately not tied to one
+ * component, and no `OrigamCssSupport` exists to name it after).
+ *
+ * The matching `FEATURE_QUERIES` const sits in `consts/CssSupport/`
+ * under its own documented exemption in the same guard. Sibling
+ * directories would have been more symmetrical, but that needs the
+ * guard's `exemptDirs` widened to `types/CssSupport` — a guard change,
+ * which is a lead's call, not a side effect of moving a type.
+ */
+export type TCssFeatureName = keyof typeof FEATURE_QUERIES;
+/** Snapshot of the whole matrix: every feature name → supported or not. */
+export type TCssSupportMap = Readonly<Record<TCssFeatureName, boolean>>;

package/dist/src/types/Commons/font-family.type.d.ts

@@ -1,5 +1,6 @@
+import { FONT_FAMILY } from '../../enums';
 /**
  * Font-family token keys (map to `--origam-font__family---{key}`):
  *   sans (Inter / Helvetica Neue / Arial) · mono (JetBrains Mono / Fira Code) · serif (Georgia / Times New Roman)
  */
-export type TFontFamily = 'sans' | 'mono' | 'serif';
+export type TFontFamily = `${FONT_FAMILY}`;

package/dist/src/types/Commons/font-size.type.d.ts

@@ -1,6 +1,7 @@
+import { FONT_SIZE } from '../../enums';
 /**
  * Font-size token keys (map to `--origam-font__size---{key}`):
  *   xs 0.625rem · sm 0.75rem · md 0.875rem · lg 1rem · xl 1.125rem
  *   2xl 1.25rem · 3xl 1.5rem · 4xl 1.875rem · 5xl 2.25rem
  */
-export type TFontSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl';
+export type TFontSize = `${FONT_SIZE}`;

package/dist/src/types/Commons/font-weight.type.d.ts

@@ -1,5 +1,6 @@
+import { FONT_WEIGHT } from '../../enums';
 /**
  * Font-weight token keys (map to `--origam-font__weight---{key}`):
  *   regular 400 · medium 500 · semibold 600 · bold 700 · extrabold 800 · black 900
  */
-export type TFontWeight = 'regular' | 'medium' | 'semibold' | 'bold' | 'extrabold' | 'black';
+export type TFontWeight = `${FONT_WEIGHT}`;

package/dist/src/types/Commons/letter-spacing.type.d.ts

@@ -1,5 +1,6 @@
+import { LETTER_SPACING } from '../../enums';
 /**
  * Letter-spacing token keys (map to `--origam-font__letterSpacing---{key}`):
  *   tight -0.025em · normal 0em · wide 0.0094em · wider 0.0125em · widest 0.0893em
  */
-export type TLetterSpacing = 'tight' | 'normal' | 'wide' | 'wider' | 'widest';
+export type TLetterSpacing = `${LETTER_SPACING}`;

package/dist/src/types/Commons/line-height.type.d.ts

@@ -1,5 +1,6 @@
+import { LINE_HEIGHT } from '../../enums';
 /**
  * Line-height token keys (map to `--origam-font__lineHeight---{key}`):
  *   none 1 · tight 1.25 · snug 1.375 · normal 1.5 · relaxed 1.625 · loose 2
  */
-export type TLineHeight = 'none' | 'tight' | 'snug' | 'normal' | 'relaxed' | 'loose';
+export type TLineHeight = `${LINE_HEIGHT}`;

package/dist/src/types/Commons/loader.type.d.ts

@@ -1,9 +1,10 @@
+import { LOADER_KIND } from '../../enums';
 import type { IProgressCircularProps, IProgressLinearProps, ISkeletonProps } from '../../interfaces';
 /**
  * Loader kind — decides which renderer is mounted by the consumer
  * component when a loading state is active.
  */
-export type TLoaderKind = 'line' | 'circular' | 'skeleton';
+export type TLoaderKind = `${LOADER_KIND}`;
 /**
  * Per-kind override config. Each kind extends the corresponding component's
  * Partial props so the consumer gets full IDE autocomplete for the right
@@ -15,11 +16,11 @@ export type TLoaderKind = 'line' | 'circular' | 'skeleton';
  * defensively.
  */
 export type TLoaderConfig = ({
-    type: 'line';
+    type: `${LOADER_KIND.LINE}`;
 } & Partial<IProgressLinearProps>) | ({
-    type: 'circular';
+    type: `${LOADER_KIND.CIRCULAR}`;
 } & Partial<IProgressCircularProps>) | ({
-    type: 'skeleton';
+    type: `${LOADER_KIND.SKELETON}`;
 } & Partial<ISkeletonProps>);
 /**
  * The full `loading` prop value accepted by every consumer component.

package/dist/src/types/Commons/state-effect.type.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/src/types/Commons/state-effect.type.d.ts

@@ -0,0 +1,30 @@
+import type { IBgColorProps, IColorProps } from '../../interfaces/Commons/color.interface';
+import type { IBorderProps } from '../../interfaces/Commons/border.interface';
+import type { IElevationProps } from '../../interfaces/Commons/elevation.interface';
+import type { IMarginProps } from '../../interfaces/Commons/margin.interface';
+import type { IPaddingProps } from '../../interfaces/Commons/padding.interface';
+import type { IRoundedProps } from '../../interfaces/Commons/rounded.interface';
+/**
+ * The prop bag `useStateEffect` reads from.
+ *
+ * It is deliberately an INTERSECTION of the existing Commons prop
+ * interfaces rather than a fresh list of properties: `useStateEffect`
+ * delegates each axis to the matching per-axis composable
+ * (`useBorder`, `useRounded`, `useElevation`, `usePadding`,
+ * `useMargin`, `useColor`), so its accepted input is by definition the
+ * union of what those composables accept. Restating the properties
+ * here would let the two drift the moment one of the Commons
+ * interfaces gains a prop.
+ *
+ * `gap` is the one axis with no Commons interface of its own — it is
+ * an ad-hoc flex/grid property that only a handful of layout
+ * components expose — so it is spelled inline.
+ *
+ * Sibling type: {@link IStateEffectConfig} in
+ * `src/interfaces/Commons/state-effect.interface.ts` describes the
+ * OVERRIDE object a consumer passes to `hover` / `active`. This type
+ * describes the RESTING props those overrides are layered on top of.
+ */
+export type TStateEffectProps = IColorProps & IBgColorProps & IBorderProps & IRoundedProps & IElevationProps & IPaddingProps & IMarginProps & {
+    gap?: boolean | number | string;
+};

package/dist/src/types/DataList/data-list.type.d.ts

@@ -1,2 +1,18 @@
 import { OrigamDataList } from "../../components";
+import { DATA_LIST_MODE } from "../../enums";
 export type TOrigamDataList = InstanceType<typeof OrigamDataList>;
+/**
+ * Layout mode of `<OrigamDataList>`.
+ *
+ * - `"avatar"` (default, back-compat) — the historical `<dl>` layout
+ *   where each item stacks a `<dt>` (title) above one or more `<dd>`
+ *   rows (text). Items conform to {@link IDataItem}. The naming reflects
+ *   the most common usage: a `prependAvatar` per title, with a stack of
+ *   labels below — the Vuetify `v-list`-flavoured shape.
+ *
+ * - `"kv"` — the PDF-aligned key/value table where each row renders a
+ *   key on the left (muted) and a value on the right (primary text or
+ *   an inline component such as `<origam-chip>` / `<origam-avatar>`).
+ *   Items conform to {@link IDataListKVItem}.
+ */
+export type TDataListMode = `${DATA_LIST_MODE}`;

package/dist/src/types/EmptyState/empty-state.type.d.ts

@@ -1,4 +1,6 @@
 import { OrigamEmptyState } from '../../components';
+import { EMPTY_STATE_PRESET } from '../../enums';
+import type { TTextAlign } from '../Commons/align.type';
 import type { TRoundedToken } from '../Commons/rounded.type';
 export type TOrigamEmptyState = InstanceType<typeof OrigamEmptyState>;
 /**
@@ -14,7 +16,7 @@ export type TOrigamEmptyState = InstanceType<typeof OrigamEmptyState>;
  * - `offline`     — connectivity issue; offline-mode CTA is typical.
  * - `locked`      — feature is gated (auth, plan, permissions).
  */
-export type TEmptyStatePreset = 'no-data' | 'no-results' | 'error' | 'offline' | 'locked';
+export type TEmptyStatePreset = `${EMPTY_STATE_PRESET}`;
 /**
  * Horizontal alignment of the icon / title / description / actions
  * stack inside `<OrigamEmptyState>`.
@@ -23,8 +25,12 @@ export type TEmptyStatePreset = 'no-data' | 'no-results' | 'error' | 'offline' |
  *              Best for full-page or full-section placeholders.
  * - `left`   — left-aligned stack. Best for narrow side panels or list
  *              empty zones where the surrounding content is left-aligned.
+ *
+ * Narrows the Commons `TTextAlign` vocabulary rather than redeclaring
+ * the strings — `right` is excluded on purpose (no design token drives
+ * a right-aligned empty state).
  */
-export type TEmptyStateAlign = 'center' | 'left';
+export type TEmptyStateAlign = Exclude<TTextAlign, 'right'>;
 /**
  * Vertical density of `<OrigamEmptyState>`. Drives icon size + title /
  * description font sizes + gap + padding via per-size token overrides.

package/dist/src/types/FileField/file-field.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamFileField } from "../../components";
+import { FILE_FIELD_DISPLAY } from "../../enums";
 export type TFileSize = boolean | 1000 | 1024;
 export type TFile = Array<File> | File | null;
 /**
@@ -7,5 +8,5 @@ export type TFile = Array<File> | File | null;
  *   - `'chips'`   — each file as a closable `<OrigamChip>` inline.
  *   - `'counter'` — single "N files" line + an `<OrigamCounter>`.
  */
-export type TFileFieldDisplay = 'list' | 'chips' | 'counter';
+export type TFileFieldDisplay = `${FILE_FIELD_DISPLAY}`;
 export type TOrigamFileField = InstanceType<typeof OrigamFileField>;

package/dist/src/types/Grid/grid-item.type.d.ts

@@ -1,7 +1,9 @@
 import { OrigamGridItem } from '../../components';
+import type { TGridPlaceItems } from './grid.type';
 export type TOrigamGridItem = InstanceType<typeof OrigamGridItem>;
 /**
  * Place-self (`align-self` + `justify-self`) on a grid item.
- * Same matrix as place-items.
+ * Same matrix as place-items — aliased rather than restated so the two
+ * cannot drift.
  */
-export type TGridPlaceSelf = 'start' | 'center' | 'end' | 'stretch';
+export type TGridPlaceSelf = TGridPlaceItems;

package/dist/src/types/Grid/grid.type.d.ts

@@ -1,4 +1,7 @@
 import { OrigamGrid } from '../../components';
+import { GRID_AUTO_FLOW } from '../../enums';
+import type { TAlign } from '../Commons/align.type';
+import type { TJustify } from '../Commons/justify.type';
 import type { TRoundedToken } from '../Commons/rounded.type';
 export type TOrigamGrid = InstanceType<typeof OrigamGrid>;
 /**
@@ -10,19 +13,25 @@ export type TOrigamGrid = InstanceType<typeof OrigamGrid>;
  * exotic value, they can pass a raw string via `:style` on the
  * outer container — we don't double-validate `grid-auto-flow`.
  */
-export type TGridAutoFlow = 'row' | 'column' | 'row dense' | 'column dense';
+export type TGridAutoFlow = `${GRID_AUTO_FLOW}`;
 /**
  * Place-items (`align-items` + `justify-items`) accepts the 4-value
  * subset of CSS Box Alignment. `baseline` is excluded on purpose —
  * it has no useful meaning when items can span rows / columns.
+ *
+ * Narrows the Commons `TAlign` vocabulary rather than redeclaring its
+ * literals, so a rung added to `ALIGN` cannot silently bypass this
+ * component's surface.
  */
-export type TGridPlaceItems = 'start' | 'center' | 'end' | 'stretch';
+export type TGridPlaceItems = Exclude<TAlign, 'baseline'>;
 /**
  * Place-content (`align-content` + `justify-content`) — aligns the
  * full grid inside its container when the grid is smaller than the
- * available space. Mirrors the CSS Box Alignment matrix.
+ * available space. Mirrors the CSS Box Alignment matrix: the full
+ * `JUSTIFY` distribution vocabulary plus `stretch`, which only the
+ * `ALIGN` side carries.
  */
-export type TGridPlaceContent = 'start' | 'center' | 'end' | 'stretch' | 'space-between' | 'space-around' | 'space-evenly';
+export type TGridPlaceContent = TJustify | Extract<TAlign, 'stretch'>;
 /**
  * Gap size tokens (`'xs' | 'sm' | 'md' | 'lg' | 'xl'`). When the
  * consumer passes one of these strings to the `gap` / `columnGap`

package/dist/src/types/InlineEdit/inline-edit.type.d.ts

@@ -1,9 +1,13 @@
 import { OrigamInlineEdit } from '../../components';
+import type { TTextFieldType } from '../TextField/text-field.type';
 export type TOrigamInlineEdit = InstanceType<typeof OrigamInlineEdit>;
 /**
  * Native HTML input types accepted by `<OrigamInlineEdit>` when not in
  * multiline mode. Intentionally a closed set — `password`, `file`,
  * `checkbox`, … don't fit the edit-in-place pattern and would require
  * a different UX surface.
+ *
+ * Narrows the shared `TEXT_FIELD_TYPE` vocabulary rather than declaring
+ * a second, near-identical enum of HTML input types.
  */
-export type TInlineEditInputType = 'text' | 'number' | 'email' | 'tel';
+export type TInlineEditInputType = Extract<TTextFieldType, 'text' | 'number' | 'email' | 'tel'>;

package/dist/src/types/Kbd/kbd.type.d.ts

@@ -1,3 +1,4 @@
 import { OrigamKbd } from '../../components';
-export type TKbdVariant = 'filled' | 'outlined' | 'tonal';
+import { KBD_VARIANT } from '../../enums';
+export type TKbdVariant = `${KBD_VARIANT}`;
 export type TOrigamKbd = InstanceType<typeof OrigamKbd>;

package/dist/src/types/Masonry/masonry.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamMasonry } from '../../components';
+import { MASONRY_ALIGN } from '../../enums';
 export type TOrigamMasonry = InstanceType<typeof OrigamMasonry>;
 /**
  * Vertical alignment of items inside a single masonry column.
@@ -15,4 +16,4 @@ export type TOrigamMasonry = InstanceType<typeof OrigamMasonry>;
  * The CSS path therefore always aligns to top; switching to `'center'`
  * implicitly forces the JS fallback so the value is observable.
  */
-export type TMasonryAlign = 'top' | 'center';
+export type TMasonryAlign = `${MASONRY_ALIGN}`;

package/dist/src/types/NumberFormat/number-format.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamNumberFormat } from '../../components';
+import { NUMBER_FORMAT_COMPACT_DISPLAY, NUMBER_FORMAT_CURRENCY_DISPLAY, NUMBER_FORMAT_FORMAT, NUMBER_FORMAT_NOTATION, NUMBER_FORMAT_SIGN_DISPLAY, NUMBER_FORMAT_UNIT_DISPLAY, NUMBER_FORMAT_USE_GROUPING } from '../../enums';
 export type TOrigamNumberFormat = InstanceType<typeof OrigamNumberFormat>;
 /**
  * High-level format dialect understood by `<OrigamNumberFormat>` and
@@ -16,39 +17,39 @@ export type TOrigamNumberFormat = InstanceType<typeof OrigamNumberFormat>;
  * - `scientific` — exponent notation (1.234E5).
  * - `engineering` — engineering-style exponent (multiples of 3).
  */
-export type TNumberFormatFormat = 'decimal' | 'currency' | 'percent' | 'unit' | 'compact' | 'scientific' | 'engineering';
+export type TNumberFormatFormat = `${NUMBER_FORMAT_FORMAT}`;
 /**
  * Currency-symbol rendering — forwarded to `Intl.NumberFormat`'s
  * `currencyDisplay` option.
  */
-export type TNumberFormatCurrencyDisplay = 'symbol' | 'narrowSymbol' | 'code' | 'name';
+export type TNumberFormatCurrencyDisplay = `${NUMBER_FORMAT_CURRENCY_DISPLAY}`;
 /**
  * Unit-label rendering — forwarded to `Intl.NumberFormat`'s
  * `unitDisplay` option.
  */
-export type TNumberFormatUnitDisplay = 'short' | 'long' | 'narrow';
+export type TNumberFormatUnitDisplay = `${NUMBER_FORMAT_UNIT_DISPLAY}`;
 /**
  * Compact-notation rendering — forwarded to `Intl.NumberFormat`'s
  * `compactDisplay` option. Only applies when `notation === 'compact'`.
  */
-export type TNumberFormatCompactDisplay = 'short' | 'long';
+export type TNumberFormatCompactDisplay = `${NUMBER_FORMAT_COMPACT_DISPLAY}`;
 /**
  * Raw `notation` mirror — exposed for advanced callers who set
  * `format: 'decimal'` but still want scientific / engineering output.
  */
-export type TNumberFormatNotation = 'standard' | 'compact' | 'scientific' | 'engineering';
+export type TNumberFormatNotation = `${NUMBER_FORMAT_NOTATION}`;
 /**
  * Sign-display strategy — forwarded to `Intl.NumberFormat`'s
  * `signDisplay` option.
  */
-export type TNumberFormatSignDisplay = 'auto' | 'always' | 'except-zero' | 'negative' | 'never';
+export type TNumberFormatSignDisplay = `${NUMBER_FORMAT_SIGN_DISPLAY}`;
 /**
  * Grouping (thousands separator) strategy — boolean kept for backwards
  * compat with the original `Intl.NumberFormat` API; the string variants
  * (`'always' | 'auto' | 'min2'`) match the modern proposal landed in
  * Chrome 106+ / Safari 16.4+.
  */
-export type TNumberFormatUseGrouping = boolean | 'always' | 'auto' | 'min2';
+export type TNumberFormatUseGrouping = boolean | `${NUMBER_FORMAT_USE_GROUPING}`;
 /**
  * Sentinel for the locale prop — `'auto'` triggers the runtime
  * resolution chain (`<html lang>` → `navigator.language` → `'en-US'`).

package/dist/src/types/PasswordField/password-field.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamPasswordField } from "../../components";
+import { PASSWORD_STRENGTH_LEVEL } from "../../enums";
 export type TOrigamPasswordField = InstanceType<typeof OrigamPasswordField>;
 /**
  * `TPasswordStrengthLevel` — discrete bucket emitted by the
@@ -9,7 +10,7 @@ export type TOrigamPasswordField = InstanceType<typeof OrigamPasswordField>;
  * (`origam-password-field__strength-segment--{level}`) and as the lookup
  * key into the `--origam-password-field__strength---bg-{level}` token.
  */
-export type TPasswordStrengthLevel = 'weak' | 'fair' | 'good' | 'strong';
+export type TPasswordStrengthLevel = `${PASSWORD_STRENGTH_LEVEL}`;
 /**
  * `TPasswordStrengthScore` — integer 0..4 returned by `computeStrength()`.
  * Drives how many segments of the bar are filled (0 = empty, 4 = full).

package/dist/src/types/QrCode/qr-code.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamQrCode } from '../../components';
+import { QR_CODE_ERROR_CORRECTION_LEVEL } from '../../enums';
 export type TOrigamQrCode = InstanceType<typeof OrigamQrCode>;
 /**
  * QR Code error-correction level (Reed-Solomon redundancy budget).
@@ -21,4 +22,4 @@ export type TOrigamQrCode = InstanceType<typeof OrigamQrCode>;
  * for ≥20%. Below `Q`, the redundancy budget is too thin for any
  * meaningful overlay.
  */
-export type TQrCodeErrorCorrectionLevel = 'L' | 'M' | 'Q' | 'H';
+export type TQrCodeErrorCorrectionLevel = `${QR_CODE_ERROR_CORRECTION_LEVEL}`;

package/dist/src/types/Sheet/sheet.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamSheet } from "../../components";
+import { SHEET_SNAP_ID } from "../../enums";
 export type TOrigamSheet = InstanceType<typeof OrigamSheet>;
 /**
  * Sheet bottom-swipe snap-point typings.
@@ -17,7 +18,7 @@ export type TOrigamSheet = InstanceType<typeof OrigamSheet>;
  * `sheetSwipe.composable.spec.ts`, the `Bottom — swipeable` story Variant
  * and `tests/e2e/sheet.spec.ts`.
  */
-export type TSheetSnapId = 'closed' | 'peek' | 'half' | 'full' | (string & {});
+export type TSheetSnapId = `${SHEET_SNAP_ID}` | (string & {});
 export type TSheetSnapPoint = {
     id: TSheetSnapId;
     height: number | string;

package/dist/src/types/Skeleton/skeleton.type.d.ts

@@ -1,3 +1,4 @@
 import { OrigamSkeleton } from '../../components';
+import { SKELETON_VARIANT } from '../../enums';
 export type TOrigamSkeleton = InstanceType<typeof OrigamSkeleton>;
-export type TSkeletonVariant = 'text' | 'rectangular' | 'circular' | 'card' | 'list-item';
+export type TSkeletonVariant = `${SKELETON_VARIANT}`;

package/dist/src/types/Snackbar/snackbar-group.type.d.ts

@@ -1,4 +1,5 @@
 import type { OrigamSnackbarGroup } from "../../components";
+import { SNACKBAR_GROUP_DIRECTION, SNACKBAR_GROUP_LOCATION } from "../../enums";
 export type TOrigamSnackbarGroup = InstanceType<typeof OrigamSnackbarGroup>;
 /**
  * Stacking direction for `OrigamSnackbarGroup`.
@@ -10,7 +11,7 @@ export type TOrigamSnackbarGroup = InstanceType<typeof OrigamSnackbarGroup>;
  *   (older items drift downward). Default for locations anchored to
  *   the bottom edge.
  */
-export type TSnackbarGroupDirection = 'top-down' | 'bottom-up';
+export type TSnackbarGroupDirection = `${SNACKBAR_GROUP_DIRECTION}`;
 /**
  * Anchor locations supported by `OrigamSnackbarGroup`.
  *
@@ -19,4 +20,4 @@ export type TSnackbarGroupDirection = 'top-down' | 'bottom-up';
  * horizontal centering. Each location maps to a CSS pinning pair on
  * the stack root (`top` / `bottom` + `left` / `right` / centered).
  */
-export type TSnackbarGroupLocation = 'top-left' | 'top-right' | 'top-center' | 'bottom-left' | 'bottom-right' | 'bottom-center' | 'top' | 'bottom';
+export type TSnackbarGroupLocation = `${SNACKBAR_GROUP_LOCATION}`;

package/dist/src/types/Stepper/stepper.type.d.ts

@@ -1,4 +1,5 @@
 import type { OrigamStepper, OrigamStepperItem } from '../../components';
+import { STEPPER_ITEM_STATUS } from '../../enums';
 import type { TDirection } from '../Commons/direction.type';
 export type TOrigamStepper = InstanceType<typeof OrigamStepper>;
 export type TOrigamStepperItem = InstanceType<typeof OrigamStepperItem>;
@@ -8,4 +9,4 @@ export type TOrigamStepperItem = InstanceType<typeof OrigamStepperItem>;
  * direction props.
  */
 export type TStepperOrientation = TDirection;
-export type TStepperItemStatus = 'pending' | 'active' | 'done' | 'error';
+export type TStepperItemStatus = `${STEPPER_ITEM_STATUS}`;

package/dist/src/types/TextField/text-field.type.d.ts

@@ -1,7 +1,7 @@
 import type { BUILT_IN_PATTERN, PATTERN_VALIDATOR } from '../../enums';
 import type { IMaskOptions } from '../../interfaces';
 import { OrigamTextField } from '../../components';
-import { TEXT_FIELD_TYPE } from "../../enums";
+import { MASK_TOKEN_KIND, TEXT_FIELD_TYPE } from "../../enums";
 export type TTextFieldType = `${TEXT_FIELD_TYPE}`;
 export type TOrigamTextField = InstanceType<typeof OrigamTextField>;
 /**
@@ -26,7 +26,7 @@ export type TMask = TBuiltInPattern | string | IMaskOptions | null;
  * - `literal`  : emitted as-is, does NOT consume the
  *                input character.
  */
-export type TMaskTokenKind = 'digit' | 'letter' | 'any' | 'literal';
+export type TMaskTokenKind = `${MASK_TOKEN_KIND}`;
 /**
  * Built-in validator name (string) — recognised by
  * `validatePattern`.

package/dist/src/types/TextMask/text-mask.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamTextMask } from "../../components";
+import { TEXT_MASK_ANIMATION } from "../../enums";
 export type TOrigamTextMask = InstanceType<typeof OrigamTextMask>;
 /**
  * Animation strategy applied to the background painted under the
@@ -15,4 +16,4 @@ export type TOrigamTextMask = InstanceType<typeof OrigamTextMask>;
  * disables the keyframes entirely so users opting out of motion get a
  * static painted text without flashes or transforms.
  */
-export type TTextMaskAnimation = 'pan' | 'rotate' | 'pulse' | 'zoom';
+export type TTextMaskAnimation = `${TEXT_MASK_ANIMATION}`;

package/dist/src/types/Theme/theme.type.d.ts

@@ -1,3 +1,4 @@
+import { COLOR_MODE } from '../../enums';
 /**
  * Runtime theme (brand) name applied to `<html data-theme="…">` (or to a
  * sub-tree via `<OrigamThemeProvider>`).
@@ -12,7 +13,7 @@
  * - any other string is treated as a custom theme (e.g. `'brand-a'`) — the
  *   matching CSS file must be loaded by the consumer.
  */
-export type TTheme = 'auto' | 'light' | 'dark' | (string & {});
+export type TTheme = `${COLOR_MODE}` | (string & {});
 /**
  * Concrete (resolved) theme — what `data-theme` actually equals after
  * resolving `'auto'`. Useful for components that need to know the
@@ -31,7 +32,7 @@ export type TThemeResolved = Exclude<TTheme, 'auto'>;
  * - `'light'` : forced light mode.
  * - `'dark'`  : forced dark mode.
  */
-export type TMode = 'auto' | 'light' | 'dark';
+export type TMode = `${COLOR_MODE}`;
 /**
  * Concrete (resolved) mode — what `data-mode` actually equals after
  * resolving `'auto'` against `prefers-color-scheme`.

package/dist/src/types/Timeline/timeline.type.d.ts

@@ -1,8 +1,9 @@
 import type { OrigamTimeline, OrigamTimelineItem } from '../../components';
+import { TIMELINE_SIDE } from '../../enums';
 import type { TDirection } from '../Commons/direction.type';
 export type TOrigamTimeline = InstanceType<typeof OrigamTimeline>;
 export type TOrigamTimelineItem = InstanceType<typeof OrigamTimelineItem>;
-export type TTimelineSide = 'start' | 'end' | 'alternating';
+export type TTimelineSide = `${TIMELINE_SIDE}`;
 /**
  * Layout axis of `<OrigamTimeline>`. Mirrors the global `TDirection` so
  * the timeline plays nicely with the rest of the design system's

package/dist/src/types/Treeview/treeview.type.d.ts

@@ -1,5 +1,6 @@
 import type { OrigamTreeview, OrigamTreeviewNode } from '../../components';
+import { TREEVIEW_SELECT_MODE, TREEVIEW_SELECTABLE_NODES } from '../../enums';
 export type TOrigamTreeview = InstanceType<typeof OrigamTreeview>;
 export type TOrigamTreeviewNode = InstanceType<typeof OrigamTreeviewNode>;
-export type TTreeviewSelectMode = 'single' | 'multiple' | 'none';
-export type TTreeviewSelectableNodes = 'leaf' | 'all';
+export type TTreeviewSelectMode = `${TREEVIEW_SELECT_MODE}`;
+export type TTreeviewSelectableNodes = `${TREEVIEW_SELECTABLE_NODES}`;

package/dist/src/types/Video/video.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamVideo } from '../../components';
+import { VIDEO_TRACK_KIND } from '../../enums';
 import type { TControlsSource } from '../Commons/controls.type';
 export type TOrigamVideo = InstanceType<typeof OrigamVideo>;
 /**
@@ -32,4 +33,4 @@ export type TVideoControls = TControlsSource;
  * See https://html.spec.whatwg.org/multipage/media.html#attr-track-kind
  * for the full list of legal values.
  */
-export type TVideoTrackKind = 'captions' | 'subtitles' | 'descriptions' | 'chapters';
+export type TVideoTrackKind = `${VIDEO_TRACK_KIND}`;