origam 2.16.0 → 2.17.1

package/dist/src/consts/Chart/chart.const.cjs

@@ -3,8 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.CHART_Y_TICK_COUNT = exports.CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = void 0;
+exports.CHART_Y_TICK_COUNT = exports.CHART_TICK_LABEL_PRECISION_FACTOR = exports.CHART_SLICE_LABEL_PREFIX = exports.CHART_SCATTER_MIN_RADIUS = exports.CHART_SCATTER_MAX_RADIUS = exports.CHART_SCATTER_DEFAULT_RADIUS = exports.CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = exports.CHART_RADAR_RADIUS_INSET = exports.CHART_RADAR_MIN_RADIUS = exports.CHART_RADAR_MARKER_RADIUS = exports.CHART_POINT_MARKER_RADIUS = exports.CHART_PLOT_LINE_LABEL_TOP_OFFSET = exports.CHART_PLOT_LINE_LABEL_OFFSET = exports.CHART_PLOT_LINE_DEFAULT_WIDTH = exports.CHART_PLOT_BAND_DEFAULT_OPACITY = exports.CHART_PIE_RADIUS_INSET = exports.CHART_PIE_MIN_RADIUS = exports.CHART_PERCENT_TICK_STEP = exports.CHART_PERCENT_MIN = exports.CHART_PERCENT_MAX = exports.CHART_NICE_STEP_LADDER = exports.CHART_EPSILON = exports.CHART_DEFAULT_PALETTE = exports.CHART_DASH_ARRAY_SOLID = exports.CHART_DASH_ARRAY_DOTTED = exports.CHART_DASH_ARRAY_DASHED = exports.CHART_COLOR_FALLBACK = exports.CHART_BAR_SLOT_FILL_RATIO = exports.CHART_ANNOTATION_LABEL_PADDING = exports.CHART_ANNOTATION_LABEL_MIN_WIDTH = exports.CHART_ANNOTATION_LABEL_HEIGHT = exports.CHART_ANNOTATION_LABEL_CHAR_WIDTH = exports.CHART_ANNOTATION_DEFAULT_WIDTH = exports.CHART_ANNOTATION_DEFAULT_RADIUS = exports.CHART_ANNOTATION_DEFAULT_DY = exports.CHART_ANNOTATION_ARROWHEAD_WIDTH_FACTOR = exports.CHART_ANNOTATION_ARROWHEAD_SPREAD = exports.CHART_ANNOTATION_ARROWHEAD_PRECISION = exports.CHART_ANNOTATION_ARROWHEAD_MIN_SIZE = exports.CHART_ANIMATION_DURATION_DEFAULT = void 0;
+var _intent = require("../../enums/Commons/intent.enum.cjs");
 const CHART_Y_TICK_COUNT = exports.CHART_Y_TICK_COUNT = 5;
+const CHART_ANIMATION_DURATION_DEFAULT = exports.CHART_ANIMATION_DURATION_DEFAULT = 600;
 const CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = exports.CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = [{
   label: "1w",
   count: 7
@@ -23,4 +25,53 @@ const CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = exports.CHART_RANGE_SELECTOR_DEFAUL
 }, {
   label: "all",
   fraction: 1
-}];
+}];
+const CHART_DEFAULT_PALETTE = exports.CHART_DEFAULT_PALETTE = [_intent.INTENT.PRIMARY, _intent.INTENT.SUCCESS, _intent.INTENT.WARNING, _intent.INTENT.DANGER, _intent.INTENT.INFO, _intent.INTENT.SECONDARY, _intent.INTENT.GHOST, _intent.INTENT.NEUTRAL];
+const CHART_COLOR_FALLBACK = exports.CHART_COLOR_FALLBACK = "currentColor";
+const CHART_EPSILON = exports.CHART_EPSILON = 1e-9;
+const CHART_DASH_ARRAY_SOLID = exports.CHART_DASH_ARRAY_SOLID = "none";
+const CHART_DASH_ARRAY_DASHED = exports.CHART_DASH_ARRAY_DASHED = "6 4";
+const CHART_DASH_ARRAY_DOTTED = exports.CHART_DASH_ARRAY_DOTTED = "2 4";
+const CHART_PLOT_BAND_DEFAULT_OPACITY = exports.CHART_PLOT_BAND_DEFAULT_OPACITY = 0.15;
+const CHART_PLOT_LINE_DEFAULT_WIDTH = exports.CHART_PLOT_LINE_DEFAULT_WIDTH = 1.5;
+const CHART_PLOT_LINE_LABEL_OFFSET = exports.CHART_PLOT_LINE_LABEL_OFFSET = 4;
+const CHART_PLOT_LINE_LABEL_TOP_OFFSET = exports.CHART_PLOT_LINE_LABEL_TOP_OFFSET = 12;
+const CHART_ANNOTATION_DEFAULT_WIDTH = exports.CHART_ANNOTATION_DEFAULT_WIDTH = 1.5;
+const CHART_ANNOTATION_DEFAULT_DY = exports.CHART_ANNOTATION_DEFAULT_DY = -14;
+const CHART_ANNOTATION_DEFAULT_RADIUS = exports.CHART_ANNOTATION_DEFAULT_RADIUS = 12;
+const CHART_ANNOTATION_ARROWHEAD_MIN_SIZE = exports.CHART_ANNOTATION_ARROWHEAD_MIN_SIZE = 6;
+const CHART_ANNOTATION_ARROWHEAD_WIDTH_FACTOR = exports.CHART_ANNOTATION_ARROWHEAD_WIDTH_FACTOR = 4;
+const CHART_ANNOTATION_ARROWHEAD_SPREAD = exports.CHART_ANNOTATION_ARROWHEAD_SPREAD = Math.PI / 5;
+const CHART_ANNOTATION_ARROWHEAD_PRECISION = exports.CHART_ANNOTATION_ARROWHEAD_PRECISION = 2;
+const CHART_ANNOTATION_LABEL_CHAR_WIDTH = exports.CHART_ANNOTATION_LABEL_CHAR_WIDTH = 7;
+const CHART_ANNOTATION_LABEL_PADDING = exports.CHART_ANNOTATION_LABEL_PADDING = 8;
+const CHART_ANNOTATION_LABEL_MIN_WIDTH = exports.CHART_ANNOTATION_LABEL_MIN_WIDTH = 48;
+const CHART_ANNOTATION_LABEL_HEIGHT = exports.CHART_ANNOTATION_LABEL_HEIGHT = 24;
+const CHART_PERCENT_MIN = exports.CHART_PERCENT_MIN = 0;
+const CHART_PERCENT_MAX = exports.CHART_PERCENT_MAX = 100;
+const CHART_PERCENT_TICK_STEP = exports.CHART_PERCENT_TICK_STEP = 25;
+const CHART_TICK_LABEL_PRECISION_FACTOR = exports.CHART_TICK_LABEL_PRECISION_FACTOR = 1e3;
+const CHART_NICE_STEP_LADDER = exports.CHART_NICE_STEP_LADDER = [{
+  below: 1.5,
+  step: 1
+}, {
+  below: 3,
+  step: 2
+}, {
+  below: 7,
+  step: 5
+}, {
+  below: Number.POSITIVE_INFINITY,
+  step: 10
+}];
+const CHART_BAR_SLOT_FILL_RATIO = exports.CHART_BAR_SLOT_FILL_RATIO = 0.7;
+const CHART_POINT_MARKER_RADIUS = exports.CHART_POINT_MARKER_RADIUS = 4;
+const CHART_RADAR_MARKER_RADIUS = exports.CHART_RADAR_MARKER_RADIUS = 3.5;
+const CHART_PIE_MIN_RADIUS = exports.CHART_PIE_MIN_RADIUS = 10;
+const CHART_PIE_RADIUS_INSET = exports.CHART_PIE_RADIUS_INSET = 4;
+const CHART_RADAR_MIN_RADIUS = exports.CHART_RADAR_MIN_RADIUS = 10;
+const CHART_RADAR_RADIUS_INSET = exports.CHART_RADAR_RADIUS_INSET = 8;
+const CHART_SCATTER_DEFAULT_RADIUS = exports.CHART_SCATTER_DEFAULT_RADIUS = 5;
+const CHART_SCATTER_MIN_RADIUS = exports.CHART_SCATTER_MIN_RADIUS = 5;
+const CHART_SCATTER_MAX_RADIUS = exports.CHART_SCATTER_MAX_RADIUS = 36;
+const CHART_SLICE_LABEL_PREFIX = exports.CHART_SLICE_LABEL_PREFIX = "Slice";

package/dist/src/consts/Chart/chart.const.d.ts

@@ -1,9 +1,20 @@
+import type { TIntent } from '../../types/Commons/intent.type';
 /**
  * How many Y-axis ticks `<OrigamChart>` draws by default. The
  * composable snaps the data range to a "nice" multiple of this —
  * five rows fits most narrow chart heights without crowding.
  */
 export declare const CHART_Y_TICK_COUNT = 5;
+/**
+ * Static default of the `animationDuration` prop, mirrored verbatim in
+ * every `OrigamChart*.vue`'s `withDefaults()` call (which MUST inline the
+ * literal — see the repo's `withDefaults()` rule, imported consts are not
+ * statically resolvable there). Kept here as the single comparison point
+ * `useChartAnimationStyle` uses to tell "resolves to the untouched default"
+ * apart from "a theme or the consumer changed it" — see that composable's
+ * doc for why the distinction matters (#505).
+ */
+export declare const CHART_ANIMATION_DURATION_DEFAULT = 600;
 /**
  * Default buttons shown in the range-selector toolbar when the consumer
  * enables `rangeSelector.enabled` without providing a custom `buttons`
@@ -30,3 +41,217 @@ export declare const CHART_RANGE_SELECTOR_DEFAULT_BUTTONS: readonly [{
     readonly label: "all";
     readonly fraction: 1;
 }];
+/*********************************************************
+ * CHART_DEFAULT_PALETTE — couleurs de série par défaut
+ *
+ * @description
+ * Palette parcourue en boucle par `useChart` quand une série ne fixe pas
+ * son propre `color` et que le consommateur ne passe pas de `colorScheme`.
+ * Reprend les huit membres de `INTENT` ; la résolution vers du CSS a lieu
+ * dans `resolveColor`, à l'intérieur de `chart.composable.ts`.
+ ********************************************************/
+export declare const CHART_DEFAULT_PALETTE: Array<TIntent>;
+/*********************************************************
+ * CHART_COLOR_FALLBACK — couleur de dernier recours
+ *
+ * @description
+ * Utilisée dès qu'une couleur de graphique ne se résout pas : valeur vide,
+ * ou chaîne qui n'est ni une couleur CSS brute ni un nom d'`INTENT` connu.
+ * Hérite de la couleur de texte environnante, donc la forme reste visible
+ * sur les deux thèmes.
+ ********************************************************/
+export declare const CHART_COLOR_FALLBACK = "currentColor";
+/*********************************************************
+ * CHART_EPSILON — plancher des diviseurs
+ *
+ * @description
+ * Appliqué à toute amplitude avant de s'en servir comme diviseur. Les
+ * amplitudes viennent des données et s'effondrent légitimement à `0`
+ * (série à un seul point, valeurs toutes égales) ; diviser par cette
+ * valeur donne un ratio énorme mais FINI, que les bornages alentour
+ * absorbent, là où `0` propagerait `Infinity` / `NaN` dans les attributs
+ * SVG.
+ ********************************************************/
+export declare const CHART_EPSILON = 1e-9;
+/*********************************************************
+ * CHART_DASH_ARRAY_* — motifs de tirets SVG
+ *
+ * @description
+ * Valeurs de `stroke-dasharray` derrière `IChartPlotLine['dash']`. SVG
+ * attend un couple longueur de tiret / longueur d'espace ; `'none'` est le
+ * mot-clé du trait continu.
+ ********************************************************/
+export declare const CHART_DASH_ARRAY_SOLID = "none";
+export declare const CHART_DASH_ARRAY_DASHED = "6 4";
+export declare const CHART_DASH_ARRAY_DOTTED = "2 4";
+/*********************************************************
+ * CHART_PLOT_BAND_DEFAULT_OPACITY — opacité de bande
+ *
+ * @description
+ * Opacité de remplissage appliquée à une bande qui ne fixe pas la sienne.
+ * Assez basse pour que les séries dessinées par-dessus restent lisibles.
+ ********************************************************/
+export declare const CHART_PLOT_BAND_DEFAULT_OPACITY = 0.15;
+/*********************************************************
+ * CHART_PLOT_LINE_* — ligne de seuil et son étiquette
+ *
+ * @description
+ * `DEFAULT_WIDTH` est l'épaisseur d'une ligne de seuil qui ne fixe pas la
+ * sienne.
+ * @description
+ * `LABEL_OFFSET` est l'écart, en unités SVG, entre la ligne et son
+ * étiquette — au-dessus d'une ligne horizontale, à droite d'une verticale.
+ * @description
+ * `LABEL_TOP_OFFSET` est la distance entre le haut du plot et la ligne de
+ * base de l'étiquette d'une ligne verticale, pour que le texte dégage le
+ * bord du plot.
+ ********************************************************/
+export declare const CHART_PLOT_LINE_DEFAULT_WIDTH = 1.5;
+export declare const CHART_PLOT_LINE_LABEL_OFFSET = 4;
+export declare const CHART_PLOT_LINE_LABEL_TOP_OFFSET = 12;
+/*********************************************************
+ * CHART_ANNOTATION_DEFAULT_* — valeurs par défaut d'annotation
+ *
+ * @description
+ * `WIDTH` est l'épaisseur de trait d'une annotation qui ne fixe pas la
+ * sienne. `DY` est le décalage vertical du texte par rapport à son point
+ * d'ancrage — négatif, l'étiquette se place donc au-dessus du point par
+ * défaut. `RADIUS` est le rayon d'une annotation `'circle'` sans rayon
+ * explicite.
+ ********************************************************/
+export declare const CHART_ANNOTATION_DEFAULT_WIDTH = 1.5;
+export declare const CHART_ANNOTATION_DEFAULT_DY = -14;
+export declare const CHART_ANNOTATION_DEFAULT_RADIUS = 12;
+/*********************************************************
+ * CHART_ANNOTATION_ARROWHEAD_* — pointe de flèche
+ *
+ * @description
+ * Dimensionnement de la pointe de l'annotation `'arrow'` : le triangle
+ * grandit avec l'épaisseur du trait (`WIDTH_FACTOR`) mais ne descend jamais
+ * sous `MIN_SIZE`, et ses deux barbes s'ouvrent à `± SPREAD` radians de
+ * part et d'autre de la hampe.
+ * @description
+ * `PRECISION` est le nombre de décimales conservées à la sérialisation du
+ * polygone dans son attribut `points` — assez pour le sous-pixel, sans
+ * gonfler le DOM.
+ ********************************************************/
+export declare const CHART_ANNOTATION_ARROWHEAD_MIN_SIZE = 6;
+export declare const CHART_ANNOTATION_ARROWHEAD_WIDTH_FACTOR = 4;
+export declare const CHART_ANNOTATION_ARROWHEAD_SPREAD: number;
+export declare const CHART_ANNOTATION_ARROWHEAD_PRECISION = 2;
+/*********************************************************
+ * CHART_ANNOTATION_LABEL_* — bulle de l'annotation `'label'`
+ *
+ * @description
+ * La largeur est estimée depuis la longueur du texte — SVG n'offre ici
+ * aucune API de mesure synchrone — via une chasse moyenne
+ * (`CHAR_WIDTH`) plus un `PADDING` horizontal de chaque côté, plancher à
+ * `MIN_WIDTH` pour que les libellés courts restent lisibles. `HEIGHT` est
+ * fixe.
+ ********************************************************/
+export declare const CHART_ANNOTATION_LABEL_CHAR_WIDTH = 7;
+export declare const CHART_ANNOTATION_LABEL_PADDING = 8;
+export declare const CHART_ANNOTATION_LABEL_MIN_WIDTH = 48;
+export declare const CHART_ANNOTATION_LABEL_HEIGHT = 24;
+/*********************************************************
+ * CHART_PERCENT_* — axe d'un empilement `'percent'`
+ *
+ * @description
+ * Plage Y canonique d'un graphique empilé en pourcentage. L'axe est cloué
+ * à `0 → 100` quelles que soient les données, et les surcharges `yMin` /
+ * `yMax` sont délibérément ignorées pour que l'échelle reste comparable
+ * d'un graphique à l'autre.
+ * @description
+ * `TICK_STEP` est l'incrément de graduation sur cet axe fixe : cinq
+ * lignes de grille.
+ ********************************************************/
+export declare const CHART_PERCENT_MIN = 0;
+export declare const CHART_PERCENT_MAX = 100;
+export declare const CHART_PERCENT_TICK_STEP = 25;
+/*********************************************************
+ * CHART_TICK_LABEL_PRECISION_FACTOR — arrondi des libellés
+ *
+ * @description
+ * Arrondi appliqué aux libellés de graduation numériques :
+ * `Math.round(v * F) / F` rogne le bruit flottant laissé par
+ * l'accumulation de `niceStep`, en gardant trois décimales.
+ ********************************************************/
+export declare const CHART_TICK_LABEL_PRECISION_FACTOR = 1000;
+/*********************************************************
+ * CHART_NICE_STEP_LADDER — échelle d'arrondi des graduations
+ *
+ * @description
+ * Échelle d'incréments de l'arrondi « nice » façon D3 : le ratio brut
+ * amplitude / nombre de graduations est normalisé dans `[1, 10)`, puis
+ * remonté au premier barreau dont il franchit la borne `below`. Le dernier
+ * barreau n'a pas de borne supérieure.
+ ********************************************************/
+export declare const CHART_NICE_STEP_LADDER: readonly [{
+    readonly below: 1.5;
+    readonly step: 1;
+}, {
+    readonly below: 3;
+    readonly step: 2;
+}, {
+    readonly below: 7;
+    readonly step: 5;
+}, {
+    readonly below: number;
+    readonly step: 10;
+}];
+/*********************************************************
+ * CHART_BAR_SLOT_FILL_RATIO — remplissage d'un créneau
+ *
+ * @description
+ * Fraction d'un créneau catégoriel réellement occupée par sa ou ses
+ * barres. Le reste devient la gouttière entre créneaux voisins ; en mode
+ * groupé (non empilé), cette largeur est ensuite partagée entre les séries
+ * visibles.
+ ********************************************************/
+export declare const CHART_BAR_SLOT_FILL_RATIO = 0.7;
+/*********************************************************
+ * CHART_POINT_MARKER_RADIUS / CHART_RADAR_MARKER_RADIUS
+ *
+ * @description
+ * Rayon des marqueurs de point dessinés sur les séries line / area /
+ * spline, et rayon — plus petit — de ceux posés sur chaque axe d'un radar.
+ ********************************************************/
+export declare const CHART_POINT_MARKER_RADIUS = 4;
+export declare const CHART_RADAR_MARKER_RADIUS = 3.5;
+/*********************************************************
+ * CHART_PIE_* / CHART_RADAR_* — rayon des familles circulaires
+ *
+ * @description
+ * Rayon extérieur d'un camembert / donut : la moitié du plus petit côté du
+ * plot, retirée d'un `INSET` pour que l'anneau ne touche jamais le cadre,
+ * et plancher à `MIN_RADIUS` pour qu'un plot minuscule affiche encore un
+ * disque visible.
+ * @description
+ * Le radar suit la même règle avec un `INSET` plus large, qui laisse la
+ * place aux libellés d'axes.
+ ********************************************************/
+export declare const CHART_PIE_MIN_RADIUS = 10;
+export declare const CHART_PIE_RADIUS_INSET = 4;
+export declare const CHART_RADAR_MIN_RADIUS = 10;
+export declare const CHART_RADAR_RADIUS_INSET = 8;
+/*********************************************************
+ * CHART_SCATTER_*_RADIUS — taille des points de nuage
+ *
+ * @description
+ * Les points sans valeur `z` gardent le rayon fixe `DEFAULT`. Dès qu'un
+ * point du graphique porte un `z`, les rayons sont mis à l'échelle
+ * linéairement depuis la plage Z globale vers `[MIN..MAX]`.
+ ********************************************************/
+export declare const CHART_SCATTER_DEFAULT_RADIUS = 5;
+export declare const CHART_SCATTER_MIN_RADIUS = 5;
+export declare const CHART_SCATTER_MAX_RADIUS = 36;
+/*********************************************************
+ * CHART_SLICE_LABEL_PREFIX — libellé de secours d'une part
+ *
+ * @description
+ * Préfixe du libellé synthétique donné à une part de camembert / donut qui
+ * n'a ni entrée correspondante dans `categories`, ni donnée en forme
+ * d'objet porteuse d'un libellé `x`. Suffixé par l'index de la part, en
+ * base 1.
+ ********************************************************/
+export declare const CHART_SLICE_LABEL_PREFIX = "Slice";

package/dist/src/consts/Chart/chart.const.js

@@ -1,4 +1,6 @@
+import { INTENT } from "../../enums/Commons/intent.enum.js";
 export const CHART_Y_TICK_COUNT = 5;
+export const CHART_ANIMATION_DURATION_DEFAULT = 600;
 export const CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = [
   { label: "1w", count: 7 },
   { label: "1m", count: 30 },
@@ -7,3 +9,54 @@ export const CHART_RANGE_SELECTOR_DEFAULT_BUTTONS = [
   { label: "1y", count: 365 },
   { label: "all", fraction: 1 }
 ];
+export const CHART_DEFAULT_PALETTE = [
+  INTENT.PRIMARY,
+  INTENT.SUCCESS,
+  INTENT.WARNING,
+  INTENT.DANGER,
+  INTENT.INFO,
+  INTENT.SECONDARY,
+  INTENT.GHOST,
+  INTENT.NEUTRAL
+];
+export const CHART_COLOR_FALLBACK = "currentColor";
+export const CHART_EPSILON = 1e-9;
+export const CHART_DASH_ARRAY_SOLID = "none";
+export const CHART_DASH_ARRAY_DASHED = "6 4";
+export const CHART_DASH_ARRAY_DOTTED = "2 4";
+export const CHART_PLOT_BAND_DEFAULT_OPACITY = 0.15;
+export const CHART_PLOT_LINE_DEFAULT_WIDTH = 1.5;
+export const CHART_PLOT_LINE_LABEL_OFFSET = 4;
+export const CHART_PLOT_LINE_LABEL_TOP_OFFSET = 12;
+export const CHART_ANNOTATION_DEFAULT_WIDTH = 1.5;
+export const CHART_ANNOTATION_DEFAULT_DY = -14;
+export const CHART_ANNOTATION_DEFAULT_RADIUS = 12;
+export const CHART_ANNOTATION_ARROWHEAD_MIN_SIZE = 6;
+export const CHART_ANNOTATION_ARROWHEAD_WIDTH_FACTOR = 4;
+export const CHART_ANNOTATION_ARROWHEAD_SPREAD = Math.PI / 5;
+export const CHART_ANNOTATION_ARROWHEAD_PRECISION = 2;
+export const CHART_ANNOTATION_LABEL_CHAR_WIDTH = 7;
+export const CHART_ANNOTATION_LABEL_PADDING = 8;
+export const CHART_ANNOTATION_LABEL_MIN_WIDTH = 48;
+export const CHART_ANNOTATION_LABEL_HEIGHT = 24;
+export const CHART_PERCENT_MIN = 0;
+export const CHART_PERCENT_MAX = 100;
+export const CHART_PERCENT_TICK_STEP = 25;
+export const CHART_TICK_LABEL_PRECISION_FACTOR = 1e3;
+export const CHART_NICE_STEP_LADDER = [
+  { below: 1.5, step: 1 },
+  { below: 3, step: 2 },
+  { below: 7, step: 5 },
+  { below: Number.POSITIVE_INFINITY, step: 10 }
+];
+export const CHART_BAR_SLOT_FILL_RATIO = 0.7;
+export const CHART_POINT_MARKER_RADIUS = 4;
+export const CHART_RADAR_MARKER_RADIUS = 3.5;
+export const CHART_PIE_MIN_RADIUS = 10;
+export const CHART_PIE_RADIUS_INSET = 4;
+export const CHART_RADAR_MIN_RADIUS = 10;
+export const CHART_RADAR_RADIUS_INSET = 8;
+export const CHART_SCATTER_DEFAULT_RADIUS = 5;
+export const CHART_SCATTER_MIN_RADIUS = 5;
+export const CHART_SCATTER_MAX_RADIUS = 36;
+export const CHART_SLICE_LABEL_PREFIX = "Slice";

package/dist/src/consts/ColorPicker/color-picker.const.d.ts

@@ -1,4 +1,4 @@
-import type { IColorPickerMode } from "../../interfaces";
+import type { IColorPickerMode } from '../../interfaces/ColorPicker/color-picker.interface';
 export declare const COLOR_NULL: {
     h: number;
     s: number;

package/dist/src/consts/Commons/anchor.const.d.ts

@@ -1,4 +1,4 @@
-import type { TBlock, TBlockStartEnd, TDirectionBoth, TInline, TInlineStartEnd } from '../../types';
+import type { TBlock, TBlockStartEnd, TDirectionBoth, TInline, TInlineStartEnd } from '../../types/Commons/anchor.type';
 export declare const BLOCK_ARRAY: Array<TBlock>;
 export declare const INLINE_ARRAY: Array<TInline>;
 export declare const BLOCK_START_END_ARRAY: Array<TBlockStartEnd>;

package/dist/src/consts/Commons/border.const.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.BORDER_REGEX = exports.BORDER_POSITION_MAP = exports.BORDER_LOGICAL_AXIS_MAP = void 0;
+exports.BORDER_REGEX = exports.BORDER_PROP_KEYS = exports.BORDER_POSITION_MAP = exports.BORDER_LOGICAL_AXIS_MAP = exports.BORDER_KEYWORD_WIDTH = void 0;
 var _enums = require("../../enums/index.cjs");
 const BORDER_REGEX = exports.BORDER_REGEX = /^(?<width>(?: ?(?:[0-9]+)(?:px|pt|PC|in|cm|mm|em|rem|%|ex|ch|fr)?){0,4}) {0,1}(?<style>(?:(?: ?(?:none|hidden|dotted|dashed|solid|double|groove|ridge|inset|outset))+){0,4}) ?(?<color>(?: ?(?:(?:(?:#)(?:[a-f0-9]{3}|[a-f0-9]{6}))|(?:var\(--[^)]+\))|(?:(?:rgb|hsl|rgba)a?\(.*\))|(?:[A-Za-z]+))){0,4})$/;
 const BORDER_POSITION_MAP = exports.BORDER_POSITION_MAP = [{
@@ -29,4 +29,10 @@ const BORDER_LOGICAL_AXIS_MAP = exports.BORDER_LOGICAL_AXIS_MAP = [{
 }, {
   axis: _enums.BORDER_LOGICAL_AXIS.INLINE,
   widthProp: "borderInline"
-}];
+}];
+const BORDER_PROP_KEYS = exports.BORDER_PROP_KEYS = ["border", "borderTop", "borderRight", "borderBottom", "borderLeft", "borderBlock", "borderInline", "borderColor", "borderStyle", "borderTopColor", "borderRightColor", "borderBottomColor", "borderLeftColor"];
+const BORDER_KEYWORD_WIDTH = exports.BORDER_KEYWORD_WIDTH = {
+  none: "var(--origam-border__width---0)",
+  thin: "var(--origam-border__width---thin)",
+  thick: "var(--origam-border__width---2)"
+};

package/dist/src/consts/Commons/border.const.d.ts

@@ -1,5 +1,5 @@
 import { BLOCK, INLINE } from '../../enums';
-import type { TBorderLogicalAxis } from '../../types';
+import type { TBorderLogicalAxis, TBorderWidthKeyword } from '../../types/Commons/border.type';
 /**
  * Parse a free-form `border` value into width / style / color groups.
  *
@@ -63,3 +63,46 @@ export declare const BORDER_LOGICAL_AXIS_MAP: ReadonlyArray<{
     axis: TBorderLogicalAxis;
     widthProp: 'borderBlock' | 'borderInline';
 }>;
+/*********************************************************
+ * BORDER_PROP_KEYS
+ *
+ * @description
+ * Every key `IBorderProps` declares — the complete prop surface `useBorder`
+ * consumes, in one place.
+ *
+ * @description
+ * Issue #726. The four components that wrap an `<origam-field>` inside an
+ * `<origam-input>` (TextField, TextareaField, PasswordField, FileField) must
+ * hand this surface to the FIELD and withhold it from the INPUT. The input is
+ * the outer box and has no notch, so a border painted there crosses the
+ * floating label; the field owns the notched outline that opens around it.
+ * Both children resolve their bindings through `filterProps(props, excludes)`,
+ * so the split is expressed as this exclude list — named once here rather than
+ * retyped in four templates, where one forgotten key (`borderBlock`,
+ * `borderTopColor`, …) would silently restore the defect for that one value.
+ */
+export declare const BORDER_PROP_KEYS: readonly ["border", "borderTop", "borderRight", "borderBottom", "borderLeft", "borderBlock", "borderInline", "borderColor", "borderStyle", "borderTopColor", "borderRightColor", "borderBottomColor", "borderLeftColor"];
+/*********************************************************
+ * BORDER_KEYWORD_WIDTH
+ *
+ * @description
+ * The CSS width each `border="none|thin|thick"` keyword resolves to —
+ * the SAME token the matching `.origam--border-{kw}` utility declares in
+ * `assets/css/tokens/origam-utilities.css`. Single source of truth for
+ * the pair: the utility paints where nothing competes, `useBorder` emits
+ * these inline where a component's own scoped rule would otherwise win.
+ *
+ * @description
+ * ⛔ #391 — why the inline copy exists at all. A component that paints
+ * its border from `border-width: var(--origam-{cmp}---border-width, …)`
+ * inside a Vue scoped rule outranks the utility: `.class[data-v-hash]` is
+ * specificity (0,2,0), `.origam--border-thick` is (0,1,0), so the utility
+ * loses whatever the sheet order — that is specificity, not order.
+ * Measured across the catalogue: 10 of the 43 `useBorder` consumers carry
+ * such a rule, and on those `border="thick"` painted `thin` and
+ * `border="none"` painted `thin` instead of nothing. Emitting the width
+ * inline (exactly as the numeric `:border="4"` path already does, which
+ * is why THAT case always worked) fixes all 10 from one place instead of
+ * replicating three SCSS rules per component.
+ ********************************************************/
+export declare const BORDER_KEYWORD_WIDTH: Readonly<Record<TBorderWidthKeyword, string>>;

package/dist/src/consts/Commons/border.const.js

@@ -10,3 +10,23 @@ export const BORDER_LOGICAL_AXIS_MAP = [
   { axis: BORDER_LOGICAL_AXIS.BLOCK, widthProp: "borderBlock" },
   { axis: BORDER_LOGICAL_AXIS.INLINE, widthProp: "borderInline" }
 ];
+export const BORDER_PROP_KEYS = [
+  "border",
+  "borderTop",
+  "borderRight",
+  "borderBottom",
+  "borderLeft",
+  "borderBlock",
+  "borderInline",
+  "borderColor",
+  "borderStyle",
+  "borderTopColor",
+  "borderRightColor",
+  "borderBottomColor",
+  "borderLeftColor"
+];
+export const BORDER_KEYWORD_WIDTH = {
+  none: "var(--origam-border__width---0)",
+  thin: "var(--origam-border__width---thin)",
+  thick: "var(--origam-border__width---2)"
+};

package/dist/src/consts/Commons/color.const.cjs

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.SRGB_REVERSE_TRANSFORM = exports.SRGB_REVERSE_MATRIX = exports.SRGB_FORWARD_TRANSFORM = exports.SRGB_FORWARD_MATRIX = exports.SCALE_W_O_B = exports.SCALE_B_O_W = exports.REV_TXT = exports.REV_BG = exports.RCO = exports.NORM_TXT = exports.NORM_BG = exports.MAIN_TRC = exports.LO_CON_THRESH = exports.LO_CON_OFFSET = exports.LO_CON_FACTOR = exports.LO_CLIP = exports.GCO = exports.CSS_NAMED_COLORS = exports.CSS_COLOR_REGEX = exports.COLOR_UTILITY_INTENTS = exports.COLOR_MAPPERS = exports.COLOR_INTENTS = exports.COLOR_HOVER_MIX_PCT = exports.COLOR_DELTA_Y_MIN = exports.COLOR_DELTA = exports.COLOR_ACTIVE_MIX_PCT = exports.CIELAB_REVERSE_TRANSFORM = exports.CIELAB_FORWARD_TRANSFORM = exports.BLK_THRS = exports.BLK_CLMP = exports.BCO = void 0;
 var _enums = require("../../enums/index.cjs");
-var _utils = require("../../utils/index.cjs");
+var _color = require("../../utils/Commons/color.util.cjs");
 const CSS_COLOR_REGEX = exports.CSS_COLOR_REGEX = /^(?<fn>(?:rgb|hsl)a?)\((?<values>.+)\)/;
 const CSS_NAMED_COLORS = exports.CSS_NAMED_COLORS = /* @__PURE__ */new Set(["aliceblue", "antiquewhite", "aqua", "aquamarine", "azure", "beige", "bisque", "black", "blanchedalmond", "blue", "blueviolet", "brown", "burlywood", "cadetblue", "chartreuse", "chocolate", "coral", "cornflowerblue", "cornsilk", "crimson", "cyan", "darkblue", "darkcyan", "darkgoldenrod", "darkgray", "darkgreen", "darkgrey", "darkkhaki", "darkmagenta", "darkolivegreen", "darkorange", "darkorchid", "darkred", "darksalmon", "darkseagreen", "darkslateblue", "darkslategray", "darkslategrey", "darkturquoise", "darkviolet", "deeppink", "deepskyblue", "dimgray", "dimgrey", "dodgerblue", "firebrick", "floralwhite", "forestgreen", "fuchsia", "gainsboro", "ghostwhite", "gold", "goldenrod", "gray", "green", "greenyellow", "grey", "honeydew", "hotpink", "indianred", "indigo", "ivory", "khaki", "lavender", "lavenderblush", "lawngreen", "lemonchiffon", "lightblue", "lightcoral", "lightcyan", "lightgoldenrodyellow", "lightgray", "lightgreen", "lightgrey", "lightpink", "lightsalmon", "lightseagreen", "lightskyblue", "lightslategray", "lightslategrey", "lightsteelblue", "lightyellow", "lime", "limegreen", "linen", "magenta", "maroon", "mediumaquamarine", "mediumblue", "mediumorchid", "mediumpurple", "mediumseagreen", "mediumslateblue", "mediumspringgreen", "mediumturquoise", "mediumvioletred", "midnightblue", "mintcream", "mistyrose", "moccasin", "navajowhite", "navy", "oldlace", "olive", "olivedrab", "orange", "orangered", "orchid", "palegoldenrod", "palegreen", "paleturquoise", "palevioletred", "papayawhip", "peachpuff", "peru", "pink", "plum", "powderblue", "purple", "rebeccapurple", "red", "rosybrown", "royalblue", "saddlebrown", "salmon", "sandybrown", "seagreen", "seashell", "sienna", "silver", "skyblue", "slateblue", "slategray", "slategrey", "snow", "springgreen", "steelblue", "tan", "teal", "thistle", "tomato", "turquoise", "violet", "wheat", "white", "whitesmoke", "yellow", "yellowgreen",
 // CSS-wide keywords
@@ -23,25 +23,25 @@ const COLOR_MAPPERS = exports.COLOR_MAPPERS = {
     b,
     a
   }),
-  hsl: (h, s, l, a) => (0, _utils.HSLtoRGB)({
+  hsl: (h, s, l, a) => (0, _color.HSLtoRGB)({
     h,
     s,
     l,
     a
   }),
-  hsla: (h, s, l, a) => (0, _utils.HSLtoRGB)({
+  hsla: (h, s, l, a) => (0, _color.HSLtoRGB)({
     h,
     s,
     l,
     a
   }),
-  hsv: (h, s, v, a) => (0, _utils.HSVtoRGB)({
+  hsv: (h, s, v, a) => (0, _color.HSVtoRGB)({
     h,
     s,
     v,
     a
   }),
-  hsva: (h, s, v, a) => (0, _utils.HSVtoRGB)({
+  hsva: (h, s, v, a) => (0, _color.HSVtoRGB)({
     h,
     s,
     v,

package/dist/src/consts/Commons/color.const.js

@@ -1,5 +1,5 @@
 import { INTENT } from "../../enums/index.js";
-import { HSLtoRGB, HSVtoRGB } from "../../utils/index.js";
+import { HSLtoRGB, HSVtoRGB } from "../../utils/Commons/color.util.js";
 export const CSS_COLOR_REGEX = /^(?<fn>(?:rgb|hsl)a?)\((?<values>.+)\)/;
 export const CSS_NAMED_COLORS = /* @__PURE__ */ new Set([
   "aliceblue",

package/dist/src/consts/Commons/commons.const.cjs

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.SUPPORTS_TOUCH = exports.SUPPORTS_INTERSECTION = exports.SUPPORTS_EYE_DROPPER = exports.ON_REGEX = exports.IN_BROWSER = exports.HORIZON = exports.HISTORY = exports.EVENT_PROP = exports.DEFAULT_DOCUMENT = void 0;
+exports.SUPPORTS_TOUCH = exports.SUPPORTS_INTERSECTION = exports.SUPPORTS_EYE_DROPPER = exports.REDUCED_MOTION_QUERY = exports.REDUCED_MOTION_ANIMATION_DURATION = exports.ON_REGEX = exports.NAME_ATTR_TAGS = exports.IN_BROWSER = exports.HORIZON = exports.HISTORY = exports.EVENT_PROP = exports.DEFAULT_DOCUMENT = void 0;
 const IN_BROWSER = exports.IN_BROWSER = typeof window !== "undefined" && typeof document !== "undefined";
 const DEFAULT_DOCUMENT = exports.DEFAULT_DOCUMENT = IN_BROWSER ? window.document : void 0;
 const EVENT_PROP = () => [Function, Array];
@@ -13,4 +13,7 @@ const HORIZON = exports.HORIZON = 100;
 const SUPPORTS_INTERSECTION = exports.SUPPORTS_INTERSECTION = IN_BROWSER && "IntersectionObserver" in window;
 const ON_REGEX = exports.ON_REGEX = /^on[^a-z]/;
 const SUPPORTS_TOUCH = exports.SUPPORTS_TOUCH = IN_BROWSER && ("ontouchstart" in window || window.navigator.maxTouchPoints > 0);
-const SUPPORTS_EYE_DROPPER = exports.SUPPORTS_EYE_DROPPER = IN_BROWSER && "EyeDropper" in window;
+const SUPPORTS_EYE_DROPPER = exports.SUPPORTS_EYE_DROPPER = IN_BROWSER && "EyeDropper" in window;
+const REDUCED_MOTION_QUERY = exports.REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+const REDUCED_MOTION_ANIMATION_DURATION = exports.REDUCED_MOTION_ANIMATION_DURATION = 0.01;
+const NAME_ATTR_TAGS = exports.NAME_ATTR_TAGS = /* @__PURE__ */new Set(["button", "fieldset", "form", "input", "output", "select", "textarea"]);

package/dist/src/consts/Commons/commons.const.d.ts

@@ -1,5 +1,5 @@
 import { PropType } from 'vue';
-import type { TEventProp } from '../../types';
+import type { TEventProp } from '../../types/Commons/commons.type';
 export declare const IN_BROWSER: boolean;
 export declare const DEFAULT_DOCUMENT: Document | undefined;
 export declare const EVENT_PROP: <T extends Array<any> = Array<any>>() => PropType<TEventProp<T>>;
@@ -9,3 +9,41 @@ export declare const SUPPORTS_INTERSECTION: boolean;
 export declare const ON_REGEX: RegExp;
 export declare const SUPPORTS_TOUCH: boolean;
 export declare const SUPPORTS_EYE_DROPPER: boolean;
+/*********************************************************
+ * REDUCED_MOTION_QUERY
+ *
+ * @description
+ * The media query every composable that gates motion behind the
+ * OS-level accessibility setting must pass to `window.matchMedia`.
+ * Kept here rather than re-typed per composable — a typo in the query
+ * string does not throw, it just returns `matches: false` forever, so
+ * the failure mode is motion that silently ignores the user's setting.
+ ********************************************************/
+export declare const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+/*********************************************************
+ * REDUCED_MOTION_ANIMATION_DURATION
+ *
+ * @description
+ * The WAAPI (`el.animate()`) twin of the `0.01ms` duration every
+ * `@include ds.ds-reduced-motion { transition-duration: 0.01ms !important }`
+ * block in the DS's SCSS uses (see `assets/scss/_helpers.scss`). Kept as a
+ * near-zero duration rather than `0` on purpose: `Animation.finished` must
+ * keep resolving so `done()` callbacks in Vue `<transition>` hooks still
+ * fire — skipping `el.animate()` outright (as a naive "respect reduced
+ * motion" fix would) leaves any code awaiting `.finished` hanging forever.
+ ********************************************************/
+export declare const REDUCED_MOTION_ANIMATION_DURATION = 0.01;
+/*********************************************************
+ * NAME_ATTR_TAGS
+ *
+ * @description
+ * The elements the HTML Living Standard allows a `name` content
+ * attribute on. Any other element — `<label>`, `<div>`, `<span>`, … —
+ * only accepts global attributes, so a bound `name` lands in the DOM,
+ * is ignored by the browser, and fails W3C validation on every page
+ * that renders it (issue #458).
+ * @description
+ * Components whose `tag` is consumer-controlled must gate the binding
+ * on this set rather than emitting `name` unconditionally.
+ ********************************************************/
+export declare const NAME_ATTR_TAGS: ReadonlySet<string>;

package/dist/src/consts/Commons/commons.const.js

@@ -7,3 +7,14 @@ export const SUPPORTS_INTERSECTION = IN_BROWSER && "IntersectionObserver" in win
 export const ON_REGEX = /^on[^a-z]/;
 export const SUPPORTS_TOUCH = IN_BROWSER && ("ontouchstart" in window || window.navigator.maxTouchPoints > 0);
 export const SUPPORTS_EYE_DROPPER = IN_BROWSER && "EyeDropper" in window;
+export const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+export const REDUCED_MOTION_ANIMATION_DURATION = 0.01;
+export const NAME_ATTR_TAGS = /* @__PURE__ */ new Set([
+  "button",
+  "fieldset",
+  "form",
+  "input",
+  "output",
+  "select",
+  "textarea"
+]);

package/dist/src/consts/Commons/date.const.d.ts

@@ -1,5 +1,5 @@
 import type { InjectionKey } from "vue";
-import type { IDateInstance, IDateOptions } from "../../interfaces";
+import type { IDateInstance, IDateOptions } from '../../interfaces/Commons/date.interface';
 export declare const ORIGAM_DATE_OPTIONS_KEY: InjectionKey<IDateOptions>;
 export declare const ORIGAM_DATE_ADAPTER_KEY: InjectionKey<IDateInstance>;
 export declare const REGEX_DATE_YYYY_MM_DD: RegExp;

package/dist/src/consts/Commons/defaults.const.d.ts

@@ -1,5 +1,5 @@
 import type { InjectionKey, Ref } from 'vue';
-import type { IDefault } from '../../interfaces';
+import type { IDefault } from '../../interfaces/DefaultsProvider/defaults-provider.interface';
 /**
  * Provide/inject key for the defaults map shared between
  * `<OrigamDefaultsProvider>` and components consuming defaults

package/dist/src/consts/Commons/density.const.d.ts

@@ -1,2 +1,2 @@
-import type { TDensity } from '../../types';
+import type { TDensity } from '../../types/Commons/density.type';
 export declare const PREDEFINED_DENSITY: Array<TDensity>;

package/dist/src/consts/Commons/dimension.const.d.ts

@@ -1,2 +1,2 @@
-import type { TDimensions } from '../../types';
+import type { TDimensions } from '../../types/Commons/dimension.type';
 export declare const DIMENSIONS_ARRAY: Array<TDimensions>;