@motir/design-system 0.10.1 → 0.12.0

package/dist/theme/fontSets.d.ts

@@ -0,0 +1,222 @@
+/**
+ * The Motir FONT-SET REGISTRY: which faces each locale's script is drawn in
+ * (Story MOTIR-7733 · Subtask MOTIR-7843).
+ *
+ * A Type pairing (`./typography.ts`) decides the LATIN faces of the three roles
+ * (sans / serif / mono). A font set decides the SCRIPT face that sits BEHIND
+ * them, so a ja page draws its Latin in the pairing's face and its kana and
+ * kanji in the ja set's face, under every pairing. The two axes are
+ * independent: a set never changes which pairing is active, and a pairing never
+ * changes which set a locale uses.
+ *
+ * ── Where the rows come from ────────────────────────────────────────────
+ * Every set, member and default below is taken from
+ * `docs/typography/font-sets.md` (MOTIR-7841), which read dooooWeb's mapping at
+ * `225af77` and filled the roles dooooWeb leaves empty from cited references.
+ * `inDooooWeb` carries that document's `in dooooWeb` / `added (not in dooooWeb)`
+ * tag. Change a row here only together with that document; the package test
+ * holds the two equal.
+ *
+ * ── What this module is NOT ─────────────────────────────────────────────
+ * Data and pure resolvers only. It names CSS custom properties (the contract
+ * between the app's `next/font` loader and `theme.css`) but sets none, loads no
+ * face, and writes no CSS. Loading stays in the consuming app.
+ */
+/** The eleven locales app.motir.co ships in. A closed product decision. */
+declare const FONT_SET_LOCALES: readonly ["en", "zh", "ja", "ko", "de", "fr", "es", "it", "nl", "pl", "pt"];
+/** A locale the font-set registry knows. */
+type FontSetLocale = (typeof FONT_SET_LOCALES)[number];
+/** The three type roles every set covers: the same roles `--font-*` carries. */
+declare const FONT_SET_ROLES: readonly ["sans", "serif", "mono"];
+/** One of the three type roles. */
+type FontSetRole = (typeof FONT_SET_ROLES)[number];
+/**
+ * Where a member's face comes from.
+ *
+ * - `type-pairing`: the active Type pairing's own face for the role. The Latin
+ *   set's only member; it loads nothing and has no CSS variable.
+ * - `next/font/google`: a Google Fonts face the app loads with `next/font`;
+ *   `googleFamily` is the loader's export name (`Noto_Sans_JP`).
+ */
+type FontSetMemberSource = {
+    readonly kind: 'type-pairing';
+} | {
+    readonly kind: 'next/font/google';
+    readonly googleFamily: string;
+};
+/** One selectable face in one role of one set. */
+interface FontSetMember {
+    /** Stable kebab-case slug, unique within its role. The value a pick stores. */
+    readonly id: string;
+    /** The display name, or `null` for the `type-pairing` member. */
+    readonly family: string | null;
+    readonly source: FontSetMemberSource;
+    /** `docs/typography/font-sets.md`'s tag: `in dooooWeb` (true) or `added` (false). */
+    readonly inDooooWeb: boolean;
+    /**
+     * The role whose member of the SAME id this member re-uses the face of. A
+     * CJK set's mono role draws its Han glyphs from the set's sans face (the Noto
+     * Sans Mono CJK practice, see the doc), so the face is loaded once and both
+     * roles read one variable.
+     */
+    readonly sameFaceAs?: FontSetRole;
+}
+/** One role of one set: its members, and which one a page uses by default. */
+interface FontSetRoleMembers {
+    /** The id of the member used when nobody has picked one. */
+    readonly default: string;
+    readonly members: readonly FontSetMember[];
+}
+/** A locale group's font set. */
+interface FontSet {
+    readonly id: string;
+    /** Display name for `/tokens` and the picker. */
+    readonly label: string;
+    /**
+     * The BCP 47 tag the set's `:lang()` rule matches. It is the tag the app
+     * renders on `<html lang>` (`zh`, not `zh-Hans`), because `:lang(zh)`
+     * matches `zh` and `zh-Hans` while `:lang(zh-Hans)` does not match `zh`.
+     * `null` for the Latin set, which is matched by its locales instead.
+     */
+    readonly lang: string | null;
+    /** True for a CJK set: its faces are unicode-range sliced and never preloaded. */
+    readonly cjk: boolean;
+    readonly roles: Readonly<Record<FontSetRole, FontSetRoleMembers>>;
+}
+/**
+ * The registry, one entry per set. Ids are the doc's registry ids; dooooWeb's
+ * own group names are noted beside each.
+ */
+declare const FONT_SET_REGISTRY: {
+    readonly latin: {
+        readonly id: "latin";
+        readonly label: "Latin";
+        readonly lang: null;
+        readonly cjk: false;
+        readonly roles: {
+            readonly sans: {
+                readonly default: "type-pairing";
+                readonly members: readonly [FontSetMember];
+            };
+            readonly serif: {
+                readonly default: "type-pairing";
+                readonly members: readonly [FontSetMember];
+            };
+            readonly mono: {
+                readonly default: "type-pairing";
+                readonly members: readonly [FontSetMember];
+            };
+        };
+    };
+    readonly 'zh-Hans': {
+        readonly id: "zh-Hans";
+        readonly label: "Simplified Chinese";
+        readonly lang: "zh";
+        readonly cjk: true;
+        readonly roles: {
+            readonly sans: {
+                readonly default: "noto-sans-sc";
+                readonly members: readonly [FontSetMember];
+            };
+            readonly serif: {
+                readonly default: "noto-serif-sc";
+                readonly members: readonly [FontSetMember, FontSetMember];
+            };
+            readonly mono: {
+                readonly default: "noto-sans-sc";
+                readonly members: readonly [FontSetMember];
+            };
+        };
+    };
+    readonly ja: {
+        readonly id: "ja";
+        readonly label: "Japanese";
+        readonly lang: "ja";
+        readonly cjk: true;
+        readonly roles: {
+            readonly sans: {
+                readonly default: "noto-sans-jp";
+                readonly members: readonly [FontSetMember, FontSetMember];
+            };
+            readonly serif: {
+                readonly default: "noto-serif-jp";
+                readonly members: readonly [FontSetMember];
+            };
+            readonly mono: {
+                readonly default: "noto-sans-jp";
+                readonly members: readonly [FontSetMember];
+            };
+        };
+    };
+    readonly ko: {
+        readonly id: "ko";
+        readonly label: "Korean";
+        readonly lang: "ko";
+        readonly cjk: true;
+        readonly roles: {
+            readonly sans: {
+                readonly default: "noto-sans-kr";
+                readonly members: readonly [FontSetMember, FontSetMember];
+            };
+            readonly serif: {
+                readonly default: "noto-serif-kr";
+                readonly members: readonly [FontSetMember];
+            };
+            readonly mono: {
+                readonly default: "noto-sans-kr";
+                readonly members: readonly [FontSetMember];
+            };
+        };
+    };
+};
+/** The id of every registered set. */
+type FontSetId = keyof typeof FONT_SET_REGISTRY;
+/** All set ids, in registry order. */
+declare const FONT_SET_IDS: FontSetId[];
+/** The set an unknown or empty page language falls back to: the app renders it in English. */
+declare const DEFAULT_FONT_SET_ID: FontSetId;
+/** Which set each locale is drawn in (font-sets.md § Locale → set). */
+declare const LOCALE_FONT_SET: {
+    readonly en: "latin";
+    readonly zh: "zh-Hans";
+    readonly ja: "ja";
+    readonly ko: "ko";
+    readonly de: "latin";
+    readonly fr: "latin";
+    readonly es: "latin";
+    readonly it: "latin";
+    readonly nl: "latin";
+    readonly pl: "latin";
+    readonly pt: "latin";
+};
+/** Narrowing guard: is an arbitrary value one of the eleven locales? */
+declare function isFontSetLocale(value: unknown): value is FontSetLocale;
+/**
+ * The set for an `<html lang>` value. Matches the primary subtag
+ * case-insensitively (`ja-JP` → ja, `PT-br` → pt, `zh-Hans` → zh).
+ *
+ * The fallback is explicit: an empty or unknown tag returns the Latin set,
+ * because the app renders an unknown language in English. It never falls back
+ * to "the nearest CJK set". Use `isFontSetLocale` on the primary subtag to tell
+ * a fallback from a match.
+ */
+declare function resolveFontSet(lang: string): FontSet;
+/**
+ * A member of one role of one set, by id. A missing or unknown id (a stored
+ * pick naming a member that has since been removed) returns that role's
+ * default, never another set's face.
+ */
+declare function resolveFontSetMember(setId: FontSetId, role: FontSetRole, memberId?: string): FontSetMember;
+/**
+ * The CSS custom property the app's `next/font` loader assigns to a member's
+ * face and `theme.css` reads: `--font-set-<set>-<role>-<member>`. This name is
+ * the contract between the registry, the loader and the stylesheet, so it is
+ * built here and nowhere else.
+ *
+ * A member that re-uses another role's face (`sameFaceAs`) returns THAT role's
+ * variable, so the face is declared once. The `type-pairing` member, and an id
+ * the role does not have, return `null`.
+ */
+declare function fontSetMemberVar(setId: FontSetId, role: FontSetRole, memberId: string): string | null;
+
+export { DEFAULT_FONT_SET_ID, FONT_SET_IDS, FONT_SET_LOCALES, FONT_SET_REGISTRY, FONT_SET_ROLES, type FontSet, type FontSetId, type FontSetLocale, type FontSetMember, type FontSetMemberSource, type FontSetRole, type FontSetRoleMembers, LOCALE_FONT_SET, fontSetMemberVar, isFontSetLocale, resolveFontSet, resolveFontSetMember };

package/dist/theme/fontSets.js

@@ -0,0 +1,155 @@
+// src/theme/fontSets.ts
+var FONT_SET_LOCALES = [
+  "en",
+  "zh",
+  "ja",
+  "ko",
+  "de",
+  "fr",
+  "es",
+  "it",
+  "nl",
+  "pl",
+  "pt"
+];
+var FONT_SET_ROLES = ["sans", "serif", "mono"];
+var TYPE_PAIRING = {
+  id: "type-pairing",
+  family: null,
+  source: { kind: "type-pairing" },
+  inDooooWeb: false
+};
+function google(id, family, inDooooWeb, sameFaceAs) {
+  return {
+    id,
+    family,
+    source: { kind: "next/font/google", googleFamily: family.replace(/ /g, "_") },
+    inDooooWeb,
+    ...sameFaceAs ? { sameFaceAs } : {}
+  };
+}
+var FONT_SET_REGISTRY = {
+  // dooooWeb: `latin`. Its Latin picker faces are deliberately not members:
+  // behind the pairing's face they would never draw a glyph (font-sets.md § latin).
+  latin: {
+    id: "latin",
+    label: "Latin",
+    lang: null,
+    cjk: false,
+    roles: {
+      sans: { default: "type-pairing", members: [TYPE_PAIRING] },
+      serif: { default: "type-pairing", members: [TYPE_PAIRING] },
+      mono: { default: "type-pairing", members: [TYPE_PAIRING] }
+    }
+  },
+  // dooooWeb: `chinese-simplified`.
+  "zh-Hans": {
+    id: "zh-Hans",
+    label: "Simplified Chinese",
+    lang: "zh",
+    cjk: true,
+    roles: {
+      sans: { default: "noto-sans-sc", members: [google("noto-sans-sc", "Noto Sans SC", false)] },
+      serif: {
+        default: "noto-serif-sc",
+        members: [
+          google("noto-serif-sc", "Noto Serif SC", true),
+          // Draws Traditional / inherited forms, so never the default (font-sets.md § Region forms).
+          google("lxgw-wenkai-tc", "LXGW WenKai TC", true)
+        ]
+      },
+      mono: {
+        default: "noto-sans-sc",
+        members: [google("noto-sans-sc", "Noto Sans SC", false, "sans")]
+      }
+    }
+  },
+  // dooooWeb: `japanese`.
+  ja: {
+    id: "ja",
+    label: "Japanese",
+    lang: "ja",
+    cjk: true,
+    roles: {
+      sans: {
+        default: "noto-sans-jp",
+        members: [
+          google("noto-sans-jp", "Noto Sans JP", true),
+          google("m-plus-rounded-1c", "M PLUS Rounded 1c", true)
+        ]
+      },
+      serif: {
+        default: "noto-serif-jp",
+        members: [google("noto-serif-jp", "Noto Serif JP", false)]
+      },
+      mono: {
+        default: "noto-sans-jp",
+        members: [google("noto-sans-jp", "Noto Sans JP", false, "sans")]
+      }
+    }
+  },
+  // dooooWeb: `korean`.
+  ko: {
+    id: "ko",
+    label: "Korean",
+    lang: "ko",
+    cjk: true,
+    roles: {
+      sans: {
+        default: "noto-sans-kr",
+        members: [
+          google("noto-sans-kr", "Noto Sans KR", true),
+          google("nanum-gothic", "Nanum Gothic", true)
+        ]
+      },
+      serif: {
+        default: "noto-serif-kr",
+        members: [google("noto-serif-kr", "Noto Serif KR", false)]
+      },
+      mono: {
+        default: "noto-sans-kr",
+        members: [google("noto-sans-kr", "Noto Sans KR", false, "sans")]
+      }
+    }
+  }
+};
+var FONT_SET_IDS = Object.keys(FONT_SET_REGISTRY);
+var DEFAULT_FONT_SET_ID = "latin";
+var LOCALE_FONT_SET = {
+  en: "latin",
+  zh: "zh-Hans",
+  ja: "ja",
+  ko: "ko",
+  de: "latin",
+  fr: "latin",
+  es: "latin",
+  it: "latin",
+  nl: "latin",
+  pl: "latin",
+  pt: "latin"
+};
+function isFontSetLocale(value) {
+  return typeof value === "string" && FONT_SET_LOCALES.includes(value);
+}
+function resolveFontSet(lang) {
+  const primary = lang.trim().split(/[-_]/)[0]?.toLowerCase() ?? "";
+  const id = isFontSetLocale(primary) ? LOCALE_FONT_SET[primary] : DEFAULT_FONT_SET_ID;
+  return FONT_SET_REGISTRY[id];
+}
+function resolveFontSetMember(setId, role, memberId) {
+  const r = FONT_SET_REGISTRY[setId].roles[role];
+  const named = memberId === void 0 ? void 0 : r.members.find((m) => m.id === memberId);
+  return named ?? r.members.find((m) => m.id === r.default);
+}
+function fontSetMemberVar(setId, role, memberId) {
+  const member = FONT_SET_REGISTRY[setId].roles[role].members.find(
+    (m) => m.id === memberId
+  );
+  if (!member || member.source.kind === "type-pairing") return null;
+  const faceRole = member.sameFaceAs ?? role;
+  return `--font-set-${setId}-${faceRole}-${member.id}`;
+}
+
+export { DEFAULT_FONT_SET_ID, FONT_SET_IDS, FONT_SET_LOCALES, FONT_SET_REGISTRY, FONT_SET_ROLES, LOCALE_FONT_SET, fontSetMemberVar, isFontSetLocale, resolveFontSet, resolveFontSetMember };
+//# sourceMappingURL=fontSets.js.map
+//# sourceMappingURL=fontSets.js.map

package/dist/theme/fontSets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/fontSets.ts"],"names":[],"mappings":"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","file":"fontSets.js","sourcesContent":["/**\n * The Motir FONT-SET REGISTRY: which faces each locale's script is drawn in\n * (Story MOTIR-7733 · Subtask MOTIR-7843).\n *\n * A Type pairing (`./typography.ts`) decides the LATIN faces of the three roles\n * (sans / serif / mono). A font set decides the SCRIPT face that sits BEHIND\n * them, so a ja page draws its Latin in the pairing's face and its kana and\n * kanji in the ja set's face, under every pairing. The two axes are\n * independent: a set never changes which pairing is active, and a pairing never\n * changes which set a locale uses.\n *\n * ── Where the rows come from ────────────────────────────────────────────\n * Every set, member and default below is taken from\n * `docs/typography/font-sets.md` (MOTIR-7841), which read dooooWeb's mapping at\n * `225af77` and filled the roles dooooWeb leaves empty from cited references.\n * `inDooooWeb` carries that document's `in dooooWeb` / `added (not in dooooWeb)`\n * tag. Change a row here only together with that document; the package test\n * holds the two equal.\n *\n * ── What this module is NOT ─────────────────────────────────────────────\n * Data and pure resolvers only. It names CSS custom properties (the contract\n * between the app's `next/font` loader and `theme.css`) but sets none, loads no\n * face, and writes no CSS. Loading stays in the consuming app.\n */\n\n/** The eleven locales app.motir.co ships in. A closed product decision. */\nexport const FONT_SET_LOCALES = [\n  'en',\n  'zh',\n  'ja',\n  'ko',\n  'de',\n  'fr',\n  'es',\n  'it',\n  'nl',\n  'pl',\n  'pt',\n] as const;\n\n/** A locale the font-set registry knows. */\nexport type FontSetLocale = (typeof FONT_SET_LOCALES)[number];\n\n/** The three type roles every set covers: the same roles `--font-*` carries. */\nexport const FONT_SET_ROLES = ['sans', 'serif', 'mono'] as const;\n\n/** One of the three type roles. */\nexport type FontSetRole = (typeof FONT_SET_ROLES)[number];\n\n/**\n * Where a member's face comes from.\n *\n * - `type-pairing`: the active Type pairing's own face for the role. The Latin\n *   set's only member; it loads nothing and has no CSS variable.\n * - `next/font/google`: a Google Fonts face the app loads with `next/font`;\n *   `googleFamily` is the loader's export name (`Noto_Sans_JP`).\n */\nexport type FontSetMemberSource =\n  | { readonly kind: 'type-pairing' }\n  | { readonly kind: 'next/font/google'; readonly googleFamily: string };\n\n/** One selectable face in one role of one set. */\nexport interface FontSetMember {\n  /** Stable kebab-case slug, unique within its role. The value a pick stores. */\n  readonly id: string;\n  /** The display name, or `null` for the `type-pairing` member. */\n  readonly family: string | null;\n  readonly source: FontSetMemberSource;\n  /** `docs/typography/font-sets.md`'s tag: `in dooooWeb` (true) or `added` (false). */\n  readonly inDooooWeb: boolean;\n  /**\n   * The role whose member of the SAME id this member re-uses the face of. A\n   * CJK set's mono role draws its Han glyphs from the set's sans face (the Noto\n   * Sans Mono CJK practice, see the doc), so the face is loaded once and both\n   * roles read one variable.\n   */\n  readonly sameFaceAs?: FontSetRole;\n}\n\n/** One role of one set: its members, and which one a page uses by default. */\nexport interface FontSetRoleMembers {\n  /** The id of the member used when nobody has picked one. */\n  readonly default: string;\n  readonly members: readonly FontSetMember[];\n}\n\n/** A locale group's font set. */\nexport interface FontSet {\n  readonly id: string;\n  /** Display name for `/tokens` and the picker. */\n  readonly label: string;\n  /**\n   * The BCP 47 tag the set's `:lang()` rule matches. It is the tag the app\n   * renders on `<html lang>` (`zh`, not `zh-Hans`), because `:lang(zh)`\n   * matches `zh` and `zh-Hans` while `:lang(zh-Hans)` does not match `zh`.\n   * `null` for the Latin set, which is matched by its locales instead.\n   */\n  readonly lang: string | null;\n  /** True for a CJK set: its faces are unicode-range sliced and never preloaded. */\n  readonly cjk: boolean;\n  readonly roles: Readonly<Record<FontSetRole, FontSetRoleMembers>>;\n}\n\nconst TYPE_PAIRING: FontSetMember = {\n  id: 'type-pairing',\n  family: null,\n  source: { kind: 'type-pairing' },\n  inDooooWeb: false,\n};\n\nfunction google(\n  id: string,\n  family: string,\n  inDooooWeb: boolean,\n  sameFaceAs?: FontSetRole,\n): FontSetMember {\n  return {\n    id,\n    family,\n    source: { kind: 'next/font/google', googleFamily: family.replace(/ /g, '_') },\n    inDooooWeb,\n    ...(sameFaceAs ? { sameFaceAs } : {}),\n  };\n}\n\n/**\n * The registry, one entry per set. Ids are the doc's registry ids; dooooWeb's\n * own group names are noted beside each.\n */\nexport const FONT_SET_REGISTRY = {\n  // dooooWeb: `latin`. Its Latin picker faces are deliberately not members:\n  // behind the pairing's face they would never draw a glyph (font-sets.md § latin).\n  latin: {\n    id: 'latin',\n    label: 'Latin',\n    lang: null,\n    cjk: false,\n    roles: {\n      sans: { default: 'type-pairing', members: [TYPE_PAIRING] },\n      serif: { default: 'type-pairing', members: [TYPE_PAIRING] },\n      mono: { default: 'type-pairing', members: [TYPE_PAIRING] },\n    },\n  },\n  // dooooWeb: `chinese-simplified`.\n  'zh-Hans': {\n    id: 'zh-Hans',\n    label: 'Simplified Chinese',\n    lang: 'zh',\n    cjk: true,\n    roles: {\n      sans: { default: 'noto-sans-sc', members: [google('noto-sans-sc', 'Noto Sans SC', false)] },\n      serif: {\n        default: 'noto-serif-sc',\n        members: [\n          google('noto-serif-sc', 'Noto Serif SC', true),\n          // Draws Traditional / inherited forms, so never the default (font-sets.md § Region forms).\n          google('lxgw-wenkai-tc', 'LXGW WenKai TC', true),\n        ],\n      },\n      mono: {\n        default: 'noto-sans-sc',\n        members: [google('noto-sans-sc', 'Noto Sans SC', false, 'sans')],\n      },\n    },\n  },\n  // dooooWeb: `japanese`.\n  ja: {\n    id: 'ja',\n    label: 'Japanese',\n    lang: 'ja',\n    cjk: true,\n    roles: {\n      sans: {\n        default: 'noto-sans-jp',\n        members: [\n          google('noto-sans-jp', 'Noto Sans JP', true),\n          google('m-plus-rounded-1c', 'M PLUS Rounded 1c', true),\n        ],\n      },\n      serif: {\n        default: 'noto-serif-jp',\n        members: [google('noto-serif-jp', 'Noto Serif JP', false)],\n      },\n      mono: {\n        default: 'noto-sans-jp',\n        members: [google('noto-sans-jp', 'Noto Sans JP', false, 'sans')],\n      },\n    },\n  },\n  // dooooWeb: `korean`.\n  ko: {\n    id: 'ko',\n    label: 'Korean',\n    lang: 'ko',\n    cjk: true,\n    roles: {\n      sans: {\n        default: 'noto-sans-kr',\n        members: [\n          google('noto-sans-kr', 'Noto Sans KR', true),\n          google('nanum-gothic', 'Nanum Gothic', true),\n        ],\n      },\n      serif: {\n        default: 'noto-serif-kr',\n        members: [google('noto-serif-kr', 'Noto Serif KR', false)],\n      },\n      mono: {\n        default: 'noto-sans-kr',\n        members: [google('noto-sans-kr', 'Noto Sans KR', false, 'sans')],\n      },\n    },\n  },\n} as const satisfies Record<string, FontSet>;\n\n/** The id of every registered set. */\nexport type FontSetId = keyof typeof FONT_SET_REGISTRY;\n\n/** All set ids, in registry order. */\nexport const FONT_SET_IDS = Object.keys(FONT_SET_REGISTRY) as FontSetId[];\n\n/** The set an unknown or empty page language falls back to: the app renders it in English. */\nexport const DEFAULT_FONT_SET_ID: FontSetId = 'latin';\n\n/** Which set each locale is drawn in (font-sets.md § Locale → set). */\nexport const LOCALE_FONT_SET = {\n  en: 'latin',\n  zh: 'zh-Hans',\n  ja: 'ja',\n  ko: 'ko',\n  de: 'latin',\n  fr: 'latin',\n  es: 'latin',\n  it: 'latin',\n  nl: 'latin',\n  pl: 'latin',\n  pt: 'latin',\n} as const satisfies Record<FontSetLocale, FontSetId>;\n\n/** Narrowing guard: is an arbitrary value one of the eleven locales? */\nexport function isFontSetLocale(value: unknown): value is FontSetLocale {\n  return typeof value === 'string' && (FONT_SET_LOCALES as readonly string[]).includes(value);\n}\n\n/**\n * The set for an `<html lang>` value. Matches the primary subtag\n * case-insensitively (`ja-JP` → ja, `PT-br` → pt, `zh-Hans` → zh).\n *\n * The fallback is explicit: an empty or unknown tag returns the Latin set,\n * because the app renders an unknown language in English. It never falls back\n * to \"the nearest CJK set\". Use `isFontSetLocale` on the primary subtag to tell\n * a fallback from a match.\n */\nexport function resolveFontSet(lang: string): FontSet {\n  const primary = lang.trim().split(/[-_]/)[0]?.toLowerCase() ?? '';\n  const id = isFontSetLocale(primary) ? LOCALE_FONT_SET[primary] : DEFAULT_FONT_SET_ID;\n  return FONT_SET_REGISTRY[id];\n}\n\n/**\n * A member of one role of one set, by id. A missing or unknown id (a stored\n * pick naming a member that has since been removed) returns that role's\n * default, never another set's face.\n */\nexport function resolveFontSetMember(\n  setId: FontSetId,\n  role: FontSetRole,\n  memberId?: string,\n): FontSetMember {\n  const r: FontSetRoleMembers = FONT_SET_REGISTRY[setId].roles[role];\n  const named = memberId === undefined ? undefined : r.members.find((m) => m.id === memberId);\n  return named ?? r.members.find((m) => m.id === r.default)!;\n}\n\n/**\n * The CSS custom property the app's `next/font` loader assigns to a member's\n * face and `theme.css` reads: `--font-set-<set>-<role>-<member>`. This name is\n * the contract between the registry, the loader and the stylesheet, so it is\n * built here and nowhere else.\n *\n * A member that re-uses another role's face (`sameFaceAs`) returns THAT role's\n * variable, so the face is declared once. The `type-pairing` member, and an id\n * the role does not have, return `null`.\n */\nexport function fontSetMemberVar(\n  setId: FontSetId,\n  role: FontSetRole,\n  memberId: string,\n): string | null {\n  const member = FONT_SET_REGISTRY[setId].roles[role].members.find(\n    (m: FontSetMember) => m.id === memberId,\n  );\n  if (!member || member.source.kind === 'type-pairing') return null;\n  const faceRole = member.sameFaceAs ?? role;\n  return `--font-set-${setId}-${faceRole}-${member.id}`;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motir/design-system",
-  "version": "0.10.1",
+  "version": "0.12.0",
   "description": "Motir's 3-axis design system (colour · style · type): distributable token CSS, the axis registries, the theme-apply API, and framework-agnostic React primitives. Shared by motir-core and planner-scaffolded products.",
   "license": "GPL-3.0-only",
   "repository": {
@@ -66,6 +66,6 @@
     "happy-dom": "^20.9.0",
     "tsup": "^8.5.0",
     "typescript": "^5",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.11"
   }
 }