@pipelex/mthds-form 0.12.1 → 0.13.0

package/README.md

@@ -58,6 +58,14 @@ Submitting goes through the gate: `buildRunInputsSchema` → `prepareRunInputs`
 
 A file field (`document` or `image`) carries `formats`, the formats its slot accepts, and the control's hint, file-picker filter and check all read that one list. A host whose upload path takes fewer types narrows the whole tree once with `narrowFileFormats(fields, mimeTypes)` and has its server check uploads against the same list. [docs/upload-seam.md](docs/upload-seam.md) is everything a file control and its host owe each other.
 
+The controls' own copy comes through `FieldStringsProvider`: `locale` picks a language pack (`fr`, `fr-FR`, `en`…, English when unknown) and `strings` overrides single keys on top. The field labels, helper lines and enum choices come from the method's own names and descriptions, never from the host:
+
+```tsx
+<FieldStringsProvider locale="fr">{/* the form over buildRunFields(form, contract) */}</FieldStringsProvider>
+```
+
+[docs/i18n.md](docs/i18n.md) has the language packs and the locale switch.
+
 ## Theming
 
 The controls carry Tailwind classes over the standard shadcn/ui semantic tokens (`--background`, `--input`, `--border`, `--primary`, …). A host that already defines those tokens gets controls that match its product with no configuration. A host with no Tailwind build loads the prebuilt `@pipelex/mthds-form/styles.css`. Both paths, and the exact token list, are in [docs/theming.md](docs/theming.md).
@@ -71,6 +79,7 @@ The controls carry Tailwind classes over the standard shadcn/ui semantic tokens
 | [docs/theming.md](docs/theming.md) | the token contract and host setup |
 | [docs/wire-correspondence.md](docs/wire-correspondence.md) | the name-for-name wire ↔ `RunField` mapping |
 | [docs/upload-seam.md](docs/upload-seam.md) | what a file control and its host owe each other: accepted formats and narrowing them, write-back paths, previews, the file card |
+| [docs/i18n.md](docs/i18n.md) | wording a form for its reader: the controls' strings, the French set and the locale switch |
 | [docs/derivation-swap.md](docs/derivation-swap.md) | the record of the swap to the wire descriptor — what changed, what survived |
 
 ## Development

package/dist/{chunk-2D4NEFUH.js → chunk-D2EQVWGN.js}

@@ -3,7 +3,7 @@ import { readStuffFile } from './chunk-RRTI7AIR.js';
 import { viewableUrl, isNativeDateNode, isNativeHtmlNode, readHtmlContent, isNativeCompositeNode, readCompositeContent, isNativeValueNode, readDateContent, formatDateContent, readImageContent, readDataUrl, readDocumentContent } from './chunk-CM4KVG53.js';
 import { conceptCategory } from './chunk-FABY3DEY.js';
 import { acceptLabel, acceptMap, isAcceptedFile, formatOfFilename, DOCUMENT_FORMATS, IMAGE_FORMATS } from './chunk-XCO6GTEC.js';
-import { isFilled } from './chunk-PM55AHRO.js';
+import { shownAsOptional, isFilled } from './chunk-MJQ7CXUB.js';
 import { toStoredDateValue, toDateInputValue } from './chunk-GKV77RAS.js';
 import { ownProp } from './chunk-V3OV2XQT.js';
 import { clsx } from 'clsx';
@@ -181,12 +181,14 @@ function BooleanField({ field, value, onChange, id, disabled }) {
     }
   );
 }
+
+// src/react/locales/en.ts
 function formatBytes(bytes) {
   if (bytes < 1024) return bytes === 1 ? "1 byte" : `${bytes} bytes`;
   if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;
   return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
-var DEFAULT_FIELD_STRINGS = {
+var EN_FIELD_STRINGS = {
   optionalBadge: "optional",
   selectPlaceholder: "Select\u2026",
   typeValuePlaceholder: "Type a value\u2026",
@@ -237,12 +239,100 @@ var DEFAULT_FIELD_STRINGS = {
   optionalFieldsCount: (count) => count === 1 ? "1 optional field" : `${count} optional fields`,
   optionalInputsCount: (count) => count === 1 ? "1 optional input" : `${count} optional inputs`
 };
+
+// src/react/locales/fr.ts
+var PLURALS = new Intl.PluralRules("fr");
+var BYTES = new Intl.NumberFormat("fr-FR", { style: "unit", unit: "byte", unitDisplay: "long" });
+var KILOBYTES = new Intl.NumberFormat("fr-FR", {
+  style: "unit",
+  unit: "kilobyte",
+  unitDisplay: "short",
+  maximumFractionDigits: 0
+});
+var MEGABYTES = new Intl.NumberFormat("fr-FR", {
+  style: "unit",
+  unit: "megabyte",
+  unitDisplay: "short",
+  maximumFractionDigits: 1
+});
+function plural(count, one, other) {
+  return PLURALS.select(count) === "one" ? one : other;
+}
+function formatBytes2(bytes) {
+  if (bytes < 1024) return BYTES.format(bytes);
+  if (bytes < 1024 * 1024) return KILOBYTES.format(bytes / 1024);
+  return MEGABYTES.format(bytes / (1024 * 1024));
+}
+var FR_FIELD_STRINGS = {
+  optionalBadge: "facultatif",
+  selectPlaceholder: "Choisir\u2026",
+  typeValuePlaceholder: "Saisissez une valeur\u2026",
+  writeHerePlaceholder: "\xC9crivez ici\u2026",
+  jsonHint: "Saisissez cette valeur en JSON brut.",
+  decrease: "Diminuer",
+  increase: "Augmenter",
+  noItemsYet: "Aucun \xE9l\xE9ment pour le moment",
+  addItem: "Ajouter un \xE9l\xE9ment",
+  removeItemAria: (index) => `Supprimer l\u2019\xE9l\xE9ment ${index}`,
+  itemsCount: (count) => `${count} ${plural(count, "\xE9l\xE9ment", "\xE9l\xE9ments")}`,
+  itemsCountOf: (count, total) => `${count} sur ${total} ${plural(total, "\xE9l\xE9ment", "\xE9l\xE9ments")}`,
+  fieldsCount: (count) => `${count} ${plural(count, "champ", "champs")}`,
+  uploading: "Envoi en cours\u2026",
+  dropToUpload: "D\xE9posez pour envoyer",
+  dropOrBrowse: "D\xE9posez un fichier ou cliquez pour parcourir",
+  pasteUrlInstead: "coller un lien \xE0 la place",
+  uploadUnavailable: "Impossible d\u2019envoyer un fichier ici. Collez plut\xF4t un lien vers le fichier.",
+  urlPlaceholder: "https://\u2026",
+  fileUrlAria: (label) => label ? `Lien vers le fichier pour ${label}` : "Lien vers le fichier",
+  uploadedFile: "Fichier joint",
+  encodedFileSummary: (format, bytes) => `${format} \xB7 ${formatBytes2(bytes)}`,
+  preview: "Aper\xE7u",
+  removeFileAria: "Retirer le fichier",
+  previewUnavailablePdf: "Aper\xE7u indisponible - ouvrez le fichier pour le consulter.",
+  // U+002D HYPHEN-MINUS, as in the English defaults.
+  resultAbsent: "-",
+  resultAbsentDescription: "Non renseign\xE9",
+  resultUndescribed: "Aucun descripteur de sortie pour ce pipe \u2014 affichage de la valeur brute.",
+  toggleRowDetails: (index) => `Afficher ou masquer le d\xE9tail de la ligne ${index}`,
+  rowDetailsColumn: "D\xE9tail",
+  copyUrl: "Copier le lien",
+  copyText: "Copier le texte",
+  download: "T\xE9l\xE9charger",
+  downloading: "T\xE9l\xE9chargement\u2026",
+  downloadIncomplete: (names) => `${names.length <= 1 ? "Un fichier n\u2019a pas pu \xEAtre enregistr\xE9" : `${names.length} fichiers n\u2019ont pas pu \xEAtre enregistr\xE9s`}\xA0: ${names.join(", ")}`,
+  downloadFile: (name) => `T\xE9l\xE9charger ${name}`,
+  downloadFileFailed: "Le fichier n\u2019a pas pu \xEAtre enregistr\xE9",
+  viewRendered: "R\xE9sultat",
+  viewJson: "JSON",
+  copyJson: "Copier le JSON",
+  resultViewGroup: "Affichage du r\xE9sultat",
+  yes: "Oui",
+  no: "Non",
+  unsupportedFileType: (formats) => `Ce type de fichier n\u2019est pas pris en charge. Formats accept\xE9s\xA0: ${formats}.`,
+  hideOptionalFields: "Masquer les champs facultatifs",
+  hideOptionalInputs: "Masquer les entr\xE9es facultatives",
+  optionalFieldsCount: (count) => `${count} ${plural(count, "champ facultatif", "champs facultatifs")}`,
+  optionalInputsCount: (count) => `${count} ${plural(count, "entr\xE9e facultative", "entr\xE9es facultatives")}`
+};
+
+// src/react/locales/index.ts
+var FIELD_STRINGS_BY_LOCALE = {
+  en: EN_FIELD_STRINGS,
+  fr: FR_FIELD_STRINGS
+};
+var SUPPORTED_LOCALES = Object.keys(FIELD_STRINGS_BY_LOCALE);
+function fieldStringsFor(locale) {
+  const language = (locale ?? "").trim().toLowerCase().split(/[-_]/)[0] ?? "";
+  return FIELD_STRINGS_BY_LOCALE[language] ?? EN_FIELD_STRINGS;
+}
+var DEFAULT_FIELD_STRINGS = EN_FIELD_STRINGS;
 var FieldStringsContext = createContext(DEFAULT_FIELD_STRINGS);
 function FieldStringsProvider({
+  locale,
   strings,
   children
 }) {
-  const merged = useMemo(() => ({ ...DEFAULT_FIELD_STRINGS, ...strings }), [strings]);
+  const merged = useMemo(() => ({ ...fieldStringsFor(locale), ...strings }), [locale, strings]);
   return /* @__PURE__ */ jsx(FieldStringsContext.Provider, { value: merged, children });
 }
 function useFieldStrings() {
@@ -315,7 +405,7 @@ function DateField({ field, value, onChange, id, error, disabled }) {
       conceptRef: field.conceptRef,
       category: "date",
       description: field.description,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: domId,
       children: /* @__PURE__ */ jsx(
@@ -511,7 +601,7 @@ function FileField({
       conceptRef: field.conceptRef,
       category,
       description: field.description,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: domId,
       children: [
@@ -903,7 +993,7 @@ function EnumField({ field, value, onChange, id, error, disabled }) {
       conceptRef: field.conceptRef,
       category: "choice",
       description: field.description,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: isSegmented ? void 0 : domId,
       children: isSegmented ? (
@@ -972,7 +1062,7 @@ function NumberField({ field, value, onChange, id, error, disabled }) {
       conceptRef: field.conceptRef,
       category: "number",
       description: field.description ?? rangeHint,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: domId,
       children: /* @__PURE__ */ jsxs("div", { className: "flex items-stretch gap-1.5", children: [
@@ -1034,7 +1124,7 @@ function TextField({ field, value, onChange, id, error, disabled }) {
       conceptRef: field.conceptRef,
       category: "text",
       description: field.description,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: domId,
       children: /* @__PURE__ */ jsx(
@@ -1064,7 +1154,7 @@ function ProseField({ field, value, onChange, id, error, disabled }) {
       conceptRef: field.conceptRef,
       category: "text",
       description: field.description,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: domId,
       children: /* @__PURE__ */ jsx(
@@ -1108,8 +1198,10 @@ function ObjectField({ field, value, onChange, id, error, env }) {
   const isApp = presentation === "app";
   const data = value ?? {};
   const setChild = (name, childValue) => onChange({ ...data, [name]: childValue });
-  const optionalEmpty = field.fields.filter((f) => !f.required && !isFilled(ownProp(data, f.name)));
-  const visible = showOptional ? field.fields : field.fields.filter((f) => f.required || isFilled(ownProp(data, f.name)));
+  const optionalEmpty = field.fields.filter(
+    (f) => shownAsOptional(f) && !isFilled(ownProp(data, f.name))
+  );
+  const visible = showOptional ? field.fields : field.fields.filter((f) => !shownAsOptional(f) || isFilled(ownProp(data, f.name)));
   return /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
     /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-baseline gap-x-2 gap-y-1", children: [
       /* @__PURE__ */ jsx(
@@ -1123,7 +1215,7 @@ function ObjectField({ field, value, onChange, id, error, env }) {
         }
       ),
       !isApp && /* @__PURE__ */ jsx(ConceptPill, { conceptRef: field.conceptRef, category: "structured" }),
-      !field.required && /* @__PURE__ */ jsx("span", { className: "ml-auto font-mono text-[10px] uppercase tracking-wider text-muted-foreground", children: s.optionalBadge })
+      shownAsOptional(field) && /* @__PURE__ */ jsx("span", { className: "ml-auto font-mono text-[10px] uppercase tracking-wider text-muted-foreground", children: s.optionalBadge })
     ] }),
     field.description && /* @__PURE__ */ jsx("p", { className: "text-[12px] leading-relaxed text-muted-foreground", children: field.description }),
     /* @__PURE__ */ jsxs(
@@ -1223,7 +1315,7 @@ function ListField({ field, value, onChange, id, error, env }) {
       ),
       !isApp && /* @__PURE__ */ jsx(ConceptPill, { conceptRef: field.conceptRef, category: "list" }),
       /* @__PURE__ */ jsx("span", { className: "font-mono text-[10.5px] text-muted-foreground", children: field.itemCount !== void 0 && field.maxItemCount === field.itemCount ? s.itemsCountOf(items.length, field.itemCount) : s.itemsCount(items.length) }),
-      !field.required && /* @__PURE__ */ jsx("span", { className: "ml-auto font-mono text-[10px] uppercase tracking-wider text-muted-foreground", children: s.optionalBadge })
+      shownAsOptional(field) && /* @__PURE__ */ jsx("span", { className: "ml-auto font-mono text-[10px] uppercase tracking-wider text-muted-foreground", children: s.optionalBadge })
     ] }),
     field.description && /* @__PURE__ */ jsx("p", { className: "text-[12px] leading-relaxed text-muted-foreground", children: field.description }),
     /* @__PURE__ */ jsxs("div", { className: "space-y-2", children: [
@@ -1341,7 +1433,7 @@ function UnknownField({ field, value, onChange, id, error, disabled }) {
       conceptRef: field.conceptRef,
       category: "structured",
       description: field.description ?? s.jsonHint,
-      required: field.required,
+      required: !shownAsOptional(field),
       error,
       htmlFor: domId,
       children: /* @__PURE__ */ jsx(
@@ -3127,6 +3219,6 @@ function StuffPanel({
   ] });
 }
 
-export { BooleanField, ConceptPill, DEFAULT_FIELD_STRINGS, DateField, DocumentField, EnumField, FieldDomIdProvider, FieldPresentationProvider, FieldRenderer, FieldShell, FieldStringsProvider, HtmlPreview, ImageField, JsonView, ListField, Markdown, NumberField, ObjectField, OptionalToggle, ProseField, ResultEnvProvider, ResultField, ResultRoot, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, StuffViewer, Switch, TextField, ToggleGroup, ToggleGroupItem, UnknownField, cn, fieldControlClass, humanizeFieldName, saveInBrowser, useFieldDomId, useFieldPresentation, useFieldStrings, useProseImages, useResolveShareUrl, useResolveUrl, useResolvedUrl };
-//# sourceMappingURL=chunk-2D4NEFUH.js.map
-//# sourceMappingURL=chunk-2D4NEFUH.js.map
+export { BooleanField, ConceptPill, DEFAULT_FIELD_STRINGS, DateField, DocumentField, EN_FIELD_STRINGS, EnumField, FIELD_STRINGS_BY_LOCALE, FR_FIELD_STRINGS, FieldDomIdProvider, FieldPresentationProvider, FieldRenderer, FieldShell, FieldStringsProvider, HtmlPreview, ImageField, JsonView, ListField, Markdown, NumberField, ObjectField, OptionalToggle, ProseField, ResultEnvProvider, ResultField, ResultRoot, SUPPORTED_LOCALES, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, StuffViewer, Switch, TextField, ToggleGroup, ToggleGroupItem, UnknownField, cn, fieldControlClass, fieldStringsFor, humanizeFieldName, saveInBrowser, useFieldDomId, useFieldPresentation, useFieldStrings, useProseImages, useResolveShareUrl, useResolveUrl, useResolvedUrl };
+//# sourceMappingURL=chunk-D2EQVWGN.js.map
+//# sourceMappingURL=chunk-D2EQVWGN.js.map