@forthtilliath/forth-ui 0.3.0 → 0.4.0

package/dist/locale/UiLocaleProvider.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+import { type UiLocale } from "./locale.js";
+export interface UiLocaleProviderProps {
+    locale: UiLocale;
+    children: ReactNode;
+}
+/**
+ * Sets the language of every forth-ui component's built-in labels below it
+ * — for a bilingual site, switch it once here instead of passing `locale` to
+ * each component. A component's own `locale` prop still wins, and its text
+ * props (`placeholder`, `emptyMessage`…) still override individual strings.
+ *
+ * @example
+ * <UiLocaleProvider locale={lang}>
+ *   {children}
+ * </UiLocaleProvider>
+ */
+export declare function UiLocaleProvider({ locale, children }: UiLocaleProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=UiLocaleProvider.d.ts.map

package/dist/locale/UiLocaleProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UiLocaleProvider.d.ts","sourceRoot":"","sources":["../../src/locale/UiLocaleProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAE,KAAK,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAE3E"}

package/dist/locale/UiLocaleProvider.js

@@ -0,0 +1,17 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { UiLocaleContext } from "./locale.js";
+/**
+ * Sets the language of every forth-ui component's built-in labels below it
+ * — for a bilingual site, switch it once here instead of passing `locale` to
+ * each component. A component's own `locale` prop still wins, and its text
+ * props (`placeholder`, `emptyMessage`…) still override individual strings.
+ *
+ * @example
+ * <UiLocaleProvider locale={lang}>
+ *   {children}
+ * </UiLocaleProvider>
+ */
+export function UiLocaleProvider({ locale, children }) {
+    return _jsx(UiLocaleContext, { value: locale, children: children });
+}

package/dist/locale/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./locale.js";
+export * from "./messages.js";
+export * from "./UiLocaleProvider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/locale/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}

package/dist/locale/index.js

@@ -0,0 +1,3 @@
+export * from "./locale.js";
+export * from "./messages.js";
+export * from "./UiLocaleProvider.js";

package/dist/locale/locale.d.ts

@@ -0,0 +1,15 @@
+import { type UiMessages } from "./messages.js";
+/** Languages forth-ui's built-in labels are available in. */
+export type UiLocale = "fr" | "en";
+/** Used when neither a `locale` prop nor a `UiLocaleProvider` sets one. */
+export declare const DEFAULT_UI_LOCALE: UiLocale;
+/** Provided by `UiLocaleProvider`, read by {@link useUiLocale}. */
+export declare const UiLocaleContext: import("react").Context<UiLocale>;
+/**
+ * Resolves the locale a component renders its built-in labels in: its own
+ * `locale` prop, else the nearest `UiLocaleProvider`, else French.
+ */
+export declare function useUiLocale(locale?: UiLocale): UiLocale;
+/** The built-in labels of the resolved locale (see {@link useUiLocale}). */
+export declare function useUiMessages(locale?: UiLocale): UiMessages;
+//# sourceMappingURL=locale.d.ts.map

package/dist/locale/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/locale/locale.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,6DAA6D;AAC7D,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,QAAe,CAAC;AAEhD,mEAAmE;AACnE,eAAO,MAAM,eAAe,mCAA6C,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAGvD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAE3D"}

package/dist/locale/locale.js

@@ -0,0 +1,19 @@
+"use client";
+import { createContext, use } from "react";
+import { UI_MESSAGES } from "./messages.js";
+/** Used when neither a `locale` prop nor a `UiLocaleProvider` sets one. */
+export const DEFAULT_UI_LOCALE = "fr";
+/** Provided by `UiLocaleProvider`, read by {@link useUiLocale}. */
+export const UiLocaleContext = createContext(DEFAULT_UI_LOCALE);
+/**
+ * Resolves the locale a component renders its built-in labels in: its own
+ * `locale` prop, else the nearest `UiLocaleProvider`, else French.
+ */
+export function useUiLocale(locale) {
+    const contextLocale = use(UiLocaleContext);
+    return locale ?? contextLocale;
+}
+/** The built-in labels of the resolved locale (see {@link useUiLocale}). */
+export function useUiMessages(locale) {
+    return UI_MESSAGES[useUiLocale(locale)];
+}

package/dist/locale/messages.d.ts

@@ -0,0 +1,98 @@
+import type { UiLocale } from "./locale.js";
+/** Every built-in label of forth-ui, grouped by component. */
+export interface UiMessages {
+    /** Alert and Banner close button. */
+    dismiss: string;
+    avatar: {
+        online: string;
+        offline: string;
+        away: string;
+        busy: string;
+    };
+    badge: {
+        remove: string;
+    };
+    breadcrumb: {
+        showHidden: string;
+    };
+    codeBlock: {
+        copy: string;
+        copied: string;
+    };
+    colorPicker: {
+        choose: string;
+        hex: string;
+    };
+    /** Combobox and MultiSelect. */
+    combobox: {
+        placeholder: string;
+    };
+    commandPalette: {
+        placeholder: string;
+    };
+    confirmDialog: {
+        cancel: string;
+        confirm: string;
+    };
+    datePicker: {
+        placeholder: string;
+    };
+    dropzone: {
+        removeFile: string;
+    };
+    /** Combobox, MultiSelect and CommandPalette. */
+    emptyResults: string;
+    imageInput: {
+        remove: string;
+    };
+    modeToggle: {
+        toggle: string;
+        light: string;
+        dark: string;
+        system: string;
+    };
+    navbar: {
+        toggleMenu: string;
+        menu: string;
+    };
+    notificationCenter: {
+        title: string;
+        empty: string;
+    };
+    numberInput: {
+        decrement: string;
+        increment: string;
+    };
+    pagination: {
+        first: string;
+        previous: string;
+        previousLabel: string;
+        next: string;
+        nextLabel: string;
+        last: string;
+    };
+    passwordInput: {
+        show: string;
+        hide: string;
+    };
+    qrCode: {
+        label: (value: string) => string;
+    };
+    rating: {
+        stars: (count: number) => string;
+    };
+    snippet: {
+        copy: string;
+        copied: string;
+    };
+    spinner: {
+        loading: string;
+    };
+    tagsInput: {
+        placeholder: string;
+        label: string;
+    };
+}
+/** forth-ui's built-in labels, per locale. */
+export declare const UI_MESSAGES: Record<UiLocale, UiMessages>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/locale/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/locale/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,UAAU,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,gCAAgC;IAChC,QAAQ,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,cAAc,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,aAAa,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,UAAU,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,QAAQ,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,UAAU,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kBAAkB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,WAAW,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAC;IAC7C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,8CAA8C;AAC9C,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,QAAQ,EAAE,UAAU,CAiGpD,CAAC"}

package/dist/locale/messages.js

@@ -0,0 +1,99 @@
+/** forth-ui's built-in labels, per locale. */
+export const UI_MESSAGES = {
+    fr: {
+        dismiss: "Fermer",
+        avatar: {
+            online: "En ligne",
+            offline: "Hors ligne",
+            away: "Absent",
+            busy: "Occupé",
+        },
+        badge: { remove: "Retirer" },
+        breadcrumb: { showHidden: "Afficher les éléments masqués du fil d'Ariane" },
+        codeBlock: { copy: "Copier le code", copied: "Copié" },
+        colorPicker: { choose: "Choisir une couleur", hex: "Code hexadécimal" },
+        combobox: { placeholder: "Sélectionner…" },
+        commandPalette: { placeholder: "Saisir une commande ou rechercher…" },
+        confirmDialog: { cancel: "Annuler", confirm: "Continuer" },
+        datePicker: { placeholder: "Choisir une date" },
+        dropzone: { removeFile: "Retirer le fichier" },
+        emptyResults: "Aucun résultat.",
+        imageInput: { remove: "Supprimer l'image" },
+        modeToggle: {
+            toggle: "Changer de thème",
+            light: "Clair",
+            dark: "Sombre",
+            system: "Système",
+        },
+        navbar: { toggleMenu: "Afficher ou masquer le menu", menu: "Menu" },
+        notificationCenter: {
+            title: "Notifications",
+            empty: "Aucune notification",
+        },
+        numberInput: { decrement: "Diminuer", increment: "Augmenter" },
+        pagination: {
+            first: "Aller à la première page",
+            previous: "Précédent",
+            previousLabel: "Aller à la page précédente",
+            next: "Suivant",
+            nextLabel: "Aller à la page suivante",
+            last: "Aller à la dernière page",
+        },
+        passwordInput: {
+            show: "Afficher le mot de passe",
+            hide: "Masquer le mot de passe",
+        },
+        qrCode: { label: (value) => `QR code : ${value}` },
+        rating: {
+            stars: (count) => `${count.toString()} étoile${count > 1 ? "s" : ""}`,
+        },
+        snippet: { copy: "Copier", copied: "Copié" },
+        spinner: { loading: "Chargement" },
+        tagsInput: { placeholder: "Ajouter un tag…", label: "Ajouter un tag" },
+    },
+    en: {
+        dismiss: "Dismiss",
+        avatar: {
+            online: "Online",
+            offline: "Offline",
+            away: "Away",
+            busy: "Busy",
+        },
+        badge: { remove: "Dismiss" },
+        breadcrumb: { showHidden: "Show hidden breadcrumb items" },
+        codeBlock: { copy: "Copy code", copied: "Copied" },
+        colorPicker: { choose: "Choose color", hex: "Hex color code" },
+        combobox: { placeholder: "Select…" },
+        commandPalette: { placeholder: "Type a command or search…" },
+        confirmDialog: { cancel: "Cancel", confirm: "Continue" },
+        datePicker: { placeholder: "Pick a date" },
+        dropzone: { removeFile: "Remove file" },
+        emptyResults: "No results found.",
+        imageInput: { remove: "Remove image" },
+        modeToggle: {
+            toggle: "Toggle theme",
+            light: "Light",
+            dark: "Dark",
+            system: "System",
+        },
+        navbar: { toggleMenu: "Toggle menu", menu: "Menu" },
+        notificationCenter: { title: "Notifications", empty: "No notifications" },
+        numberInput: { decrement: "Decrement", increment: "Increment" },
+        pagination: {
+            first: "Go to first page",
+            previous: "Previous",
+            previousLabel: "Go to previous page",
+            next: "Next",
+            nextLabel: "Go to next page",
+            last: "Go to last page",
+        },
+        passwordInput: { show: "Show password", hide: "Hide password" },
+        qrCode: { label: (value) => `QR code encoding: ${value}` },
+        rating: {
+            stars: (count) => `${count.toString()} star${count > 1 ? "s" : ""}`,
+        },
+        snippet: { copy: "Copy", copied: "Copied" },
+        spinner: { loading: "Loading" },
+        tagsInput: { placeholder: "Add tag…", label: "Add a tag" },
+    },
+};

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@forthtilliath/forth-ui",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
+  "sideEffects": [
+    "*.css"
+  ],
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -24,15 +27,25 @@
     "clsx": "^2.1.1",
     "lucide-react": "^1.31.0",
     "qrcode": "^1.5.4",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8",
     "shiki": "^4.4.3",
-    "@forthtilliath/react-kit": "0.4.0",
-    "@forthtilliath/shadcn-ui": "0.2.0"
+    "@forthtilliath/react-kit": "^0.5.0",
+    "@forthtilliath/shadcn-ui": "^0.3.0",
+    "@forthtilliath/ts-types": "^0.3.0"
+  },
+  "peerDependencies": {
+    "next-themes": ">=0.4",
+    "react": ">=19",
+    "react-dom": ">=19"
+  },
+  "peerDependenciesMeta": {
+    "next-themes": {
+      "optional": true
+    }
   },
   "devDependencies": {
-    "@size-limit/file": "^11.2.0",
-    "@tailwindcss/postcss": "4.1.12",
+    "@size-limit/file": "^14.1.0",
+    "@tailwindcss/cli": "4.3.3",
+    "@tailwindcss/postcss": "4.3.3",
     "@turbo/gen": "^2.10.9",
     "@types/node": "^26.2.0",
     "@types/qrcode": "^1.5.6",
@@ -40,18 +53,21 @@
     "@types/react-dom": "^19.2.4",
     "concurrently": "^10.0.4",
     "eslint": "10.7.0",
-    "size-limit": "^11.2.0",
-    "tailwindcss": "4.1.12",
+    "next-themes": "^0.4.6",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "size-limit": "^14.1.0",
+    "tailwindcss": "4.3.3",
     "typescript": "^5.9.3",
-    "@forthtilliath/ts-types": "0.2.0",
     "@forthtilliath/typescript-config": "0.1.1",
-    "@forthtilliath/eslint-config": "0.7.0"
+    "@forthtilliath/eslint-config": "0.8.0"
   },
   "files": [
     "dist"
   ],
   "exports": {
     "./components/*": "./dist/components/*/index.js",
+    "./locale": "./dist/locale/index.js",
     "./styles/globals.css": "./dist/globals.css"
   },
   "size-limit": [
@@ -67,15 +83,15 @@
     }
   ],
   "scripts": {
-    "lint": "eslint . --max-warnings 0",
+    "lint": "eslint . --max-warnings 0 && node scripts/check-css-sources.js",
     "check-types": "tsc --noEmit",
-    "clean": "rm -rf dist",
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
     "dev": "concurrently \"pnpm:dev:ts\" \"pnpm:dev:tw\"",
     "dev:ts": "tsc --watch",
     "dev:tw": "pnpm run build:tw --watch",
     "build": "pnpm run clean && pnpm run build:ts && pnpm run build:tw",
     "build:ts": "tsc",
-    "build:tw": "npx @tailwindcss/cli -i ./src/styles/globals.css -o ./dist/globals.css",
+    "build:tw": "tailwindcss -i ./src/styles/globals.css -o ./dist/globals.css",
     "size": "size-limit"
   }
 }