@ahoo-wang/wow-view-engine 9.2.0-rc.0

package/dist/ui/theme/tokens.d.ts

@@ -0,0 +1,1526 @@
+/**
+ * The theme's contract, as data: every host variable a host or a preset may
+ * write, and what the engine does with it (ui/theme.md「登记表：合同只有一个来源」, D46).
+ *
+ * This is the one source the rest is made from or held to — the README's
+ * token tables (`test/themeFiles.test.ts`, with the words in `tokenDocs.ts`),
+ * the `FveToken` type, the rules `scripts/verify-package.mjs` checks the
+ * built stylesheets by (through `dist/theme-tokens.json`, written from here
+ * at build time), the contrast pairs both the jsdom suite and the browser
+ * matrix measure (`pairs.ts`), and the tokens a chart reads and the
+ * attributes it watches (below).
+ *
+ * It holds structure and never a value: the values are in `styles.css` and
+ * the preset sources, which stay the runtime's one source of truth, and the
+ * tests hold the two together — every entry the stylesheet declares where
+ * this says, every `--fve-*` the package reads is here.
+ *
+ * Three layers write a token (ui/theme.md「三层变量」, S2): the host writes
+ * `--fve-<name>`, a preset — a built-in one, a host's own or the shadcn
+ * bridge — writes `--fvp-<name>`, and the stylesheet reads
+ * `var(--fve-<name>, var(--fvp-<name>, <built-in>))`, so the host is read
+ * first under any nesting and any pin. What the engine derives or measures
+ * for itself is `--_fve-*` and is not here: it is no one's to write.
+ */
+/**
+ * Who a token is for, by what it describes (ui/theme.md「登记表：合同只有一个来源」):
+ *
+ * - `semantic` — shadcn's colour names and the engine's own derived ones.
+ * - `role` — one surface of the engine's own, falling back to a semantic
+ *   token or to what was drawn before it existed (S3).
+ * - `group` — a preset's parameter set: some given whole or not at all.
+ * - `axis` — an input a host gives beside any preset (the brand colour).
+ * - `layout` — a host's length or level, not the theme's at all.
+ */
+export type TokenTier = 'semantic' | 'role' | 'group' | 'axis' | 'layout';
+/** What a token's value is, and so how a tool reads it. */
+export type TokenKind = 'color' | 'length' | 'number' | 'shadow' | 'font' | 'keyword';
+/**
+ * A preset's optional parameter sets (D35 Q62): a palette, a ladder of
+ * lifts, a font stack, a switch, a step and the bounds a brand colour is
+ * held to on its grounds — none of them one surface of the engine's. The groups that were surfaces (`canvas`, `card`,
+ * `controls`, `title`, D43) are roles since S3 (ui/theme.md「角色：引擎自己的面」).
+ */
+export type TokenGroup = 'chart' | 'shadow' | 'font' | 'patterns' | 'density' | 'brand';
+/**
+ * Which part of the surface a role paints (ui/theme.md「角色：引擎自己的面」): the
+ * grounds and the cards on them, the tables, what marks a state, focus, the
+ * controls, the shapes, the type, what floats over the rest, and the charts
+ * (6.2), which the library draws off the cascade and so read theirs back.
+ */
+export type RoleArea = 'surface' | 'table' | 'state' | 'focus' | 'control' | 'shape' | 'type' | 'float' | 'chart';
+export interface TokenEntry {
+    /** The token, as `--fve-<name>` spells it. */
+    readonly name: string;
+    readonly tier: TokenTier;
+    readonly kind: TokenKind;
+    /** `2` when it has a dark half, `--fve-dark-<name>`. */
+    readonly modes: 1 | 2;
+    /**
+     * The token blocks of `styles.css` declare `--<name>`, reading
+     * `--fve-<name>` (and its dark half) with the built-in value behind it.
+     * Otherwise the variable is read where it is used.
+     */
+    readonly block?: boolean;
+    /**
+     * The block declares it under the engine's own name, `--_fve-<name>`,
+     * rather than `--<name>`: a name of this package's, not one of shadcn's,
+     * so the tokens boundary on a host's chrome does not shadow a variable of
+     * the host's that happens to share it (ui/theme.md「三层变量」).
+     */
+    readonly own?: boolean;
+    /**
+     * A preset may set it, as `--fvp-<name>`; the reset rule of `styles.css`
+     * (`@layer fve-reset`) clears it on every element that names a preset.
+     */
+    readonly preset?: boolean;
+    /** `shadcn-bridge.css` points it at the host's shadcn token of its name. */
+    readonly bridge?: boolean;
+    /** A chart reads it (`CHART_TOKENS`). */
+    readonly chart?: boolean;
+    /** The optional group a preset gives it in. */
+    readonly group?: TokenGroup;
+    /** The part of the surface a role paints; every role has one. */
+    readonly area?: RoleArea;
+    /** The token its built-in value is, when that is another token. */
+    readonly fallback?: string;
+    /**
+     * Derived from the host's brand colour (`--fve-brand`) when there is one
+     * (ui/theme.md「品牌色是输入，不是预设」, S4): the block reads
+     * `var(--fve-<name>, var(--_fve-brand-<name>, var(--fvp-<name>, …)))`, so
+     * the host's own value beats the brand and the brand beats the preset's
+     * literal. With no brand colour the derived value is invalid and the
+     * preset's literal is read, as before.
+     */
+    readonly brand?: boolean;
+    /**
+     * A link (ui/theme.md「链接：角色跟着面上解析出的 token」): this token says how much of a token
+     * the surface has resolved — `to` — the role `role` is drawn in. The
+     * stylesheet's link rule declares
+     * `--_fve-link-<role>: color-mix(in oklab, var(<to>) var(--_fve-<name>),
+     * transparent)`, and the role reads it between the host and the preset:
+     * `var(--fve-<role>, var(--_fve-link-<role>, var(--fvp-<role>, …)))`.
+     * Unset, the link is invalid and the role reads the preset, as before.
+     * Resolved on the surface, so it follows a brand colour, a host's own
+     * `--fve-primary` and the mode, which a preset's value cannot: a preset
+     * block sits where its attribute is, above the surface, and a `var()` in
+     * it is worked out there.
+     */
+    readonly link?: {
+        readonly role: string;
+        readonly to: string;
+    };
+    /**
+     * The height of something a reader presses — a control, a filter's chip,
+     * a view in the list — held to `TARGET_FLOOR` (`pairs.ts`, WCAG 2.5.8):
+     * theme-check reports a value under it as an error.
+     */
+    readonly target?: boolean;
+}
+/**
+ * Each optional group, and whether a preset has to give it whole. Only a
+ * set whose members are one design has to be: the eight chart slots are
+ * measured against each other for colour-vision distance, and the three
+ * lifts are one ladder. Any other member a preset leaves out is the
+ * built-in value, since the reset rule clears what an outer preset gave
+ * (ui/theme.md「三层变量」).
+ */
+export declare const TOKEN_GROUPS: Readonly<Record<TokenGroup, {
+    readonly whole: boolean;
+}>>;
+/**
+ * Every host variable, in the order the README lists them. The private
+ * variables the engine writes for itself (the expanded view's box, a pinned
+ * column's offset, the chart's tap hint, a popup's type) are not the
+ * contract and are not here: they are `--_fve-*`.
+ */
+export declare const TOKENS: readonly [{
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "background";
+}, {
+    readonly chart: true;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "foreground";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "card";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "card-foreground";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "popover";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "popover-foreground";
+}, {
+    readonly brand: true;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "primary";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "primary-foreground";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "secondary";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "secondary-foreground";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "muted";
+}, {
+    readonly chart: true;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "muted-foreground";
+}, {
+    readonly brand: true;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "accent";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "accent-foreground";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "sidebar";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "sidebar-foreground";
+}, {
+    readonly brand: true;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "sidebar-accent";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "sidebar-accent-foreground";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "sidebar-border";
+}, {
+    readonly chart: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "destructive";
+}, {
+    readonly chart: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "success";
+}, {
+    readonly chart: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "warning";
+}, {
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "border";
+}, {
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "input";
+}, {
+    readonly brand: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "ring";
+}, {
+    readonly fallback: "background";
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "destructive-foreground";
+}, {
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "quiet-foreground";
+}, {
+    readonly brand: true;
+    readonly fallback: "primary";
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "primary-fill";
+}, {
+    readonly fallback: "primary-foreground";
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "primary-fill-foreground";
+}, {
+    readonly preset: false;
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly name: "pin-shadow";
+}, {
+    readonly brand: true;
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-1";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-2";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-3";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-4";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-5";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-6";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-7";
+}, {
+    readonly tier: "group";
+    readonly group: "chart";
+    readonly chart: true;
+    readonly bridge: false;
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "chart-8";
+}, {
+    readonly kind: "length";
+    readonly modes: 1;
+    readonly tier: "semantic";
+    readonly block: true;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly name: "radius";
+}, {
+    readonly kind: "length";
+    readonly modes: 1;
+    readonly preset: false;
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly block: true;
+    readonly name: "text-ui";
+}, {
+    readonly name: "font-sans";
+    readonly tier: "group";
+    readonly kind: "font";
+    readonly modes: 1;
+    readonly preset: true;
+    readonly bridge: true;
+    readonly group: "font";
+}, {
+    readonly name: "chart-patterns";
+    readonly tier: "group";
+    readonly kind: "keyword";
+    readonly modes: 1;
+    readonly preset: true;
+    readonly chart: true;
+    readonly group: "patterns";
+}, {
+    readonly name: "brand";
+    readonly tier: "axis";
+    readonly kind: "color";
+    readonly modes: 2;
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-l-min";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-l-max";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-c-max";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-ring-l-min";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-ring-l-max";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-primary-fill-l-min";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-primary-fill-l-max";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-accent-lc";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-sidebar-accent-lc";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-row-selected-lc";
+}, {
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 2;
+    readonly preset: true;
+    readonly group: "brand";
+    readonly name: "brand-chart-1-lc";
+}, {
+    readonly name: "preset-density";
+    readonly tier: "group";
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly preset: true;
+    readonly group: "density";
+}, {
+    readonly preset: false;
+    readonly chart: true;
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly name: "rise";
+}, {
+    readonly preset: false;
+    readonly chart: true;
+    readonly own: true;
+    readonly bridge: false;
+    readonly tier: "semantic";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly name: "fall";
+}, {
+    readonly tier: "group";
+    readonly kind: "shadow";
+    readonly group: "shadow";
+    readonly bridge: false;
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "shadow-sm";
+}, {
+    readonly tier: "group";
+    readonly kind: "shadow";
+    readonly group: "shadow";
+    readonly bridge: false;
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "shadow-md";
+}, {
+    readonly tier: "group";
+    readonly kind: "shadow";
+    readonly group: "shadow";
+    readonly bridge: false;
+    readonly modes: 2;
+    readonly block: true;
+    readonly preset: true;
+    readonly name: "shadow-lg";
+}, {
+    readonly fallback: "background";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "canvas";
+}, {
+    readonly fallback: "background";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "content";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "card-edge";
+}, {
+    readonly kind: "shadow";
+    readonly tier: "role";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "card-shadow";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "scrim";
+}, {
+    readonly fallback: "muted";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "table-header";
+}, {
+    readonly fallback: "foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "table-header-foreground";
+}, {
+    readonly fallback: "strong-weight";
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "table-header-weight";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "table-header-divider";
+}, {
+    readonly fallback: "muted";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "totals";
+}, {
+    readonly fallback: "muted";
+    readonly brand: true;
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-selected";
+}, {
+    readonly fallback: "foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-selected-foreground";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-hover";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-selected-mark";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-selected-mark-link";
+}, {
+    readonly fallback: "content";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-stripe";
+}, {
+    readonly fallback: "border";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "row-divider";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "table-sort-idle";
+}, {
+    readonly fallback: "accent";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "highlight";
+}, {
+    readonly fallback: "accent-foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "highlight-foreground";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "highlight-link";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "highlight-foreground-link";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "item-selected";
+}, {
+    readonly fallback: "popover-foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "item-selected-foreground";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "item-selected-weight";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "item-selected-link";
+}, {
+    readonly fallback: "background";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "nav-current";
+}, {
+    readonly fallback: "foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "nav-current-foreground";
+}, {
+    readonly fallback: "border";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "nav-current-edge";
+}, {
+    readonly kind: "shadow";
+    readonly tier: "role";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "nav-current-shadow";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "nav-current-link";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "nav-current-foreground-link";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-hover";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-pressed";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "outline-hover-edge";
+}, {
+    readonly fallback: "foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "outline-hover-foreground";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "outline-hover-edge-link";
+}, {
+    readonly kind: "number";
+    readonly modes: 1;
+    readonly link: {
+        readonly role: string;
+        readonly to: string;
+    };
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "outline-hover-foreground-link";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "focus-width";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "focus-offset";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "focus-style";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "focus-halo";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-edge";
+}, {
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-thumb";
+}, {
+    readonly kind: "shadow";
+    readonly tier: "role";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-thumb-shadow";
+}, {
+    readonly target: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-height";
+}, {
+    readonly target: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "control-height-sm";
+}, {
+    readonly target: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "filter-height";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "edge-width";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "badge-edge";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "badge-fill";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "radius-card";
+}, {
+    readonly fallback: "radius";
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "radius-control";
+}, {
+    readonly fallback: "radius";
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "radius-popover";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "radius-badge";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "radius-checkbox";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "title-weight";
+}, {
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "strong-weight";
+}, {
+    readonly fallback: "foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "tooltip";
+}, {
+    readonly fallback: "background";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "tooltip-foreground";
+}, {
+    readonly fallback: "border";
+    readonly chart: true;
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-grid";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-grid-width";
+}, {
+    readonly fallback: "muted-foreground";
+    readonly chart: true;
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-axis";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-text-size";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-label-size";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-line-width";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-area-opacity";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-bar-radius";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-bar-min-width";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-bar-max-width";
+}, {
+    readonly chart: true;
+    readonly kind: "number" | "length" | "keyword";
+    readonly modes: 1;
+    readonly tier: "role";
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-slice-border";
+}, {
+    readonly fallback: "chart-axis";
+    readonly chart: true;
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-map-edge";
+}, {
+    readonly fallback: "popover";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-tooltip";
+}, {
+    readonly fallback: "popover-foreground";
+    readonly tier: "role";
+    readonly kind: "color";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-tooltip-foreground";
+}, {
+    readonly kind: "shadow";
+    readonly fallback: "shadow-md";
+    readonly tier: "role";
+    readonly modes: 2;
+    readonly block: true;
+    readonly own: true;
+    readonly preset: true;
+    readonly area: RoleArea;
+    readonly name: "chart-tooltip-shadow";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "table-header-height";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "table-cell-padding-block";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "table-cell-padding-inline";
+}, {
+    readonly kind: "length";
+    readonly target: true;
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "sidebar-item-height";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "panel-padding";
+}, {
+    readonly kind: "number";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "expanded-z-index";
+}, {
+    readonly kind: "number";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "popup-z-index";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "record-table-max-h";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "record-text-max-w";
+}, {
+    readonly kind: "length";
+    readonly tier: "layout";
+    readonly modes: 1;
+    readonly name: "workbench-min-height";
+}];
+/** A registered token's name. */
+export type TokenName = (typeof TOKENS)[number]['name'];
+/**
+ * Every host variable of the contract: `--fve-<token>`, and
+ * `--fve-dark-<token>` for a token with a dark half. What a host may set on
+ * `:root`, any ancestor, or one surface.
+ */
+export type FveToken = `--fve-${TokenName}` | `--fve-dark-${Extract<(typeof TOKENS)[number], {
+    modes: 2;
+}>['name']}`;
+/** The host variables one entry is written through, light first. */
+export declare function hostVariables(entry: TokenEntry): string[];
+/**
+ * The preset variables one entry is written through, light first — none for
+ * an entry no preset owns.
+ */
+export declare function presetVariables(entry: TokenEntry): string[];
+/**
+ * The variable a token block declares an entry as: `--<name>` for shadcn's
+ * names, `--_fve-<name>` for the engine's own; `undefined` for one read where
+ * it is used.
+ */
+export declare function declaredVariable(entry: TokenEntry): string | undefined;
+/**
+ * The attributes, on a surface or an ancestor, that move what the tokens
+ * resolve to, by the axis each carries (ui/theme.md「五条轴」): the mode
+ * (`class` for `.dark`, and any class a host themes by; `data-theme`, a
+ * pinned mode), the preset, the change convention, the density — which
+ * moves no colour, but a chart's cell, and so is watched too — and whether
+ * the first chart slot follows the brand colour.
+ */
+export declare const THEME_AXES: readonly [{
+    readonly name: "mode";
+    readonly attributes: readonly ["class", "data-theme"];
+}, {
+    readonly name: "preset";
+    readonly attributes: readonly ["data-fve-preset"];
+}, {
+    readonly name: "change-colors";
+    readonly attributes: readonly ["data-fve-change-colors"];
+}, {
+    readonly name: "density";
+    readonly attributes: readonly ["data-fve-density"];
+}, {
+    readonly name: "brand-chart";
+    readonly attributes: readonly ["data-fve-brand-chart"];
+}];
+/**
+ * The token classes: the only classes of the stylesheet that are public
+ * (D66, second-round review R2-86). Every other `fve:` utility is the
+ * engine's own, kept in the stylesheet only while a component writes it,
+ * and changes in any release; a host's chrome reads the theme through the
+ * tokens instead. `canvas` has no shadcn name for a host's own Tailwind
+ * to map, so its ground is offered as a class, kept in the stylesheet by
+ * `@source inline` in `styles.css` and held there by
+ * `scripts/verify-package.mjs`.
+ */
+export declare const TOKEN_CLASSES: readonly string[];
+/**
+ * Every attribute a chart watches to know its theme moved: the axes', and
+ * `style`, where a host sets the tokens themselves inline.
+ */
+export declare const THEME_ATTRIBUTES: readonly string[];
+/**
+ * Every variable a chart reads, the eight slots first and in their order:
+ * a token as the blocks declare it (`--chart-1`, `--_fve-rise`), and one
+ * read where it is used by its host variable and then its preset variable,
+ * the order the stylesheet reads the layers in (`--fve-chart-patterns`,
+ * `--fvp-chart-patterns`).
+ */
+export declare const CHART_TOKENS: readonly string[];
+//# sourceMappingURL=tokens.d.ts.map