@surgeui/ds-vue 2.2.0 → 3.0.0

package/dist/composables/useLocale.d.ts

@@ -0,0 +1,33 @@
+import { ComputedRef, InjectionKey, MaybeRefOrGetter } from 'vue';
+import { LocaleMessage, MessageKey, MessageParams, SurgeLocale, SurgeLocaleInput } from '../locales/types';
+export declare const LocaleKey: InjectionKey<ComputedRef<SurgeLocale>>;
+/**
+ * Complète une locale de base avec des messages partiels.
+ * @example defineLocale(en, { messages: { selectBox: { placeholder: 'Pick one…' } } })
+ */
+export declare function defineLocale(base: SurgeLocale, overrides?: SurgeLocaleInput | SurgeLocale): SurgeLocale;
+/** Met en forme un message : forme plurielle selon `count`, puis paramètres `{nom}` */
+export declare function formatMessage(message: LocaleMessage, params?: MessageParams, code?: string): string;
+/**
+ * Fournit une locale à un sous-arbre de composants. Les messages partiels
+ * complètent la locale du parent (ou le français).
+ *
+ * @example
+ * // Dans le composant racine : la langue suit l'état de l'application
+ * provideLocale(() => (lang.value === 'en' ? en : fr))
+ */
+export declare function provideLocale(locale: MaybeRefOrGetter<SurgeLocale | SurgeLocaleInput>): ComputedRef<SurgeLocale>;
+/**
+ * Accès aux textes de la locale courante.
+ *
+ * @example
+ * const { t } = useLocale()
+ * const label = computed(() => props.clearLabel ?? t('selectBox.clear'))
+ * t('fileUpload.selectedCount', { count: 3 }) // « 3 fichiers sélectionnés »
+ */
+export declare function useLocale(): {
+    locale: ComputedRef<SurgeLocale>;
+    t: (key: MessageKey, params?: MessageParams) => string;
+    formatBytes: (bytes: number) => string;
+};
+//# sourceMappingURL=useLocale.d.ts.map

package/dist/composables/useLocale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocale.d.ts","sourceRoot":"","sources":["../../src/composables/useLocale.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,KAAK,CAAA;AAEZ,OAAO,KAAK,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,WAAW,EACX,gBAAgB,EAEjB,MAAM,iBAAiB,CAAA;AAUxB,eAAO,MAAM,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,WAAW,CAAC,CAAyB,CAAA;AAEtF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,gBAAgB,GAAG,WAAW,GAAG,WAAW,CAUvG;AAiBD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,GAAE,aAAkB,EAAE,IAAI,SAAO,GAAG,MAAM,CAcrG;AAOD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,WAAW,GAAG,gBAAgB,CAAC,4BAKrF;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS;;aAKP,UAAU,WAAW,aAAa,KAAG,MAAM;yBAM/B,MAAM,KAAG,MAAM;EAoB5C"}

package/dist/composables/usePrice.d.ts

@@ -0,0 +1,85 @@
+import { Ref } from 'vue';
+import { CurrencyDisplay } from '../types';
+export interface UsePriceOptions {
+    /** Montant numérique. Accepte un ref, un getter, ou un nombre statique. */
+    amount: number | Ref<number> | (() => number);
+    /** Code devise ISO 4217 (ex: 'EUR', 'USD', 'GBP'). Défaut: 'EUR' */
+    currency?: string;
+    /** Locale BCP 47 (ex: 'fr-FR', 'en-US'). Défaut: 'fr-FR' */
+    locale?: string;
+    /** Affichage de la devise. Défaut: 'symbol' */
+    currencyDisplay?: CurrencyDisplay;
+    /** Nombre minimum de chiffres décimaux. Défaut: 2 */
+    minimumFractionDigits?: number;
+    /** Nombre maximum de chiffres décimaux. Défaut: 2 */
+    maximumFractionDigits?: number;
+    /**
+     * Formatter personnalisé. Quand fourni, remplace Intl.NumberFormat.
+     * Utile pour des formats spéciaux ("Gratuit", "Sur devis", etc.)
+     */
+    formatValue?: (amount: number, currency: string, locale: string) => string;
+}
+export interface UsePriceReturn {
+    /** Prix formaté complet (ex: "1 299,99 €") */
+    formatted: Readonly<Ref<string>>;
+    /** Partie entière uniquement (ex: "1 299") */
+    integerPart: Readonly<Ref<string>>;
+    /** Partie décimale sans séparateur (ex: "99") */
+    decimalPart: Readonly<Ref<string>>;
+    /** Séparateur décimal de la locale (ex: "," pour fr-FR) */
+    decimalSeparator: Readonly<Ref<string>>;
+    /** Symbole de la devise (ex: "€", "$", "£") */
+    currencySymbol: Readonly<Ref<string>>;
+    /** true si le symbole est positionné avant le montant */
+    isSymbolPrefix: Readonly<Ref<boolean>>;
+    /** Texte accessible pour les lecteurs d'écran (ex: "1 299,99 euros") */
+    ariaLabel: Readonly<Ref<string>>;
+    /** Montant numérique brut résolu */
+    rawAmount: Readonly<Ref<number>>;
+}
+/**
+ * Composable pour le formatage réactif des prix.
+ *
+ * Utilise `Intl.NumberFormat` pour un formatage correct selon
+ * la locale et la devise. Expose les différentes parties du prix
+ * pour un rendu flexible dans les composants.
+ *
+ * Compatible SSR — `Intl.NumberFormat` est disponible dans Node.js.
+ *
+ * @example
+ * ```ts
+ * const { formatted, integerPart, decimalPart, currencySymbol } = usePrice({
+ *   amount: 1299.99,
+ *   currency: 'EUR',
+ *   locale: 'fr-FR',
+ * })
+ *
+ * formatted.value      // "1 299,99 €"
+ * integerPart.value    // "1 299"
+ * decimalPart.value    // "99"
+ * currencySymbol.value // "€"
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Avec un ref réactif
+ * const amount = ref(49.99)
+ * const { formatted } = usePrice({ amount })
+ *
+ * amount.value = 29.99
+ * formatted.value // "29,99 €"
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Avec formatter personnalisé
+ * const { formatted } = usePrice({
+ *   amount: 0,
+ *   formatValue: (amt) => amt === 0 ? 'Gratuit' : `${amt} €`,
+ * })
+ *
+ * formatted.value // "Gratuit"
+ * ```
+ */
+export declare function usePrice(options: UsePriceOptions): UsePriceReturn;
+//# sourceMappingURL=usePrice.d.ts.map

package/dist/composables/usePrice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrice.d.ts","sourceRoot":"","sources":["../../src/composables/usePrice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAElD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAM9C,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAC7C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,qDAAqD;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,qDAAqD;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3E;AAED,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAChC,8CAA8C;IAC9C,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,iDAAiD;IACjD,WAAW,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAClC,2DAA2D;IAC3D,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACvC,+CAA+C;IAC/C,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACrC,yDAAyD;IACzD,cAAc,EAAE,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACtC,wEAAwE;IACxE,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAChC,oCAAoC;IACpC,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;CACjC;AAmKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA4GjE"}

package/dist/composables/useTheme.d.ts

@@ -5,10 +5,10 @@ export declare function useTheme(options?: UseThemeOptions): {
     contrastMode: import('vue').Ref<ContrastMode, ContrastMode>;
     motionMode: import('vue').Ref<MotionMode, MotionMode>;
     effectiveTheme: import('vue').ComputedRef<ThemeName>;
-    effectiveThemeMode: import('vue').ComputedRef<"dark" | "light">;
+    effectiveThemeMode: import('vue').ComputedRef<"light" | "dark">;
     effectiveContrast: import('vue').ComputedRef<"normal" | "high">;
     effectiveMotion: import('vue').ComputedRef<"reduce" | "normal">;
-    systemTheme: import('vue').ComputedRef<"dark" | "light">;
+    systemTheme: import('vue').ComputedRef<"light" | "dark">;
     systemContrast: import('vue').ComputedRef<"normal" | "high">;
     systemMotion: import('vue').ComputedRef<"reduce" | "normal">;
     currentThemeMetadata: import('vue').ComputedRef<ThemeMetadata>;

package/dist/composables/useTypeahead.d.ts

@@ -0,0 +1,17 @@
+import { MaybeRefOrGetter } from 'vue';
+export interface TypeaheadOptions<T> {
+    items: MaybeRefOrGetter<readonly T[]>;
+    /** Texte comparé au préfixe saisi */
+    getLabel: (item: T) => string;
+    /** Éléments ignorés */
+    isDisabled?: (item: T, index: number) => boolean;
+    /** Délai d'inactivité qui remet le préfixe à zéro (ms) */
+    timeout?: number;
+}
+export declare function useTypeahead<T>(options: TypeaheadOptions<T>): {
+    search: (char: string, fromIndex: number) => number;
+    reset: () => void;
+    /** Une saisie est en cours (Espace complète alors le préfixe) */
+    isTyping: () => boolean;
+};
+//# sourceMappingURL=useTypeahead.d.ts.map

package/dist/composables/useTypeahead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTypeahead.d.ts","sourceRoot":"","sources":["../../src/composables/useTypeahead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAUzF,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,KAAK,EAAE,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;IACrC,qCAAqC;IACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;IAC7B,uBAAuB;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IAChD,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;mBAepC,MAAM,aAAa,MAAM,KAAG,MAAM;;IA6BtD,iEAAiE;;EAGpE"}

package/dist/composables/useUniqueId.d.ts

@@ -1,5 +1,9 @@
 /**
  * Composable pour générer des IDs uniques
+ *
+ * Dans un composant, préférer `useId()` de Vue (3.5+) : il produit le même ID
+ * côté serveur et côté client. Ce compteur reste disponible hors composant ;
+ * il est déterministe (pas d'horodatage) pour limiter les écarts d'hydratation.
  */
 export declare function useUniqueId(prefix?: string): string;
 //# sourceMappingURL=useUniqueId.d.ts.map

package/dist/composables/useUniqueId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useUniqueId.d.ts","sourceRoot":"","sources":["../../src/composables/useUniqueId.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAa,GAAG,MAAM,CAEzD"}
+{"version":3,"file":"useUniqueId.d.ts","sourceRoot":"","sources":["../../src/composables/useUniqueId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wBAAgB,WAAW,CAAC,MAAM,GAAE,MAAa,GAAG,MAAM,CAEzD"}

package/dist/{index-B5DNZRyd.js → index-DxsqHbLv.js}

@@ -1,5 +1,5 @@
 import { createElementBlock as o, openBlock as n, createElementVNode as r } from "vue";
-import { r as Wr, a as Xr, b as Qr, c as Kr, d as Yr, e as Jr, f as ro, g as oo, i as no, h as eo, j as to, k as ao, l as io, m as co } from "./index-B3HEnZbh.js";
+import { r as Wr, a as Xr, b as Qr, c as Kr, d as Yr, e as Jr, f as ro, g as oo, i as no, h as eo, j as to, k as ao, l as io, m as co } from "./index-n-LN9d8r.js";
 function i(e, t) {
   return n(), o("svg", {
     xmlns: "http://www.w3.org/2000/svg",