origam 2.15.0 → 2.16.0

package/dist/src/interfaces/Parallax/parallax.interface.d.ts

@@ -121,3 +121,21 @@ export interface IParallaxLayerProvide {
     register: (layer: IParallaxLayerRegistry) => void;
     unregister: (id: symbol) => void;
 }
+/*********************************************************
+ * Options consumed by `useParallaxRuntime`.
+ ********************************************************/
+export interface IUseParallaxRuntimeOptions {
+    target: Ref<HTMLElement | undefined>;
+    direction: Ref<TParallaxDirection>;
+    easing: Ref<TParallaxEasing | string>;
+    threshold: Ref<number>;
+    disabled: Ref<boolean>;
+    /**
+     * Fallback speed used when `slot=default` carries raw content (no
+     * `<OrigamParallaxLayer>`). Mirrors `IParallaxProps.speed`.
+     */
+    speed: Ref<number>;
+    onEnter?: () => void;
+    onLeave?: () => void;
+    onProgress?: (progress: number) => void;
+}

package/dist/src/interfaces/QrCode/qr-code.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, ITagProps } from '../../interfaces';
+import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ISrcObject, IQrCodeLogo, ITagProps } from '../../interfaces';
 import type { TIcon, TQrCodeErrorCorrectionLevel } from '../../types';
 /**
  * Per-matrix overrides — applied INSIDE the SVG (modules + quiet
@@ -150,3 +150,17 @@ export interface IQrCodeSlots {
         size: number;
     }) => any;
 }
+/**
+ * `useQrCode`'s option bag AFTER defaulting — every field resolved to a
+ * concrete value, so the SVG builders downstream never re-apply a
+ * fallback. Distinct from `IUseQrCodeOptions`, which is the loose,
+ * all-optional shape a caller passes in.
+ */
+export interface IQrCodeResolvedOptions {
+    errorCorrectionLevel: TQrCodeErrorCorrectionLevel;
+    foreground: string;
+    background: string;
+    margin: number;
+    cornerRadius: number;
+    logo?: IQrCodeLogo;
+}

package/dist/src/interfaces/Radio/radio-group.interface.d.ts

@@ -1,6 +1,9 @@
-import type { IBorderProps, ICommonsComponentProps, IElevationProps, IInputProps, IMarginProps, IPaddingProps, IRadioProps, IRoundedProps, ISelectionControlGroupProps } from '../../interfaces';
+import type { IBorderProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IInputProps, IMarginProps, IPaddingProps, IRadioProps, IRoundedProps, ISelectionControlGroupProps } from '../../interfaces';
 export interface IRadioGroupProps extends ICommonsComponentProps, Partial<Omit<IRadioProps, 'trueValue' | 'falseValue'>>, IPaddingProps, IMarginProps, IBorderProps, IRoundedProps, IElevationProps, IInputProps, Partial<Omit<ISelectionControlGroupProps, 'multiple'>> {
 }
+/** Emits fired by `<OrigamRadioGroup>` — v-model de la valeur choisie. */
+export interface IRadioGroupEmits extends ICommonsComponentEmits {
+}
 /** Slot signatures for `<OrigamRadioGroup>`. `item` reuses the same
  *  `{id, messagesId, isDisabled, isReadonly, isValid}` scope as
  *  `default` (NOT the individual `item` being rendered — the template

package/dist/src/interfaces/Sheet/sheet-emits.interface.d.ts

@@ -1,3 +1,4 @@
+import type { IActiveEmits } from '../../interfaces';
 import type { TSheetSnapId } from '../../types';
 /**
  * Emit signature for `<OrigamSheet>`.
@@ -8,8 +9,13 @@ import type { TSheetSnapId } from '../../types';
  * - `update:open` is the v-model:open companion — emitted on the
  *   closed/non-closed boundary so two-way binding stays consistent
  *   when the user dismisses via swipe-down.
+ * - `update:active` vient de `useActive(props)` : `onActive()` est câblé
+ *   sur le clic ET sur `keydown.enter` / `keydown.space` du template, et
+ *   écrit dans le v-model `active`. L'émission partait sans être
+ *   déclarée. Prouvé au runtime dans
+ *   `packages/tests/TU/origam/relay-emits-declaration.spec.ts`.
  */
-export interface ISheetEmits {
+export interface ISheetEmits extends IActiveEmits {
     (e: 'update:snap', id: TSheetSnapId): void;
     (e: 'update:open', value: boolean): void;
 }

package/dist/src/interfaces/Snackbar/snackbar-group.interface.d.ts

@@ -1,4 +1,5 @@
-import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { Ref } from 'vue';
+import type { ICommonsComponentProps, ISnackbarGroupItem, ISnackbarGroupItemOptions, ITagProps } from '../../interfaces';
 import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types';
 /**
  * Props for `<OrigamSnackbarGroup>` — a multi-toast container that
@@ -39,7 +40,11 @@ export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
     /**
      * Default auto-dismiss timeout (ms) applied to items that do not
      * supply their own `duration`. Pass `0` to make all items sticky
-     * by default.
+     * by default. Registered into the shared stack store on mount (and
+     * kept in sync reactively), so it applies to `notify()` calls from
+     * ANY `useSnackbarGroup({ id })` instance targeting this stack —
+     * not only calls that repeat `defaultDuration` as a composable
+     * option.
      *
      * @default 5000
      */
@@ -58,3 +63,58 @@ export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
      */
     direction?: TSnackbarGroupDirection;
 }
+/**
+ * Per-`id` singleton store backing `useSnackbarGroup`.
+ *
+ * One entry per stack `id`, held in a module-level map for the lifetime
+ * of the module, so any number of components / composables addressing
+ * the same `id` share state (notify here, dismiss there).
+ */
+export interface ISnackbarGroupState {
+    items: Ref<Array<ISnackbarGroupItem>>;
+    timers: Map<string, number>;
+    counter: {
+        current: number;
+    };
+    /**
+     * Fallback `duration` (ms) for this stack, registered by the
+     * mounted `<OrigamSnackbarGroup defaultDuration="…">` instance (see
+     * `useSnackbarGroupInternal`'s `registerDefaultDuration`). Lets
+     * `notify()` — called from ANYWHERE, independent of which
+     * `useSnackbarGroup({ id })` call site fired it — honour the
+     * component's declared default without requiring every caller to
+     * repeat `defaultDuration` as a composable option. See #snackbar-
+     * group-default-duration-bug: before this, the component's prop and
+     * the composable's `notify()` never met, so `defaultDuration` on
+     * `<OrigamSnackbarGroup>` was purely decorative.
+     */
+    defaultDuration: Ref<number>;
+}
+/** Options accepted by `useSnackbarGroup`. */
+export interface IUseSnackbarGroupOptions {
+    id?: string;
+    /**
+     * Maximum number of items kept in the stack. When `notify` would
+     * push past this number, the oldest item is evicted FIFO. When
+     * undefined, the stack is unbounded (the rendering component
+     * still caps the visible count via its `max` prop).
+     */
+    max?: number;
+    /**
+     * Fallback `duration` applied to items that omit their own.
+     * Defaults to `SNACKBAR_GROUP_DEFAULT_DURATION` (5 000 ms).
+     */
+    defaultDuration?: number;
+}
+/**
+ * Public API returned by `useSnackbarGroup`. The `items` ref is the
+ * same reactive reference shared with the matching
+ * `<OrigamSnackbarGroup id="…">` instance, so direct mutation outside
+ * of `notify` / `dismiss` is discouraged.
+ */
+export interface IUseSnackbarGroupReturn {
+    items: Readonly<Ref<ReadonlyArray<ISnackbarGroupItem>>>;
+    notify: (opts: ISnackbarGroupItemOptions) => string;
+    dismiss: (itemId: string) => void;
+    dismissAll: () => void;
+}

package/dist/src/interfaces/Snackbar/snackbar.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IOverlayProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
+import type { IActiveProps, IBgColorProps, IBorderProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IElevationProps, IHoverProps, ILocationProps, IMarginProps, IOverlayProps, IPaddingProps, IPositionProps, IRoundedProps, IStatusProps, ITagProps, ITransitionComponentProps } from '../../interfaces';
 export interface ISnackbarProps extends ICommonsComponentProps, ITagProps, IStatusProps, IColorProps, IBgColorProps, IOverlayProps, IPositionProps, ILocationProps, IRoundedProps, IBorderProps, IPaddingProps, IMarginProps, IElevationProps, ITransitionComponentProps, IActiveProps, IHoverProps {
     multiLine?: boolean;
     text?: string;
@@ -6,6 +6,9 @@ export interface ISnackbarProps extends ICommonsComponentProps, ITagProps, IStat
     timeout?: number | string;
     vertical?: boolean;
 }
+/** Emits fired by `<OrigamSnackbar>` — fermeture auto ou par geste. */
+export interface ISnackbarEmits extends ICommonsComponentEmits {
+}
 /** Slot signatures for `<OrigamSnackbar>` — the nested
  *  `<OrigamSnackbarItem>`'s `prepend` / `title` / `message` chrome,
  *  plus the unscoped `default` and the `action` slot. */

package/dist/src/interfaces/Theme/origam-theme.interface.d.ts

@@ -1,6 +1,21 @@
+import type { Ref } from 'vue';
 import type { IThemeVars, TThemeVars } from '../../types';
-import type { TMode } from '../../types/Theme/theme.type';
+import type { TMode, TTheme } from '../../types/Theme/theme.type';
 import type { IDefault } from '../DefaultProvider/default-provider.interface';
+/**
+ * Shape of the `useTheme()` singleton state.
+ *
+ * Held on `globalThis` in the browser (so duplicated module instances
+ * within the same JS realm share it) and as a plain module-level object
+ * on the server (so per-request theme state cannot leak across
+ * concurrent requests). See `theme.composable.ts` for the full rationale.
+ */
+export interface IOrigamThemeSingletonState {
+    theme: Ref<TTheme> | null;
+    mode: Ref<TMode> | null;
+    systemPrefersDark: Ref<boolean> | null;
+    mediaInitDone: boolean;
+}
 /**
  * Runtime theme object ingested by `createOrigam({ themes })`. At install time
  * the DS resolves it to a block of `--origam-*` CSS variables injected into

package/dist/src/interfaces/Timeline/timeline.interface.d.ts

@@ -1,5 +1,5 @@
 import type { IColorProps, ICommonsComponentProps, IDensityProps, ISizeProps, ITagProps } from '../../interfaces';
-import type { TIcon, TIntent, TTimelineOrientation } from '../../types';
+import type { TIcon, TIntent, TTimelineOrientation, TTimelineSide } from '../../types';
 /**
  * Shape of the context object provided by OrigamTimeline to its
  * nested OrigamTimelineItem children. Used via inject so each item
@@ -10,7 +10,7 @@ import type { TIcon, TIntent, TTimelineOrientation } from '../../types';
  * `src/consts/Timeline/timeline.const.ts` (TIMELINE_CONTEXT_KEY).
  */
 export interface ITimelineContext {
-    side: 'start' | 'end' | 'alternating';
+    side: TTimelineSide;
     truncateLine: boolean;
     orientation: TTimelineOrientation;
     color?: string;
@@ -33,7 +33,7 @@ export interface ITimelineProps extends ICommonsComponentProps, ITagProps, IColo
      *    Content (title/subtitle/body) renders BELOW each dot.
      */
     orientation?: TTimelineOrientation;
-    side?: 'start' | 'end' | 'alternating';
+    side?: TTimelineSide;
     truncateLine?: boolean;
     ariaLabel?: string;
 }
@@ -44,7 +44,7 @@ export interface ITimelineItemProps extends ICommonsComponentProps, IColorProps,
     intent?: TIntent;
     isLast?: boolean;
     truncateLine?: boolean;
-    side?: 'start' | 'end' | 'alternating';
+    side?: TTimelineSide;
     /**
      * Layout direction forwarded by the parent OrigamTimeline. When unset
      * the item assumes vertical layout. Items rarely set this directly —

package/dist/src/interfaces/Video/video.interface.d.ts

@@ -1,6 +1,6 @@
 import type { Ref } from 'vue';
 import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IMediaPlayerEmits, IMediaPlayerMethods, IMediaPlayerState, IPaddingProps, IRoundedProps, ITypographyProps, IUseMediaPlayerOptions, IVideoSource, IVideoTrack } from '../../interfaces';
-import type { TVideoControls } from '../../types';
+import type { TCrossOrigin, TVideoControls } from '../../types';
 /**
  * Bindings passed to the `#controls` scoped slot of `<OrigamVideo>`.
  *
@@ -160,7 +160,7 @@ export interface IVideoProps extends ICommonsComponentProps, IColorProps, IBgCol
      * the consumer needs canvas / WebAudio access to the decoded
      * frames. Affects how cookies are sent on the request.
      */
-    crossorigin?: 'anonymous' | 'use-credentials';
+    crossorigin?: TCrossOrigin;
     /**
      * Disables the picture-in-picture button (and the matching
      * keyboard shortcut). Useful for content where PIP would defeat

package/dist/src/interfaces/Watermark/watermark.interface.d.ts

@@ -161,3 +161,22 @@ export interface IUseWatermarkOptions {
     /** Same semantics as `IWatermarkProps.zIndex`. */
     zIndex?: number;
 }
+/**
+ * `useWatermark`'s options AFTER defaulting — every field resolved to a
+ * concrete value so the SVG data-URL builder never re-applies a
+ * fallback. Counterpart of `IUseWatermarkOptions`, which is the loose,
+ * all-optional shape a caller passes in.
+ */
+export interface IWatermarkResolvedOptions {
+    text: string;
+    image: string;
+    opacity: number;
+    angle: number;
+    gap: number;
+    fontSize: number;
+    fontFamily: string;
+    color: string;
+    fontWeight: number | string;
+    pointerEvents: 'none' | 'auto';
+    zIndex: number;
+}

package/dist/src/interfaces/index.cjs

@@ -168,6 +168,17 @@ Object.keys(_bracketRoundComponent).forEach(function (key) {
     }
   });
 });
+var _bracketSurface = require("./Bracket/bracket-surface.interface.cjs");
+Object.keys(_bracketSurface).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _bracketSurface[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _bracketSurface[key];
+    }
+  });
+});
 var _breadcrumb = require("./Breadcrumb/breadcrumb.interface.cjs");
 Object.keys(_breadcrumb).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -2610,6 +2621,28 @@ Object.keys(_calendar2).forEach(function (key) {
     }
   });
 });
+var _rrule = require("./Calendar/rrule.interface.cjs");
+Object.keys(_rrule).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _rrule[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _rrule[key];
+    }
+  });
+});
+var _cssSupport = require("./CssSupport/css-support.interface.cjs");
+Object.keys(_cssSupport).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _cssSupport[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _cssSupport[key];
+    }
+  });
+});
 var _chartSeries = require("./Chart/chart-series.interface.cjs");
 Object.keys(_chartSeries).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/dist/src/interfaces/index.d.ts

@@ -13,6 +13,7 @@ export * from './Bracket/bracket-round.interface';
 export * from './Bracket/bracket-match-component.interface';
 export * from './Bracket/bracket-competitor-component.interface';
 export * from './Bracket/bracket-round-component.interface';
+export * from './Bracket/bracket-surface.interface';
 export * from './Breadcrumb/breadcrumb.interface';
 export * from './Breadcrumb/breadcrumb-item.interface';
 export * from './Breadcrumb/breadcrumb-divider.interface';
@@ -235,6 +236,8 @@ export * from './Video/video.interface';
 export * from './Video/video-track.interface';
 export * from './Calendar/event.interface';
 export * from './Calendar/calendar.interface';
+export * from './Calendar/rrule.interface';
+export * from './CssSupport/css-support.interface';
 export * from './Chart/chart-series.interface';
 export * from './Chart/chart-point.interface';
 export * from './Chart/chart-drilldown.interface';

package/dist/src/interfaces/index.js

@@ -13,6 +13,7 @@ export * from "./Bracket/bracket-round.interface.js";
 export * from "./Bracket/bracket-match-component.interface.js";
 export * from "./Bracket/bracket-competitor-component.interface.js";
 export * from "./Bracket/bracket-round-component.interface.js";
+export * from "./Bracket/bracket-surface.interface.js";
 export * from "./Breadcrumb/breadcrumb.interface.js";
 export * from "./Breadcrumb/breadcrumb-item.interface.js";
 export * from "./Breadcrumb/breadcrumb-divider.interface.js";
@@ -235,6 +236,8 @@ export * from "./Video/video.interface.js";
 export * from "./Video/video-track.interface.js";
 export * from "./Calendar/event.interface.js";
 export * from "./Calendar/calendar.interface.js";
+export * from "./Calendar/rrule.interface.js";
+export * from "./CssSupport/css-support.interface.js";
 export * from "./Chart/chart-series.interface.js";
 export * from "./Chart/chart-point.interface.js";
 export * from "./Chart/chart-drilldown.interface.js";

package/dist/src/origam.cjs

@@ -32,6 +32,7 @@ function createOrigam(origam = {}) {
   const installedThemes = (0, _utils.installedThemesFromList)(allThemes);
   const defaultsRef = (0, _composables.createDefaults)({});
   defaultsRef.value = activeDefaultsFor(allThemes, allThemes[0]?.name ?? "", void 0);
+  const themedKeysUnion = (0, _composables.themedPropKeysUnion)(allThemes.map(theme => theme.components).filter(components2 => !!components2));
   const scope = (0, _vue.effectScope)();
   return scope.run(() => {
     const icons = (0, _composables.createIcons)(options.icons);
@@ -67,6 +68,7 @@ function createOrigam(origam = {}) {
       app.provide(_consts.ORIGAM_GO_TO_KEY, goTo);
       app.provide(_consts.ORIGAM_THEMES_KEY, installedThemes);
       app.provide(_consts.ORIGAM_DEFAULTS_KEY, defaultsRef);
+      (0, _composables.installThemePropsResolver)(app, themedKeysUnion);
       app.provide(_consts.ORIGAM_THEME_DEFAULTS_KEY, (brand, mode) => activeDefaultsFor(allThemes, brand, mode));
       if (_consts.IN_BROWSER && options.ssr) {
         const nuxt = app.$nuxt;

package/dist/src/origam.js

@@ -1,5 +1,14 @@
 import * as origamComponents from "./components/index.js";
-import { createDate, createDefaults, createDisplay, createGoTo, createIcons, createLocale } from "./composables/index.js";
+import {
+  createDate,
+  createDefaults,
+  createDisplay,
+  createGoTo,
+  createIcons,
+  createLocale,
+  installThemePropsResolver,
+  themedPropKeysUnion
+} from "./composables/index.js";
 import {
   IN_BROWSER,
   ORIGAM_DATE_ADAPTER_KEY,
@@ -34,6 +43,9 @@ export function createOrigam(origam = {}) {
   const installedThemes = installedThemesFromList(allThemes);
   const defaultsRef = createDefaults({});
   defaultsRef.value = activeDefaultsFor(allThemes, allThemes[0]?.name ?? "", void 0);
+  const themedKeysUnion = themedPropKeysUnion(
+    allThemes.map((theme) => theme.components).filter((components2) => !!components2)
+  );
   const scope = effectScope();
   return scope.run(() => {
     const icons = createIcons(options.icons);
@@ -69,6 +81,7 @@ export function createOrigam(origam = {}) {
       app.provide(ORIGAM_GO_TO_KEY, goTo);
       app.provide(ORIGAM_THEMES_KEY, installedThemes);
       app.provide(ORIGAM_DEFAULTS_KEY, defaultsRef);
+      installThemePropsResolver(app, themedKeysUnion);
       app.provide(ORIGAM_THEME_DEFAULTS_KEY, (brand, mode) => activeDefaultsFor(allThemes, brand, mode));
       if (IN_BROWSER && options.ssr) {
         const nuxt = app.$nuxt;

package/dist/src/types/Blockquote/blockquote.type.d.ts

@@ -1,10 +1,11 @@
 import { OrigamBlockquote } from '../../components';
+import { BLOCKQUOTE_LANG, BLOCKQUOTE_VARIANT, TEXT_ALIGN } from '../../enums';
 export type TOrigamBlockquote = InstanceType<typeof OrigamBlockquote>;
 /**
  * Horizontal alignment of the citation body. `pull` variant defaults to
  * `'center'`; every other variant defaults to `'left'`.
  */
-export type TBlockquoteAlign = 'left' | 'center' | 'right';
+export type TBlockquoteAlign = `${TEXT_ALIGN}`;
 /**
  * Locale hint for `<OrigamBlockquote>` decorative quote marks. Only
  * relevant for `variant="quoted"` — the other variants ignore the prop.
@@ -22,7 +23,7 @@ export type TBlockquoteAlign = 'left' | 'center' | 'right';
  * Resolution lives in `src/consts/Blockquote/blockquote.const.ts`
  * (`QUOTE_MARKS_BY_LANG`).
  */
-export type TBlockquoteLang = 'fr' | 'en' | 'es' | 'de' | 'auto';
+export type TBlockquoteLang = `${BLOCKQUOTE_LANG}`;
 /**
  * Visual variants for `<OrigamBlockquote>`. Each variant is a self
  * contained typographic treatment; consumers do not mix them — pick the
@@ -39,4 +40,4 @@ export type TBlockquoteLang = 'fr' | 'en' | 'es' | 'de' | 'auto';
  * - `pull`     — pull quote: large body type, centred, extracted out of
  *                the flow. Use sparingly — one per article max.
  */
-export type TBlockquoteVariant = 'default' | 'elegant' | 'quoted' | 'minimal' | 'pull';
+export type TBlockquoteVariant = `${BLOCKQUOTE_VARIANT}`;

package/dist/src/types/Bracket/bracket-round.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamBracketRound } from '../../components';
+import { BRACKET_ROUND_SIDE } from '../../enums';
 /**
  * Optional side marker for double-elimination tournaments.
  *
@@ -10,5 +11,5 @@ import { OrigamBracketRound } from '../../components';
  * Single-elimination tournaments do not need to set this — leave it
  * `undefined`.
  */
-export type TBracketRoundSide = 'winner' | 'loser' | 'grand-final';
+export type TBracketRoundSide = `${BRACKET_ROUND_SIDE}`;
 export type TOrigamBracketRound = InstanceType<typeof OrigamBracketRound>;

package/dist/src/types/Bracket/bracket.type.d.ts

@@ -1,5 +1,9 @@
 import type { IBracketMatch, IBracketRound } from '../../interfaces';
+import type { IBorderProps } from '../../interfaces/Commons/border.interface';
+import type { IRoundedProps } from '../../interfaces/Commons/rounded.interface';
+import type { TColor } from '../Commons/color.type';
 import type { TDirection } from '../Commons/direction.type';
+import type { TElevation } from '../Commons/elevation.type';
 import { BRACKET_VARIANT } from '../../enums';
 import { OrigamBracket } from '../../components';
 /**
@@ -52,3 +56,49 @@ export type TBracketDoubleSection = {
 };
 export type TBracketVariant = `${BRACKET_VARIANT}`;
 export type TOrigamBracket = InstanceType<typeof OrigamBracket>;
+/**
+ * Input vocabularies accepted by the `resolveBracket*` helpers in
+ * `src/utils/Bracket/bracket-surface.util.ts`.
+ *
+ * Each one is DERIVED from the matching Commons surface rather than
+ * restated as a literal union. The four started life as four hand-typed
+ * unions — three of which (`rounded`, `elevation`, `border`) had
+ * collapsed to the byte-identical `string | number | boolean | null |
+ * undefined`, so nothing in the type system stopped them drifting apart
+ * from the props they are fed by, nor from each other. Deriving them
+ * means a widening of `IRoundedProps['rounded']` (or of `TElevation`)
+ * reaches the resolver's signature on its own.
+ *
+ * They are LOOSER than the props they mirror on one axis: the resolvers
+ * are called with raw prop bags through a cast (see
+ * `bracketSurfaceVars(props as IBracketSurfaceInput)` in
+ * `OrigamBracket.vue`), so `null` and a bare `true` opt-in both have to
+ * be accepted and are handled explicitly at runtime.
+ */
+/**
+ * Colour input — the string half of {@link TColor}. The bracket
+ * resolvers deliberately do NOT accept `IGradient`: they emit
+ * `--origam-bracket-match---*` custom properties that feed
+ * `background-color` / `border-color`, and neither CSS property has a
+ * gradient form.
+ */
+export type TBracketColor = Extract<TColor, string> | null | undefined;
+/** Corner-radius input — the exact vocabulary of `IRoundedProps['rounded']`. */
+export type TBracketRounded = IRoundedProps['rounded'];
+/**
+ * Elevation input — {@link TElevation} plus the boolean opt-in
+ * (`true` → the default `md` rung) and the falsy opt-out.
+ */
+export type TBracketElevation = TElevation | boolean | null | undefined;
+/**
+ * Border-width input — the per-side vocabulary of
+ * `IBorderProps['borderTop']`, plus the falsy opt-out.
+ *
+ * The per-SIDE prop is the right reference here, not the global
+ * `IBorderProps['border']`: the latter also accepts a
+ * `TDirectionBoth[]` ("border on these edges only"), which is an edge
+ * SELECTOR, not a width. `resolveBracketBorderWidth` resolves a width
+ * for one already-chosen edge, so the array form has no meaning at this
+ * layer.
+ */
+export type TBracketBorder = IBorderProps['borderTop'] | null | undefined;

package/dist/src/types/Calendar/calendar.type.d.ts

@@ -1,4 +1,5 @@
 import { OrigamCalendar } from '../../components';
+import { CALENDAR_NAVIGATE, CALENDAR_TIME_FORMAT, CALENDAR_VIEW } from '../../enums';
 export type TOrigamCalendar = InstanceType<typeof OrigamCalendar>;
 /**
  * Clock format for time labels in week / day / agenda views.
@@ -6,13 +7,13 @@ export type TOrigamCalendar = InstanceType<typeof OrigamCalendar>;
  * `'24h'` — 00:00 → 23:59. Default for everywhere except en-US.
  * `'12h'` — 12:00 AM → 11:59 PM. Honours locale-specific AM/PM.
  */
-export type TCalendarTimeFormat = '12h' | '24h';
+export type TCalendarTimeFormat = `${CALENDAR_TIME_FORMAT}`;
 /**
  * Navigation direction passed to `useCalendar().navigate(...)` and
  * the `navigate` event. `'today'` jumps to "now" regardless of the
  * current view.
  */
-export type TCalendarNavigate = 'prev' | 'next' | 'today';
+export type TCalendarNavigate = `${CALENDAR_NAVIGATE}`;
 /**
  * Top-level view modes supported by `<OrigamCalendar>`.
  *
@@ -22,4 +23,4 @@ export type TCalendarNavigate = 'prev' | 'next' | 'today';
  * - `'agenda'`— flat list grouped by day, useful for screen readers
  *               and dense schedules.
  */
-export type TCalendarView = 'month' | 'week' | 'day' | 'agenda';
+export type TCalendarView = `${CALENDAR_VIEW}`;

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

@@ -1,4 +1,5 @@
 import { OrigamChartCartesian } from '../../components';
+import { CHART_CARTESIAN_KIND } from '../../enums';
 /**
  * Cartesian chart topology — the subset of `TChartType` that
  * `<OrigamChartCartesian>` knows how to render. Each value implies
@@ -16,5 +17,5 @@ import { OrigamChartCartesian } from '../../components';
  * `TChartType` because the family-level component only accepts
  * this narrower subset — the SFC's `defineProps` enforces it.
  */
-export type TChartCartesianKind = 'line' | 'area' | 'bar' | 'column' | 'scatter' | 'spline' | 'stepped-line';
+export type TChartCartesianKind = `${CHART_CARTESIAN_KIND}`;
 export type TOrigamChartCartesian = InstanceType<typeof OrigamChartCartesian>;

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

@@ -1,8 +1,12 @@
 import { OrigamChartLegend } from '../../components';
+import type { TDirectionBoth } from '../Commons/anchor.type';
 /**
  * Anchor position of the legend block inside `<OrigamChart>`. The
  * SVG plotting area shrinks or grows depending on the value — the
  * flex layout in the SCSS handles the box arithmetic.
+ *
+ * Aliases the Commons physical-side vocabulary (`BLOCK` + `INLINE` =
+ * top/bottom/left/right) rather than redeclaring its four literals.
  */
-export type TChartLegendPosition = 'top' | 'bottom' | 'left' | 'right';
+export type TChartLegendPosition = TDirectionBoth;
 export type TOrigamChartLegend = InstanceType<typeof OrigamChartLegend>;

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

@@ -1,3 +1,4 @@
 import { OrigamChartPictorial } from '../../components';
-export type TChartPictorialMode = 'stack' | 'fill';
+import { CHART_PICTORIAL_MODE } from '../../enums';
+export type TChartPictorialMode = `${CHART_PICTORIAL_MODE}`;
 export type TOrigamChartPictorial = InstanceType<typeof OrigamChartPictorial>;

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

@@ -1,4 +1,5 @@
 import { OrigamChartPolar } from '../../components';
+import { CHART_POLAR_KIND } from '../../enums';
 /**
  * Polar chart topology — the subset of `TChartType` that
  * `<OrigamChartPolar>` knows how to render. Two values, two arc
@@ -12,5 +13,5 @@ import { OrigamChartPolar } from '../../components';
  * reason (the legacy `<OrigamChart>` shell painted axis lines
  * behind pie/donut slices, which is the user's primary complaint).
  */
-export type TChartPolarKind = 'pie' | 'donut';
+export type TChartPolarKind = `${CHART_POLAR_KIND}`;
 export type TOrigamChartPolar = InstanceType<typeof OrigamChartPolar>;

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

@@ -1,3 +1,4 @@
 import { OrigamChartStreamgraph } from '../../components';
-export type TChartStreamgraphOffset = 'wiggle' | 'silhouette' | 'expand' | 'zero';
+import { CHART_STREAMGRAPH_OFFSET } from '../../enums';
+export type TChartStreamgraphOffset = `${CHART_STREAMGRAPH_OFFSET}`;
 export type TOrigamChartStreamgraph = InstanceType<typeof OrigamChartStreamgraph>;

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

@@ -1,2 +1,10 @@
 import { OrigamChartSunburst } from '../../components';
+import { CHART_SUNBURST_LABEL_MODE } from '../../enums';
 export type TOrigamChartSunburst = InstanceType<typeof OrigamChartSunburst>;
+/**
+ * How the label for a node is rendered.
+ * - `'inline'`  — centred horizontally inside the arc (wide arcs).
+ * - `'rotated'` — rotated tangentially along the arc midpoint (narrow arcs).
+ * - `'leader'`  — placed outside the chart with a leader line (very narrow arcs).
+ */
+export type TChartSunburstLabelMode = `${CHART_SUNBURST_LABEL_MODE}`;

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

@@ -1,4 +1,5 @@
 import { OrigamChartTreemap } from '../../components';
+import { CHART_TREEMAP_ALGORITHM } from '../../enums';
 /**
  * Treemap layout algorithm selector.
  *
@@ -10,5 +11,5 @@ import { OrigamChartTreemap } from '../../components';
  *   each recursion level (slice at even depth, dice at odd depth).
  *   Tiles tend to be long and thin but preserve data order.
  */
-export type TChartTreemapAlgorithm = 'squarified' | 'slice-dice';
+export type TChartTreemapAlgorithm = `${CHART_TREEMAP_ALGORITHM}`;
 export type TOrigamChartTreemap = InstanceType<typeof OrigamChartTreemap>;