Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .claude/skills/forma-localizing/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ description: The localization standard — reading library strings through the b
- Do leave caller-supplied text such as `Title`, `Label`, and `ConfirmText` for the host to localize.
- Do format, parse and compare dates, numbers and text with the context's `Context.CultureState.Culture`, choose direction with `Context.CultureState.IsRightToLeft`, and run an API that reads the ambient culture, such as `DisplayAttribute.GetName()`, in `Context.CultureState.Run`; the ambient culture's members are banned in a component project.
- Do use American English spelling for `en` localization.
- Do write Spanish in Latin American Spanish, the dialect of `es-419`, in files whose culture stays `es`, so every Spanish-speaking reader gets them, and address the reader as *tú*: *agregar*, *presionar* or *hacer clic*, *ingresar*, *video* and *monto*, where Spain says *añadir*, *pulsar*, *introducir*, *vídeo* and *importe*.
- Do run the localization linter, which checks the locale files against the `L[...]` call sites that key them, before offering the work for review.
- Don't hardcode user-facing component strings.
- Don't localize text supplied by the caller a second time inside the library.
Expand Down
2 changes: 1 addition & 1 deletion .config/dotnet-tools.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"isRoot": true,
"tools": {
"formaui-net.locali": {
"version": "1.0.0-preview.25",
"version": "1.0.0-preview.26",
"commands": [
"locali"
],
Expand Down
22 changes: 22 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,28 @@ release is cut, and reads *Unreleased* until then. It lists every change a consu
breaks what the release before it allowed says how to migrate, as [Versioning's rules](https://github.com/FormaUI/Versioning/blob/v1.0.0-preview.5/docs/releases.md#the-release-record)
set out. What Forma gained before its first release, month by month, is in [the feature history](FEATURE-HISTORY.md).

## `1.0.0-preview.12`

*November 20, 2026*

- A gender expression chooses a string's words by whom it is about, as a plural expression chooses them by a count:
`[$ [Rider] gender; female: Escaladora; other: Escalador; $]`. Its fields are `female`, `male` and `other`, and an
enum value or a string selects the field its name spells, whatever its case, so `Gender.Female` and `"female"`
select `female`; a null, or a name without a field of its own, selects `other`.
- A key's values pair with the arguments its expressions name as well as its holes, in the order each name first
appears, so a key can carry a value no hole writes, such as a gender:
`L["[$ [Rider] gender; other: {Name} is the best climber; $]", rider.Gender, rider.Name]`. A key whose expression
names an argument ahead of that argument's first hole, with another hole between them, pairs the argument earlier
than it did; to migrate, pass the values in the order the names first appear.
- `PluralExpressionEvaluator` is `LocaleExpressionEvaluator`, which evaluates gender expressions too, and its
`Keyword` is `PluralKeyword`, beside `GenderKeyword` and the set of both, `Keywords`. To migrate, rename the type
and the property.
- The Spanish locale pack is written throughout in Latin American Spanish, addressing the reader as *tú*: the table
menu's *Agregar Fila Arriba* and the three like it, the inputs' *Agrega un número.* and *Agrega un símbolo.*, the
composer's six prompts starting *Ingresa…*, the explorer's *Video*, and the input router's *Presiona una tecla, haz
clic o desplázate…*. They read *Añadir…*, *Añade…*, *Introduce…*, *Vídeo* and *Pulse una tecla, haga clic o
desplácese…*, Spain's words, and the last one addressed the reader as *usted*.

## `1.0.0-preview.11`

*November 18, 2026*
Expand Down
2 changes: 1 addition & 1 deletion Directory.Build.props
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
<!-- The one version every package ships at; a preview, as the framework it targets is. -->
<PropertyGroup>
<VersionPrefix>1.0.0</VersionPrefix>
<VersionSuffix>preview.11</VersionSuffix>
<VersionSuffix>preview.12</VersionSuffix>
</PropertyGroup>

<!-- Reports the .editorconfig IDE* code-style severities from the compiler, not just the IDE, and fails the build on any warning, the compiler's or MSBuild's. -->
Expand Down
2 changes: 1 addition & 1 deletion docs/features-status.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
| Measure | Now |
| --- | --- |
| Components | 67 implemented and 7 in progress, as [the catalog](component-catalog.md) lists them, and 21 planned, as [the roadmap](component-roadmap.md) orders them |
| Packages | Every project under `src/` but the Showcase, released from `main` by `release.yml` to nuget.org and the organization's GitHub feed, the latest published release `1.0.0-preview.11` |
| Packages | Every project under `src/` but the Showcase, released from `main` by `release.yml` to nuget.org and the organization's GitHub feed, the latest published release `1.0.0-preview.12` |
| Render modes | Interactive Server, WebAssembly and Auto implemented: every call a component makes to a script and every call back checked in each, and on the Server in WebKit, the engine of Safari and of Apple's web views, every runtime on a page following its culture coordinator, a client reading its host's own strings, and a host setting either arrangement up as the README says; static rendering implemented, every check page rendered statically with no enabled control that needs interactivity; Blazor Hybrid implemented on WPF, Windows Forms and MAUI on Windows, every component checked in a web view and each host's application set up as the README says; an inventory holds every component to a check page in every render mode |

The gate runs every check [the verification design](verification-design.md#gates) sets out, each platform's where the machine can run it. It passes locally on Windows and in CI on Linux, on Windows and on an Android emulator.
Expand Down
13 changes: 7 additions & 6 deletions docs/localization-design.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ every file is read into, the default reading of a file's place and name, the pat
state instead, the `.locale.json` config that shapes reading, the locale packs an assembly's
strings may ship in, the order entries apply in, how the runtime reports a lookup that doesn't
find an entry, and how code written against Microsoft's `IStringLocalizer` reads them. The contract a component reads strings
through, holes, plural forms and the file format are the `Forma.Framework.Localization` README's;
through, holes, plural and gender forms and the file format are the `Forma.Framework.Localization` README's;
the checks run over the files are the [Locali](https://github.com/FormaUI/Locali) linter's,
`dotnet locali`.

Expand Down Expand Up @@ -439,10 +439,11 @@ The broader report stands for every narrower one beneath it, so an assembly that
report rather than one for each of its keys, and an `es-419` without files of its own misses nothing `es`
answers. Each is logged once per factory, which reads each file once, so what it has reported follows what it
has read. The three are warnings, each its own event carrying the assembly, the type, the key and the culture
as fields, since grouping explains a miss without making it matter less; a plural argument that isn't a count
is a warning under the checks too, and `Debug` without them. A file that a culture checked beside the lookup's
can't read is a warning of its own, once for each type and culture, and leaves the text the reader sees as it
is: the checks report what they find without changing what a lookup shows.
as fields, since grouping explains a miss without making it matter less; a plural argument that isn't a count,
or a gender argument that is neither an enum nor a string, is a warning under the checks too, and `Debug` without
them. A file that a culture checked beside the lookup's can't read is a warning of its own, once for each type
and culture, and leaves the text the reader sees as it is: the checks report what they find without changing
what a lookup shows.

The checks see the lookups that run. The [Locali](https://github.com/FormaUI/Locali) linter checks what it
can establish before the application runs, and where the two read the same files and settings they agree;
Expand All @@ -467,7 +468,7 @@ The key a caller passes decides how its string is filled, never the text a cultu
filled one way in every culture:

- **A Forma key** names a hole, `{Name}`, or holds an expression, `[$ … $]`, and Forma alone fills it, its
arguments paired with the holes by position.
arguments paired by position with the names the key uses, its holes and its expressions' arguments.
- **A composite key** holds a composite placeholder, `{0}`, or neither, and `string.Format` alone fills its
text in the formatting culture, as Microsoft's localizer does, so code written for it keeps its keys. Read
without arguments, its text is returned as written.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,6 @@
"$localization": "SchemaVersion: 1.0.0; Culture: es;",
"Components.Pages.Libraries.LocalizationPage": {
"Written in the root's file": "Desde la carpeta del anfitrión: el archivo de la raíz",
"Added by the host's folder alone": "Añadido solo desde la carpeta del anfitrión"
"Added by the host's folder alone": "Agregado solo desde la carpeta del anfitrión"
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@
"Selection Actions": "Acciones de Selección",
"Caption Agreeing with the Count": "Título que Concuerda con el Recuento",
"Step the count up. The caption is a plural construct, so a language with a dual reads differently at one, two, and more.": "Aumenta el recuento. El título es una construcción plural, así que un idioma con dual se lee distinto en uno, dos y más.",
"Add one": "Añadir uno",
"Add one": "Agregar uno",
"Without a Clear Button": "Sin Botón de Borrado",
"Several Actions": "Varias Acciones",
"Caller-Supplied Caption": "Título Proporcionado por el Llamador",
Expand All @@ -37,8 +37,8 @@
"A quiet strip of status readouts and occasional commands, meant to sit beneath a canvas or at the foot of a panel. Built on FormaToolbar, so a readout announces itself to a screen reader through the same role and a command runs through the same OnCommand.": "Una franja discreta de indicadores de estado y comandos ocasionales, pensada para situarse debajo de un lienzo o al pie de un panel. Construida sobre FormaToolbar, de modo que un indicador se anuncia a un lector de pantalla mediante el mismo rol y un comando se ejecuta mediante el mismo OnCommand.",
"Readouts": "Indicadores",
"An Announced Readout": "Un Indicador Anunciado",
"Press the button to change the count. A screen reader announces the new value because IsAnnounced is set.": "Pulse el botón para cambiar el recuento. Un lector de pantalla anuncia el nuevo valor porque IsAnnounced está activado.",
"Type some words": "Escriba algunas palabras",
"Press the button to change the count. A screen reader announces the new value because IsAnnounced is set.": "Presiona el botón para cambiar el recuento. Un lector de pantalla anuncia el nuevo valor porque IsAnnounced está activado.",
"Type some words": "Escribe algunas palabras",
"A Command": "Un Comando",
"Empty, Hidden": "Vacío, Oculto",
"The default EmptyMode renders nothing at all while there are no items, rather than an empty bar.": "El EmptyMode predeterminado no muestra nada mientras no hay elementos, en lugar de mostrar una barra vacía.",
Expand Down Expand Up @@ -88,7 +88,7 @@
"Word count": "Recuento de palabras",
"[$ plural; one: # word; other: # words; $]": "[$ plural; one: # palabra; other: # palabras; $]",
"Save state": "Estado de guardado",
"Add Words": "Añadir Palabras",
"Add Words": "Agregar Palabras",
"Recount": "Recontar",
"Custom Item": "Elemento Personalizado",
"A ToolbarCustomItem renders a component of the caller's choosing, with its own parameters, in place of a standard control.": "Un ToolbarCustomItem representa un componente elegido por el llamador, con sus propios parámetros, en lugar de un control estándar.",
Expand All @@ -97,9 +97,9 @@
"Keyboard Shortcuts": "Atajos de Teclado",
"An action's ShortcutDisplay appears in its tooltip alongside the label.": "El ShortcutDisplay de una acción aparece en su información sobre herramientas junto a la etiqueta.",
"Shortcuts That Fire": "Atajos Que Se Activan",
"Setting Target makes each action's ShortcutAriaKeys live while that element or a descendant holds focus, so the toolbar never listens document-wide. Click into the panel and press Ctrl+B or Ctrl+I.": "Definir Target activa el ShortcutAriaKeys de cada acción mientras ese elemento o un descendiente tiene el foco, de modo que la barra nunca escucha en todo el documento. Haz clic en el panel y pulsa Ctrl+B o Ctrl+I.",
"Setting Target makes each action's ShortcutAriaKeys live while that element or a descendant holds focus, so the toolbar never listens document-wide. Click into the panel and press Ctrl+B or Ctrl+I.": "Definir Target activa el ShortcutAriaKeys de cada acción mientras ese elemento o un descendiente tiene el foco, de modo que la barra nunca escucha en todo el documento. Haz clic en el panel y presiona Ctrl+B o Ctrl+I.",
"Shortcut Surface": "Superficie de Atajos",
"Focus here, then press Ctrl+B or Ctrl+I.": "Enfoca aquí y pulsa Ctrl+B o Ctrl+I.",
"Focus here, then press Ctrl+B or Ctrl+I.": "Enfoca aquí y presiona Ctrl+B o Ctrl+I.",
"One Item Disabled": "Un Solo Elemento Deshabilitado",
"An item's own IsDisabled stands it down while the rest of the toolbar stays live. Its shortcut is refused as well, not only its button.": "El IsDisabled propio de un elemento lo desactiva mientras el resto de la barra sigue activa. Su atajo también se rechaza, no solo su botón.",
"Disable Delete": "Deshabilitar Eliminar",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"On a Colored Surface": "Sobre una Superficie de Color"
},
"FormaButtonPage": {
"The button every Forma surface presses. Its variant says how much it should stand out, its size how dense the row around it is, and while work is in flight it shows itself busy so the same click cannot be sent twice.": "El botón que pulsa toda superficie de Forma. Su variante dice cuánto debe destacar, su tamaño cuán densa es la fila que lo rodea, y mientras hay trabajo en curso se muestra ocupado para que el mismo clic no pueda enviarse dos veces.",
"The button every Forma surface presses. Its variant says how much it should stand out, its size how dense the row around it is, and while work is in flight it shows itself busy so the same click cannot be sent twice.": "El botón que presiona toda superficie de Forma. Su variante dice cuánto debe destacar, su tamaño cuán densa es la fila que lo rodea, y mientras hay trabajo en curso se muestra ocupado para que el mismo clic no pueda enviarse dos veces.",
"Variants": "Variantes",
"Row Actions": "Acciones de Fila",
"Busy": "Ocupado",
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@
"Long List in a Scrolling Panel": "Lista larga en un panel con desplazamiento",
"Holding a drag near the top or bottom edge scrolls the panel, and releasing in the empty space below the last row sends the item to the end.": "Mantener un arrastre cerca del borde superior o inferior desplaza el panel, y soltar en el espacio vacío bajo la última fila envía el elemento al final.",
"Dragging from the Whole Row": "Arrastrar desde Toda la Fila",
"The whole row starts a drag, not just the handle. Interactive elements inside a row keep their own press, and on touch the row is held briefly before it lifts so a swipe still scrolls.": "Toda la fila inicia un arrastre, no sólo el asa. Los elementos interactivos dentro de una fila conservan su propia pulsación, y en pantallas táctiles la fila se mantiene pulsada un momento antes de levantarse, así que un deslizamiento sigue desplazando.",
"Drag a row anywhere to reorder, or press Edit — it still clicks.": "Arrastra una fila desde cualquier punto para reordenar, o pulsa Editar: sigue siendo clicable.",
"Edit was clicked on {Name}, so the row did not take the press.": "Se pulsó Editar en {Name}, así que la fila no tomó la pulsación.",
"The whole row starts a drag, not just the handle. Interactive elements inside a row keep their own press, and on touch the row is held briefly before it lifts so a swipe still scrolls.": "Toda la fila inicia un arrastre, no solo el asa. Los elementos interactivos dentro de una fila conservan su propio clic o toque, y en pantallas táctiles la fila se mantiene presionada un momento antes de levantarse, así que un deslizamiento sigue desplazando.",
"Drag a row anywhere to reorder, or press Edit — it still clicks.": "Arrastra una fila desde cualquier punto para reordenar, o presiona Editar: sigue siendo clicable.",
"Edit was clicked on {Name}, so the row did not take the press.": "Se presionó Editar en {Name}, así que la fila no tomó el clic.",
"In a Popover": "En un Popover",
"A list inside a popover that keeps focus. A drag begun inside it belongs to the list, Escape while dragging cancels the drag and leaves the popover open, and its keys move the item without leaving the popover.": "Una lista dentro de un popover que mantiene el foco. Un arrastre iniciado dentro pertenece a la lista, Escape durante el arrastre cancela el arrastre y deja el popover abierto, y sus teclas mueven el elemento sin salir del popover.",
"Open": "Abrir"
Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$localization": "SchemaVersion: 1.0.0; Culture: es;",
"FormaInputInspectorPage": {
"Every key, press, wheel turn and drop on the page is resolved by one router to one owner. The panel on the side shows each decision as it is made: who owns the input, by which rule, and what stands active above what.": "Cada tecla, pulsación, giro de rueda y soltado en la página lo resuelve un único enrutador hacia un único propietario. El panel lateral muestra cada decisión al tomarse: quién posee la entrada, por qué regla, y qué está activo sobre qué.",
"Every key, press, wheel turn and drop on the page is resolved by one router to one owner. The panel on the side shows each decision as it is made: who owns the input, by which rule, and what stands active above what.": "Cada tecla, clic o toque, giro de rueda y soltado en la página lo resuelve un único enrutador hacia un único propietario. El panel lateral muestra cada decisión al tomarse: quién posee la entrada, por qué regla, y qué está activo sobre qué.",
"Nested scopes": "Ámbitos anidados",
"A grid routes the arrows, Home and End. Inside it, native controls keep the keys they consume, and a popup that is open keeps every key inside itself: its list routes the arrows, and nothing reaches the grid.": "Una cuadrícula enruta las flechas, Inicio y Fin. Dentro, los controles nativos conservan las teclas que consumen, y un popup abierto retiene cada tecla dentro de sí: su lista enruta las flechas y nada llega a la cuadrícula.",
"Grid": "Cuadrícula",
Expand Down
Loading