origam 2.15.0 → 2.17.0

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

@@ -149,7 +149,19 @@ export const origamLightTheme = {
   components: {
     "origam-alert": { tag: "div", density: "default" },
     "origam-audio": { tag: "article", variant: "expanded", position: "relative" },
-    "origam-avatar": { tag: "div", size: "default", rounded: "full", color: "primary" },
+    /*********************************************************
+     * origam-avatar — no forced `color` (#530)
+     *
+     * @description
+     * A global constant foreground can't stay readable against every
+     * `bgColor` a consumer picks (a text-secondary grey by default is
+     * fine unstyled; violet-on-amber or violet-on-blue once a consumer
+     * sets `bgColor="warning"`/`"info"` is not). Leaving `color` unset
+     * lets `OrigamAvatar`'s own per-instance auto-contrast
+     * (`useStateEffect`, `bgColor` → matching `fg` token) do the job it
+     * was built for instead of being pre-empted by a static default.
+     ********************************************************/
+    "origam-avatar": { tag: "div", size: "default", rounded: "full" },
     "origam-badge": { tag: "div", location: "top right" },
     "origam-blockquote": { tag: "blockquote", variant: "default" },
     "origam-bottom-nav": { tag: "nav", position: "start" },
@@ -158,7 +170,7 @@ export const origamLightTheme = {
     "origam-btn": { variant: "text", size: "small" },
     "origam-btn-group": { variant: "text", size: "small" },
     "origam-btn-toggle": { variant: "text", size: "small" },
-    "origam-card": { tag: "div", density: "default", rounded: "lg", border: true, flat: true },
+    "origam-card": { tag: "div", density: "default", rounded: "lg", border: true },
     "origam-checkbox": { density: "default" },
     "origam-chip": { size: "small", variant: "outlined", color: "primary", pill: true, border: true, borderColor: "var(--origam-color__action--primary---bg)" },
     "origam-clipboard": { tag: "span" },
@@ -188,7 +200,7 @@ export const origamLightTheme = {
     "origam-number-field": { border: true, rounded: true },
     "origam-number-format": { tag: "span" },
     "origam-overlay": { location: "bottom" },
-    "origam-pagination": { tag: "div" },
+    "origam-pagination": { tag: "nav" },
     "origam-parallax": { tag: "div" },
     "origam-password-field": { density: "default", rounded: true },
     "origam-progress": { tag: "div", size: "default" },
@@ -299,7 +311,19 @@ export const origamDarkTheme = {
   components: {
     "origam-alert": { tag: "div", density: "default" },
     "origam-audio": { tag: "article", variant: "expanded", position: "relative" },
-    "origam-avatar": { tag: "div", size: "default", rounded: "full", color: "primary" },
+    /*********************************************************
+     * origam-avatar — no forced `color` (#530)
+     *
+     * @description
+     * A global constant foreground can't stay readable against every
+     * `bgColor` a consumer picks (a text-secondary grey by default is
+     * fine unstyled; violet-on-amber or violet-on-blue once a consumer
+     * sets `bgColor="warning"`/`"info"` is not). Leaving `color` unset
+     * lets `OrigamAvatar`'s own per-instance auto-contrast
+     * (`useStateEffect`, `bgColor` → matching `fg` token) do the job it
+     * was built for instead of being pre-empted by a static default.
+     ********************************************************/
+    "origam-avatar": { tag: "div", size: "default", rounded: "full" },
     "origam-badge": { tag: "div", location: "top right" },
     "origam-blockquote": { tag: "blockquote", variant: "default" },
     "origam-bottom-nav": { tag: "nav", position: "start" },
@@ -308,7 +332,7 @@ export const origamDarkTheme = {
     "origam-btn": { variant: "text", size: "small" },
     "origam-btn-group": { variant: "text", size: "small" },
     "origam-btn-toggle": { variant: "text", size: "small" },
-    "origam-card": { tag: "div", density: "default", rounded: "lg", border: true, flat: true },
+    "origam-card": { tag: "div", density: "default", rounded: "lg", border: true },
     "origam-checkbox": { density: "default" },
     "origam-chip": { size: "small", variant: "outlined", color: "primary", pill: true, border: true, borderColor: "var(--origam-color__action--primary---bg)" },
     "origam-clipboard": { tag: "span" },
@@ -338,7 +362,7 @@ export const origamDarkTheme = {
     "origam-number-field": { border: true, rounded: true },
     "origam-number-format": { tag: "span" },
     "origam-overlay": { location: "bottom" },
-    "origam-pagination": { tag: "div" },
+    "origam-pagination": { tag: "nav" },
     "origam-parallax": { tag: "div" },
     "origam-password-field": { density: "default", rounded: true },
     "origam-progress": { tag: "div", size: "default" },

package/dist/src/types/Alert/alert.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamAlert } from '../../components';
+import OrigamAlert from '../../components/Alert/OrigamAlert.vue';
 export type TOrigamAlert = InstanceType<typeof OrigamAlert>;

package/dist/src/types/App/app-bar.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamAppBar } from '../../components';
+import OrigamAppBar from '../../components/App/OrigamAppBar.vue';
 export type TOrigamAppBar = InstanceType<typeof OrigamAppBar>;

package/dist/src/types/App/app.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamApp } from '../../components';
+import OrigamApp from '../../components/App/OrigamApp.vue';
 export type TOrigamApp = InstanceType<typeof OrigamApp>;

package/dist/src/types/Audio/audio.type.d.ts

@@ -1,8 +1,10 @@
-import { OrigamAudio } from '../../components';
-import { AUDIO_LOOP_MODE, AUDIO_VARIANT } from '../../enums';
+import OrigamAudio from '../../components/Audio/OrigamAudio.vue';
+import OrigamAudioWaveform from '../../components/Audio/OrigamAudioWaveform.vue';
+import { AUDIO_LOOP_MODE, AUDIO_VARIANT } from '../../enums/Audio/audio.enum';
 import type { TControlsSource } from '../Commons/controls.type';
 import type { TInline } from '../Commons/anchor.type';
 export type TOrigamAudio = InstanceType<typeof OrigamAudio>;
+export type TOrigamAudioWaveform = InstanceType<typeof OrigamAudioWaveform>;
 /**
  * Controls rendering strategy for `<OrigamAudio>`.
  *

package/dist/src/types/Avatar/avatar-group.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamAvatarGroup } from '../../components';
+import OrigamAvatarGroup from '../../components/Avatar/OrigamAvatarGroup.vue';
 export type TOrigamAvatarGroup = InstanceType<typeof OrigamAvatarGroup>;

package/dist/src/types/Avatar/avatar.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamAvatar } from '../../components';
+import OrigamAvatar from '../../components/Avatar/OrigamAvatar.vue';
 export type TOrigamAvatar = InstanceType<typeof OrigamAvatar>;

package/dist/src/types/Badge/badge.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamBadge } from '../../components';
+import OrigamBadge from '../../components/Badge/OrigamBadge.vue';
 export type TOrigamBadge = InstanceType<typeof OrigamBadge>;

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

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

package/dist/src/types/BottomNav/bottom-nav.type.d.ts

@@ -1,5 +1,5 @@
-import { OrigamBottomNav } from '../../components';
-import type { BOTTOM_NAV_POSITION } from '../../enums';
+import OrigamBottomNav from '../../components/BottomNav/OrigamBottomNav.vue';
+import type { BOTTOM_NAV_POSITION } from '../../enums/BottomNav/bottom-nav.enum';
 export type TOrigamBottomNav = InstanceType<typeof OrigamBottomNav>;
 /**
  * String-typed equivalent of {@link BOTTOM_NAV_POSITION}, a strict

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

@@ -1,2 +1,2 @@
-import { OrigamBracketCompetitor } from '../../components';
+import OrigamBracketCompetitor from '../../components/Bracket/OrigamBracketCompetitor.vue';
 export type TOrigamBracketCompetitor = InstanceType<typeof OrigamBracketCompetitor>;

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

@@ -1,4 +1,4 @@
-import { BRACKET_MATCH_STATUS } from '../../enums';
-import { OrigamBracketMatch } from '../../components';
+import { BRACKET_MATCH_STATUS } from '../../enums/Bracket/bracket-match.enum';
+import OrigamBracketMatch from '../../components/Bracket/OrigamBracketMatch.vue';
 export type TBracketMatchStatus = `${BRACKET_MATCH_STATUS}`;
 export type TOrigamBracketMatch = InstanceType<typeof OrigamBracketMatch>;

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

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

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

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

package/dist/src/types/Breadcrumb/breadcrumb-divider.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamBreadcrumbDivider } from '../../components';
+import OrigamBreadcrumbDivider from '../../components/Breadcrumb/OrigamBreadcrumbDivider.vue';
 export type TOrigamBreadcrumbDivider = InstanceType<typeof OrigamBreadcrumbDivider>;

package/dist/src/types/Breadcrumb/breadcrumb-item.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamBreadcrumbItem } from '../../components';
+import OrigamBreadcrumbItem from '../../components/Breadcrumb/OrigamBreadcrumbItem.vue';
 export type TOrigamBreadcrumbItem = InstanceType<typeof OrigamBreadcrumbItem>;

package/dist/src/types/Breadcrumb/breadcrumb.type.d.ts

@@ -1,4 +1,4 @@
-import { OrigamBreadcrumb } from "../../components";
-import type { IBreadcrumbItemProps } from '../../interfaces';
+import OrigamBreadcrumb from '../../components/Breadcrumb/OrigamBreadcrumb.vue';
+import type { IBreadcrumbItemProps } from '../../interfaces/Breadcrumb/breadcrumb-item.interface';
 export type TBreadcrumbItem = string | Partial<IBreadcrumbItemProps> | never;
 export type TOrigamBreadcrumb = InstanceType<typeof OrigamBreadcrumb>;

package/dist/src/types/Btn/btn-group.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamBtnGroup } from '../../components';
+import OrigamBtnGroup from '../../components/Btn/OrigamBtnGroup.vue';
 export type TOrigamBtnGroup = InstanceType<typeof OrigamBtnGroup>;

package/dist/src/types/Btn/btn-toggle.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamBtnToggle } from '../../components';
+import OrigamBtnToggle from '../../components/Btn/OrigamBtnToggle.vue';
 export type TOrigamBtnToggle = InstanceType<typeof OrigamBtnToggle>;

package/dist/src/types/Btn/btn.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamBtn } from '../../components';
+import OrigamBtn from '../../components/Btn/OrigamBtn.vue';
 export type TOrigamBtn = InstanceType<typeof OrigamBtn>;

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

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

package/dist/src/types/Card/card-header.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamCardHeader } from '../../components';
+import OrigamCardHeader from '../../components/Card/OrigamCardHeader.vue';
 export type TOrigamCardHeader = InstanceType<typeof OrigamCardHeader>;

package/dist/src/types/Card/card-text.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamCardText } from '../../components';
+import OrigamCardText from '../../components/Card/OrigamCardText.vue';
 export type TOrigamCardText = InstanceType<typeof OrigamCardText>;

package/dist/src/types/Card/card.type.d.ts

@@ -1,4 +1,4 @@
-import { OrigamCard } from '../../components';
-import { CARD_TYPE } from '../../enums';
+import OrigamCard from '../../components/Card/OrigamCard.vue';
+import { CARD_TYPE } from '../../enums/Card/card.enum';
 export type TCardType = `${CARD_TYPE}`;
 export type TOrigamCard = InstanceType<typeof OrigamCard>;

package/dist/src/types/Carousel/carousel-item.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamCarouselItem } from "../../components";
+import OrigamCarouselItem from '../../components/Carousel/OrigamCarouselItem.vue';
 export type TOrigamCarouselItem = InstanceType<typeof OrigamCarouselItem>;

package/dist/src/types/Carousel/carousel.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamCarousel } from "../../components";
+import OrigamCarousel from '../../components/Carousel/OrigamCarousel.vue';
 export type TOrigamCarousel = InstanceType<typeof OrigamCarousel>;

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

@@ -1,2 +1,2 @@
-import { OrigamChartAxis } from '../../components';
+import OrigamChartAxis from '../../components/Chart/OrigamChartAxis.vue';
 export type TOrigamChartAxis = InstanceType<typeof OrigamChartAxis>;

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

@@ -1,2 +1,2 @@
-import { OrigamChartBoxPlot } from '../../components';
+import OrigamChartBoxPlot from '../../components/Chart/OrigamChartBoxPlot.vue';
 export type TOrigamChartBoxPlot = InstanceType<typeof OrigamChartBoxPlot>;

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

@@ -1,2 +1,2 @@
-import { OrigamChartBullet } from '../../components';
+import OrigamChartBullet from '../../components/Chart/OrigamChartBullet.vue';
 export type TOrigamChartBullet = InstanceType<typeof OrigamChartBullet>;

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

@@ -1,2 +1,2 @@
-import { OrigamChartCandlestick } from '../../components';
+import OrigamChartCandlestick from '../../components/Chart/OrigamChartCandlestick.vue';
 export type TOrigamChartCandlestick = InstanceType<typeof OrigamChartCandlestick>;

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

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

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

@@ -1,2 +1,2 @@
-import { OrigamChartGauge } from '../../components';
+import OrigamChartGauge from '../../components/Chart/OrigamChartGauge.vue';
 export type TOrigamChartGauge = InstanceType<typeof OrigamChartGauge>;

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

@@ -1,2 +1,2 @@
-import { OrigamChartHeatmap } from '../../components';
+import OrigamChartHeatmap from '../../components/Chart/OrigamChartHeatmap.vue';
 export type TOrigamChartHeatmap = InstanceType<typeof OrigamChartHeatmap>;

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

@@ -1,5 +1,5 @@
-import type { CHART_HONEYCOMB_COLOR_MODE, CHART_HONEYCOMB_ORIENTATION } from '../../enums';
-import { OrigamChartHoneycomb } from '../../components';
+import type { CHART_HONEYCOMB_COLOR_MODE, CHART_HONEYCOMB_ORIENTATION } from '../../enums/Chart/chart-honeycomb.enum';
+import OrigamChartHoneycomb from '../../components/Chart/OrigamChartHoneycomb.vue';
 export type TChartHoneycombColorMode = `${CHART_HONEYCOMB_COLOR_MODE}`;
 export type TChartHoneycombOrientation = `${CHART_HONEYCOMB_ORIENTATION}`;
 export type TOrigamChartHoneycomb = InstanceType<typeof OrigamChartHoneycomb>;

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

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

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

@@ -1,5 +1,5 @@
 import type { CHART_MAP_MODE } from '../../enums/Chart/chart-map.enum';
-import { OrigamChartMap } from '../../components';
+import OrigamChartMap from '../../components/Chart/OrigamChartMap.vue';
 /**
  * Rendering mode for `<OrigamChartMap>`.
  *

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

@@ -1,2 +1,2 @@
-import { OrigamChartPareto } from '../../components';
+import OrigamChartPareto from '../../components/Chart/OrigamChartPareto.vue';
 export type TOrigamChartPareto = InstanceType<typeof OrigamChartPareto>;

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

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

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

@@ -1,2 +1,2 @@
-import { OrigamChartPolarBar } from '../../components';
+import OrigamChartPolarBar from '../../components/Chart/OrigamChartPolarBar.vue';
 export type TOrigamChartPolarBar = InstanceType<typeof OrigamChartPolarBar>;

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

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

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

@@ -1,5 +1,5 @@
-import { CHART_PYRAMID_KIND } from '../../enums';
-import { OrigamChartPyramid } from '../../components';
+import { CHART_PYRAMID_KIND } from '../../enums/Chart/chart-pyramid.enum';
+import OrigamChartPyramid from '../../components/Chart/OrigamChartPyramid.vue';
 /**
  * The two rendering modes of the pyramid / funnel family.
  *

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

@@ -1,2 +1,2 @@
-import { OrigamChartRadar } from '../../components';
+import OrigamChartRadar from '../../components/Chart/OrigamChartRadar.vue';
 export type TOrigamChartRadar = InstanceType<typeof OrigamChartRadar>;

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

@@ -1,2 +1,2 @@
-import { OrigamChartRangeSelector } from '../../components';
+import OrigamChartRangeSelector from '../../components/Chart/OrigamChartRangeSelector.vue';
 export type TOrigamChartRangeSelector = InstanceType<typeof OrigamChartRangeSelector>;

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

@@ -1,4 +1,4 @@
-import { OrigamChartSankey } from '../../components';
+import OrigamChartSankey from '../../components/Chart/OrigamChartSankey.vue';
 export type TOrigamChartSankey = InstanceType<typeof OrigamChartSankey>;
 /**
  * Per-link layout spec computed while laying out ribbons — carries the

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

@@ -1,5 +1,5 @@
-import { CHART_SPARKLINE_KIND } from '../../enums';
-import { OrigamChartSparkline } from '../../components';
+import { CHART_SPARKLINE_KIND } from '../../enums/Chart/chart-sparkline.enum';
+import OrigamChartSparkline from '../../components/Chart/OrigamChartSparkline.vue';
 /**
  * The four rendering modes of the sparkline family.
  *

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

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

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

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

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

@@ -1,2 +1,2 @@
-import { OrigamChartTooltip } from '../../components';
+import OrigamChartTooltip from '../../components/Chart/OrigamChartTooltip.vue';
 export type TOrigamChartTooltip = InstanceType<typeof OrigamChartTooltip>;

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

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

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

@@ -1,2 +1,2 @@
-import { OrigamChartVariwide } from '../../components';
+import OrigamChartVariwide from '../../components/Chart/OrigamChartVariwide.vue';
 export type TOrigamChartVariwide = InstanceType<typeof OrigamChartVariwide>;

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

@@ -1,5 +1,5 @@
 import { CHART_WORD_CLOUD_ROTATION } from '../../enums/Chart/chart-word-cloud.enum';
-import { OrigamChartWordCloud } from '../../components';
+import OrigamChartWordCloud from '../../components/Chart/OrigamChartWordCloud.vue';
 /**
  * Word rotation mode for `<OrigamChartWordCloud>`.
  * - `'none'`        — all words horizontal (0°).

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

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

package/dist/src/types/Checkbox/checkbox-btn.type.d.ts

@@ -1,2 +1,2 @@
-import { OrigamCheckboxBtn } from "../../components";
+import OrigamCheckboxBtn from '../../components/Checkbox/OrigamCheckboxBtn.vue';
 export type TOrigamCheckboxBtn = InstanceType<typeof OrigamCheckboxBtn>;