origam 2.21.0 → 2.23.0

package/dist/src/consts/Code/code.const.d.ts

@@ -1,4 +1,6 @@
+import type { InjectionKey } from 'vue';
 import { CODE_LANG } from '../../enums';
+import type { ICodeOptions } from '../../interfaces/Code/code.interface';
 /**
  * Languages bundled with the default shiki highlighter. Keep this list and
  * the `langs` argument of `createHighlighter()` in lockstep — see
@@ -51,3 +53,15 @@ export declare const CODE_DEFAULTS: Readonly<{
      */
     readonly copyFeedbackDurationMs: 2000;
 }>;
+/*********************************************************
+ * ORIGAM_CODE_KEY
+ *
+ * @description
+ * Provide/inject key for the `code` block of `createOrigam()`'s options
+ * (`ICodeOptions` — today just `highlighter`). `useCode()` reads it via
+ * `inject(ORIGAM_CODE_KEY)` — optional on purpose: an app that never calls
+ * `createOrigam({ code })`, or that never installs the plugin at all, gets
+ * `undefined` and `loadHighlighter()` falls back to the DS's own
+ * `import('shiki')` path unchanged. See `code.composable.ts`.
+ ********************************************************/
+export declare const ORIGAM_CODE_KEY: InjectionKey<ICodeOptions>;

package/dist/src/consts/Code/code.const.js

@@ -30,3 +30,4 @@ export const CODE_DEFAULTS = Object.freeze({
    */
   copyFeedbackDurationMs: 2e3
 });
+export const ORIGAM_CODE_KEY = /* @__PURE__ */ Symbol.for("origam:code");

package/dist/src/interfaces/Btn/btn-group.interface.d.ts

@@ -10,8 +10,8 @@ import type { IMarginProps } from '../Commons/margin.interface';
 import type { IPaddingProps } from '../Commons/padding.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISizeProps } from '../Commons/size.interface';
-import type { IVariantProps } from '../Commons/variant.interface';
-export interface IBtnGroupProps extends ITagProps, ICommonsComponentProps, IRoundedProps, IBorderProps, IDensityProps, IElevationProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IHoverProps, IActiveProps, IVariantProps, ISizeProps {
+import type { IActionVariantProps } from '../Commons/variant.interface';
+export interface IBtnGroupProps extends ITagProps, ICommonsComponentProps, IRoundedProps, IBorderProps, IDensityProps, IElevationProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IHoverProps, IActiveProps, IActionVariantProps, ISizeProps {
     divided?: boolean;
     items?: Array<IBtnProps>;
 }

package/dist/src/interfaces/Btn/btn.interface.d.ts

@@ -18,14 +18,14 @@ import type { IRippleProps } from '../Commons/ripple.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISizeProps } from '../Commons/size.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
-import type { IVariantProps } from '../Commons/variant.interface';
+import type { IActionVariantProps } from '../Commons/variant.interface';
 import type { TIcon } from '../../types/Icon/icon.type';
 import type { TStatus, TStatusPosition } from '../../types/Commons/status.type';
 /** Btn needs `status` / `statusIconPosition` from IStatusProps but its own
  *  `icon` prop accepts `boolean | TIcon` (boolean = icon-only mode) which is
  *  wider than `IIconProps.icon?: TIcon`.  Pulling the two status props in
  *  directly avoids the TS2430 incompatible-extends error. */
-export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IHoverProps, IActiveProps, IVariantProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
+export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IHoverProps, IActiveProps, IActionVariantProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     /** @deprecated Use `variant="flat"` instead. Kept for backward compat. */
     flat?: boolean;
     /** Pass `true` to activate icon-only mode; pass a `TIcon` value to set the icon. */

package/dist/src/interfaces/Code/code.interface.d.ts

@@ -7,7 +7,7 @@ import type { IMarginProps } from '../Commons/margin.interface';
 import type { IPaddingProps } from '../Commons/padding.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
-import type { TCodeLang } from '../../types/Code/code.type';
+import type { TCodeLang, TShikiHighlighterLoader } from '../../types/Code/code.type';
 /**
  * Props for `<OrigamCode>` — a shiki-powered code block with line numbers,
  * line highlighting, copy button and theme awareness.
@@ -85,6 +85,38 @@ export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderPr
      */
     prompt?: string;
 }
+/*********************************************************
+ * ICodeOptions
+ *
+ * @description
+ * App-level config for `<OrigamCode>`, passed via `createOrigam({ code })`.
+ * Today it carries a single knob — `highlighter` — but it is its own
+ * interface (rather than a bare function on `IOrigamOptions`) so a future
+ * `OrigamCode`-wide setting (e.g. a default theme pair) has somewhere to
+ * land without another breaking shape change.
+ *
+ * @description
+ * `highlighter` supplies your own shiki-compatible module loader instead of
+ * the DS's default `import('shiki')` (see `code.composable.ts`'s
+ * `loadHighlighter()`). Absent (default) — `useCode()` keeps loading the
+ * full `shiki` package exactly as before, nothing changes for a consumer
+ * who does not set this. Supplied — the DS never touches `shiki` itself: no
+ * bare-specifier dynamic import, no `@vite-ignore`, no WASM-loader chunk in
+ * THIS path. Typical use: an app bundling `shiki/core` + a JS regex engine
+ * (no WASM loader, no oniguruma binary) to shrink the syntax-highlighting
+ * cost — any module exposing `createHighlighter` works, see `TShikiModule`.
+ *
+ * @description
+ * The loader is read once, synchronously, the first time `useCode()` is
+ * invoked inside a mounted `<OrigamCode>` — `useCode()` is a module-scoped
+ * singleton (one highlighter promise for the whole page), so the FIRST
+ * instance to resolve it wins for the lifetime of the page; later instances
+ * reuse that same highlighter regardless of their own `createOrigam()`
+ * ancestor.
+ ********************************************************/
+export interface ICodeOptions {
+    highlighter?: TShikiHighlighterLoader;
+}
 /** Emits fired by `<OrigamCode>` — copy-to-clipboard confirmation. */
 export interface ICodeEmits {
     (e: 'copy', code: string): void;

package/dist/src/interfaces/CommandPalette/command-palette.interface.d.ts

@@ -1,4 +1,5 @@
 import type { ICommand } from './command.interface';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { ICommonsComponentProps } from '../Commons/commons.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
 /**
@@ -11,7 +12,7 @@ import type { ITypographyProps } from '../Commons/typography.interface';
  * the listeners so consumers can pass either form interchangeably.
  */
 export type TCommandPaletteHotkey = ReadonlyArray<string> | ReadonlyArray<ReadonlyArray<string>>;
-export interface ICommandPaletteProps extends ICommonsComponentProps, Pick<ITypographyProps, 'fontSize'> {
+export interface ICommandPaletteProps extends ICommonsComponentProps, Pick<ITypographyProps, 'fontSize'>, IAttachProps {
     /** v-model — whether the palette is open. */
     modelValue?: boolean;
     /**

package/dist/src/interfaces/Commons/attach.interface.cjs

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

package/dist/src/interfaces/Commons/attach.interface.d.ts

@@ -0,0 +1,30 @@
+/**
+ * `attach` — the teleport target for a component's floating / portal
+ * surface, resolved through `useTeleport()`
+ * (`composables/Commons/teleport.composable.ts`), the SINGLE consumption
+ * point for the whole DS. Extracted from `IOverlayProps` (#attach-
+ * harmonisation) so every component that teleports declares the exact
+ * same surface instead of a half-implemented, hand-rolled `to="body"`.
+ *
+ *   • `true`               → no teleport, render in place.
+ *   • `false` / unset      → `document.body`. Vue's boolean-prop casting
+ *                             defaults an ABSENT prop whose declared type
+ *                             includes `Boolean` to `false` when the
+ *                             component declares no `default` for it — so
+ *                             "not passed" and "passed `false`" resolve
+ *                             identically to `document.body` by design
+ *                             (see `OrigamOverlay`, `OrigamMenu`).
+ *   • a CSS selector string → resolved against `document.querySelector`.
+ *   • an `Element`          → used directly as the teleport container.
+ *   • `null`                → reserved for a component whose OWN default
+ *                             is not `document.body` (`OrigamDrawer`
+ *                             teleports into its `<OrigamLayout>` wrapper
+ *                             by default) and therefore needs a THIRD
+ *                             state, distinguishable from an explicit
+ *                             `false`, to fall back to that non-body
+ *                             default instead. Same tri-state pattern as
+ *                             `IDrawerProps.push` / `.clipped`.
+ */
+export interface IAttachProps {
+    attach?: boolean | string | Element | null;
+}

package/dist/src/interfaces/Commons/commons.interface.d.ts

@@ -6,6 +6,7 @@ import type { IDisplayOptions } from './display.interface';
 import type { IGoToOptions } from './goTo.interface';
 import type { ILocaleOptions, IRtlOptions } from './locale.interface';
 import type { IOrigamTheme } from './theme.interface';
+import type { ICodeOptions } from '../Code/code.interface';
 import { TIconOptions } from '../../types/Icon/icon.type';
 import { TOrigamPluginOptionsImport } from '../../types/Commons/commons.type';
 import { TSSROptions } from '../../types/Commons/display.type';
@@ -53,6 +54,7 @@ export interface IOrigamOptions {
      * injected. SSR-safe (injection is a no-op without `document`).
      */
     themes?: IOrigamTheme[];
+    code?: ICodeOptions;
 }
 export interface IOrigamPluginOptions {
     autoImport?: TOrigamPluginOptionsImport;

package/dist/src/interfaces/Commons/variant.interface.d.ts

@@ -1,10 +1,32 @@
 import type { TVariant, TVariantInput } from '../../types/Commons/variant.type';
-/**
- * Mixin props for components that expose a visual variant. The union accepts
- * both action-style variants (`text/flat/elevated/tonal/outlined/plain`) and
- * input-style variants (`solo/filled/underlined/...`) so a single prop type
- * fits every consumer.
- */
-export interface IVariantProps {
-    variant?: TVariant | TVariantInput;
+/*********************************************************
+ * IActionVariantProps
+ *
+ * @description
+ * Mixin props for ACTION-style surfaces (Btn, BtnGroup, BtnToggle…) — the
+ * `VARIANT` enum taxonomy (`text/flat/elevated/tonal/outlined/plain/ghost`).
+ *
+ * @description
+ * Split from the former single `IVariantProps` (#1050 / ADR-005 follow-up):
+ * that mixin's union accepted BOTH this family's 7 values AND the input
+ * family's 5, so every one of the 14 consumers silently accepted 3-5 values
+ * it never implements (`underlined`/`filled`/`solo` here). Each family now
+ * only names the vocabulary it actually renders.
+ ********************************************************/
+export interface IActionVariantProps {
+    variant?: TVariant;
+}
+/*********************************************************
+ * IInputVariantProps
+ *
+ * @description
+ * Mixin props for INPUT-style surfaces (Field and its descendants,
+ * ConfirmWrapper) — the `VARIANT_INPUT` enum taxonomy
+ * (`underlined/filled/solo/outlined/plain`).
+ *
+ * @description
+ * See `IActionVariantProps` above for why this was split out.
+ ********************************************************/
+export interface IInputVariantProps {
+    variant?: TVariantInput;
 }

package/dist/src/interfaces/ConfirmWrapper/confirm-wrapper.interface.d.ts

@@ -6,7 +6,7 @@ import type { IDirectionProps } from '../Commons/direction.interface';
 import type { IElevationProps } from '../Commons/elevation.interface';
 import type { IFocusProps } from '../Commons/focus.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
-import type { IVariantProps } from '../Commons/variant.interface';
+import type { IInputVariantProps } from '../Commons/variant.interface';
 /**
  * Props for `<OrigamConfirmWrapper>` — a "type-it-twice" form helper that
  * pairs a primary input with a confirmation input and lights up only when
@@ -15,8 +15,13 @@ import type { IVariantProps } from '../Commons/variant.interface';
  *
  * Inherits the standard form mixins so it slots into a Field/Form pipeline
  * alongside any other input control.
+ *
+ * `variant` is `IInputVariantProps` (not `IActionVariantProps`) — decided by
+ * the owner: ConfirmWrapper wraps form fields, so it only pushes a FIELD
+ * variant (`underlined/filled/solo/outlined/plain`), never an action-style
+ * one (#1050).
  */
-export interface IConfirmWrapperProps extends ICommonsComponentProps, IAdjacentProps, IDirectionProps, IColorProps, IDensityProps, IRoundedProps, IElevationProps, IVariantProps, IFocusProps {
+export interface IConfirmWrapperProps extends ICommonsComponentProps, IAdjacentProps, IDirectionProps, IColorProps, IDensityProps, IRoundedProps, IElevationProps, IInputVariantProps, IFocusProps {
     modelValue?: any;
     confirm?: any;
     field?: string;

package/dist/src/interfaces/Drawer/drawer.interface.d.ts

@@ -1,5 +1,6 @@
 import type { IActiveProps } from '../Commons/active.interface';
 import type { IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
 import type { IBorderProps } from '../Commons/border.interface';
 import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
@@ -12,7 +13,7 @@ import type { IPaddingProps } from '../Commons/padding.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { IScrimProps } from '../Overlay/overlay-scrim.interface';
 import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
-export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorderProps, IElevationProps, ILayoutItemProps, IRoundedProps, IColorProps, IBgColorProps, IDensityProps, IPaddingProps, IMarginProps, ITransitionComponentProps, IScrimProps, IActiveProps, IHoverProps {
+export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorderProps, IElevationProps, ILayoutItemProps, IRoundedProps, IColorProps, IBgColorProps, IDensityProps, IPaddingProps, IMarginProps, ITransitionComponentProps, IScrimProps, IActiveProps, IHoverProps, IAttachProps {
     disableResizeWatcher?: boolean;
     disableRouteWatcher?: boolean;
     expandOnHover?: boolean;
@@ -60,6 +61,28 @@ export interface IDrawerProps extends ITagProps, ICommonsComponentProps, IBorder
      *               Drawer before AppBar → drawer full-height.
      */
     clipped?: boolean | null;
+    /**
+     * `attach` — inherited from `IAttachProps`, re-documented here because
+     * `OrigamDrawer`'s DEFAULT target is not `document.body` like the rest
+     * of the Overlay family: it teleports into its `<OrigamLayout>`
+     * ancestor's `.origam-layout__wrapper` (by `id`, via `useLayoutItem`),
+     * or renders inline when no `<OrigamLayout>` ancestor exists (the
+     * "orphan" case).
+     *
+     *   • `null` (default) → keep the layout-wrapper / orphan-inline
+     *               behaviour described above. Declared as the explicit
+     *               `withDefaults` value so Vue's boolean-prop casting —
+     *               which would otherwise force an UNSET `attach` to
+     *               `false` — never overrides it. Same device as `push` /
+     *               `clipped` above.
+     *   • `true`  → render in place, bypassing BOTH the layout teleport
+     *               AND the orphan fallback.
+     *   • `false` → `document.body`, same as the rest of the Overlay
+     *               family — escapes the layout wrapper entirely.
+     *   • a CSS selector `string` / an `Element` → teleport there instead
+     *               of the layout wrapper.
+     */
+    attach?: boolean | string | Element | null;
 }
 /**
  * Emits fired by `<OrigamDrawer>` — v-model on the open state, plus a

package/dist/src/interfaces/Field/field.interface.d.ts

@@ -11,7 +11,7 @@ import type { ILoaderProps } from '../Commons/loader.interface';
 import type { IRoundedProps } from '../Commons/rounded.interface';
 import type { ISizeProps } from '../Commons/size.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
-import type { IVariantProps } from '../Commons/variant.interface';
+import type { IInputVariantProps } from '../Commons/variant.interface';
 /*********************************************************
  * IFieldProps
  *
@@ -31,7 +31,7 @@ import type { IVariantProps } from '../Commons/variant.interface';
  * `--origam-field---border-*` token channel the three outline legs already
  * read, so the notch keeps opening under `--active` / `--focused`.
  ********************************************************/
-export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColorProps, IBgColorProps, IAdjacentInnerProps, IBorderProps, IFocusProps, IDensityProps, ILabelProps, IActiveProps, IVariantProps, IRoundedProps, IElevationProps, ISizeProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
+export interface IFieldProps extends ICommonsComponentProps, ILoaderProps, IColorProps, IBgColorProps, IAdjacentInnerProps, IBorderProps, IFocusProps, IDensityProps, ILabelProps, IActiveProps, IInputVariantProps, IRoundedProps, IElevationProps, ISizeProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     centerAffix?: boolean;
     dirty?: boolean;
     disabled?: boolean;

package/dist/src/interfaces/NumberField/number-field.interface.d.ts

@@ -2,9 +2,9 @@ import type { IAdjacentInnerEmits } from '../Commons/adjacent.interface';
 import type { IFocusEmits } from '../Commons/focus.interface';
 import type { IFieldProps, IFieldSlots } from '../Field/field.interface';
 import type { IInputEmits, IInputProps, IInputSlots } from '../Input/input.interface';
-import type { IVariantProps } from '../Commons/variant.interface';
+import type { IInputVariantProps } from '../Commons/variant.interface';
 import type { TIcon } from '../../types/Icon/icon.type';
-export interface INumberFieldProps extends IFieldProps, IInputProps, IVariantProps {
+export interface INumberFieldProps extends IFieldProps, IInputProps, IInputVariantProps {
     autofocus?: boolean;
     placeholder?: string;
     persistentPlaceholder?: boolean;

package/dist/src/interfaces/OtpInputField/otp-input-field.interface.d.ts

@@ -3,7 +3,7 @@ import type { ICommonsComponentEmits } from '../Commons/commons.interface';
 import type { IFocusEmits } from '../Commons/focus.interface';
 import type { IFieldProps, IFieldSlots } from '../Field/field.interface';
 import type { IInputProps, IInputSlots } from '../Input/input.interface';
-import type { IVariantProps } from '../Commons/variant.interface';
+import type { IInputVariantProps } from '../Commons/variant.interface';
 import type { ITypographyProps } from '../Commons/typography.interface';
 import type { TOtpInputFieldType } from '../../types/OtpInputField/otp-input-field.type';
 /*********************************************************
@@ -43,7 +43,7 @@ import type { TOtpInputFieldType } from '../../types/OtpInputField/otp-input-fie
  * → `IAdjacentInnerProps`, reach `<origam-field>` via `fieldProps()`, and were
  * measured PRESENT in the same sweep.
  ********************************************************/
-export interface IOtpInputFieldProps extends Omit<IFieldProps, 'fontFamily' | 'fontWeight' | 'lineHeight' | 'letterSpacing'>, Omit<IInputProps, 'fontFamily' | 'fontWeight' | 'lineHeight' | 'letterSpacing' | 'prependIcon' | 'appendIcon' | 'prependAvatar' | 'appendAvatar' | 'prependAriaLabel' | 'appendAriaLabel'>, IVariantProps, Pick<ITypographyProps, 'fontSize'> {
+export interface IOtpInputFieldProps extends Omit<IFieldProps, 'fontFamily' | 'fontWeight' | 'lineHeight' | 'letterSpacing'>, Omit<IInputProps, 'fontFamily' | 'fontWeight' | 'lineHeight' | 'letterSpacing' | 'prependIcon' | 'appendIcon' | 'prependAvatar' | 'appendAvatar' | 'prependAriaLabel' | 'appendAriaLabel'>, IInputVariantProps, Pick<ITypographyProps, 'fontSize'> {
     autofocus?: boolean;
     divider?: string;
     focusAll?: boolean;

package/dist/src/interfaces/Overlay/overlay.interface.d.ts

@@ -1,4 +1,5 @@
 import type { IActivatorProps } from '../Commons/activator.interface';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { IClickOutsideEmits } from '../Commons/clickOutside.interface';
 import type { ICommonsComponentEmits, ICommonsComponentProps } from '../Commons/commons.interface';
 import type { IDimensionProps } from '../Commons/dimension.interface';
@@ -7,9 +8,8 @@ import type { ILocationStrategyProps } from '../Commons/location.interface';
 import type { IScrimProps } from './overlay-scrim.interface';
 import type { IScrollStrategyProps } from '../Commons/scroll.interface';
 import type { ITransitionComponentProps } from '../Commons/transition-component.interface';
-export interface IOverlayProps extends ICommonsComponentProps, IDimensionProps, IActivatorProps, ILocationStrategyProps, IScrollStrategyProps, ILazyProps, ITransitionComponentProps, IScrimProps {
+export interface IOverlayProps extends ICommonsComponentProps, IDimensionProps, IActivatorProps, ILocationStrategyProps, IScrollStrategyProps, ILazyProps, ITransitionComponentProps, IScrimProps, IAttachProps {
     absolute?: boolean;
-    attach?: boolean | string | Element;
     closeOnBack?: boolean;
     contentClass?: string | Array<string>;
     contentProps?: any;

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

@@ -1,4 +1,5 @@
 import type { Ref } from 'vue';
+import type { IAttachProps } from '../Commons/attach.interface';
 import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
 import type { ISnackbarGroupItem, ISnackbarGroupItemOptions } from './snackbar-group-item.interface';
 import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../types/Snackbar/snackbar-group.type';
@@ -12,7 +13,7 @@ import type { TSnackbarGroupDirection, TSnackbarGroupLocation } from '../../type
  * The component subscribes to its registered stack `id` and re-renders
  * when the underlying `items` ref changes.
  */
-export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps {
+export interface ISnackbarGroupProps extends ICommonsComponentProps, ITagProps, IAttachProps {
     /**
      * Identifier of the stack this container renders. Pair with
      * `useSnackbarGroup({ id })` to spawn items into the same stack.

package/dist/src/interfaces/index.cjs

@@ -520,6 +520,17 @@ Object.keys(_align).forEach(function (key) {
     }
   });
 });
+var _attach = require("./Commons/attach.interface.cjs");
+Object.keys(_attach).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _attach[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _attach[key];
+    }
+  });
+});
 var _audio = require("./Commons/audio.interface.cjs");
 Object.keys(_audio).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

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

@@ -45,6 +45,7 @@ export * from './Commons/activator.interface';
 export * from './Commons/active.interface';
 export * from './Commons/adjacent.interface';
 export * from './Commons/align.interface';
+export * from './Commons/attach.interface';
 export * from './Commons/audio.interface';
 export * from './Commons/autocomplete.interface';
 export * from './Commons/backdrop.interface';

package/dist/src/interfaces/index.js

@@ -45,6 +45,7 @@ export * from "./Commons/activator.interface.js";
 export * from "./Commons/active.interface.js";
 export * from "./Commons/adjacent.interface.js";
 export * from "./Commons/align.interface.js";
+export * from "./Commons/attach.interface.js";
 export * from "./Commons/audio.interface.js";
 export * from "./Commons/autocomplete.interface.js";
 export * from "./Commons/backdrop.interface.js";

package/dist/src/origam.cjs

@@ -61,6 +61,7 @@ function createOrigam(origam = {}) {
       const appScope = (0, _vue.effectScope)();
       app.onUnmount(() => appScope.stop());
       app.provide(_consts.ORIGAM_ICONS_KEY, icons);
+      app.provide(_consts.ORIGAM_CODE_KEY, options.code ?? {});
       app.provide(_consts.ORIGAM_DISPLAY_KEY, display);
       app.provide(_consts.ORIGAM_LOCALE_KEY, locale);
       app.provide(_consts.ORIGAM_DATE_OPTIONS_KEY, date.options);

package/dist/src/origam.js

@@ -12,6 +12,7 @@ import {
 } from "./composables/index.js";
 import {
   IN_BROWSER,
+  ORIGAM_CODE_KEY,
   ORIGAM_DATE_ADAPTER_KEY,
   ORIGAM_DATE_OPTIONS_KEY,
   ORIGAM_DEFAULTS_KEY,
@@ -79,6 +80,7 @@ export function createOrigam(origam = {}) {
       const appScope = effectScope();
       app.onUnmount(() => appScope.stop());
       app.provide(ORIGAM_ICONS_KEY, icons);
+      app.provide(ORIGAM_CODE_KEY, options.code ?? {});
       app.provide(ORIGAM_DISPLAY_KEY, display);
       app.provide(ORIGAM_LOCALE_KEY, locale);
       app.provide(ORIGAM_DATE_OPTIONS_KEY, date.options);

package/dist/src/themes/origam.theme.cjs

@@ -525,7 +525,16 @@ const origamDarkTheme = exports.origamDarkTheme = {
       text: {
         primary: "#fafafa",
         secondary: "#a3a3a3",
-        tertiary: "#737373",
+        /*********************************************************
+         * #1044 — tertiary corrigé
+         *
+         * @description
+         * Était '#737373' (neutral-500), copié du mode clair sans
+         * réadapter : 4.18:1 sur ce fond, sous AA (4.5:1). Aligné sur
+         * dark.css (neutral-400, 7.85:1) — voir sa note pour la
+         * mesure complète et pourquoi ce rung s'aplatit sur secondary.
+         ********************************************************/
+        tertiary: "#a3a3a3",
         disabled: "#525252",
         inverse: "#0a0a0a",
         onColor: "#ffffff",

package/dist/src/themes/origam.theme.js

@@ -253,7 +253,16 @@ export const origamDarkTheme = {
       text: {
         primary: "#fafafa",
         secondary: "#a3a3a3",
-        tertiary: "#737373",
+        /*********************************************************
+         * #1044 — tertiary corrigé
+         *
+         * @description
+         * Était '#737373' (neutral-500), copié du mode clair sans
+         * réadapter : 4.18:1 sur ce fond, sous AA (4.5:1). Aligné sur
+         * dark.css (neutral-400, 7.85:1) — voir sa note pour la
+         * mesure complète et pourquoi ce rung s'aplatit sur secondary.
+         ********************************************************/
+        tertiary: "#a3a3a3",
         disabled: "#525252",
         inverse: "#0a0a0a",
         onColor: "#ffffff",

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

@@ -22,3 +22,32 @@ export type TShikiHighlighter = {
         defaultColor?: false | string;
     }) => string;
 };
+/*********************************************************
+ * TShikiModule / TShikiHighlighterLoader
+ *
+ * @description
+ * `TShikiModule` is the slice of a shiki-COMPATIBLE MODULE that `useCode()`
+ * needs to build a highlighter — i.e. what `import('shiki')` (the DS's own
+ * default) or an app-supplied alternative must resolve to. Deliberately
+ * minimal, for the same reason `TShikiHighlighter` is: an app that wants to
+ * avoid shiki's WASM-loader chunk (see `code.composable.ts`'s
+ * `loadHighlighter()`) can hand `createOrigam({ code: { highlighter } })`
+ * a loader resolving to `shiki/core` + a regex engine — or any other
+ * module — as long as it exposes this one method. `shiki`'s own
+ * `createHighlighter` satisfies this type structurally; no cast needed on
+ * the consumer side.
+ *
+ * @description
+ * `TShikiHighlighterLoader` is the function shape an app passes as
+ * `createOrigam({ code: { highlighter } })` to supply that module instead
+ * of the DS's default `import('shiki')`. See `code.composable.ts`'s
+ * `loadHighlighter()` for how this branches the dynamic-import path, and
+ * `ICodeOptions` for the option itself.
+ ********************************************************/
+export type TShikiModule = {
+    createHighlighter: (opts: {
+        themes: ReadonlyArray<string>;
+        langs: ReadonlyArray<string>;
+    }) => Promise<TShikiHighlighter>;
+};
+export type TShikiHighlighterLoader = () => Promise<TShikiModule>;