origam 2.16.0 → 2.17.1

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

@@ -1,8 +1,22 @@
-import type { IActiveProps, IBorderProps, IBtnProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IElevationProps, IHoverProps, IMarginProps, IPaddingProps, IRoundedProps, ISizeProps, ITagProps, IVariantProps } from '../../interfaces';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBtnProps } from './btn.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+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 {
     divided?: boolean;
     items?: Array<IBtnProps>;
 }
+export interface IBtnGroupEmits {
+}
 /** Slot signatures for `<OrigamBtnGroup>`. */
 export interface IBtnGroupSlots {
     /** Overrides the whole auto-generated `<origam-btn>` list. */

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

@@ -1,4 +1,7 @@
-import type { IBtnGroupProps, IBtnProps, ICommonsComponentEmits, IGroupProps, IGroupProvide } from '../../interfaces';
+import type { IBtnGroupProps } from './btn-group.interface';
+import type { IBtnProps } from './btn.interface';
+import type { ICommonsComponentEmits } from '../Commons/commons.interface';
+import type { IGroupProps, IGroupProvide } from '../Commons/group.interface';
 export interface IBtnToggleProps extends IBtnGroupProps, IGroupProps {
 }
 /** Emits fired by `<OrigamBtnToggle>` — v-model on the active toggle index. */

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

@@ -1,11 +1,31 @@
-import type { IActiveState, IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IGroupEmits, IGroupItemProps, IHoverProps, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ISizeProps, ITagProps, ITypographyProps, IVariantProps } from '../../interfaces';
-import type { TIcon, TStatus, TStatusPosition } from '../../types';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IGroupEmits, IGroupItemProps } from '../Commons/group.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { ILinkProps } from '../Commons/router.interface';
+import type { ILoaderProps } from '../Commons/loader.interface';
+import type { ILocationProps } from '../Commons/location.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IPositionProps } from '../Commons/position.interface';
+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 { 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, IVariantProps, ITypographyProps {
-    active?: boolean | IActiveState;
+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'> {
     /** @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. */
@@ -17,8 +37,28 @@ export interface IBtnProps extends ICommonsComponentProps, IColorProps, IBgColor
     status?: TStatus;
     statusIconPosition?: TStatusPosition;
 }
-/** Emits fired by `<OrigamBtn>` — clicks on prepend/append slots and
- *  group-membership lifecycle. */
+/**
+ * Emit signatures for `<OrigamBtn>`.
+ *
+ * ⛔ DEPRECATED SURFACE (#443) — `click:prepend` / `click:append`, inherited
+ * from {@link IAdjacentEmits}, are **deprecated and will be removed in
+ * v3.0.0**. They still fire for now so no consumer breaks silently, and
+ * `<OrigamBtn>` warns once per emit in dev builds.
+ *
+ * They were never reachable by keyboard: the emit is bound to the
+ * `origam-btn__prepend` / `origam-btn__append` `<span>`, while a keyboard
+ * activation synthesises its click on the component ROOT, which never
+ * reaches a descendant listener. The fix `useAdjacent` applies on the other
+ * ten consumers — promote the zone to a `role="button"` tab stop — is
+ * ILLEGAL here: Btn renders as `<button>` or `<a>`, and both forbid an
+ * interactive-content descendant and any descendant with `tabindex`.
+ *
+ * Two actions are two buttons: compose them with `<origam-btn-group>`. The
+ * `prepend` / `append` SLOTS are unaffected — see {@link IBtnSlots}.
+ *
+ * @deprecated The inherited `click:prepend` / `click:append` only. Drop
+ * `IAdjacentEmits` from this interface in v3.0.0.
+ */
 export interface IBtnEmits extends IAdjacentEmits, IGroupEmits {
 }
 /** Slot signatures for `<OrigamBtn>`. */

package/dist/src/interfaces/Calendar/calendar.interface.d.ts

@@ -1,5 +1,15 @@
-import type { IBgColorProps, IBorderProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IEvent, IMarginProps, IPaddingProps, IRoundedProps } from '../../interfaces';
-import type { TCalendarNavigate, TCalendarTimeFormat, TCalendarView, TIntent } from '../../types';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IEvent } from './event.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TCalendarNavigate, TCalendarTimeFormat, TCalendarView } from '../../types/Calendar/calendar.type';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Props for `<OrigamCalendar>`. Two-way bindings on `view` and
  * `currentDate` so the parent can sync with router state or persist

package/dist/src/interfaces/Calendar/event.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TIntent } from '../../types';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Public event shape consumed by `<OrigamCalendar>` and the
  * `useCalendar` composable. Designed to be friendly to JSON

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

@@ -1,7 +1,27 @@
-import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots, IBorderProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
-export interface ICardHeaderProps extends ITagProps, ICommonsComponentProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IAdjacentProps, ITypographyProps {
+import type { IAdjacentEmits, IAdjacentProps, IAdjacentSlots } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+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';
+export interface ICardHeaderProps extends ITagProps, ICommonsComponentProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, IAdjacentProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'lineHeight' | 'letterSpacing'> {
     subtitle?: string | number;
     title?: string | number;
+    /*********************************************************
+     * titleId
+     *
+     * @description
+     * DOM id posed on the rendered `.origam-card-header__title` element
+     * — distinct from `id` (already claimed by `ICommonsComponentProps`
+     * for the header's OWN root/style id). A consumer that needs an
+     * `aria-labelledby` target pointing at the title (e.g. `<OrigamDialog>`
+     * for its `role="dialog"`) passes this instead of reusing `id`, the
+     * same separation `OrigamRatingField` already applies for its own
+     * `useStyle` id vs. the consumer's `id` prop (#381/#412).
+     ********************************************************/
+    titleId?: string;
 }
 /** Emits fired by `<OrigamCardHeader>` — clicks on prepend/append slots. */
 export interface ICardHeaderEmits extends IAdjacentEmits {

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

@@ -1,8 +1,23 @@
-import type { IBorderProps, ICommonsComponentProps, IDensityProps, IMarginProps, IPaddingProps, IRoundedProps, ITagProps, ITypographyProps } from '../../interfaces';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+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';
 export interface ICardTextSlots {
     /** Overrides the `text` prop. */
     default?: () => any;
 }
-export interface ICardTextProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, ITypographyProps {
+/*********************************************************
+ * ICardTextEmits
+ *
+ * @description
+ * `<OrigamCardText>` only renders the `text` prop / slot content — it
+ * never calls `emit(...)` in its script.
+ ********************************************************/
+export interface ICardTextEmits {
+}
+export interface ICardTextProps extends ICommonsComponentProps, ITagProps, IBorderProps, IRoundedProps, IPaddingProps, IMarginProps, IDensityProps, Pick<ITypographyProps, 'fontSize' | 'fontWeight' | 'letterSpacing'> {
     text?: string | number;
 }

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

@@ -1,5 +1,21 @@
-import type { IActiveEmits, IActiveProps, IAdjacentEmits, IAdjacentProps, IBorderProps, IBgColorProps, IColorProps, ICommonsComponentProps, IDensityProps, IDimensionProps, IElevationProps, IHoverEmits, ILinkProps, ILoaderProps, ILocationProps, IMarginProps, IPaddingProps, IPositionProps, IRippleProps, IRoundedProps, ITagProps } from '../../interfaces';
-import type { TCardType } from '../../types';
+import type { IActiveEmits, IActiveProps } from '../Commons/active.interface';
+import type { IAdjacentEmits, IAdjacentProps } from '../Commons/adjacent.interface';
+import type { IBorderProps } from '../Commons/border.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDensityProps } from '../Commons/density.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+import type { IHoverEmits } from '../Commons/hover.interface';
+import type { ILinkProps } from '../Commons/router.interface';
+import type { ILoaderProps } from '../Commons/loader.interface';
+import type { ILocationProps } from '../Commons/location.interface';
+import type { IMarginProps } from '../Commons/margin.interface';
+import type { IPaddingProps } from '../Commons/padding.interface';
+import type { IPositionProps } from '../Commons/position.interface';
+import type { IRippleProps } from '../Commons/ripple.interface';
+import type { IRoundedProps } from '../Commons/rounded.interface';
+import type { TCardType } from '../../types/Card/card.type';
 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;
@@ -10,6 +26,16 @@ export interface ICardProps extends ICommonsComponentProps, ITagProps, IBorderPr
     text?: string | number;
     title?: string | number;
     type?: TCardType;
+    /*********************************************************
+     * titleId
+     *
+     * @description
+     * Forwarded to the nested `<OrigamCardHeader>` as its own `titleId`
+     * (#412) — lets a consumer (e.g. `<OrigamDialog>`) give the rendered
+     * title element a stable DOM id to target with `aria-labelledby`,
+     * without overloading `id` (already the Card's own root/style id).
+     ********************************************************/
+    titleId?: string;
 }
 /** Emits fired by `<OrigamCard>` — prepend/append clicks + active/hover
  *  state propagation. */

package/dist/src/interfaces/Carousel/carousel-item.interface.d.ts

@@ -1,4 +1,5 @@
-import type { IImgProps, IWindowItemProps } from '../../interfaces';
+import type { IImgProps } from '../Img/img.interface';
+import type { IWindowItemProps } from '../Window/window-item.interface';
 export interface ICarouselItemProps extends IImgProps, IWindowItemProps {
     transition?: boolean | string;
 }
@@ -11,3 +12,12 @@ export interface ICarouselItemSlots {
     error?: () => any;
     placeholder?: () => any;
 }
+/*********************************************************
+ * ICarouselItemEmits
+ *
+ * @description
+ * `<OrigamCarouselItem>` only forwards props/slots to `<OrigamWindowItem>`
+ * and `<OrigamImg>` — it never calls `emit(...)` in its own script.
+ ********************************************************/
+export interface ICarouselItemEmits {
+}

package/dist/src/interfaces/Carousel/carousel.interface.d.ts

@@ -1,5 +1,12 @@
-import type { IActiveProps, IBgColorProps, IColorProps, ICommonsComponentEmits, ICommonsComponentProps, IDimensionProps, IGroupProvide, IHoverProps, ITagProps, IWindowNavBtnProps, IWindowProps } from '../../interfaces';
-import type { TIcon, TInline } from '../../types';
+import type { IActiveProps } from '../Commons/active.interface';
+import type { IBgColorProps, IColorProps } from '../Commons/color.interface';
+import type { ICommonsComponentEmits, ICommonsComponentProps, ITagProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IGroupProvide } from '../Commons/group.interface';
+import type { IHoverProps } from '../Commons/hover.interface';
+import type { IWindowNavBtnProps, IWindowProps } from '../Window/window.interface';
+import type { TIcon } from '../../types/Icon/icon.type';
+import type { TInline } from '../../types/Commons/anchor.type';
 /** One entry of `IGroupProvide['items'].value` — the resolved (unwrapped)
  *  item descriptor iterated by `<OrigamCarousel>`'s delimiter dots. */
 export interface ICarouselDelimiterItem {
@@ -22,7 +29,12 @@ export interface ICarouselEmits extends ICommonsComponentEmits {
 /** Slot signatures for `<OrigamCarousel>` — thin wrapper over
  *  `<OrigamWindow>`'s own slots (`default` / `prev` / `next` /
  *  `arrows` share the exact same scope), plus the delimiter dots
- *  (`item.{index}` / `item`) and the cycle `progress` bar. */
+ *  (`item.{index}` / `item`), the cycle `progress` bar, and
+ *  `play-pause` — the autoplay stop control, rendered only while
+ *  `cycle` is on. Overriding `play-pause` REPLACES the built-in
+ *  button, so the replacement must still offer a way to stop the
+ *  animation or the component falls out of WCAG 2.2.2 conformance;
+ *  `toggle` and `isPaused` are handed over for that purpose. */
 export interface ICarouselSlots {
     default?: (group: IGroupProvide) => any;
     additional?: (group: IGroupProvide) => any;
@@ -38,6 +50,11 @@ export interface ICarouselSlots {
     progress?: (data: {
         percent: number;
     }) => any;
+    'play-pause'?: (data: {
+        isPaused: boolean;
+        toggle: () => void;
+        label: string;
+    }) => any;
     prev?: (data: {
         props: IWindowNavBtnProps;
         canMove: boolean;

package/dist/src/interfaces/Chart/chart-annotation.interface.d.ts

@@ -1,4 +1,4 @@
-import type { TIntent } from '../../types';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * A single overlay annotation drawn on top of a cartesian chart's
  * SVG surface. Annotations are positioned in data coordinates and

package/dist/src/interfaces/Chart/chart-axis.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IChartTick } from '../../interfaces';
+import type { IChartTick } from './chart.interface';
 /**
  * Props for `<OrigamChartAxis>` — the cartesian-only axes + grid +
  * tick labels block. Extracted from the legacy `<OrigamChart>`
@@ -36,14 +36,20 @@ export interface IChartAxisProps {
      */
     secondaryYTicks?: Array<IChartTick>;
     /**
-     * Render the four-corner axis frame + tick labels. When `false`,
-     * the component renders nothing (mirrors the legacy `showAxis`
-     * prop on `<OrigamChart>`).
+     * Render the axis frame (left + bottom lines) + tick labels, and
+     * the secondary right axis when `secondaryYTicks` is supplied.
+     * Mirrors the legacy `showAxis` prop on `<OrigamChart>`.
+     *
+     * ⛔ It does NOT gate the grid: `<g v-if="showGrid">` is a sibling
+     * root with an independent condition, so `showAxis: false` +
+     * `showGrid: true` renders grid lines alone. Pinned by
+     * `TU/components/Chart/chart-axis-grid-independence.spec.ts`.
      */
     showAxis?: boolean;
     /**
      * Render horizontal grid lines under the plot. When `false`,
      * no grid is drawn (mirrors the legacy `showGrid` prop).
+     * Independent of `showAxis` — see above.
      */
     showGrid?: boolean;
     /**
@@ -62,6 +68,24 @@ export interface IChartAxisProps {
      */
     secondaryYAxisFormat?: (value: number) => string;
 }
+/*********************************************************
+ * IChartAxisEmits
+ *
+ * @description
+ * Emits fired by `<OrigamChartAxis>` — none. Pure SVG renderer driven
+ * entirely by its `plot` / `ticks` props.
+ ********************************************************/
+export interface IChartAxisEmits {
+}
+/*********************************************************
+ * IChartAxisSlots
+ *
+ * @description
+ * Slot signatures for `<OrigamChartAxis>` — none. The axis chrome
+ * (grid lines, tick labels) is fully derived from props.
+ ********************************************************/
+export interface IChartAxisSlots {
+}
 /**
  * Configuration object for the secondary (right-hand) Y axis.
  * Passed as the `secondaryYAxis` prop on `<OrigamChartCartesian>`.

package/dist/src/interfaces/Chart/chart-base.interface.d.ts

@@ -1,5 +1,15 @@
-import type { IBgColorProps, IChartPoint, IChartSeries, ICommonsComponentProps, IDimensionProps, IElevationProps, IMarginProps, IPaddingProps, IRoundedProps, ITypographyProps } from '../../interfaces';
-import type { TChartLegendPosition, TIntent } from '../../types';
+import type { IBgColorProps } from '../Commons/color.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { IChartSeries } from './chart-series.interface';
+import type { ICommonsComponentProps } from '../Commons/commons.interface';
+import type { IDimensionProps } from '../Commons/dimension.interface';
+import type { IElevationProps } from '../Commons/elevation.interface';
+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 { TChartLegendPosition } from '../../types/Chart/chart-legend.type';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Props shared across every chart type. Per-type components
  * (`OrigamChartBar`, `OrigamChartLine`, `OrigamChartPie`, …) extend
@@ -24,11 +34,32 @@ export interface IChartBaseProps extends ICommonsComponentProps, IDimensionProps
     title?: string;
     /** Optional subtitle rendered below the title. */
     subtitle?: string;
-    /** Toggle the legend block. Default `true`. */
+    /**
+     * Toggle the legend block. Default `true`.
+     *
+     * ⛔ #545 — has **no effect** on `OrigamChartGauge`: a gauge is a
+     * single-value visualisation (only `series[0].data[0]` is read, extra
+     * series are ignored) with no legend markup in its template at all.
+     * Passing it warns once in dev builds (see `useUnsupportedProp`)
+     * instead of silently doing nothing — same treatment as `colorScheme`
+     * on Bullet/Candlestick/Heatmap/Map (#426).
+     */
     showLegend?: boolean;
-    /** Anchor of the legend block. Default `'bottom'`. */
+    /**
+     * Anchor of the legend block. Default `'bottom'`.
+     *
+     * ⛔ #545 — has **no effect** on `OrigamChartGauge`, for the same
+     * reason as `showLegend` just above: no legend exists to anchor.
+     */
     legendPosition?: TChartLegendPosition;
-    /** Toggle the hover tooltip. Default `true`. */
+    /**
+     * Toggle the hover tooltip. Default `true`.
+     *
+     * ⛔ #545 — has **no effect** on `OrigamChartGauge`: no tooltip markup
+     * exists in its template, and `IChartGaugeSlots` deliberately `Omit`s
+     * the `tooltip` slot the base family would otherwise expose. Passing
+     * it warns once in dev builds — same treatment as `colorScheme` (#426).
+     */
     showTooltip?: boolean;
     /**
      * Animate paths / bars / slices on first paint and on data
@@ -41,6 +72,14 @@ export interface IChartBaseProps extends ICommonsComponentProps, IDimensionProps
      * Palette used when a series does not pin its own `color`.
      * Pass intent strings (cycled in order) or raw CSS colours.
      * Default cycles through the 8 origam intents.
+     *
+     * ⛔ #426 — has **no effect** on `OrigamChartBullet`,
+     * `OrigamChartCandlestick`, `OrigamChartHeatmap`, `OrigamChartMap`:
+     * each has its own colour model (uniform fill + range palette,
+     * binary bullish/bearish, or continuous gradient) with no
+     * per-series identity axis for a rotating palette to drive.
+     * Passing it on those four warns once in dev builds (see
+     * `useUnsupportedProp`) instead of silently doing nothing.
      */
     colorScheme?: Array<TIntent | string>;
     /**

package/dist/src/interfaces/Chart/chart-box-plot.interface.d.ts

@@ -1,5 +1,7 @@
-import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint, IChartSeries } from '../../interfaces';
-import type { TIntent } from '../../types';
+import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { IChartSeries } from './chart-series.interface';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Five-number summary + outlier list produced by `computeQuartiles`.
  * Exported so consumers can type the return value without importing

package/dist/src/interfaces/Chart/chart-bullet.interface.d.ts

@@ -1,5 +1,8 @@
-import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint, IChartSeries } from '../../interfaces';
-import type { TDirection, TIntent } from '../../types';
+import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { IChartSeries } from './chart-series.interface';
+import type { TDirection } from '../../types/Commons/direction.type';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * One qualitative range band in a bullet chart.
  * Bands are rendered left-to-right (horizontal) or bottom-to-top

package/dist/src/interfaces/Chart/chart-candlestick.interface.d.ts

@@ -1,5 +1,6 @@
-import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint } from '../../interfaces';
-import type { TIntent } from '../../types';
+import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * One OHLC data point in a candlestick series.
  *

package/dist/src/interfaces/Chart/chart-cartesian.interface.d.ts

@@ -1,5 +1,13 @@
-import type { IChartAnnotation, IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartDrilldownLink, IChartDrilldownProps, IChartPlotBand, IChartPlotLine, IChartPoint, IChartRangeSelector, IChartSecondaryYAxis } from '../../interfaces';
-import type { TChartCartesianKind, TChartSmoothing, TChartStacking } from '../../types';
+import type { IChartAnnotation } from './chart-annotation.interface';
+import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
+import type { IChartDrilldownLink, IChartDrilldownProps } from './chart-drilldown.interface';
+import type { IChartPlotBand } from './chart-plot-band.interface';
+import type { IChartPlotLine } from './chart-plot-line.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { IChartRangeSelector } from './chart-range-selector.interface';
+import type { IChartSecondaryYAxis } from './chart-axis.interface';
+import type { TChartCartesianKind } from '../../types/Chart/chart-cartesian.type';
+import type { TChartSmoothing, TChartStacking } from '../../types/Chart/chart.type';
 /**
  * Props for `<OrigamChartCartesian>` — the cartesian family
  * component. Owns the X+Y plotting area (axes, grid, tick labels)
@@ -86,6 +94,21 @@ export interface IChartCartesianProps extends IChartBaseProps {
      * Default `false`.
      */
     zoomable?: boolean;
+    /*********************************************************
+     * zoomResetLabel
+     *
+     * @description
+     * Accessible name for the "Reset zoom" control (aria-label) shown
+     * when `zoomable` is active and the plot is currently zoomed.
+     * Carries a locale key, not final text — it is resolved through the
+     * DS `t()` mechanism. Defaults to `'origam.chart.zoom.reset_aria_label'`
+     * (#477).
+     * @description
+     * A raw string that matches no key is returned unchanged, so
+     * `zoomResetLabel="Reset the view"` still works for consumers who
+     * prefer to translate on their side.
+     ********************************************************/
+    zoomResetLabel?: string;
     /**
      * Optional band-style range-selector toolbar rendered above the chart.
      * Provides preset zoom buttons (`1w`, `1m`, `3m`, `6m`, `1y`, `all`).

package/dist/src/interfaces/Chart/chart-drilldown.interface.d.ts

@@ -44,6 +44,21 @@ export interface IChartDrilldownProps {
      * segment. Default `'← Back'`.
      */
     backLabel?: string;
+    /*********************************************************
+     * navAriaLabel
+     *
+     * @description
+     * Accessible name for the breadcrumb `<nav>` landmark (aria-label).
+     * Carries a locale key, not final text — it is resolved through the
+     * DS `t()` mechanism, so it follows the active locale out of the box.
+     * Defaults to `'origam.chart.drilldown.aria_label'`, shared by both
+     * `OrigamChartCartesian` and `OrigamChartPolar` (#477).
+     * @description
+     * A raw string that matches no key is returned unchanged, so
+     * `navAriaLabel="Category drilldown"` still works for consumers who
+     * prefer to translate on their side.
+     ********************************************************/
+    navAriaLabel?: string;
 }
 /**
  * One frame in the navigation stack maintained internally by the chart.

package/dist/src/interfaces/Chart/chart-gauge.interface.d.ts

@@ -1,4 +1,4 @@
-import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from '../../interfaces';
+import type { IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
 /**
  * Props for `<OrigamChartGauge>` — solid gauge (radial progress
  * indicator). Mirrors Highcharts' "Solid Gauge" demo: a 270-degree
@@ -45,8 +45,25 @@ export interface IChartGaugeProps extends IChartBaseProps {
      */
     gaugeShowValue?: boolean;
 }
-/** Emits surfaced by `<OrigamChartGauge>`. Mirrors the base family. */
-export type IChartGaugeEmits = IChartBaseEmits;
+/**
+ * `<OrigamChartGauge>` emits — deliberately EMPTY, not an alias of
+ * `IChartBaseEmits`.
+ *
+ * ⛔ Was `export type IChartGaugeEmits = IChartBaseEmits` until #545 —
+ * an alias `buildInterfaceIndex()` never resolved (it only matched `export
+ * interface`), so `unemitted-declarations` never even SAW this component,
+ * let alone flagged it. Once the guard was taught to follow the alias, all
+ * three inherited events (`point-click`, `legend-click`, `series-toggle`)
+ * measured genuinely dead: the template has no per-point interactivity (no
+ * `@click`/`@keydown` on the arc paths, no `role`/`tabindex`), no legend
+ * markup at all, and `series` beyond the first entry is silently ignored —
+ * there is no "series" axis for a toggle to flip. Same reasoning as
+ * `IChartGaugeSlots`'s `Omit<IChartBaseSlots, 'tooltip' | 'legend-item'>`
+ * just below, applied to the emits side: a gauge is a single-value
+ * visualisation with neither points, a legend, nor a tooltip.
+ */
+export interface IChartGaugeEmits {
+}
 /**
  * Slot signatures exposed by `<OrigamChartGauge>`.
  *

package/dist/src/interfaces/Chart/chart-heatmap.interface.d.ts

@@ -1,5 +1,7 @@
-import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint } from '../../interfaces';
-import type { TChartLegendPosition, TIntent } from '../../types';
+import type { IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { TChartLegendPosition } from '../../types/Chart/chart-legend.type';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Props for `<OrigamChartHeatmap>` — the rectangular heatmap family.
  *
@@ -64,8 +66,21 @@ export interface IChartHeatmapProps extends IChartBaseProps {
      */
     yAxisFormat?: (value: number) => string;
 }
-/** Emits surfaced by `<OrigamChartHeatmap>`. Mirrors the base family. */
-export type IChartHeatmapEmits = IChartBaseEmits;
+/**
+ * `<OrigamChartHeatmap>` emits — `point-click` only, NOT the full base
+ * family. Was `export type IChartHeatmapEmits = IChartBaseEmits` until
+ * #545 — an alias `buildInterfaceIndex()` never resolved, so the guard
+ * never even saw this component. Once fixed, `legend-click` and
+ * `series-toggle` measured genuinely dead: the heatmap renders a
+ * continuous colour-gradient legend (min/max labels + a gradient swatch,
+ * see `IChartHeatmapSlots`'s `Omit<IChartBaseSlots, 'legend-item'>` above),
+ * not a discrete per-series legend list — there is no toggleable entry for
+ * either event to report. `point-click` stays: cells ARE individually
+ * clickable/keyboard-activatable (see `onCellActivate` in the component).
+ */
+export interface IChartHeatmapEmits {
+    (e: 'point-click', point: IChartPoint, originalEvent: MouseEvent | KeyboardEvent): void;
+}
 /**
  * Slot signatures exposed by `<OrigamChartHeatmap>`.
  *

package/dist/src/interfaces/Chart/chart-honeycomb.interface.d.ts

@@ -1,5 +1,7 @@
-import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots, IChartPoint } from '../../interfaces';
-import type { TChartHoneycombColorMode, TChartHoneycombOrientation, TIntent } from '../../types';
+import type { IChartBaseEmits, IChartBaseProps, IChartBaseSlots } from './chart-base.interface';
+import type { IChartPoint } from './chart-point.interface';
+import type { TChartHoneycombColorMode, TChartHoneycombOrientation } from '../../types/Chart/chart-honeycomb.type';
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * Props for `<OrigamChartHoneycomb>` — the hexagonal tile-map family.
  *

package/dist/src/interfaces/Chart/chart-legend.interface.d.ts

@@ -1,5 +1,6 @@
-import type { IChartLegendItem, IChartSeries } from '../../interfaces';
-import type { TChartLegendPosition } from '../../types';
+import type { IChartLegendItem } from './chart.interface';
+import type { IChartSeries } from './chart-series.interface';
+import type { TChartLegendPosition } from '../../types/Chart/chart-legend.type';
 /**
  * Props for `<OrigamChartLegend>` — the series-name + colour-swatch
  * + visibility-toggle list that sits on one side of the chart.