@12-apps/ui 6.8.0 → 6.10.0

package/src/en-US.form.ts

@@ -0,0 +1,103 @@
+/**
+ * The en-US pack for the form family. Split the same way `pt-BR.form.ts` is —
+ * see `en-US.ts` for why.
+ */
+import type {
+  AddressAutocompleteCopy,
+  AutocompleteCopy,
+  CodeEditorCopy,
+  PasswordStrengthCopy,
+  PhoneInputCopy,
+  RichEditorToolbarCopy,
+  UploadButtonCopy,
+} from './copy';
+
+export const EN_US_ADDRESS_AUTOCOMPLETE_COPY: AddressAutocompleteCopy = {
+  loadingMaps: "Loading Google Maps…",
+  mapsLoadFailed:
+    "Could not load the Google Maps API. Check the API key and the internet connection.",
+  useCurrentLocation: "Use my current location",
+};
+
+export const EN_US_AUTOCOMPLETE_COPY: AutocompleteCopy = {
+  loading: "Loading…",
+  noResults: "No results found",
+  placeholder: "Type to search…",
+};
+
+export const EN_US_CODE_EDITOR_COPY: CodeEditorCopy = {
+  loading: "Loading the editor…",
+  readOnly: "Read only",
+  // The shortcut is the editor's own binding and is not translated — it is what
+  // the reader must press, not something they read.
+  formatCode: "Format code (Ctrl+Shift+F)",
+  enableWrap: "Wrap lines",
+  disableWrap: "Do not wrap lines",
+  copyToClipboard: "Copy to clipboard",
+  copied: "Copied!",
+  enterFullscreen: "Full screen",
+  exitFullscreen: "Leave full screen",
+};
+
+export const EN_US_PASSWORD_STRENGTH_COPY: PasswordStrengthCopy = {
+  strengthHeading: "Password strength",
+  requirementsHeading: "Requirements:",
+  suggestionsHeading: "Suggestions:",
+  bands: {
+    veryWeak: "Very weak",
+    weak: "Weak",
+    fair: "Fair",
+    good: "Good",
+    strong: "Strong",
+  },
+  requirements: {
+    // The count is the HOST's configured minimum, interpolated rather than
+    // written out: a host raising it must not end up with a requirement naming
+    // the old number.
+    minLength: (count) => `At least ${count} characters`,
+    uppercase: "One uppercase letter",
+    lowercase: "One lowercase letter",
+    numbers: "One number",
+    special: "One special character",
+  },
+  suggestions: {
+    minLength: (count) => `Use at least ${count} characters`,
+    uppercase: "Add uppercase letters",
+    lowercase: "Add lowercase letters",
+    numbers: "Include numbers",
+    special: "Add special characters",
+  },
+};
+
+export const EN_US_RICH_EDITOR_TOOLBAR_COPY: RichEditorToolbarCopy = {
+  bold: "Bold",
+  italic: "Italic",
+  underline: "Underline",
+  bulletList: "Bulleted list",
+  numberedList: "Numbered list",
+  quote: "Quote",
+  code: "Code",
+  insertLink: "Insert link",
+  textColor: "Text colour",
+  backgroundColor: "Background colour",
+  linkPrompt: "Enter the URL:",
+};
+
+export const EN_US_PHONE_INPUT_COPY: PhoneInputCopy = {
+  selectCountry: "Select country",
+  invalidNumber: (countryName) => `Not a valid phone number for ${countryName}`,
+  // Substituted into the sentence above when no country is chosen, so it has to
+  // read as a noun phrase inside it rather than as a sentence of its own.
+  unknownCountry: "the selected country",
+};
+
+export const EN_US_UPLOAD_BUTTON_COPY: UploadButtonCopy = {
+  buttonLabel: "Upload a file",
+  dropzoneHint: "Drop the file here, or click to choose one",
+  dropzoneRole: (label) => `File upload area. ${label}`,
+  uploading: "Uploading…",
+  dropReady: "File ready to drop",
+  percentUploaded: (percent) => `${percent}% uploaded`,
+  uploadInProgress: (percent) => `Upload in progress: ${percent}%`,
+  errorAnnouncement: (message) => `Error: ${message}`,
+};

package/src/en-US.layout.ts

@@ -0,0 +1,15 @@
+/**
+ * The en-US pack for the layout family. Split the same way `pt-BR.layout.ts`
+ * is — see `en-US.ts` for why the packs live in per-family files.
+ */
+import type {
+  TableFilterCopy,
+} from './copy';
+
+export const EN_US_TABLE_FILTER_COPY: TableFilterCopy = {
+  clearAllFilters: "Clear all filters",
+  clearKeyword: "Clear the search",
+  invalidRange: "The maximum must be greater than or equal to the minimum.",
+  rangeMin: "Minimum",
+  rangeMax: "Maximum",
+};

package/src/en-US.navigation.ts

@@ -0,0 +1,23 @@
+/**
+ * The en-US pack for the navigation family. Split the same way
+ * `pt-BR.navigation.ts` is — see `en-US.ts` for why.
+ */
+import type {
+  BreadcrumbCopy,
+  CommandPaletteCopy,
+} from './copy';
+
+export const EN_US_COMMAND_PALETTE_COPY: CommandPaletteCopy = {
+  execute: "Run",
+  // The arrow glyphs and the key name are part of the hint a reader looks at
+  // while their hands are on the keyboard, so they survive translation intact.
+  navigate: "↑↓ Navigate",
+  close: "ESC Close",
+  recent: "Recent",
+  tryAnotherTerm: "Try another term",
+};
+
+export const EN_US_BREADCRUMB_COPY: BreadcrumbCopy = {
+  showMore: "Show more",
+  moreItems: "More items",
+};

package/src/en-US.shared.ts

@@ -0,0 +1,105 @@
+/**
+ * The en-US pack for the shared family. Split the same way `pt-BR.shared.ts`
+ * is — see `en-US.ts` for why.
+ */
+import type { SavedViewsLabels } from "./components/layout/ContentToolbar/ContentToolbar.types";
+import type {
+  CategorySelectCopy,
+  CepFieldCopy,
+  ConfirmActionCopy,
+  SectionOnboardingCopy,
+} from './copy';
+
+export const EN_US_SECTION_ONBOARDING_COPY: SectionOnboardingCopy = {
+  edit: "Edit",
+  collapse: "Hide",
+  start: "Start",
+};
+
+export const EN_US_CONFIRM_ACTION_COPY: ConfirmActionCopy = {
+  cancel: "Cancel",
+  defaultError: "That action could not be completed. Try again.",
+  irreversible: "This cannot be undone.",
+  // The expected word is what the reader must type, and it is the HOST's word.
+  // It is interpolated rather than translated: a dialog that asks for one word
+  // and matches on another can never be confirmed.
+  typeToConfirm: (expected) => `Type "${expected}" to confirm.`,
+};
+
+export const EN_US_CATEGORY_SELECT_COPY: CategorySelectCopy = {
+  purpose: "Categories organise the menu and the filters shoppers see.",
+  clearSelection: "Clear selection",
+  selectAll: "Select all",
+  deselectAll: "Deselect all",
+  expandAll: "Expand all",
+  collapseAll: "Collapse all",
+  expandCategory: (name) => `Expand ${name}`,
+  collapseCategory: (name) => `Collapse ${name}`,
+  placeholderSingle: "Move to…",
+  placeholderMulti: "Category",
+  emptyTitle: "No categories yet",
+  createCategory: "Create category",
+  noResults: {
+    title: (query) => `Nothing found for “${query}”`,
+    hint: "Try another term, or check the spelling.",
+    clearSearch: "Clear search",
+    create: (query) => `Create “${query}”`,
+  },
+  search: {
+    placeholderSingle: "Search categories…",
+    placeholderMulti: "Search a category or subcategory",
+    clear: "Clear search",
+    removeChip: (label) => `Remove ${label}`,
+    pinnedLabel: (count) => `Selected · ${count}`,
+  },
+  footer: {
+    // The pt-BR pack pluralises with a suffix; English changes the noun, so the
+    // whole word is chosen here. Each locale owning its own plural rule is the
+    // reason these are functions rather than templates.
+    selectedCount: (count) => `${count} ${count === 1 ? "category" : "categories"} selected`,
+    clear: "Clear",
+    apply: "Apply",
+    close: "Close",
+    singleHint: "Pick one category",
+    cancel: "Cancel",
+  },
+};
+
+/**
+ * CEP is Brazil's postal code and is NOT translated: the field looks up a
+ * Brazilian address by a Brazilian code, and calling it a "ZIP code" in the
+ * error would send an English-reading operator hunting for a field that does
+ * not exist. The surrounding sentences are English; the code's name is a proper
+ * noun, the same way a vendor's own field name is.
+ */
+export const EN_US_CEP_FIELD_COPY: CepFieldCopy = {
+  loading: "Looking up the address…",
+  found: "Address filled in from the CEP.",
+  notfound: "CEP not found — fill the address in by hand.",
+};
+
+/**
+ * The saved-views dropdown's labels.
+ *
+ * Typed as the package's OWN `SavedViewsLabels` rather than a parallel shape,
+ * for the reason `pt-BR.shared.ts` records: that interface already named every
+ * string, including the seven with no diacritics the copy gate could not see.
+ */
+export const EN_US_SAVED_VIEWS_LABELS: SavedViewsLabels = {
+  trigger: "Views",
+  mainView: "Main view",
+  pinned: "Pinned",
+  recent: "Recent",
+  empty: "No saved views yet.",
+  saveCurrent: "+ Save current view",
+  manageAll: "Manage views",
+  apply: "Apply",
+  setDefault: "Set as default",
+  pin: "Pin to the sidebar",
+  unpin: "Unpin",
+  share: "Share with the team",
+  unshare: "Make private",
+  edit: "Edit",
+  remove: "Delete",
+  defaultTag: "Default",
+};

package/src/en-US.ts

@@ -0,0 +1,24 @@
+/**
+ * The en-US packs — NAMED constants a host passes by hand, never defaults.
+ *
+ * The filename is what exempts this file from the copy-portability gate,
+ * exactly as `pt-BR.ts` beside it is exempt: a language may ship, it may not be
+ * silent. `@12-apps/ui` is the package EVERY host renders, so a default
+ * compiled in here would reach every adopter of every other package too — which
+ * is the leak the copy port closed and the reason a second language arrives as
+ * a second named pack rather than as a fallback.
+ *
+ * A BARREL over `./en-US.<family>.ts`, mirroring the pt-BR side one for one.
+ * Each part keeps its tag in its own FILENAME rather than sitting in an
+ * `en-US/` folder, because the portability gates' exemption is a filename rule
+ * (`lib/locale-tag.mjs`): a folder would have put seven files of copy back in
+ * scope. Consumers read `@12-apps/ui/en-US`.
+ */
+
+export * from './en-US.data-display';
+export * from './en-US.feedback';
+export * from './en-US.form';
+export * from './en-US.layout';
+export * from './en-US.navigation';
+export * from './en-US.shared';
+export * from './en-US.utility';

package/src/en-US.utility.ts

@@ -0,0 +1,24 @@
+/**
+ * The en-US pack for the utility family. Split the same way
+ * `pt-BR.utility.ts` is — see `en-US.ts` for why.
+ */
+import type {
+  InstallPromptCopy,
+  UserAvatarCopy,
+} from './copy';
+
+export const EN_US_INSTALL_PROMPT_COPY: InstallPromptCopy = {
+  title: "Install this app",
+  installLabel: "Install",
+  dismissLabel: "Dismiss the install prompt",
+  // The two halves wrap the platform's share glyph, which the component renders
+  // between them. Splitting the sentence is what lets the icon sit inline, so
+  // the translation has to keep the same seam rather than one whole sentence.
+  iosTapBefore: "Tap",
+  iosTapAfter: 'and then "Add to Home Screen"',
+  shareLabel: "Share",
+};
+
+export const EN_US_USER_AVATAR_COPY: UserAvatarCopy = {
+  signOut: "Sign out",
+};

package/src/locales.ts

@@ -0,0 +1,151 @@
+/**
+ * Every component family's copy, in both languages, keyed by tag.
+ *
+ * One pack per family rather than one giant pack, because that is how the
+ * components take it: six of these are mounted independently and each takes
+ * what it renders, while the DataViews family threads one object through a
+ * context. A single blob would force a host mounting one component to state
+ * copy for ninety.
+ *
+ * ```ts
+ * import { useLocaleCopy } from '@12-apps/i18n/react';
+ * const copy = useLocaleCopy(LIGHTBOX_COPY);
+ * ```
+ *
+ * `LocalePack` is mirrored here rather than imported from `@12-apps/i18n`: this
+ * package is the one EVERY host renders, and giving it a dependency to carry a
+ * type would push that dependency onto every adopter of every other package.
+ * The mirror buys the same key-checking for one line.
+ */
+import type { DataViewsCopy } from './components/data-display/DataViews/data-views-copy';
+import type { SavedViewsLabels } from './components/layout/ContentToolbar/ContentToolbar.types';
+import type {
+  AddressAutocompleteCopy,
+  AutocompleteCopy,
+  BreadcrumbCopy,
+  CarouselCopy,
+  CategorySelectCopy,
+  CepFieldCopy,
+  ChromeCopy,
+  CodeEditorCopy,
+  CommandPaletteCopy,
+  ConfirmActionCopy,
+  DataStateCopy,
+  InstallPromptCopy,
+  LightboxCopy,
+  MapPreviewCopy,
+  PasswordStrengthCopy,
+  PhoneInputCopy,
+  RichEditorToolbarCopy,
+  SectionOnboardingCopy,
+  TableFilterCopy,
+  TimingDiagramCopy,
+  TutorialCopy,
+  UploadButtonCopy,
+  UserAvatarCopy,
+} from './copy';
+import * as en from './en-US';
+import * as pt from './pt-BR';
+
+type LocalePack<T> = { readonly 'pt-BR': T; readonly 'en-US': T };
+
+const pack = <T,>(ptBR: T, enUS: T): LocalePack<T> => ({ 'pt-BR': ptBR, 'en-US': enUS });
+
+// data-display
+export const LIGHTBOX_COPY = pack<LightboxCopy>(pt.PT_BR_LIGHTBOX_COPY, en.EN_US_LIGHTBOX_COPY);
+export const MAP_PREVIEW_COPY = pack<MapPreviewCopy>(
+  pt.PT_BR_MAP_PREVIEW_COPY,
+  en.EN_US_MAP_PREVIEW_COPY,
+);
+export const CAROUSEL_COPY = pack<CarouselCopy>(pt.PT_BR_CAROUSEL_COPY, en.EN_US_CAROUSEL_COPY);
+export const TIMING_DIAGRAM_COPY = pack<TimingDiagramCopy>(
+  pt.PT_BR_TIMING_DIAGRAM_COPY,
+  en.EN_US_TIMING_DIAGRAM_COPY,
+);
+export const DATA_STATE_COPY = pack<DataStateCopy>(
+  pt.PT_BR_DATA_STATE_COPY,
+  en.EN_US_DATA_STATE_COPY,
+);
+export const DATA_VIEWS_COPY = pack<DataViewsCopy>(
+  pt.PT_BR_DATA_VIEWS_COPY,
+  en.EN_US_DATA_VIEWS_COPY,
+);
+
+// feedback
+export const TUTORIAL_COPY = pack<TutorialCopy>(pt.PT_BR_TUTORIAL_COPY, en.EN_US_TUTORIAL_COPY);
+export const CHROME_COPY = pack<ChromeCopy>(pt.PT_BR_CHROME_COPY, en.EN_US_CHROME_COPY);
+
+// form
+export const ADDRESS_AUTOCOMPLETE_COPY = pack<AddressAutocompleteCopy>(
+  pt.PT_BR_ADDRESS_AUTOCOMPLETE_COPY,
+  en.EN_US_ADDRESS_AUTOCOMPLETE_COPY,
+);
+export const AUTOCOMPLETE_COPY = pack<AutocompleteCopy>(
+  pt.PT_BR_AUTOCOMPLETE_COPY,
+  en.EN_US_AUTOCOMPLETE_COPY,
+);
+export const CODE_EDITOR_COPY = pack<CodeEditorCopy>(
+  pt.PT_BR_CODE_EDITOR_COPY,
+  en.EN_US_CODE_EDITOR_COPY,
+);
+export const PASSWORD_STRENGTH_COPY = pack<PasswordStrengthCopy>(
+  pt.PT_BR_PASSWORD_STRENGTH_COPY,
+  en.EN_US_PASSWORD_STRENGTH_COPY,
+);
+export const RICH_EDITOR_TOOLBAR_COPY = pack<RichEditorToolbarCopy>(
+  pt.PT_BR_RICH_EDITOR_TOOLBAR_COPY,
+  en.EN_US_RICH_EDITOR_TOOLBAR_COPY,
+);
+export const PHONE_INPUT_COPY = pack<PhoneInputCopy>(
+  pt.PT_BR_PHONE_INPUT_COPY,
+  en.EN_US_PHONE_INPUT_COPY,
+);
+export const UPLOAD_BUTTON_COPY = pack<UploadButtonCopy>(
+  pt.PT_BR_UPLOAD_BUTTON_COPY,
+  en.EN_US_UPLOAD_BUTTON_COPY,
+);
+
+// layout
+export const TABLE_FILTER_COPY = pack<TableFilterCopy>(
+  pt.PT_BR_TABLE_FILTER_COPY,
+  en.EN_US_TABLE_FILTER_COPY,
+);
+
+// navigation
+export const COMMAND_PALETTE_COPY = pack<CommandPaletteCopy>(
+  pt.PT_BR_COMMAND_PALETTE_COPY,
+  en.EN_US_COMMAND_PALETTE_COPY,
+);
+export const BREADCRUMB_COPY = pack<BreadcrumbCopy>(
+  pt.PT_BR_BREADCRUMB_COPY,
+  en.EN_US_BREADCRUMB_COPY,
+);
+
+// shared
+export const SECTION_ONBOARDING_COPY = pack<SectionOnboardingCopy>(
+  pt.PT_BR_SECTION_ONBOARDING_COPY,
+  en.EN_US_SECTION_ONBOARDING_COPY,
+);
+export const CONFIRM_ACTION_COPY = pack<ConfirmActionCopy>(
+  pt.PT_BR_CONFIRM_ACTION_COPY,
+  en.EN_US_CONFIRM_ACTION_COPY,
+);
+export const CATEGORY_SELECT_COPY = pack<CategorySelectCopy>(
+  pt.PT_BR_CATEGORY_SELECT_COPY,
+  en.EN_US_CATEGORY_SELECT_COPY,
+);
+export const CEP_FIELD_COPY = pack<CepFieldCopy>(pt.PT_BR_CEP_FIELD_COPY, en.EN_US_CEP_FIELD_COPY);
+export const SAVED_VIEWS_LABELS = pack<SavedViewsLabels>(
+  pt.PT_BR_SAVED_VIEWS_LABELS,
+  en.EN_US_SAVED_VIEWS_LABELS,
+);
+
+// utility
+export const INSTALL_PROMPT_COPY = pack<InstallPromptCopy>(
+  pt.PT_BR_INSTALL_PROMPT_COPY,
+  en.EN_US_INSTALL_PROMPT_COPY,
+);
+export const USER_AVATAR_COPY = pack<UserAvatarCopy>(
+  pt.PT_BR_USER_AVATAR_COPY,
+  en.EN_US_USER_AVATAR_COPY,
+);