origam 0.3.10 → 2.3.0

package/dist/src/interfaces/Bracket/bracket-competitor-component.interface.d.ts

@@ -0,0 +1,53 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TIntent } from '../../types';
+import type { IBracketCompetitor } from './bracket-competitor.interface';
+/**
+ * Props for `<OrigamBracketCompetitor>` — a single competitor row.
+ * Exported so consumers can render a competitor row standalone (e.g.
+ * inside a custom match slot).
+ */
+export interface IBracketCompetitorProps extends ICommonsComponentProps, ITagProps {
+    /**
+     * The competitor payload. `null` renders a "TBD" placeholder — used
+     * when the match's participant is not yet determined (winner of an
+     * earlier round, byes, …).
+     */
+    competitor: IBracketCompetitor | null;
+    /** Optional score — accepts string for non-numeric markers. */
+    score?: number | string;
+    /**
+     * Whether to apply the `--winner` modifier class (bolder text,
+     * intent-tinted background).
+     *
+     * @default false
+     */
+    isWinner?: boolean;
+    /**
+     * Mirror the player-is-loser state. Used to lighten the row when
+     * the match is completed and the consumer wants to de-emphasize
+     * the losing side.
+     *
+     * @default false
+     */
+    isLoser?: boolean;
+    /**
+     * Toggle the score column.
+     *
+     * @default true
+     */
+    showScore?: boolean;
+    /**
+     * Toggle the seed prefix.
+     *
+     * @default false
+     */
+    showSeed?: boolean;
+    /**
+     * Whether the row advertises interactivity (hover state, cursor).
+     *
+     * @default true
+     */
+    interactive?: boolean;
+    /** Intent color driving the winner highlight. */
+    color?: TIntent;
+}

package/dist/src/interfaces/Bracket/bracket-competitor.interface.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A single competitor / team in a bracket match.
+ *
+ * Kept intentionally generic — neither e-sport-specific (no `team` /
+ * `player` distinction) nor sport-specific. Consumers can stash any
+ * extra payload under `metadata`.
+ */
+export interface IBracketCompetitor {
+    /** Stable identifier — used to detect the winner via `winnerId`. */
+    id: string | number;
+    /** Display name (team name, player tag, …). */
+    name: string;
+    /**
+     * Optional seed number (`1` = top seed). When `showSeed` is enabled
+     * on `OrigamBracket`, the seed is rendered before the name.
+     */
+    seed?: number;
+    /**
+     * Optional avatar URL (team logo, country flag, player portrait).
+     * Rendered as a small `<img>` left of the name.
+     */
+    avatar?: string;
+    /** Free-form payload — never read by the component. */
+    metadata?: Record<string, unknown>;
+}

package/dist/src/interfaces/Bracket/bracket-match-component.interface.cjs

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

package/dist/src/interfaces/Bracket/bracket-match-component.interface.d.ts

@@ -0,0 +1,45 @@
+import type { ICommonsComponentProps, ITagProps } from '../../interfaces';
+import type { TBracketMatchStatus, TIntent } from '../../types';
+import type { IBracketMatch } from './bracket-match.interface';
+/**
+ * Props for `<OrigamBracketMatch>` — a single match card rendered
+ * inside `<OrigamBracket>`. Exported so consumers can render a match
+ * card outside the full bracket (e.g. on a match-details page).
+ */
+export interface IBracketMatchProps extends ICommonsComponentProps, ITagProps {
+    /** The match payload to render. */
+    match: IBracketMatch;
+    /**
+     * Override of the per-match status — useful when the caller wants
+     * to force a status (e.g. preview a "live" badge from a story).
+     */
+    status?: TBracketMatchStatus;
+    /**
+     * Hoists the match into the "final" visual treatment — bigger
+     * card, shadow, and rounded corners.
+     *
+     * @default false
+     */
+    isFinal?: boolean;
+    /**
+     * Hides the score column when `false`.
+     *
+     * @default true
+     */
+    showScores?: boolean;
+    /**
+     * Shows the seed prefix on competitor names.
+     *
+     * @default false
+     */
+    showSeed?: boolean;
+    /**
+     * Whether the card advertises interactivity (hover state, cursor,
+     * keyboard focus, `role="button"`).
+     *
+     * @default true
+     */
+    interactive?: boolean;
+    /** Intent color for the winner highlight. */
+    color?: TIntent;
+}

package/dist/src/interfaces/Bracket/bracket-match.interface.cjs

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

package/dist/src/interfaces/Bracket/bracket-match.interface.d.ts

@@ -0,0 +1,51 @@
+import type { TBracketMatchStatus } from '../../types';
+import type { IBracketCompetitor } from './bracket-competitor.interface';
+/**
+ * A single match between two competitors.
+ *
+ * `competitorA` / `competitorB` are nullable so the bracket can render
+ * "TBD" placeholders for matches whose participants are not yet
+ * determined (e.g. winner of an earlier round).
+ *
+ * `scoreA` / `scoreB` accept `string` to allow non-numeric markers
+ * (`'—'`, `'DSQ'`, `'W/O'`, …) without forcing the consumer to coerce.
+ *
+ * `nextMatchId` lets `OrigamBracket` draw a connector from this match
+ * to the next round automatically. If `undefined`, the layout falls
+ * back to positional mapping (match `i` of round `n` connects to match
+ * `floor(i / 2)` of round `n + 1`).
+ */
+export interface IBracketMatch {
+    /** Stable identifier — required for connector linking. */
+    id: string | number;
+    /** Left-side / top-side competitor. `null` = TBD or bye. */
+    competitorA: IBracketCompetitor | null;
+    /** Right-side / bottom-side competitor. `null` = TBD or bye. */
+    competitorB: IBracketCompetitor | null;
+    /** Score of `competitorA`. Accepts `string` for non-numeric markers. */
+    scoreA?: number | string;
+    /** Score of `competitorB`. Accepts `string` for non-numeric markers. */
+    scoreB?: number | string;
+    /**
+     * Identifier of the declared winner. Falls back to `null` /
+     * `undefined` when the match is not yet completed. Used by the
+     * component to apply the `--winner` modifier class on the
+     * relevant competitor row.
+     */
+    winnerId?: string | number | null;
+    /**
+     * Optional lifecycle marker. Drives the visual `--status-{value}`
+     * modifier on the match card (e.g. live pulse, completed grey out).
+     */
+    status?: TBracketMatchStatus;
+    /**
+     * Optional id of the downstream match this one feeds into. Used
+     * by the connector layout to draw a path. If omitted, positional
+     * mapping is used.
+     */
+    nextMatchId?: string | number;
+    /** ISO date string — informative only, displayed when present. */
+    scheduledAt?: string;
+    /** Free-form payload — never read by the component. */
+    metadata?: Record<string, unknown>;
+}

package/dist/src/interfaces/Bracket/bracket-round-component.interface.cjs

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

package/dist/src/interfaces/Bracket/bracket-round-component.interface.d.ts

@@ -0,0 +1,26 @@
+import type { ICommonsComponentProps, IDirectionProps, ITagProps } from '../../interfaces';
+import type { TIntent } from '../../types';
+import type { IBracketRound } from './bracket-round.interface';
+/**
+ * Props for `<OrigamBracketRound>` — a single round (column in
+ * horizontal mode, row in vertical mode). Exported so consumers can
+ * render a round standalone (e.g. inside a custom layout).
+ */
+export interface IBracketRoundProps extends ICommonsComponentProps, ITagProps, IDirectionProps {
+    /** The round payload to render. */
+    round: IBracketRound;
+    /** Index of the round inside its bracket — drives the vertical offset. */
+    index: number;
+    /** Total number of rounds — used to flag the last round as final. */
+    totalRounds: number;
+    /** Toggle the round title heading. */
+    showRoundTitle?: boolean;
+    /** Forward to children — toggles score column. */
+    showScores?: boolean;
+    /** Forward to children — toggles seed prefix. */
+    showSeed?: boolean;
+    /** Forward to children — toggles match-card interactivity. */
+    interactive?: boolean;
+    /** Forward intent color. */
+    color?: TIntent;
+}

package/dist/src/interfaces/Bracket/bracket-round.interface.cjs

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

package/dist/src/interfaces/Bracket/bracket-round.interface.d.ts

@@ -0,0 +1,27 @@
+import type { TBracketRoundSide } from '../../types';
+import type { IBracketMatch } from './bracket-match.interface';
+/**
+ * A round (column in horizontal mode, row in vertical mode) of the
+ * tournament tree.
+ *
+ * Title is required — `OrigamBracket` renders it above (or beside) the
+ * matches list when `showRoundTitles` is enabled. Consumers should
+ * pre-translate the label (the component does not call `useT`).
+ *
+ * `side` is only meaningful for double-elimination — single-elim
+ * tournaments leave it `undefined`.
+ */
+export interface IBracketRound {
+    /** Stable identifier — used as key and in slot scopes. */
+    id: string | number;
+    /** Pre-translated label ("Quarter-finals", "Semi-finals", "Final"). */
+    title: string;
+    /** Ordered list of matches that belong to this round. */
+    matches: IBracketMatch[];
+    /**
+     * Optional bracket-side marker for double-elimination layouts.
+     * Drives grouping into Winner Bracket / Loser Bracket / Grand
+     * Final sections.
+     */
+    side?: TBracketRoundSide;
+}

package/dist/src/interfaces/Bracket/bracket.interface.cjs

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

package/dist/src/interfaces/Bracket/bracket.interface.d.ts

@@ -0,0 +1,71 @@
+import type { ICommonsComponentProps, IDensityProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { TBracketVariant, TIntent } from '../../types';
+import type { IBracketRound } from './bracket-round.interface';
+/**
+ * Props for `<OrigamBracket>` — a tournament tree renderer supporting
+ * single-elimination, double-elimination and round-robin layouts.
+ *
+ * The component is purely presentational: it accepts an immutable
+ * `rounds` payload and emits user-interaction events (`match-click`,
+ * `winner-click`, `competitor-click`) so the consumer can update the
+ * data and re-render. No internal state is held about scores or
+ * winners — the data passed in is the source of truth.
+ */
+export interface IBracketProps extends ICommonsComponentProps, ITagProps, IDensityProps, IRoundedProps {
+    /**
+     * Required. Pre-ordered list of rounds. For single-elimination,
+     * the rounds are laid out from earliest (e.g. round-of-16) to
+     * final. For double-elimination, segregate by `IBracketRound.side`
+     * (`'winner'`, `'loser'`, `'grand-final'`).
+     */
+    rounds: IBracketRound[];
+    /**
+     * Tournament shape. Single-elimination is the default.
+     * Round-robin renders a NxN matrix instead of a tree.
+     *
+     * @default 'single-elimination'
+     */
+    variant?: TBracketVariant;
+    /**
+     * Layout axis. Horizontal stacks rounds as columns (the classic
+     * tournament tree look). Vertical stacks rounds as rows — useful
+     * for narrow viewports. Ignored when `variant === 'round-robin'`
+     * (the matrix layout has its own grid axis).
+     *
+     * @default 'horizontal'
+     */
+    direction?: 'horizontal' | 'vertical';
+    /**
+     * Toggle round headers (`<h3>Quarter-finals</h3>`).
+     *
+     * @default true
+     */
+    showRoundTitles?: boolean;
+    /**
+     * Toggle the score column on each competitor row.
+     *
+     * @default true
+     */
+    showScores?: boolean;
+    /**
+     * Toggle the seed prefix on competitor names (e.g. `1. Team Liquid`).
+     *
+     * @default false
+     */
+    showSeed?: boolean;
+    /**
+     * Semantic intent driving the winner highlight color, the connector
+     * "winner" stroke, and any focus rings.
+     *
+     * @default 'primary'
+     */
+    color?: TIntent;
+    /**
+     * Whether match cards should be interactive (cursor, hover state,
+     * keyboard focus). When `false`, click handlers still fire but the
+     * cards do not advertise affordance.
+     *
+     * @default true
+     */
+    interactive?: boolean;
+}

package/dist/src/interfaces/Breadcrumb/breadcrumb-item.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IActiveProps, IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IBreadcrumbItemProps extends ICommonsComponentProps, ITagProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, ILinkProps, IColorProps, IDensityProps, IAdjacentProps, IHoverProps, IActiveProps {
+import type { IActiveProps, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+export interface IBreadcrumbItemProps extends ICommonsComponentProps, ITagProps, IBorderProps, IPaddingProps, IMarginProps, IRoundedProps, ILinkProps, IColorProps, IBgColorProps, IDensityProps, IAdjacentProps, IHoverProps, IActiveProps {
     title: string;
     disabled?: boolean;
 }

package/dist/src/interfaces/Breadcrumb/breadcrumb.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TBreadcrumbItem, TIcon } from '../../types';
-export interface IBreadcrumbProps extends IColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps {
+export interface IBreadcrumbProps extends IColorProps, IBgColorProps, ITagProps, ICommonsComponentProps, IDensityProps, IRoundedProps, IPaddingProps, IMarginProps, IBorderProps, IElevationProps {
     activeClass?: string;
     disabled?: boolean;
     divider?: string | TIcon;

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

@@ -1,5 +1,5 @@
-import type { IBorderProps, IBtnProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
-export interface IBtnGroupProps extends ITagProps, ICommonsComponentProps, IRoundedProps, IBorderProps, IDensityProps, IElevationProps, IColorProps, IMarginProps, IPaddingProps {
+import type { IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../../interfaces';
+export interface IBtnGroupProps extends ITagProps, ICommonsComponentProps, IRoundedProps, IBorderProps, IDensityProps, IElevationProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps {
     divided?: boolean;
     items?: Array<IBtnProps>;
 }

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

@@ -1,7 +1,8 @@
-import type { IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupItemProps, IHoverProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ISizeProps, IStatusProps, ITagProps } from '../../interfaces';
+import type { IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupItemProps, IHoverProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ISizeProps, IStatusProps, ITagProps, IVariantProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IStatusProps, IHoverProps {
+export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColorProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, IRoundedProps, ITagProps, ISizeProps, ILinkProps, IRippleProps, ILoaderProps, IPositionProps, ILocationProps, IGroupItemProps, IPaddingProps, IMarginProps, IAdjacentProps, IStatusProps, IHoverProps, IVariantProps {
     active?: boolean;
+    /** @deprecated Use `variant="flat"` instead. Kept for backward compat. */
     flat?: boolean;
     icon?: boolean | TIcon;
     block?: boolean;

package/dist/src/interfaces/Card/card.interface.d.ts

@@ -1,6 +1,6 @@
-import type { IAdjacentProps, IBorderProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
 import type { TCardType } from '../../types';
-export interface ICardProps extends ICommonsComponentProps, ITagProps, IBorderProps, IDensityProps, IDimensionProps, IElevationProps, ILoaderProps, ILocationProps, IPositionProps, IRoundedProps, IMarginProps, IPaddingProps, ILinkProps, IRippleProps, IAdjacentProps {
+export interface ICardProps extends ICommonsComponentProps, ITagProps, IBorderProps, IColorProps, IBgColorProps, IDensityProps, IDimensionProps, IElevationProps, ILoaderProps, ILocationProps, IPositionProps, IRoundedProps, IMarginProps, IPaddingProps, ILinkProps, IRippleProps, IAdjacentProps, IActiveProps {
     disabled?: boolean;
     flat?: boolean;
     hover?: boolean;

package/dist/src/interfaces/Checkbox/checkbox-btn.interface.d.ts

@@ -1,6 +1,19 @@
-import type { ICommonsComponentProps, ISelectionControlProps } from '../../interfaces';
-import type { TIcon } from '../../types';
+import type { ICommonsComponentEmits, ICommonsComponentProps, ICommonsComponentSlots, IFocusEmits, ISelectionControlEmits, ISelectionControlProps } from '../../interfaces';
+import type { TColor, TIcon } from '../../types';
 export interface ICheckboxBtnProps extends ICommonsComponentProps, ISelectionControlProps {
     indeterminate?: boolean;
     indeterminateIcon?: TIcon;
 }
+export interface ICheckboxBtnEmits extends ICommonsComponentEmits, IFocusEmits, ISelectionControlEmits {
+    (e: 'update:indeterminate', event: any): void;
+}
+export interface ICheckboxBtnSlots extends ICommonsComponentSlots {
+    label?: () => any;
+    input?: (data: {
+        props: any;
+        icon: TIcon;
+        textColorStyles: TColor;
+        backgroundColorStyles: TColor;
+        model: any;
+    }) => any;
+}

package/dist/src/interfaces/Checkbox/checkbox.interface.d.ts

@@ -1,3 +1,23 @@
-import type { IBorderProps, ICheckboxBtnProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IInputProps, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-export interface ICheckboxProps extends ICommonsComponentProps, IInputProps, ICheckboxBtnProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBorderProps, IElevationProps {
+import type { IActiveProps, IBorderProps, ICheckboxBtnProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDensityProps, IElevationProps, IFocusEmits, IHoverProps, IInputProps, IMarginProps, IPaddingProps, IRoundedProps, ISelectionControlEmits } from '../../interfaces';
+import type { TColor, TIcon } from '../../types';
+export interface ICheckboxProps extends ICommonsComponentProps, IInputProps, ICheckboxBtnProps, IDensityProps, IPaddingProps, IMarginProps, IRoundedProps, IColorProps, IBorderProps, IElevationProps, IActiveProps, IHoverProps {
+}
+export interface ICheckboxEmits extends ICommonsComponentEmits, IFocusEmits, ISelectionControlEmits {
+}
+export interface ICheckboxSlots {
+    default?: (data: {
+        id: string;
+        messagesId: string;
+        isDisabled: boolean;
+        isReadonly: boolean;
+        isValid: boolean;
+    }) => any;
+    label?: () => any;
+    input?: (data: {
+        props: any;
+        icon: TIcon;
+        textColorStyles: TColor;
+        backgroundColorStyles: TColor;
+        model: any;
+    }) => any;
 }

package/dist/src/interfaces/Chip/chip-group.interface.d.ts

@@ -1,5 +1,5 @@
-import type { IBorderProps, IColorProps, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps } from '../../interfaces';
-export interface IChipGroupProps extends ICommonsComponentProps, ITagProps, IGroupProps, IColorProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, ISlideGroupProps {
+import type { IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IGroupProps, IMarginProps, IPaddingProps, IRoundedProps, ISlideGroupProps, ITagProps } from '../../interfaces';
+export interface IChipGroupProps extends ICommonsComponentProps, ITagProps, IGroupProps, IColorProps, IBgColorProps, IMarginProps, IPaddingProps, IBorderProps, IRoundedProps, ISlideGroupProps {
     column?: boolean;
     filter?: boolean;
     valueComparator?: (a: any, b: any) => boolean;

package/dist/src/interfaces/Chip/chip.interface.d.ts

@@ -1,7 +1,6 @@
-import type { IAdjacentProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupItemProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
+import type { IActiveProps, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IGroupItemProps, IHoverProps, ILinkProps, IMarginProps, IPaddingProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps } from '../../interfaces';
 import type { TIcon } from '../../types';
-export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITagProps, IColorProps, IRippleProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IGroupItemProps, ILinkProps, ISizeProps, IElevationProps {
-    activeClass?: string;
+export interface IChipProps extends ICommonsComponentProps, IAdjacentProps, ITagProps, IColorProps, IBgColorProps, IRippleProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IGroupItemProps, ILinkProps, ISizeProps, IElevationProps, IActiveProps, IHoverProps {
     closable?: boolean;
     closeIcon?: TIcon;
     closeLabel?: string;

package/dist/src/interfaces/Code/code.interface.cjs

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

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

@@ -0,0 +1,99 @@
+import type { IBorderProps, ICommonsComponentProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps } from '../index';
+import type { TCodeLang, TCodeTheme } from '../../types';
+/**
+ * Props for `<OrigamCode>` — a shiki-powered code block with line numbers,
+ * line highlighting, copy button and theme awareness.
+ *
+ * Backward-compat note: the v2.x `<OrigamCode>` was a thin `<pre>` wrapper
+ * with a `code` prop only. Every new prop below is optional with a
+ * conservative default so existing call sites keep their behaviour
+ * (plain-text, no line numbers, copy button visible).
+ */
+export interface ICodeProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IElevationProps, IPaddingProps, IMarginProps {
+    /**
+     * The code to highlight. When omitted, the default slot is used as the
+     * source — useful for multi-line snippets that are nicer to read in
+     * the template than as a JS string literal. When both are provided,
+     * the prop wins.
+     */
+    code?: string;
+    /**
+     * Language grammar to apply. One of the values in `SUPPORTED_LANGS`.
+     * Unknown values fall back to `plaintext` (with a one-shot console
+     * warning).
+     */
+    lang?: TCodeLang;
+    /**
+     * Show a left gutter with line numbers. Pure CSS — uses a CSS counter
+     * incremented per `.origam-code__row`, no JS layout work.
+     */
+    lineNumbers?: boolean;
+    /**
+     * Lines to highlight. Accepts either a pre-computed array of 1-based
+     * line numbers (`[2, 5, 6, 7]`) or a comma/range string (`'2,5-7'`)
+     * that the component parses via `parseHighlightLines()`. `null` /
+     * empty disables the feature.
+     */
+    highlightLines?: number[] | string | null;
+    /**
+     * Show the copy-to-clipboard button in the top-right corner. Defaults
+     * to `true` — most code blocks benefit from it.
+     */
+    copyable?: boolean;
+    /**
+     * Cap the rendered block at this height and enable vertical scroll
+     * past it. `null` (default) lets the block grow to fit its content.
+     */
+    maxHeight?: number | string | null;
+    /**
+     * Theme override. `'auto'` (default) follows the document theme,
+     * `'light'` / `'dark'` force a specific shiki theme.
+     */
+    theme?: TCodeTheme;
+    /**
+     * Auto-format the code before highlighting. Reserved for v3 — prettier
+     * is intentionally NOT bundled at runtime to keep the tarball small.
+     * Currently a no-op; passing `true` warns once in dev and pre-formats
+     * via a best-effort whitespace trim only.
+     */
+    format?: boolean;
+    /**
+     * Wrap long lines instead of scrolling horizontally. Off by default so
+     * the visual column matches the source file.
+     */
+    wrap?: boolean;
+    /**
+     * Optional filename rendered in the header bar (e.g. `'App.vue'`).
+     * When provided AND `copyable` is true, the header also hosts the copy
+     * button; otherwise the copy button is absolutely positioned in the
+     * top-right corner of the code surface.
+     */
+    filename?: string;
+}
+/**
+ * Public surface of the `useCode` composable. Lazily instantiates a shiki
+ * highlighter on first call and reuses it across every `OrigamCode`
+ * instance for the lifetime of the page.
+ */
+export interface IUseCodeReturn {
+    /**
+     * Render `code` to a pre-tokenised HTML string. Resolves once the
+     * underlying shiki highlighter has loaded the requested language /
+     * theme (lazy; ~200 ms cold, instant on subsequent calls).
+     */
+    highlight(code: string, lang: TCodeLang, themeName: 'light' | 'dark'): Promise<string>;
+    /**
+     * Force the highlighter to load. Useful for stories / tests that want
+     * to warm the cache before mounting consumers.
+     */
+    prime(): Promise<void>;
+    /**
+     * Whether the singleton highlighter is ready. `false` on first paint,
+     * flips to `true` once the dynamic import finishes.
+     */
+    isReady(): boolean;
+    /**
+     * Wipe the LRU cache. Test-only — production code never needs this.
+     */
+    resetCacheForTesting(): void;
+}

package/dist/src/interfaces/CommandPalette/command-palette.interface.cjs

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

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

@@ -0,0 +1,57 @@
+import type { ICommand } from './command.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+/**
+ * A hotkey is either a single combination (`['meta', 'k']`) or an
+ * array of alternatives — every entry being a list of normalised key
+ * tokens compatible with `useHotkey` (e.g. `[['meta', 'k'], ['ctrl', 'k']]`).
+ *
+ * The component normalises a single-combination input (`['meta', 'k']`)
+ * to the multi-combination shape (`[['meta', 'k']]`) before installing
+ * the listeners so consumers can pass either form interchangeably.
+ */
+export type TCommandPaletteHotkey = ReadonlyArray<string> | ReadonlyArray<ReadonlyArray<string>>;
+export interface ICommandPaletteProps extends ICommonsComponentProps {
+    /** v-model — whether the palette is open. */
+    modelValue?: boolean;
+    /**
+     * Global hotkey(s) that toggle the palette open. Defaults to
+     * `[['meta', 'k'], ['ctrl', 'k']]` (⌘K / Ctrl+K). Pass `null`
+     * to disable the global listener entirely.
+     */
+    hotkey?: TCommandPaletteHotkey | null;
+    /**
+     * Static command list. When omitted, the palette renders commands
+     * registered via the `useCommand()` global registry instead.
+     */
+    commands?: ReadonlyArray<ICommand>;
+    /** Placeholder of the search input (already-translated string). */
+    placeholder?: string;
+    /** Empty-state message when no command matches the query. */
+    emptyText?: string;
+    /** Max height of the result list. Number → px. */
+    maxHeight?: number | string;
+    /** Width of the palette dialog. Number → px. */
+    width?: number | string;
+    /** Display a loader inside the result list (use during async fetches). */
+    loading?: boolean;
+    /** Close the palette automatically when a command is selected. */
+    closeOnSelect?: boolean;
+    /** Close when the user presses Escape. */
+    closeOnEscape?: boolean;
+    /** Close when the user clicks the backdrop. */
+    closeOnBackdrop?: boolean;
+}
+export interface ICommandPaletteEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    (e: 'select', command: ICommand): void;
+    (e: 'query', text: string): void;
+}
+export interface ICommandPaletteSlotProps {
+    command: ICommand;
+    isActive: boolean;
+}
+export interface ICommandPaletteSlots {
+    item?: (props: ICommandPaletteSlotProps) => any;
+    empty?: () => any;
+    footer?: () => any;
+}

package/dist/src/interfaces/CommandPalette/command.interface.cjs

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