@eduardoalvarez/arrecife 0.11.0 → 0.12.0

package/dist/og/index.js

@@ -1,5 +1,5 @@
 import { ASSETS_PATH, faces, poses, fins } from '../chunk-CKRSQPTX.js';
-import { fonts, dark, light, naming, gradient, tagline, typeScale } from '../chunk-FGFNK72B.js';
+import { fonts, dark, light, naming, gradient, tagline, typeScale } from '../chunk-5YWGOFDX.js';
 
 // src/og/templates.ts
 var OG = {

package/dist/shiki/index.js

@@ -1,4 +1,4 @@
-import { syntax } from '../chunk-FGFNK72B.js';
+import { syntax } from '../chunk-5YWGOFDX.js';
 
 // src/shiki/theme.ts
 var arrecife = {

package/dist/tokens/index.cjs

@@ -146,7 +146,7 @@ var typeScale = {
    * (plankton 5.57:1 over abyss), which is the part that is not negotiable.
    *
    * At 13 the three badge families grew past the size of a small button and
-   * outweighed the title they accompany. See `docs/decisions/`.
+   * outweighed the title they accompany. See `docs/decisions/` § 10.
    */
   chip: { family: "mono", size: 11.5, lineHeight: 1.4, weight: 400 },
   /**
@@ -200,7 +200,7 @@ var control = {
    * baseline; 28 would have been a fifth height that matches nothing.
    *
    * It does not replace `icon`. A page's primary action stays at 42; this is for
-   * a row of a table. See `docs/decisions/0.6.md` § 22.
+   * a row of a table. See `docs/decisions/` § 22.
    */
   iconSm: 32
 };
@@ -223,7 +223,7 @@ var size = {
    * together eat the top of the content area. 56 is what `cursos` had arrived at
    * on its own, and it is the same reasoning as `control.iconSm`: the one admin
    * app of the five is denser than the four reading sites. See
-   * `docs/decisions/0.7.md` § 30.
+   * `docs/decisions/` § 30.
    */
   navCompact: 56,
   /**
@@ -296,7 +296,20 @@ var naming = {
   wordmark: "Eduardo \xC1lvarez",
   mascot: "Tiburonc\xEDn",
   /** The domain, for the footer CLI signature: `$ cd ~/eduardoalvarez.dev/2026`. */
-  domain: "eduardoalvarez.dev"
+  domain: "eduardoalvarez.dev",
+  /** The library's own name, for a footer that credits it. */
+  library: "Arrecife",
+  /**
+   * Where the library is published, for `Footer builtWith`.
+   *
+   * It is here and not written into the component for the reason the domain is:
+   * one string, five projects. It is the same URL as `homepage` in
+   * `package.json` and it cannot be derived from it — this file imports nothing
+   * — so `check:exports` compares the two on every build. Without that, moving
+   * the Storybook would update what npm prints and leave five production
+   * footers linking at the old address.
+   */
+  libraryUrl: "https://arrecife.eduardoalvarez.dev"
 };
 
 // src/tokens/index.ts

package/dist/tokens/index.d.cts

@@ -280,7 +280,7 @@ declare const typeScale: {
      * (plankton 5.57:1 over abyss), which is the part that is not negotiable.
      *
      * At 13 the three badge families grew past the size of a small button and
-     * outweighed the title they accompany. See `docs/decisions/`.
+     * outweighed the title they accompany. See `docs/decisions/` § 10.
      */
     readonly chip: {
         readonly family: "mono";
@@ -336,7 +336,7 @@ declare const radius: {
  *
  * Only the horizontal padding and the icon button's square. Height comes from
  * the type scale, and there is a single radius for all three sizes: see
- * `docs/decisions/`.
+ * `docs/decisions/` § 1.
  *
  * They are not in `spacing` because they are not page rhythm: 14, 22 and 30 do
  * not compose with 8/12/16/26/40 and must not be offered as margins.
@@ -360,7 +360,7 @@ declare const control: {
      * baseline; 28 would have been a fifth height that matches nothing.
      *
      * It does not replace `icon`. A page's primary action stays at 42; this is for
-     * a row of a table. See `docs/decisions/0.6.md` § 22.
+     * a row of a table. See `docs/decisions/` § 22.
      */
     readonly iconSm: 32;
 };
@@ -405,7 +405,7 @@ declare const size: {
      * together eat the top of the content area. 56 is what `cursos` had arrived at
      * on its own, and it is the same reasoning as `control.iconSm`: the one admin
      * app of the five is denser than the four reading sites. See
-     * `docs/decisions/0.7.md` § 30.
+     * `docs/decisions/` § 30.
      */
     readonly navCompact: 56;
     /**
@@ -488,7 +488,7 @@ declare const syntax: {
  *
  * A fifth series is not added by inventing a hue. If a chart needs five
  * categories, either there are too many categories or they need an «other»
- * bucket: see `docs/decisions/`.
+ * bucket: see `docs/decisions/` § 18.
  */
 declare const series: {
     readonly dark: readonly ["#35D6C0", "#F2A65A", "#3E7CB1", "#71919C"];
@@ -538,6 +538,19 @@ declare const naming: {
     readonly mascot: "Tiburoncín";
     /** The domain, for the footer CLI signature: `$ cd ~/eduardoalvarez.dev/2026`. */
     readonly domain: "eduardoalvarez.dev";
+    /** The library's own name, for a footer that credits it. */
+    readonly library: "Arrecife";
+    /**
+     * Where the library is published, for `Footer builtWith`.
+     *
+     * It is here and not written into the component for the reason the domain is:
+     * one string, five projects. It is the same URL as `homepage` in
+     * `package.json` and it cannot be derived from it — this file imports nothing
+     * — so `check:exports` compares the two on every build. Without that, moving
+     * the Storybook would update what npm prints and leave five production
+     * footers linking at the old address.
+     */
+    readonly libraryUrl: "https://arrecife.eduardoalvarez.dev";
 };
 type ColorMode = keyof typeof colors;
 type ColorToken = keyof typeof dark;
@@ -782,6 +795,8 @@ declare const tokens: {
         readonly wordmark: "Eduardo Álvarez";
         readonly mascot: "Tiburoncín";
         readonly domain: "eduardoalvarez.dev";
+        readonly library: "Arrecife";
+        readonly libraryUrl: "https://arrecife.eduardoalvarez.dev";
     };
 };
 type Tokens = typeof tokens;

package/dist/tokens/index.d.ts

@@ -280,7 +280,7 @@ declare const typeScale: {
      * (plankton 5.57:1 over abyss), which is the part that is not negotiable.
      *
      * At 13 the three badge families grew past the size of a small button and
-     * outweighed the title they accompany. See `docs/decisions/`.
+     * outweighed the title they accompany. See `docs/decisions/` § 10.
      */
     readonly chip: {
         readonly family: "mono";
@@ -336,7 +336,7 @@ declare const radius: {
  *
  * Only the horizontal padding and the icon button's square. Height comes from
  * the type scale, and there is a single radius for all three sizes: see
- * `docs/decisions/`.
+ * `docs/decisions/` § 1.
  *
  * They are not in `spacing` because they are not page rhythm: 14, 22 and 30 do
  * not compose with 8/12/16/26/40 and must not be offered as margins.
@@ -360,7 +360,7 @@ declare const control: {
      * baseline; 28 would have been a fifth height that matches nothing.
      *
      * It does not replace `icon`. A page's primary action stays at 42; this is for
-     * a row of a table. See `docs/decisions/0.6.md` § 22.
+     * a row of a table. See `docs/decisions/` § 22.
      */
     readonly iconSm: 32;
 };
@@ -405,7 +405,7 @@ declare const size: {
      * together eat the top of the content area. 56 is what `cursos` had arrived at
      * on its own, and it is the same reasoning as `control.iconSm`: the one admin
      * app of the five is denser than the four reading sites. See
-     * `docs/decisions/0.7.md` § 30.
+     * `docs/decisions/` § 30.
      */
     readonly navCompact: 56;
     /**
@@ -488,7 +488,7 @@ declare const syntax: {
  *
  * A fifth series is not added by inventing a hue. If a chart needs five
  * categories, either there are too many categories or they need an «other»
- * bucket: see `docs/decisions/`.
+ * bucket: see `docs/decisions/` § 18.
  */
 declare const series: {
     readonly dark: readonly ["#35D6C0", "#F2A65A", "#3E7CB1", "#71919C"];
@@ -538,6 +538,19 @@ declare const naming: {
     readonly mascot: "Tiburoncín";
     /** The domain, for the footer CLI signature: `$ cd ~/eduardoalvarez.dev/2026`. */
     readonly domain: "eduardoalvarez.dev";
+    /** The library's own name, for a footer that credits it. */
+    readonly library: "Arrecife";
+    /**
+     * Where the library is published, for `Footer builtWith`.
+     *
+     * It is here and not written into the component for the reason the domain is:
+     * one string, five projects. It is the same URL as `homepage` in
+     * `package.json` and it cannot be derived from it — this file imports nothing
+     * — so `check:exports` compares the two on every build. Without that, moving
+     * the Storybook would update what npm prints and leave five production
+     * footers linking at the old address.
+     */
+    readonly libraryUrl: "https://arrecife.eduardoalvarez.dev";
 };
 type ColorMode = keyof typeof colors;
 type ColorToken = keyof typeof dark;
@@ -782,6 +795,8 @@ declare const tokens: {
         readonly wordmark: "Eduardo Álvarez";
         readonly mascot: "Tiburoncín";
         readonly domain: "eduardoalvarez.dev";
+        readonly library: "Arrecife";
+        readonly libraryUrl: "https://arrecife.eduardoalvarez.dev";
     };
 };
 type Tokens = typeof tokens;

package/dist/tokens/index.js

@@ -1,2 +1,2 @@
-export { tokens } from '../chunk-5A5GH2PF.js';
-export { brand, colors, control, dark, fonts, gradient, light, limits, motion, naming, radius, series, shadow, size, spacing, syntax, tagline, typeScale } from '../chunk-FGFNK72B.js';
+export { tokens } from '../chunk-6QJQ6K7J.js';
+export { brand, colors, control, dark, fonts, gradient, light, limits, motion, naming, radius, series, shadow, size, spacing, syntax, tagline, typeScale } from '../chunk-5YWGOFDX.js';

package/dist/tokens/theme.css

@@ -18,7 +18,24 @@
 @custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));
 @custom-variant light (&:where([data-theme="light"], [data-theme="light"] *));
 
-@theme {
+/* STATIC, and that word is the whole of a bug fix. Tailwind v4 emits a theme
+   variable only if some utility it generated uses it, and a token read with
+   var() from JS is asked for by no utility at all: seriesColor(i) returns
+   var(--color-series-N) on purpose, so the color follows the mode instead of
+   freezing to whichever one was live when the chart mounted. No project writes
+   bg-series-1, so Tailwind dropped all four as unused, the var() resolved to
+   nothing, and a fill that resolves to nothing is black — on a dark page,
+   indistinguishable from «no data». No error in the console and none in the
+   build; the report that arrived was «the information is not showing».
+
+   With static, every token this file declares reaches :root whether a class
+   asks for it or not, which is what a published token set is: a contract, not
+   a subset of itself discovered by usage. It costs CSS — measured at +1.6 KB
+   raw / +234 B gzipped for a project using the library's whole vocabulary, and
+   +3.2 KB / +579 B for one that writes almost nothing — and it buys the
+   removal of a whole class of silent failure rather than of one instance.
+   See docs/decisions/ § 61. */
+@theme static {
   /* --- color · dark mode (default) ------------------------------------- */
   --color-background: #091319;
   --color-surface: #10202B;
@@ -265,7 +282,7 @@
    written from first principles about terminals rather than read off the two
    sites that already had a signature. A utility with no consumer and no origin
    is not a feature, it is the invention still sitting there under a new label.
-   See docs/decisions/0.8.md § 45.
+   See docs/decisions/ § 45.
 
    Its reason is the one the other four exceptions share: it is feedback about
    PROGRESS. A prompt that radiates says the terminal is live, which is the same
@@ -283,7 +300,7 @@
    Behind motion-safe at the call site — the half NOT copied from cursos, whose
    span animates regardless. The blog guarded it, every other exception here is
    guarded, and at rest the bar is simply solid.
-   See docs/decisions/0.8.md § 45. */
+   See docs/decisions/ § 45. */
 @keyframes arrecife-pulse {
   0%, 100% {
     box-shadow: 0 0 0 0 color-mix(in oklab, var(--color-accent) 70%, transparent);

package/dist/variants/index.cjs

@@ -21,7 +21,7 @@ var button = classVarianceAuthority.cva(
         ],
         // The one control whose focus ring is not biolume. It is the system's
         // only sand fill, and a biolume ring three pixels off a sand button puts
-        // both of the brand's accents in the same glance. See `docs/decisions/0.7.md` § 37.
+        // both of the brand's accents in the same glance. See `docs/decisions/` § 37.
         conversion: "bg-warm text-warm-on hover:bg-warm-hover focus-ring-warm",
         secondary: [
           "border-hairline-hover border bg-transparent text-text-primary",

package/dist/variants/index.d.cts

@@ -32,7 +32,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
  * actions and toolbars, next to «Editar» and «Duplicar», with no context to tell
  * them apart: with every one rendered as `secondary`, «Eliminar curso» looked
  * exactly like «Cancelar» and only the word separated them. See
- * `docs/decisions/0.6.md` § 21.
+ * `docs/decisions/` § 21.
  *
  * `destructiveOutline` fills on hover, and that IS an exception to «secondary is
  * never filled» — declared here rather than discovered later. A destructive
@@ -151,7 +151,7 @@ declare const text: (props?: ({
  *
  * The radius: the document says 12, which is none of the system's five radii. It
  * uses the card radius rather than introducing a sixth — see
- * `docs/decisions/`.
+ * `docs/decisions/` § 3.
  */
 declare const alert: (props?: ({
     variant?: "error" | "accent" | "success" | "warning" | null | undefined;

package/dist/variants/index.d.ts

@@ -32,7 +32,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
  * actions and toolbars, next to «Editar» and «Duplicar», with no context to tell
  * them apart: with every one rendered as `secondary`, «Eliminar curso» looked
  * exactly like «Cancelar» and only the word separated them. See
- * `docs/decisions/0.6.md` § 21.
+ * `docs/decisions/` § 21.
  *
  * `destructiveOutline` fills on hover, and that IS an exception to «secondary is
  * never filled» — declared here rather than discovered later. A destructive
@@ -151,7 +151,7 @@ declare const text: (props?: ({
  *
  * The radius: the document says 12, which is none of the system's five radii. It
  * uses the card radius rather than introducing a sixth — see
- * `docs/decisions/`.
+ * `docs/decisions/` § 3.
  */
 declare const alert: (props?: ({
     variant?: "error" | "accent" | "success" | "warning" | null | undefined;

package/dist/variants/index.js

@@ -1,2 +1,2 @@
-export { CARD, CARD_HOVER, CARD_SURFACE, alert as alertVariants, avatar as avatarVariants, badge as badgeVariants, button as buttonVariants, category as categoryBadgeVariants, metric as metricBadgeVariants } from '../chunk-XXDATT3A.js';
+export { CARD, CARD_HOVER, CARD_SURFACE, alert as alertVariants, avatar as avatarVariants, badge as badgeVariants, button as buttonVariants, category as categoryBadgeVariants, metric as metricBadgeVariants } from '../chunk-FF33ARRA.js';
 export { text as textVariants } from '../chunk-ODBFN44D.js';

package/llms.txt

@@ -72,6 +72,15 @@ project declares `@source`, include the package:
 @source "../node_modules/@eduardoalvarez/arrecife/dist";
 ```
 
+**Every token is in `:root`, and you may read it with `var()`.** The block is
+`@theme static`, so a token is emitted whether or not a utility asks for it:
+`style={{ fill: 'var(--color-series-1)' }}` or `var(--radius-card)` from your own
+JavaScript resolves. Do not write a fallback hexadecimal next to it — that is a
+second copy of a value this package exists to keep in one place. Before that fix
+Tailwind dropped the four `--color-series-*` as unused, because they are read by
+`var()` and requested by no class, and the charts drew black. See
+`decisions/` § 61.
+
 ### Light mode and dark mode
 
 **Dark mode is primary and it is the default.** A dark project declares nothing.
@@ -263,7 +272,7 @@ does nothing.
 
 **One `Nav` per page.** It renders the site's `banner` landmark, and two banners
 on one page is an accessibility failure — which is also why `PageHeader` goes
-inside `<main>` and is not a landmark. See `decisions/0.7.md` § 30.
+inside `<main>` and is not a landmark. See `decisions/` § 30.
 
 ### Icons are yours, the way they are drawn is not
 
@@ -332,7 +341,7 @@ a Server Component throws. It ships no `"use client"` to stop you, so the failur
 arrives at render rather than at build. The `/ssr` entry is the same icons
 without the context read, and `Icon` works with either.
 
-See `decisions/0.7.md` § 29 and § 35.
+See `decisions/` § 29 and § 35.
 
 ### `Stat`'s delta says direction, not judgement
 
@@ -349,7 +358,7 @@ errores» point the same way and mean opposite things, so whether a number is go
 news is `tone`'s job and yours: `neutral` for a datum, `alert` when the number IS
 the problem, `achievement` when it is the reward. `alert` and `achievement` paint
 the same sand on purpose — the API is the meaning, the colour is the
-implementation. See `decisions/0.7.md` § 28.
+implementation. See `decisions/` § 28.
 
 `delta.value` arrives already formatted, like `value`: the library imposes no
 locale and computes no percentage. `spark` is a `ReactNode` and the library ships
@@ -359,7 +368,7 @@ no sparkline — pass your own, exactly like `icon`.
 and biolume goes on the icon badge and the sparkline instead: three accents in
 one card and the figure stops being the loudest thing in it. `alert` and
 `achievement` DO paint the number sand, which is how «this number is not just a
-number» is said. See `decisions/0.7.md` § 31.
+number» is said. See `decisions/` § 31.
 
 **`icon` is a badge in the corner opposite the title**, in a circle tinted at
 10 % of the tone. You pass the glyph; the circle, the tint and the size are the
@@ -433,6 +442,13 @@ it is `aria-hidden`. The column titles render as `<h3>`. Pass `linkAsChild` to
 plug in the router's `Link`; without it the columns are plain `<a>` and every
 navigation costs a page load.
 
+**`builtWith` adds «Creado con Arrecife ♥» under the signature**, linking to the
+library's Storybook. It works on both shapes and it is OFF by default:
+the credit is the site's to give, so the library does not put it in a footer
+that did not ask. Do not hand-write that line instead — the heart is Phosphor's
+filled `Heart` and never the emoji, and the URL is checked against the package's
+`homepage` on every build. See `decisions/` § 62.
+
 ### `Table` brings its own surface
 
 ```tsx
@@ -485,7 +501,7 @@ largest datum, and on a horizontal ranking — whose value axis is hidden — a
 course watched to 40 % draws as a full bar when it is the highest on the list.
 The bottom is always zero, and it is a floor rather than a clip: a datum above
 `valueMax` widens the axis instead of running off the edge. It is on all three
-types. See `decisions/0.11.md` § 58.
+types. See `decisions/` § 58.
 
 `stacked` on `AreaChart` and `BarChart` adds the series up. Without it areas
 overlap, which is honest and rarely what you want with more than one series: to
@@ -494,6 +510,13 @@ COMPARE rather than add up, the type is `LineChart`.
 Anything that is not a series over a category axis has no type and is not missing
 one. A doughnut is `ChartContainer` plus Recharts' `Pie` with `SERIES_COLORS`.
 
+**The series palette comes from `seriesColor(i)` and `SERIES_COLORS`, and both
+return `var(--color-series-N)`** rather than a hexadecimal, so the colors follow
+the mode instead of freezing to the one that was live when the chart mounted. You
+do not need `data-theme` on `<html>` for that to resolve, and you do not need a
+fallback: the tokens are in `:root` on every page. Pass `color` per series only
+to override the palette on purpose — a semantic red for a failure count, say.
+
 ### The social icons are yours, and they come from Phosphor
 
 Until 0.10.0 the library shipped ten of them at `./social` — `GitHub`,
@@ -585,7 +608,7 @@ compiles and looks wrong, or that fails the project's accessibility audit.
 3. **`Button variant="destructive"` is for the irreversible only.** Never for
    «cancel» on a form, and not inside an `AlertDialog` — there the confirm button
    stays `primary`, because the title, the focus on cancel and the no-click-outside
-   already carry the weight. See `decisions/0.6.md` § 21.
+   already carry the weight. See `decisions/` § 21.
 4. **`secondary` is never filled.** It is border and text.
 5. **No entrance animations.** Modals, menus, tooltips and toasts appear where
    they will stay. There are five declared exceptions, all behind `motion-safe`
@@ -600,7 +623,7 @@ compiles and looks wrong, or that fails the project's accessibility audit.
    `PageHeader` makes the same split: `as` is the level and `titleVariant` the
    scale. An admin panel's title is `<PageHeader title="Ventas"
    titleVariant="h3" />` — still the page's only `h1`, at 25px instead of 44. See
-   `decisions/0.11.md` § 57.
+   `decisions/` § 57.
 7. **`textMuted` never goes over `surfaceRaised`**: it gives 4.07 in dark. Over a
    raised surface — menus, active tabs — the token is `textSecondary`.
 8. **A background tinted with a semantic color carries text from a text token**,
@@ -618,14 +641,14 @@ compiles and looks wrong, or that fails the project's accessibility audit.
     hole inside a table page or a dashboard widget, and it carries no face — the
     type does not accept one. `page`, the default, is the one that IS the screen,
     and there `expression` stays mandatory. A dozen mascots on one admin screen is
-    not the humour contract. See `decisions/0.7.md` § 27.
+    not the humour contract. See `decisions/` § 27.
 12. **The fin is not a free parameter**: `foam` on a dark background, `color` on a
     light one. The components already choose it from the background.
     **On a site that switches theme, pass `background="auto"`** to `Isotype` or
     `Logo`: both fins are rendered and the `light:` variant shows the one that
     reads, so no call site has to know the theme. A surface that keeps one mode
     whatever the page does — a dark panel on a light page — is a fixed
-    background, and it still says `dark`. See `decisions/0.11.md` § 60.
+    background, and it still says `dark`. See `decisions/` § 60.
 
 ## What the library does NOT do, on purpose
 
@@ -646,7 +669,7 @@ These are the confusions people run into most often when consuming it.
   already names the card — and `footer`, the closing row where a project puts the
   rating and the price. Both are nodes the project draws; the card keeps the
   title, its hover and the sand progress bar. The title does not go over the
-  cover. See `decisions/0.11.md` § 59.
+  cover. See `decisions/` § 59.
 - **It ships no `data-testid`.** A composed part your test suite has to reach is
   reached with a slot: `ArticleCard`'s `tagAsChild`, `Breadcrumb`'s and
   `TableOfContents`'s `linkAsChild`. They hand you the element and its
@@ -1470,6 +1493,7 @@ Source: `src/components/footer/index.tsx`
 | --- | --- | --- | --- | --- |
 | `action` | `ReactNode` |  |  | An action under the row of icons — «Reportar un problema». Usually a tertiary button. |
 | `brand` | `ReactNode` |  |  | The brand row: the fin and the wordmark, at the very top. |
+| `builtWith` | `boolean \| undefined` |  |  | Adds «Creado con Arrecife ♥», linking to the library's Storybook. |
 | `columns` | `readonly FooterColumn[]` |  |  | The link columns. Mandatory: without them `full` is the default form with extra steps. |
 | `description` | `ReactNode` |  |  | One line under the brand, saying what the site is. |
 | `domain` | `string` |  |  | The domain the signature prints, defaulting to the identity's own. |
@@ -1615,7 +1639,7 @@ A large metric: the number in the `stat` scale and its name underneath.
 | `label` | `ReactNode` | yes |  | What is being counted. It goes in mono small caps. |
 | `progress` | `number` |  |  | With `progress`, the metric reads as progress and adds the bar. |
 | `spark` | `ReactNode` |  |  | The number's shape over time, under it. A `ReactNode` and not a data prop: a sparkline needs a charting library, and this component lives in the barrel that four projects install. The one project that draws them passes its own, exactly like `icon`. |
-| `tone` | `"neutral" \| "alert" \| "achievement"` |  | `neutral` | `alert` ONLY when the number is the problem, and `achievement` when it is the opposite — the diplomas issued, the modules finished. The two paint the same sand today and they are still two names: a system that names by meaning cannot make «this is bad» the only way to say «this stands out». See `docs/decisions/0.7.md` § 28. |
+| `tone` | `"neutral" \| "alert" \| "achievement"` |  | `neutral` | `alert` ONLY when the number is the problem, and `achievement` when it is the opposite — the diplomas issued, the modules finished. The two paint the same sand today and they are still two names: a system that names by meaning cannot make «this is bad» the only way to say «this stands out». See `docs/decisions/` § 28. |
 | `value` | `ReactNode` | yes |  | The number, already formatted. The library imposes no locale. |
 
 ### TalkCard
@@ -1927,7 +1951,7 @@ it: if the code does not mount React, that subpath is the one to import.
 | `light` | `{ background, surface, surfaceRaised, border, hairline, hairlineHover, textPrimary, textSecondary, textMuted, accent, accentHover, accentOn, warm, warmHover, warmOn, success, warning, error, danger, dangerHover, dangerOn }` | Light mode. Contrast measured against `background` #F6F2EA. `background` is WARM white: never #FFF as the page background. |
 | `limits` | `{ readonly minScreenPx: 13; readonly minPrintPt: 12; readonly measure: "68ch"; }` | Hard legibility limits. |
 | `motion` | `{ readonly duration: "150ms"; readonly easing: "ease-out"; readonly properties: "color, background-color, border-color, fill, stroke"; }` | 150ms ease-out — color and border only. The system animates neither position nor scale: states are communicated with border and color, not with movement. |
-| `naming` | `{ readonly wordmark: "Eduardo Álvarez"; readonly mascot: "Tiburoncín"; readonly domain: "eduardoalvarez.dev"; }` | The wordmark always reads «Eduardo Álvarez». The mascot is called Tiburoncín and its name never appears inside the logo. |
+| `naming` | `{ wordmark, mascot, domain, library, libraryUrl }` | The wordmark always reads «Eduardo Álvarez». The mascot is called Tiburoncín and its name never appears inside the logo. |
 | `radius` | `{ readonly chip: 6; readonly control: 10; readonly card: 14; readonly panel: 16; readonly pill: 999; }` |  |
 | `series` | `{ readonly dark: readonly ["#35D6C0", "#F2A65A", "#3E7CB1", "#71919C"]; readonly light: readonly ["#0D7C6F", "#A65B27", "#3E7CB1", "#626A75"]; }` | The chart series palette. FOUR, for the same reason as the syntax palette: the system communicates with color and border, not with chromatic noise. |
 | `shadow` | `{ readonly standard: "0 1px 2px rgba(0, 0, 0, 0.35)"; }` | A single level. There is no elevation scale. |
@@ -2035,5 +2059,7 @@ Types (60): `AccordionProps`, `AccordionTriggerProps`, `AlertProps`, `ArticleCar
 - `architecture/design-system.md` and `architecture/brand-manual.md`: the identity documents,
   greppable.
 - `decisions/`: the points where the code and the document did not say the
-  same thing, each with its resolution.
+  same thing, each with its resolution. One file per decision, named for its
+  number, so «§ 45» is `decisions/045-*.md` — which is how every `§ N` in this
+  file resolves.
 - `AGENTS.md`: for working inside the library's repo.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eduardoalvarez/arrecife",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "The component library of Eduardo Álvarez’s visual identity",
   "license": "MIT",
   "author": "Eduardo Esteban Álvarez Castañeda <soy@eduardoalvarez.dev>",