@fairgarden/design 0.1.0-alpha.0

package/utils/scope.d.ts

@@ -0,0 +1,119 @@
+import type { PrimaryScale, RadixScale } from './scales';
+/** The six step-3 pastel page grounds [D176]. */
+export declare const pastelPresets: readonly ["tide", "meadow", "pollen", "apricot", "rose", "heather"];
+export type PastelPreset = (typeof pastelPresets)[number];
+/**
+ * The eight page grounds [D176]: follows-mode bands (or faces), painting the
+ * same step in both modes. A page has at most one pastel, as its page
+ * ground, with `paper` and `white` as its secondary bands [D179].
+ */
+export declare const pageGroundPresets: readonly ["paper", "white", "tide", "meadow", "pollen", "apricot", "rose", "heather"];
+export type PageGroundPreset = (typeof pageGroundPresets)[number];
+/**
+ * The seven fields [D177]: inset, fixed-mode surfaces with a radius and a
+ * `--primary12` edge, never full-bleed. `kind="field"` only.
+ */
+export declare const fieldPresets: readonly ["forest", "leaf", "amber", "clay", "pink", "royal", "brick"];
+export type FieldPreset = (typeof fieldPresets)[number];
+/** The presets a full-bleed band takes: the page grounds, and `night` for the footer and the media hero [D177]. */
+export type BandPreset = PageGroundPreset | 'night';
+/** Every v1 preset (§1.4.2) [D180]. */
+export type GroundPreset = PageGroundPreset | 'night' | FieldPreset;
+/**
+ * Ground's structural axis [D178]: a full-bleed `band` (a page ground, or
+ * the `night` band), an inset `field`, or a nested `face` (card face, plate,
+ * panel).
+ */
+export type GroundKind = 'band' | 'field' | 'face';
+/**
+ * Tone, as `roles.css` keys it (§1.4.2, §1.4.3) [D116]: `light-base` (paper,
+ * white), `tinted` (the six pastels, one "pastel" ladder in both modes
+ * [D176]), `dark-base` (night), `dark-tinted` (forest), `solid-light` (leaf,
+ * amber, clay, pink) and `solid-dark` (royal, brick).
+ */
+export type Tone = 'light-base' | 'tinted' | 'dark-base' | 'dark-tinted' | 'solid-light' | 'solid-dark';
+/**
+ * `page`: a follows-mode scope; `light` / `dark`: a fixed-mode scope
+ * (always-light field, light island, always-dark field or band) [D148].
+ */
+export type Scheme = 'page' | 'light' | 'dark';
+export type ModeClass = 'follows' | 'always-light' | 'always-dark';
+/** A preset's family (§1.4.2): which `kind` values accept it. */
+export type PresetFamily = 'page' | 'night' | 'field';
+export interface PresetDefinition {
+    family: PresetFamily;
+    tone: Tone;
+    mode: ModeClass;
+}
+/** §1.4.2 preset table: family, tone and mode class per preset. */
+export declare const presets: Record<GroundPreset, PresetDefinition>;
+export interface PresetDefaults {
+    primary: PrimaryScale;
+    secondary: RadixScale;
+    /** `ink`: the scope publishes its primary as the action scale (the ink pill). */
+    action: RadixScale | 'ink';
+}
+/** §1.4.2: defaults primary × secondary; action. Amber is the action on every page ground [D176]. */
+export declare const presetDefaults: Record<GroundPreset, PresetDefaults>;
+/**
+ * Each page ground's companion field [D177], which replaces the inverse
+ * pairs: the dark field for "inverse" placements and the Dialog's solid
+ * cover.
+ */
+export declare const companionFields: Record<PageGroundPreset, FieldPreset>;
+/** The companion field of a page ground [D177], e.g. `companionField('tide')` is `royal`. */
+export declare function companionField(preset: PageGroundPreset): FieldPreset;
+export declare function isPageGroundPreset(preset: GroundPreset): preset is PageGroundPreset;
+/** A full-bleed band preset: a page ground or `night` (not a field). */
+export declare function isBandPreset(preset: GroundPreset): preset is BandPreset;
+export declare function isPastelPreset(preset: GroundPreset): preset is PastelPreset;
+export declare function isFieldPreset(preset: GroundPreset): preset is FieldPreset;
+export interface ScopeValue {
+    ground: GroundPreset;
+    tone: Tone;
+    scheme: Scheme;
+    /** The scope's `kind` [D178]. */
+    kind: GroundKind;
+}
+export interface ScopeAttributes {
+    'data-ground': GroundPreset;
+    'data-tone': Tone;
+    'data-scheme': Scheme;
+}
+/** The page root is a `paper` band that follows the page mode (§1.4.3). */
+export declare const rootScope: {
+    readonly ground: "paper";
+    readonly tone: "light-base";
+    readonly scheme: "page";
+    readonly kind: "band";
+};
+/**
+ * Portaled overlay faces (menu, popover, dialog, toast) are a `white` scope
+ * that follows the page mode, whatever the trigger's ground [D139].
+ */
+export declare const overlayScope: {
+    readonly ground: "white";
+    readonly tone: "light-base";
+    readonly scheme: "page";
+    readonly kind: "face";
+};
+/**
+ * The nearest ground scope, provided by Ground. React context also reaches
+ * portaled overlays, which is why every root writes the attributes itself.
+ */
+export declare const GroundContext: import("react").Context<ScopeValue>;
+export declare function toScopeAttributes(scope: ScopeValue): ScopeAttributes;
+/** The scope a component root belongs to; the `paper` band without a Ground. */
+export declare function useScope(): ScopeValue;
+/**
+ * Spread onto every component root so `roles.css` re-resolves the `--role-*`
+ * aliases with that root's own `--primary*` / `--secondary*` [D148].
+ */
+export declare function useScopeAttributes(): ScopeAttributes;
+/**
+ * The scheme a nested scope of `preset` takes inside `parent`: fixed presets
+ * (the night band and the fields) keep their mode; a page ground inside a
+ * fixed scope is a light island [D149, D179]; otherwise it follows the page.
+ */
+export declare function resolveScheme(preset: GroundPreset, parent: ScopeValue): Scheme;
+//# sourceMappingURL=scope.d.ts.map

package/utils/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/utils/scope.tsx"],"names":[],"mappings":"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"}

package/utils/scope.js

@@ -0,0 +1,145 @@
+'use client';
+import { createContext, useContext } from 'react';
+/*
+ * The v1 ground presets (§1.4.2) [D176, D177, D180]: eight page grounds, the
+ * `night` band and seven fields, 16 in all. Deferred (sand, spruce, soil)
+ * and retired (lichen) presets are not accepted.
+ */
+/** The six step-3 pastel page grounds [D176]. */
+export const pastelPresets = ['tide', 'meadow', 'pollen', 'apricot', 'rose', 'heather'];
+/**
+ * The eight page grounds [D176]: follows-mode bands (or faces), painting the
+ * same step in both modes. A page has at most one pastel, as its page
+ * ground, with `paper` and `white` as its secondary bands [D179].
+ */
+export const pageGroundPresets = ['paper', 'white', ...pastelPresets];
+/**
+ * The seven fields [D177]: inset, fixed-mode surfaces with a radius and a
+ * `--primary12` edge, never full-bleed. `kind="field"` only.
+ */
+export const fieldPresets = ['forest', 'leaf', 'amber', 'clay', 'pink', 'royal', 'brick'];
+/** §1.4.2 preset table: family, tone and mode class per preset. */
+export const presets = {
+    paper: { family: 'page', tone: 'light-base', mode: 'follows' },
+    white: { family: 'page', tone: 'light-base', mode: 'follows' },
+    tide: { family: 'page', tone: 'tinted', mode: 'follows' },
+    meadow: { family: 'page', tone: 'tinted', mode: 'follows' },
+    pollen: { family: 'page', tone: 'tinted', mode: 'follows' },
+    apricot: { family: 'page', tone: 'tinted', mode: 'follows' },
+    rose: { family: 'page', tone: 'tinted', mode: 'follows' },
+    heather: { family: 'page', tone: 'tinted', mode: 'follows' },
+    night: { family: 'night', tone: 'dark-base', mode: 'always-dark' },
+    forest: { family: 'field', tone: 'dark-tinted', mode: 'always-dark' },
+    leaf: { family: 'field', tone: 'solid-light', mode: 'always-light' },
+    amber: { family: 'field', tone: 'solid-light', mode: 'always-light' },
+    clay: { family: 'field', tone: 'solid-light', mode: 'always-light' },
+    pink: { family: 'field', tone: 'solid-light', mode: 'always-light' },
+    royal: { family: 'field', tone: 'solid-dark', mode: 'always-dark' },
+    brick: { family: 'field', tone: 'solid-dark', mode: 'always-dark' },
+};
+/** §1.4.2: defaults primary × secondary; action. Amber is the action on every page ground [D176]. */
+export const presetDefaults = {
+    paper: { primary: 'olive', secondary: 'green', action: 'amber' },
+    white: { primary: 'olive', secondary: 'green', action: 'amber' },
+    tide: { primary: 'slate', secondary: 'blue', action: 'amber' },
+    meadow: { primary: 'sage', secondary: 'green', action: 'amber' },
+    pollen: { primary: 'sand', secondary: 'yellow', action: 'amber' },
+    apricot: { primary: 'sand', secondary: 'orange', action: 'amber' },
+    rose: { primary: 'mauve', secondary: 'red', action: 'amber' },
+    heather: { primary: 'mauve', secondary: 'purple', action: 'amber' },
+    night: { primary: 'slate', secondary: 'green', action: 'amber' },
+    forest: { primary: 'sage', secondary: 'amber', action: 'amber' },
+    leaf: { primary: 'olive', secondary: 'green', action: 'ink' },
+    amber: { primary: 'olive', secondary: 'amber', action: 'ink' },
+    clay: { primary: 'olive', secondary: 'orange', action: 'ink' },
+    pink: { primary: 'olive', secondary: 'pink', action: 'ink' },
+    royal: { primary: 'slate', secondary: 'indigo', action: 'amber' },
+    brick: { primary: 'mauve', secondary: 'red', action: 'amber' },
+};
+/**
+ * Each page ground's companion field [D177], which replaces the inverse
+ * pairs: the dark field for "inverse" placements and the Dialog's solid
+ * cover.
+ */
+export const companionFields = {
+    paper: 'forest',
+    white: 'forest',
+    meadow: 'forest',
+    pollen: 'forest',
+    tide: 'royal',
+    heather: 'royal',
+    apricot: 'brick',
+    rose: 'brick',
+};
+/** The companion field of a page ground [D177], e.g. `companionField('tide')` is `royal`. */
+export function companionField(preset) {
+    return companionFields[preset];
+}
+export function isPageGroundPreset(preset) {
+    return presets[preset].family === 'page';
+}
+/** A full-bleed band preset: a page ground or `night` (not a field). */
+export function isBandPreset(preset) {
+    return preset === 'night' || isPageGroundPreset(preset);
+}
+export function isPastelPreset(preset) {
+    return presets[preset].tone === 'tinted';
+}
+export function isFieldPreset(preset) {
+    return presets[preset].family === 'field';
+}
+/** The page root is a `paper` band that follows the page mode (§1.4.3). */
+export const rootScope = {
+    ground: 'paper',
+    tone: 'light-base',
+    scheme: 'page',
+    kind: 'band',
+};
+/**
+ * Portaled overlay faces (menu, popover, dialog, toast) are a `white` scope
+ * that follows the page mode, whatever the trigger's ground [D139].
+ */
+export const overlayScope = {
+    ground: 'white',
+    tone: 'light-base',
+    scheme: 'page',
+    kind: 'face',
+};
+/**
+ * The nearest ground scope, provided by Ground. React context also reaches
+ * portaled overlays, which is why every root writes the attributes itself.
+ */
+export const GroundContext = createContext(rootScope);
+GroundContext.displayName = 'GroundContext';
+export function toScopeAttributes(scope) {
+    return {
+        'data-ground': scope.ground,
+        'data-tone': scope.tone,
+        'data-scheme': scope.scheme,
+    };
+}
+/** The scope a component root belongs to; the `paper` band without a Ground. */
+export function useScope() {
+    return useContext(GroundContext);
+}
+/**
+ * Spread onto every component root so `roles.css` re-resolves the `--role-*`
+ * aliases with that root's own `--primary*` / `--secondary*` [D148].
+ */
+export function useScopeAttributes() {
+    return toScopeAttributes(useContext(GroundContext));
+}
+/**
+ * The scheme a nested scope of `preset` takes inside `parent`: fixed presets
+ * (the night band and the fields) keep their mode; a page ground inside a
+ * fixed scope is a light island [D149, D179]; otherwise it follows the page.
+ */
+export function resolveScheme(preset, parent) {
+    const { mode } = presets[preset];
+    if (mode === 'always-dark')
+        return 'dark';
+    if (mode === 'always-light')
+        return 'light';
+    return parent.scheme === 'page' ? 'page' : 'light';
+}
+//# sourceMappingURL=scope.js.map

package/utils/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/utils/scope.tsx"],"names":[],"mappings":"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"}

package/utils/seriesPatterns.d.ts

@@ -0,0 +1,75 @@
+import * as React from 'react';
+/** A series slot of the semantic series order (§8.7): 1 solid, 2–5 patterns, 6 outline. */
+export type SeriesSlot = 1 | 2 | 3 | 4 | 5 | 6;
+/** A sequential step (§8.7): screen fills secondary 4 / 6 / 8 / 11 / 12. */
+export type SequentialStep = 1 | 2 | 3 | 4 | 5;
+/** The primary ink: even slots, slot 6, every edge, axis and label. */
+export declare const INK_PRIMARY = "var(--primary12)";
+/**
+ * The odd slots' ink, `--role-series-odd` (roles.css): `--secondary11` on a
+ * light base ground or a `white` plate, `--primary12` elsewhere (§8.7)
+ * [D125], so the scope picks two inks or one without a prop.
+ */
+export declare const INK_ODD = "var(--role-series-odd)";
+/** The scope's ground: slot 6's inside and every pattern tile's ground. */
+export declare const GROUND = "var(--role-ground)";
+/** The label knockout plate (--primary1 in every scope and mode) [D150]. */
+export declare const HALO = "var(--role-halo)";
+/** Screen fills of the five sequential steps (§8.7). */
+export declare const SEQUENTIAL_FILLS: Record<SequentialStep, string>;
+/** Value ink on each sequential fill: --primary12 on steps 1–3, --role-inverse on 4–5. */
+export declare const SEQUENTIAL_INKS: Record<SequentialStep, string>;
+/**
+ * The ink a slot's marks take: odd slots the scope's odd ink (two-ink or
+ * one-ink by ground), even slots primary; forced one ink, all primary.
+ */
+export declare function slotInk(slot: SeriesSlot, oneInk: boolean): string;
+/** The `id` of one pattern in a figure's defs. */
+export declare function patternId(prefix: string, name: string): string;
+/** The fill a slot's shape takes: solid ink, a pattern reference, or the ground. */
+export declare function slotFill(prefix: string, slot: SeriesSlot, oneInk: boolean): string;
+/** The print (and one-ink screen) fill of a sequential step: step 1 is the empty ground. */
+export declare function stepPatternFill(prefix: string, step: SequentialStep): string;
+/** Makes a React id safe inside `url(#…)` and CSS: letters, digits, `-` and `_`. */
+export declare function safeId(reactId: string, lead: string): string;
+/** Classes the host module gives the pattern parts, for its print and forced-colors rules. */
+export interface PatternClassNames {
+    /** Every mark (hatch line, dot). */
+    mark?: string;
+    /** Standard 1.25 px dots, which print at 1 pt (§1.5.9). */
+    dot?: string;
+    /** The tile ground. */
+    ground?: string;
+}
+/** Props for PatternDefs: which patterns one figure defines, and in which inks. */
+export interface PatternDefsProps {
+    /** The figure's id prefix; each pattern id is `${prefix}-${name}`. */
+    prefix: string;
+    /**
+     * Forces every mark into --primary12. Off, odd slots take
+     * --role-series-odd, which the scope already resolves to --primary12 off
+     * the light base grounds (§8.7).
+     */
+    oneInk: boolean;
+    /** Series slots whose patterns are needed (slots 1 and 6 need none). */
+    slots?: readonly SeriesSlot[];
+    /** Defines the sequential print patterns `step2`–`step5`. */
+    steps?: boolean;
+    /** Defines the map area fills `water`, `green` and `planned` (§8.10). */
+    map?: boolean;
+    /**
+     * Counter-scale for a zoomed drawing, so pattern pitch keeps its screen
+     * size at every zoom level [I7]. Default 1.
+     */
+    scale?: number;
+    /** Classes for the host module's print and forced-colors rules. */
+    classNames?: PatternClassNames;
+}
+/**
+ * One figure's pattern definitions, in a <defs> element: the series slots it
+ * uses in their slot inks (odd --role-series-odd, even --primary12, or all
+ * --primary12 in one ink), the sequential print patterns in --primary12, and
+ * the map area fills (green space in the odd ink, §8.10).
+ */
+export declare function PatternDefs({ prefix, oneInk, slots, steps, map, scale, classNames, }: PatternDefsProps): React.JSX.Element;
+//# sourceMappingURL=seriesPatterns.d.ts.map

package/utils/seriesPatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seriesPatterns.d.ts","sourceRoot":"","sources":["../src/utils/seriesPatterns.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAc9B,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE9C,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAE9C,uEAAuE;AACvE,eAAO,MAAM,WAAW,qBAAqB,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,OAAO,2BAA2B,CAAA;AAE/C,2EAA2E;AAC3E,eAAO,MAAM,MAAM,uBAAuB,CAAA;AAE1C,4EAA4E;AAC5E,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAM3D,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAM1D,CAAA;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAEjE;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAIlF;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CAE5E;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAkCD,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AA6DD,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAA;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IAC7B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,yEAAyE;IACzE,GAAG,CAAC,EAAE,OAAO,CAAA;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,UAAU,CAAC,EAAE,iBAAiB,CAAA;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,MAAM,EACN,KAAU,EACV,KAAa,EACb,GAAW,EACX,KAAS,EACT,UAAe,GAChB,EAAE,gBAAgB,qBAuDlB"}

package/utils/seriesPatterns.js

@@ -0,0 +1,118 @@
+'use client';
+import * as React from 'react';
+import { cx } from './className';
+/** The primary ink: even slots, slot 6, every edge, axis and label. */
+export const INK_PRIMARY = 'var(--primary12)';
+/**
+ * The odd slots' ink, `--role-series-odd` (roles.css): `--secondary11` on a
+ * light base ground or a `white` plate, `--primary12` elsewhere (§8.7)
+ * [D125], so the scope picks two inks or one without a prop.
+ */
+export const INK_ODD = 'var(--role-series-odd)';
+/** The scope's ground: slot 6's inside and every pattern tile's ground. */
+export const GROUND = 'var(--role-ground)';
+/** The label knockout plate (--primary1 in every scope and mode) [D150]. */
+export const HALO = 'var(--role-halo)';
+/** Screen fills of the five sequential steps (§8.7). */
+export const SEQUENTIAL_FILLS = {
+    1: 'var(--secondary4)',
+    2: 'var(--secondary6)',
+    3: 'var(--secondary8)',
+    4: 'var(--secondary11)',
+    5: 'var(--secondary12)',
+};
+/** Value ink on each sequential fill: --primary12 on steps 1–3, --role-inverse on 4–5. */
+export const SEQUENTIAL_INKS = {
+    1: INK_PRIMARY,
+    2: INK_PRIMARY,
+    3: INK_PRIMARY,
+    4: 'var(--role-inverse)',
+    5: 'var(--role-inverse)',
+};
+/**
+ * The ink a slot's marks take: odd slots the scope's odd ink (two-ink or
+ * one-ink by ground), even slots primary; forced one ink, all primary.
+ */
+export function slotInk(slot, oneInk) {
+    return oneInk || slot % 2 === 0 ? INK_PRIMARY : INK_ODD;
+}
+/** The `id` of one pattern in a figure's defs. */
+export function patternId(prefix, name) {
+    return `${prefix}-${name}`;
+}
+/** The fill a slot's shape takes: solid ink, a pattern reference, or the ground. */
+export function slotFill(prefix, slot, oneInk) {
+    if (slot === 1)
+        return slotInk(1, oneInk);
+    if (slot === 6)
+        return GROUND;
+    return `url(#${patternId(prefix, `slot${slot}`)})`;
+}
+/** The print (and one-ink screen) fill of a sequential step: step 1 is the empty ground. */
+export function stepPatternFill(prefix, step) {
+    return step === 1 ? GROUND : `url(#${patternId(prefix, `step${step}`)})`;
+}
+/** Makes a React id safe inside `url(#…)` and CSS: letters, digits, `-` and `_`. */
+export function safeId(reactId, lead) {
+    return `${lead}${reactId.replace(/[^a-zA-Z0-9_-]/g, '')}`;
+}
+/*
+ * §1.5.9 geometry, px: hatch 1 px lines at --ds-hatch-pitch 6 px, measured
+ * perpendicular to the lines (an SVG pattern rotates an exact 6 px tile, so
+ * it needs no 8 px CSS tile); dot screens --ds-dotscreen-dot 1.25 px or
+ * --ds-dotscreen-dot-heavy 2 px at --ds-dotscreen-pitch-1/-2/-3 (6/5/4 px).
+ * SVG pattern attributes cannot read custom properties, so the values are
+ * mirrored here.
+ */
+const HATCH_PITCH = 6;
+const HATCH_LINE = 1;
+const DOT_RADIUS = 0.625;
+const DOT_RADIUS_HEAVY = 1;
+const slotGeometry = {
+    2: { kind: 'hatch', angle: 45 },
+    3: { kind: 'dots', pitch: 5, heavy: false },
+    4: { kind: 'hatch', angle: 0 },
+    5: { kind: 'crossed' },
+};
+const stepGeometry = {
+    2: { kind: 'dots', pitch: 6, heavy: false },
+    3: { kind: 'dots', pitch: 4, heavy: false },
+    4: { kind: 'dots', pitch: 4, heavy: true },
+    5: { kind: 'crossed' },
+};
+function Pattern({ id, geometry, ink, scale, classNames }) {
+    const scaled = scale === 1 ? '' : `scale(${scale}) `;
+    if (geometry.kind === 'dots') {
+        const { pitch, heavy } = geometry;
+        return (React.createElement("pattern", { id: id, patternUnits: "userSpaceOnUse", width: pitch, height: pitch, patternTransform: scaled ? scaled.trim() : undefined },
+            React.createElement("rect", { width: pitch, height: pitch, fill: GROUND, className: classNames.ground }),
+            React.createElement("circle", { cx: pitch / 2, cy: pitch / 2, r: heavy ? DOT_RADIUS_HEAVY : DOT_RADIUS, fill: ink, className: cx(classNames.mark, !heavy && classNames.dot) || undefined })));
+    }
+    const angle = geometry.kind === 'crossed' ? 45 : geometry.angle;
+    // A vertical 1 px line rotated by 45 draws "/", by -45 "\" (y points down).
+    const rotation = angle === 0 ? '' : angle === 45 ? 'rotate(45)' : 'rotate(-45)';
+    const transform = `${scaled}${rotation}`.trim();
+    return (React.createElement("pattern", { id: id, patternUnits: "userSpaceOnUse", width: HATCH_PITCH, height: HATCH_PITCH, patternTransform: transform || undefined },
+        React.createElement("rect", { width: HATCH_PITCH, height: HATCH_PITCH, fill: GROUND, className: classNames.ground }),
+        angle === 0 ? (React.createElement("rect", { width: HATCH_PITCH, height: HATCH_LINE, fill: ink, className: classNames.mark })) : (React.createElement("rect", { width: HATCH_LINE, height: HATCH_PITCH, fill: ink, className: classNames.mark })),
+        geometry.kind === 'crossed' ? (React.createElement("rect", { width: HATCH_PITCH, height: HATCH_LINE, fill: ink, className: classNames.mark })) : null));
+}
+/**
+ * One figure's pattern definitions, in a <defs> element: the series slots it
+ * uses in their slot inks (odd --role-series-odd, even --primary12, or all
+ * --primary12 in one ink), the sequential print patterns in --primary12, and
+ * the map area fills (green space in the odd ink, §8.10).
+ */
+export function PatternDefs({ prefix, oneInk, slots = [], steps = false, map = false, scale = 1, classNames = {}, }) {
+    const patternSlots = Array.from(new Set(slots)).filter((slot) => slot > 1 && slot < 6);
+    return (React.createElement("defs", null,
+        patternSlots.map((slot) => (React.createElement(Pattern, { key: `slot${slot}`, id: patternId(prefix, `slot${slot}`), geometry: slotGeometry[slot], ink: slotInk(slot, oneInk), scale: scale, classNames: classNames }))),
+        steps
+            ? [2, 3, 4, 5].map((step) => (React.createElement(Pattern, { key: `step${step}`, id: patternId(prefix, `step${step}`), geometry: stepGeometry[step], ink: INK_PRIMARY, scale: scale, classNames: classNames })))
+            : null,
+        map ? (React.createElement(React.Fragment, null,
+            React.createElement(Pattern, { id: patternId(prefix, 'water'), geometry: { kind: 'hatch', angle: 45 }, ink: INK_PRIMARY, scale: scale, classNames: classNames }),
+            React.createElement(Pattern, { id: patternId(prefix, 'green'), geometry: { kind: 'dots', pitch: 6, heavy: false }, ink: oneInk ? INK_PRIMARY : INK_ODD, scale: scale, classNames: classNames }),
+            React.createElement(Pattern, { id: patternId(prefix, 'planned'), geometry: { kind: 'hatch', angle: 135 }, ink: INK_PRIMARY, scale: scale, classNames: classNames }))) : null));
+}
+//# sourceMappingURL=seriesPatterns.js.map

package/utils/seriesPatterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seriesPatterns.js","sourceRoot":"","sources":["../src/utils/seriesPatterns.tsx"],"names":[],"mappings":"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"}

package/utils/theme.css

@@ -0,0 +1,28 @@
+/*
+ * Mode blocks (§1.11.9), follow-OS strategy: light on :root and
+ * [data-theme="light"]; dark on [data-theme="dark"] and, screen only, on an
+ * html without data-theme="light". The attribute block follows the :root
+ * block. Scale values and the per-scale contrast inks live in colors.css.
+ */
+@layer theme {
+  :root,
+  [data-theme='light'] {
+    color-scheme: light;
+    --ds-font-fine: var(--ds-font-text);
+    --ds-muted-weight-step: 0;
+  }
+
+  [data-theme='dark'] {
+    color-scheme: dark;
+    --ds-font-fine: var(--ds-font-ui);
+    --ds-muted-weight-step: 100;
+  }
+
+  @media only screen and (prefers-color-scheme: dark) {
+    :root:not([data-theme='light']) {
+      color-scheme: dark;
+      --ds-font-fine: var(--ds-font-ui);
+      --ds-muted-weight-step: 100;
+    }
+  }
+}