@datatechsolutions/tympan-tokens 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,642 @@
+import { PRINT_STYLE_ALIASES, PRINT_THEME_ALIASES, PRINT_THEME_PREFIX, PrintStyleAlias, resolvePrintThemeName, warnDeprecatedPrintId } from "./print-aliases.js";
+//#region src/color.d.ts
+/** Straight (non-premultiplied) sRGB colour, channels 0..1. */
+export interface Rgba {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+}
+export interface Oklch {
+  l: number;
+  c: number;
+  h: number;
+}
+export declare function rgbToOklab({ r, g, b }: Rgba): {
+  L: number;
+  a: number;
+  b: number;
+};
+export declare function rgbToOklch(c: Rgba): Oklch;
+/**
+ * OKLCH to sRGB. Out-of-gamut colours keep lightness and hue and lose chroma
+ * (binary search), which preserves the perceived tone of a ramp step.
+ */
+export declare function oklchToRgb({ l, c, h }: Oklch, alpha?: number): Rgba;
+/** `#rrggbb` (alpha ignored). */
+export declare function toHex(c: Rgba): string;
+/** CSS serialisation: hex when opaque, `rgb(r g b / a)` otherwise. */
+export declare function toCss(c: Rgba): string;
+/** Parses `#rgb`, `#rrggbb`, `#rrggbbaa`, `rgb(r g b / a)` and `rgba(r, g, b, a)`. */
+export declare function parseColor(input: string): Rgba;
+/** Source-over compositing of `top` onto `bottom`. */
+export declare function composite(top: Rgba, bottom: Rgba): Rgba;
+/** Composites a stack given from top to bottom; the last layer should be opaque. */
+export declare function flatten(stack: Rgba[]): Rgba;
+/** WCAG 2.x relative luminance. */
+export declare function luminance(c: Rgba): number;
+/** WCAG 2.x contrast ratio (1..21) between two opaque colours. */
+export declare function contrastRatio(a: Rgba, b: Rgba): number;
+/**
+ * APCA lightness contrast Lc (text on background), implemented from the
+ * public description of the APCA-W3 0.0.98G constants. Informational only:
+ * WCAG 2.2 conformance is decided by `contrastRatio`.
+ */
+export declare function apcaContrast(text: Rgba, background: Rgba): number;
+/** CIE L*a*b* (D65) from sRGB, via CIE XYZ. */
+export declare function rgbToLab({ r, g, b }: Rgba): {
+  L: number;
+  a: number;
+  b: number;
+};
+/**
+ * CIEDE2000 colour difference (ΔE00) between two opaque colours, implemented
+ * from the published formula (Sharma, Wu and Dalal, 2005). About 1 is a just
+ * noticeable difference; 10 or more reads as clearly different colours.
+ */
+export declare function deltaE2000(c1: Rgba, c2: Rgba): number;
+//#endregion
+//#region src/theme.d.ts
+export type Mode = 'light' | 'dark';
+export type ContrastLevel = 'default' | 'high';
+export type Density = 'compact' | 'default' | 'comfortable';
+export interface Seed {
+  /** OKLCH hue in degrees. */
+  hue: number;
+  /** Peak OKLCH chroma of the ramp (0..~0.37). */
+  chroma: number;
+}
+export type SeedName = 'brand' | 'neutral' | 'danger' | 'warning' | 'success' | 'info';
+/**
+ * Typographic roles a theme may set. They map onto the base font tokens the
+ * components read: `display` -> `--ty-font-serif` (headings h1 to h3 and KPI
+ * numbers), `body` -> `--ty-font-sans` (everything else), `mono` ->
+ * `--ty-font-mono` (identifiers). A role left out keeps the base stack.
+ */
+export type FontRole = 'display' | 'body' | 'mono' | 'sans' | 'serif';
+/** CSS token of each font role (`--ty-font-<name>`). */
+export declare const FONT_ROLE_TOKENS: Record<FontRole, 'serif' | 'sans' | 'mono'>;
+/** Elevation treatment: blurred shadows, none (flat print), or a hard offset shadow without blur. */
+export type Elevation = 'soft' | 'flat' | 'offset';
+export interface ThemeConfig {
+  /** Identifier used in `data-ty-theme`. Lowercase letters, digits and dashes. */
+  name: string;
+  /** Human label (customizer, docs). */
+  label?: string;
+  seeds: Record<SeedName, Seed>;
+  /** Hues of the eight chart / categorical colours. */
+  chartHues?: number[];
+  /** Control radius in px; card and sheet radii derive from it. */
+  radius: number;
+  contrast: ContrastLevel;
+  /** Translucent blurred surfaces when true; opaque when false. */
+  glass: boolean;
+  /** Call-to-action fill: brand gradient or solid brand. */
+  cta: 'gradient' | 'solid';
+  /** Exact colours that override generated roles (CSS colour strings). */
+  pins?: Partial<Record<Mode, Partial<Record<RoleName, string>>>>;
+  /** Exact gradient stops for the call to action, per mode. */
+  ctaPins?: Partial<Record<Mode, string[]>>;
+  /** Font families per role, most preferred first, ending with a generic family. */
+  fonts?: Partial<Record<FontRole, string[]>>;
+  /**
+   * Stylesheet URL that loads the families of `fonts` (for example a Google
+   * Fonts css2 URL). The token CSS never fetches it; the host or
+   * ThemeProvider's `fonts` map adds the link.
+   */
+  fontsUrl?: string;
+  /** Shadow treatment; `soft` when omitted. */
+  elevation?: Elevation;
+  /** Arbitrary string variables (e.g. for textures) */
+  strings?: Record<string, string>;
+}
+export declare const RAMP_STEPS: readonly [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950];
+export type RampStep = (typeof RAMP_STEPS)[number];
+/** 11-step ramp for a seed. */
+export declare function generateRamp(seed: Seed): Record<RampStep, Rgba>;
+/** Seed derived from an existing colour (keeps hue; chroma scaled to a ramp peak). */
+export declare function seedFromColor(color: string, peakChroma?: number): Seed;
+export declare const ROLE_NAMES: readonly ['bg', 'on-bg', 'surface', 'on-surface', 'surface-raised', 'on-surface-raised', 'surface-sunken', 'on-surface-sunken', 'surface-solid', 'surface-raised-solid', 'ink', 'ink-2', 'ink-3', 'line', 'line-soft', 'line-strong', 'input', 'focus-ring', 'brand', 'on-brand', 'brand-strong', 'brand-soft', 'on-brand-soft', 'cta-solid', 'on-cta', 'secondary', 'on-secondary', 'danger', 'on-danger', 'danger-soft', 'on-danger-soft', 'warning', 'on-warning', 'warning-soft', 'on-warning-soft', 'success', 'on-success', 'success-soft', 'on-success-soft', 'info', 'on-info', 'info-soft', 'on-info-soft', 'neutral', 'on-neutral', 'neutral-soft', 'on-neutral-soft', 'proof-proved', 'proof-proved-soft', 'proof-pending', 'proof-pending-soft', 'proof-refuted', 'proof-refuted-soft', 'proof-not-disclosed', 'proof-not-disclosed-soft', 'proof-none', 'proof-none-soft', 'actor-person', 'actor-person-soft', 'actor-agent', 'actor-agent-soft', 'actor-system', 'actor-system-soft', 'chart-1', 'chart-2', 'chart-3', 'chart-4', 'chart-5', 'chart-6', 'chart-7', 'chart-8', 'nav-bg', 'on-nav', 'nav-active', 'on-nav-active', 'nav-line', 'backdrop', 'ambient-1', 'ambient-2'];
+export type RoleName = (typeof ROLE_NAMES)[number];
+/** Design-direction names kept as aliases of the role model. */
+export declare const ROLE_ALIASES: Record<string, RoleName>;
+/** Contrast pairs every theme must satisfy (WCAG 2.2 AA). */
+export interface ContrastPair {
+  fg: RoleName | `cta-stop-${number}` | 'focus-ring';
+  /** Background stack from top to bottom; translucent layers are composited. */
+  over: Array<RoleName | `cta-stop-${number}`>;
+  min: 4.5 | 3;
+  kind: 'text' | 'ui';
+}
+export declare function contrastPairs(ctaStops: number): ContrastPair[];
+export interface ShadowLayer {
+  x: number;
+  y: number;
+  blur: number;
+  spread: number;
+  color: Rgba;
+  inset?: boolean;
+}
+export interface ContrastResult {
+  fg: string;
+  over: string[];
+  kind: 'text' | 'ui';
+  min: number;
+  ratio: number;
+  apca: number;
+  pass: boolean;
+}
+export interface ResolvedTheme {
+  name: string;
+  mode: Mode;
+  contrast: ContrastLevel;
+  colors: Record<string, Rgba>;
+  ramps: Record<SeedName, Record<RampStep, Rgba>>;
+  cta: {
+    angle: number;
+    stops: Rgba[];
+  };
+  shadows: Record<'sheet' | 'raised' | 'floating' | 'modal' | 'sheet-inset', ShadowLayer[]>;
+  /** Pixel dimensions (radius, glass blur, focus width). */
+  dimensions: Record<string, number>;
+  /** Font stacks keyed by token name (`serif`, `sans`, `mono`); empty when the theme keeps the base stacks. */
+  fonts: Partial<Record<'serif' | 'sans' | 'mono', string[]>>;
+  numbers: Record<string, number>;
+  strings?: Record<string, string>;
+  report: ContrastResult[];
+}
+/** Hues of the eight chart colours when a theme sets none. */
+export declare const DEFAULT_CHART_HUES: number[];
+/** Resolves one theme in one mode. */
+export declare function resolveTheme(config: ThemeConfig, mode: Mode, contrastOverride?: ContrastLevel): ResolvedTheme;
+export declare const DENSITIES: Record<Density, Record<string, number>>;
+export declare function shadowToCss(layers: ShadowLayer[]): string;
+export declare function gradientToCss(angle: number, stops: Rgba[]): string;
+/** Ordered `[--ty-name, value]` pairs for one resolved theme. */
+export declare function themeVariables(t: ResolvedTheme): Array<[string, string]>;
+/**
+ * CSS `font-family` value of a family list: names with spaces or digits are
+ * quoted, keywords and single identifiers are not (the same rule as the
+ * Style Dictionary font-family transform of the build).
+ */
+export declare function fontStackToCss(families: readonly string[]): string;
+/** Family list of a CSS `font-family` value (quotes removed). */
+export declare function parseFontStack(stack: string): string[];
+export declare function densityVariables(density: Density): Array<[string, string]>;
+//#endregion
+//#region src/presets.d.ts
+/**
+ * Default theme. Generated from seeds, with the exact colours of design
+ * direction §2.3 pinned so the product matches the approved direction.
+ */
+export declare const tympanPreset: ThemeConfig;
+/** Brand-free grey theme for embedding and white-label use. Fully generated. */
+export declare const neutralPreset: ThemeConfig;
+/**
+ * The Fakhir research platform's look, selected by name
+ * (`data-ty-theme="fakhir"`). Today it carries the default theme's values; it
+ * is a separate preset so that app keeps its look if the default changes.
+ */
+export declare const fakhirPreset: ThemeConfig;
+/** Default hues with high contrast, opaque surfaces and a thicker focus ring. */
+export declare const highContrastPreset: ThemeConfig;
+export declare const astrlabePreset: ThemeConfig;
+export declare const presets: readonly ThemeConfig[];
+export declare const DEFAULT_THEME = "tympan";
+//#endregion
+//#region src/dtcg.d.ts
+export interface DtcgColor {
+  colorSpace: 'srgb';
+  components: [number, number, number];
+  alpha?: number;
+  hex: string;
+}
+type Tree = {
+  [key: string]: Tree | unknown;
+};
+export declare function toDtcgColor(c: Rgba): DtcgColor;
+export declare function fromDtcgColor(v: DtcgColor | string): Rgba;
+/** DTCG tree for one resolved theme and mode. */
+export declare function themeToDtcg(t: ResolvedTheme): Tree;
+/** DTCG tree for one density step. */
+export declare function densityToDtcg(density: Density): Tree;
+//#endregion
+//#region src/stylesheet.d.ts
+export type VarList = Array<[string, string]>;
+export interface ThemeVars {
+  name: string;
+  light: VarList;
+  dark: VarList;
+  /** Values used under `prefers-contrast: more` (omitted for themes that are already high contrast). */
+  highLight?: VarList;
+  highDark?: VarList;
+}
+export interface StylesheetInput {
+  /** Theme-independent tokens (space, type, motion, z, layout). */
+  base?: VarList;
+  themes: ThemeVars[];
+  /** Theme applied to `:root` without attributes. `null` scopes every theme to its attribute. */
+  defaultTheme?: string | null;
+  densities?: Partial<Record<Density, VarList>>;
+  /**
+   * Component tokens that reference theme roles through var(). Declared on
+   * every theme and mode scope so a nested theme re-resolves them.
+   */
+  components?: VarList;
+  /** Extra component rules emitted after the component tokens (e.g. the flow tone mapping). */
+  componentRules?: string;
+  /** Cascade layer; `null` for none. */
+  layer?: string | null;
+  banner?: string;
+  /**
+   * Emit the user-preference blocks (reduced motion and transparency,
+   * forced colours). Default true; add-on theme sheets loaded after the main
+   * token sheet set it to false because those blocks already apply to every theme.
+   */
+  preferences?: boolean;
+}
+/**
+ * Selectors for one theme. The attributes may sit on the same element or on
+ * an ancestor: `data-ty-theme` picks the theme, `data-ty-mode` forces light or
+ * dark (absent or `system` follows `prefers-color-scheme`).
+ */
+export declare function themeSelectors(name: string, isDefault: boolean): {
+  light: string[];
+  systemDark: string[];
+  dark: string[];
+  explicitLight: string[];
+};
+/** Forced colours: roles map to system colours so boundaries and state stay visible. */
+export declare const FORCED_COLORS_VARS: VarList;
+/** Reduced transparency (and no backdrop-filter support): opaque surfaces, no blur, no ambient. */
+export declare const OPAQUE_VARS: VarList;
+export declare function buildStylesheet(input: StylesheetInput): string;
+/** Generator output for one theme config, as variable lists. */
+export declare function themeVarsFor(config: ThemeConfig): ThemeVars;
+export interface ThemeCssOptions {
+  /** Make this theme the `:root` default (for a standalone stylesheet). */
+  asDefault?: boolean;
+  /** Include the density blocks. */
+  densities?: boolean;
+  layer?: string | null;
+}
+/** CSS for one theme config, straight from the generator (used by the customizer). */
+export declare function generateThemeCss(config: ThemeConfig, options?: ThemeCssOptions): string;
+/** Variable lists of every built-in preset. */
+export declare function presetThemeVars(list?: readonly ThemeConfig[]): ThemeVars[];
+/**
+ * The opt-in stylesheet of the print themes (`print-themes.css`): every
+ * listed theme scoped to its `data-ty-theme` attribute, with its high-contrast
+ * variant, and no user-preference blocks (the main token sheet has them).
+ * Load it after `tokens.css`.
+ */
+export declare function generatePrintThemesCss(list?: readonly ThemeConfig[], options?: {
+  layer?: string | null;
+  banner?: string;
+  themes?: ThemeVars[];
+}): string;
+//#endregion
+//#region src/flow.d.ts
+export type FlowToken = {
+  type: 'color';
+  ref: string;
+  mix?: number;
+} | {
+  type: 'dimension';
+  ref: string;
+} | {
+  type: 'dimension';
+  px: number;
+};
+export declare const FLOW_TONES: readonly ['categorical-1', 'categorical-2', 'categorical-3', 'categorical-4', 'categorical-5', 'categorical-6', 'categorical-7', 'categorical-8', 'neutral'];
+export type FlowTone = (typeof FLOW_TONES)[number];
+/** Every canvas token, in stylesheet order (name without the `--ty-flow-` prefix). */
+export declare const FLOW_TOKENS: ReadonlyArray<readonly [string, FlowToken]>;
+export declare const flowCssName: (name: string) => string;
+/** CSS value of one canvas token. */
+export declare function flowTokenCss(token: FlowToken): string;
+/** Ordered `[--ty-flow-name, value]` pairs (the generator's direct serialisation). */
+export declare function flowVariables(): Array<[string, string]>;
+/** DTCG tree of the canvas tokens; colour and radius values alias the theme tree. */
+export declare function flowToDtcg(): Record<string, unknown>;
+/**
+ * The `[data-tone]` mapping: a tone name on any element selects its four parts
+ * as `--ty-flow-tone`, `-ink`, `-soft` and `-text`.
+ */
+export declare function flowToneRules(): string;
+//#endregion
+//#region src/print-presets.d.ts
+export type RenderizadorGrafico = 'limpo' | 'mao' | 'isotype' | 'gravura' | 'prancheta' | 'aquarela' | 'riso' | 'pontos';
+export type MarcaProva = 'pilula' | 'carimbo' | 'circulo' | 'sublinhado' | 'barra' | 'etiqueta' | 'formas' | 'ponto';
+export type EstadoProva = 'sustentada' | 'refutada' | 'nao-da-para-afirmar' | 'pendente' | 'sem-dado' | 'nao-testada';
+export declare const ESTADOS_PROVA: readonly EstadoProva[];
+/** The word printed for each proof state (always visible, whatever the mark's shape). */
+export declare const ROTULOS_PROVA: Record<EstadoProva, string>;
+export interface PrintFontes {
+  titulo: string;
+  corpo: string;
+  numero: string;
+  rotulo: string;
+  anotacao: string;
+  mono: string;
+}
+export interface PrintCores {
+  papel: string;
+  tinta: string;
+  tinta2: string;
+  tinta3: string;
+  linha: string;
+  destaque: string;
+  destaque2: string;
+  marcaTexto: string;
+  contexto: string;
+  prova: Record<EstadoProva, string>;
+  /** Colours of page ornaments only (frames, tiles, waves); never data. Up to four. */
+  ornamento?: string[];
+}
+/** Partial colours: any role, and any subset of the proof states. */
+export type PrintCoresParciais = Partial<Omit<PrintCores, 'prova'>> & {
+  prova?: Partial<Record<EstadoProva, string>>;
+};
+export type TexturaPapel = 'nenhuma' | 'grao' | 'pauta' | 'milimetrado' | 'fibra';
+export type Hachura = 'nenhuma' | 'simples' | 'cruzada' | 'pontilhada' | 'goiva';
+/**
+ * Page structure of a style (addition to the contract, see CONTRATO.md):
+ * how panels are framed, how the panel letter is drawn, where notes go, how a
+ * figure is marked and how panel labels are cased.
+ */
+export interface PrintEstrutura {
+  /** Panel frame: top rule, heavy top rule, box, heavy box, drafting board, soft card, flat title band or none. */
+  painel: 'fio' | 'fio-grosso' | 'caixa' | 'caixa-grossa' | 'prancha' | 'cartao' | 'bloco' | 'nenhum' | 'dossie' | 'placa';
+  /** Panel letter: plain, in a filled square, in a circle, in parentheses. */
+  rotulo: 'letra' | 'quadrado' | 'circulo' | 'parenteses';
+  /** Casing of panel labels and eyebrows. */
+  rotuloCaixa: 'alta' | 'versalete' | 'normal';
+  /** Annotations inside the flow, or as notes in the outer margin (minimo-de-tinta). */
+  notas: 'dentro' | 'margem';
+  /** Figure mark: none; a short bar and rule on top (semanario); range frame, no grid (minimo-de-tinta). */
+  figura: 'simples' | 'barra-topo' | 'amplitude';
+  /** Titles and labels in lower case (diagrama-modernista, concrete design). */
+  minusculas: boolean;
+  /** Bar charts drawn as horizontal bars (default) or vertical columns. Lengths come from the data either way. */
+  barras?: 'horizontal' | 'vertical';
+  /** Page ornament drawn in the margins, outside the type area (never over data). */
+  moldura?: Moldura;
+  /** Running head: plain text (default), a full-width band (mapa-de-metro, constructivism) or a tag with an arrow (signage). */
+  cabeco?: 'texto' | 'faixa' | 'etiqueta';
+  /**
+   * Title treatment: cut-paper word blocks, a band with a hard shadow, an offset colour shadow, the ornament colours;
+   * italic (minimo-de-tinta), centred capitals with wide spacing (graficos-1900), centred italic (fluxo-historico), heavier and larger
+   * (constructivism), set from the third column (Swiss grid), or underlined by hand (caderno).
+   */
+  tituloEstilo?: 'normal' | 'recorte' | 'faixa' | 'sombra' | 'arcoiris' | 'italico' | 'centro' | 'centro-italico' | 'pesado' | 'coluna3' | 'sublinhado';
+  /** Fill of the square or round panel letter. */
+  corRotulo?: 'destaque' | 'destaque2' | 'tinta' | 'marcaTexto' | 'sustentada' | 'refutada';
+  /** Bars get an ink outline (Memphis, pop art). */
+  contornoBarra?: boolean;
+  /**
+   * Signature shape of the comparison chart (G1 of the style audit). Default: 'barras' ('colunas' when
+   * `barras` is 'vertical'). Every shape keeps position and size from the data; see FormaGrafico.
+   */
+  forma?: FormaGrafico;
+  /** A line at the cut between the two columns of each group: dashed (minimo-de-tinta, infografico-ilustrado) or solid (diagrama-modernista). */
+  linhaCorte?: 'tracejada' | 'cheia';
+  /** A marker on the end of each column (diagrama-modernista: a circle). */
+  marcador?: 'circulo';
+  /** Thin columns (minimo-de-tinta). */
+  colunasFinas?: boolean;
+  /**
+   * Callouts drawn inside the chart (G3): numbered list under the plot (default), handwritten notes with an
+   * arrow and the value circled (caderno), speech balloons (divulgação, infografico-ilustrado) or text with a leader line (papel-salmao).
+   */
+  chamadas?: 'numeradas' | 'manuscritas' | 'baloes' | 'guia';
+  /** Two figures of one panel stacked (default) or side by side as small multiples. */
+  multiplos?: 'empilhados' | 'lado-a-lado';
+  /** A letter (A, B…) on each small multiple (scientific figure). */
+  letraMultiplo?: boolean;
+  /** Emblem beside the spread title: decoration in ornament or ink colours, never data. */
+  emblema?: Emblema;
+  /** Panel fills: a pale tint (pictogramas), alternating tints (diagrama-modernista, proporcao-modular, blocos-coloridos, divulgação) or halftone dots (riso). */
+  fundoPainel?: 'claro' | 'alternado' | 'pontilhado';
+  /** The verdict panel (e): a dark block (mapa-de-metro, sinalizacao, concretism, blocos-coloridos) or a block in the highlighter tint (riso). */
+  veredito?: 'bloco-escuro' | 'bloco-cor';
+  /** The linking paragraph under a and b: a highlight band (bauhaus), a dark block (constructivism), a thick bar (concretism, proporcao-modular) or a "você sabia?" tag (divulgação). */
+  costura?: 'faixa' | 'bloco-escuro' | 'barra' | 'selo';
+  /** Headline of the method figures: plain, on a band, on a tilted band (constructivism), with a magnifier (divulgação). */
+  manchete?: 'texto' | 'faixa' | 'diagonal' | 'lupa';
+  /** The trace of a number (g): a list (default), a metro line with stations (mapa-de-metro) or signage plates (sinalizacao). */
+  rastro?: 'lista' | 'metro' | 'placa';
+  /** Notes of a figure under it (default) or in a column beside it headed "Leia assim" (Dados BR). */
+  notasFigura?: 'dentro' | 'coluna';
+  /** The key numbers (b) marked with the highlighter (caderno). */
+  numerosMarcados?: boolean;
+}
+/**
+ * Emblems drawn beside a spread title (tympan-print Emblema). `'modulor'` is
+ * the deprecated name of `'figura-modular'`, still drawn the same; it will be
+ * removed with the style aliases (see PRINT_STYLE_ALIASES).
+ */
+export type Emblema = 'pictogramas' | 'formas' | 'circulo-bicolor' | 'figura-modular' | 'casa' | 'lupa' | 'predios' | 'modulor';
+/**
+ * Shapes of the comparison chart. Lengths, heights and thicknesses always come from the data through one
+ * linear scale per figure; the shape only decides how the two series are laid out.
+ * - 'barras': horizontal bars from zero. 'colunas': vertical columns.
+ * - 'eixo-central': the cut is the axis; the series below the cut grows to the left, the one above to the right.
+ * - 'ziguezague': a bar longer than one line folds back and forth (graficos-1900); total length = value.
+ * - 'fluxo': bands whose thickness is the value, splitting at the cut (fluxo-historico).
+ * - 'predios': columns drawn as buildings (height = value; windows are texture only).
+ * - 'cartoes': one card per row with the numbers written large and mini columns on a shared scale.
+ */
+export type FormaGrafico = 'barras' | 'colunas' | 'eixo-central' | 'ziguezague' | 'fluxo' | 'predios' | 'cartoes';
+/** Page ornaments (optional, CONTRATO §1). */
+export type Moldura = 'nenhuma' | 'dupla' | 'regua' | 'azulejo' | 'ondas' | 'ramos' | 'recortes' | 'reticula' | 'memphis' | 'diagonais' | 'formas' | 'quartos';
+export interface PrintStyle {
+  /** Stable id, e.g. 'jornal'. */
+  name: string;
+  /** Human label, e.g. "Editorial de jornal". */
+  label: string;
+  /** What the style reproduces or interprets. */
+  referencia: string;
+  /** CSS font stacks. */
+  fontes: PrintFontes;
+  /** Google Fonts css2 family specs (`Family Name:axes@values`); empty for system fonts only. */
+  googleFonts: string[];
+  cor: PrintCores;
+  papel: {
+    textura: TexturaPapel;
+    intensidade: number;
+  };
+  /** Stroke width in mm, tremor 0..2 (0 = ruled), hatching of the second series. */
+  traco: {
+    largura: number;
+    tremor: number;
+    hachura: Hachura;
+  };
+  grafico: RenderizadorGrafico;
+  marcaProva: MarcaProva;
+  /** Corner radius in mm; 0 for square styles. */
+  raio: number;
+  /** Chapter and spread titles in capitals. */
+  caixaAlta: boolean;
+  /** Adjustments for black and white print, applied after the grey conversion. */
+  pb: PrintCoresParciais;
+  estrutura: PrintEstrutura;
+  /**
+   * Brand marks in colour (default) or in their official one-ink version,
+   * for styles whose technique is one or two inks (woodcut, risograph,
+   * cyanotype). The lakebrasil mark is never recoloured; the Datatech mark
+   * has approved variations (ink, duotone, per style), see LogoDatatech.
+   */
+  logo?: 'cor' | 'mono';
+}
+/** Any token of a style may be overridden by the editor (partial, nested). */
+export interface PrintStyleOverrides {
+  label?: string;
+  fontes?: Partial<PrintFontes>;
+  googleFonts?: string[];
+  cor?: PrintCoresParciais;
+  papel?: Partial<PrintStyle['papel']>;
+  traco?: Partial<PrintStyle['traco']>;
+  grafico?: RenderizadorGrafico;
+  marcaProva?: MarcaProva;
+  raio?: number;
+  caixaAlta?: boolean;
+  pb?: PrintCoresParciais;
+  estrutura?: Partial<PrintEstrutura>;
+  logo?: 'cor' | 'mono';
+}
+/** The 39 book styles, by name. */
+export declare const printPresets: {
+  dashboard: PrintStyle;
+  'graficos-1900': PrintStyle;
+  'cartao-postal': PrintStyle;
+  caderno: PrintStyle;
+  isotype: PrintStyle;
+  cordel: PrintStyle;
+  riso: PrintStyle;
+  jornal: PrintStyle;
+  prancheta: PrintStyle;
+  'prancheta-clara': PrintStyle;
+  aquarela: PrintStyle;
+  'minimo-de-tinta': PrintStyle;
+  suico: PrintStyle;
+  concretismo: PrintStyle;
+  semanario: PrintStyle;
+  'infografico-ilustrado': PrintStyle;
+  'diagrama-modernista': PrintStyle;
+  'papel-salmao': PrintStyle;
+  'dados-br': PrintStyle;
+  'fluxo-historico': PrintStyle;
+  'blocos-coloridos': PrintStyle;
+  construtivismo: PrintStyle;
+  bauhaus: PrintStyle;
+  brutalista: PrintStyle;
+  divulgacao: PrintStyle;
+  'proporcao-modular': PrintStyle;
+  sinalizacao: PrintStyle;
+  pictogramas: PrintStyle;
+  'mapa-de-metro': PrintStyle;
+  'jornal-1959': PrintStyle;
+  'azulejo-modernista': PrintStyle;
+  tropicalia: PrintStyle;
+  'atlas-oficial': PrintStyle;
+  'grade-holandesa': PrintStyle;
+  'papel-recortado': PrintStyle;
+  'pop-art': PrintStyle;
+  cientifico: PrintStyle;
+  'art-nouveau': PrintStyle;
+  memphis: PrintStyle;
+};
+export type PrintPresetName = keyof typeof printPresets;
+export declare const PRINT_PRESET_NAMES: PrintPresetName[];
+export declare const DEFAULT_PRINT_STYLE: PrintPresetName;
+/** Any id a style can be named by: a current name or a deprecated alias (PRINT_STYLE_ALIASES). */
+export type PrintStyleId = PrintPresetName | PrintStyleAlias;
+/**
+ * The current name of a style id: a current name is returned as is, a
+ * deprecated alias is mapped (with a one-time development warning), anything
+ * else gives `undefined`.
+ */
+export declare function resolvePrintStyleName(id: string): PrintPresetName | undefined;
+/** The preset of a style id (current or deprecated); throws on an unknown id. */
+export declare function printPresetById(id: string): PrintStyle;
+/** A style with the editor's overrides applied (nested, partial). */
+export declare function mergePrintStyle(style: PrintStyle, overrides?: PrintStyleOverrides): PrintStyle;
+/** The grey with the same WCAG relative luminance, so every contrast ratio survives the conversion. */
+export declare function toGrey(color: string): string;
+/** Colours for black and white print: every role in grey, then the style's own `pb` adjustments. */
+export declare function printStyleCoresPb(style: PrintStyle): PrintCores;
+export interface PrintCssOptions {
+  /** Black and white variant. */
+  pb?: boolean;
+  /** Editor overrides of any token. */
+  overrides?: PrintStyleOverrides;
+  /** Selector to scope the properties to; defaults to `[data-ty-print-style="<name>"]`. */
+  seletor?: string;
+}
+/**
+ * The style as it will print: overrides applied, then (for `pb`) the grey
+ * conversion. Takes a preset or a style id; a deprecated id resolves to its
+ * current style (`resolvePrintStyle('economist').name === 'semanario'`).
+ */
+export declare function resolvePrintStyle(style: PrintStyle | PrintStyleId, options?: Omit<PrintCssOptions, 'seletor'>): PrintStyle;
+/** Custom properties of a resolved style, in a stable order. */
+export declare function printStyleVariables(style: PrintStyle): Array<[string, string]>;
+/**
+ * CSS custom properties (`--ty-print-*`) of a style on
+ * `[data-ty-print-style="<name>"]`, with the editor's overrides and, when
+ * `pb` is set, the black and white colours.
+ */
+export declare function printStyleToCss(style: PrintStyle, options?: PrintCssOptions): string;
+/** Google Fonts css2 URL for a style's families (null when it uses system fonts only). */
+export declare function googleFontsUrl(style: Pick<PrintStyle, 'googleFonts'>): string | null;
+/** True when the paper is dark (the brand seal and logo then use the light mono version). */
+export declare function papelEscuro(style: Pick<PrintStyle, 'cor'>): boolean;
+//#endregion
+//#region src/print-themes.d.ts
+/** Per-style adjustments where the derivation misjudges; merged over the derived config. */
+export interface PrintThemeOverride {
+  /** Brand colour to use instead of the derived one. */
+  brand?: string;
+  glass?: boolean;
+  cta?: ThemeConfig['cta'];
+  elevation?: ThemeConfig['elevation'];
+  /** Radius in px. */
+  radius?: number;
+  /** Extra pins per mode (applied before the contrast check, dropped if they fail like any pin). */
+  pins?: ThemeConfig['pins'];
+}
+/**
+ * Where the derivation reads a style differently from its tradition. Kept
+ * short on purpose: every entry is a judgement the data cannot express.
+ */
+export declare const PRINT_THEME_OVERRIDES: Partial<Record<PrintPresetName, PrintThemeOverride>>;
+/** The colour moved along OKLCH lightness (hue and chroma kept) until it reaches `min` against `over`. */
+export declare function legibleOn(colour: string, over: string, min?: number): string;
+/**
+ * The accent that represents a style, before any legibility adjustment: the
+ * first chromatic accent that nearly reads on the paper (3:1), else the most
+ * legible chromatic accent, else the first chromatic ornament, else the ink
+ * (or, on dark paper, the paper itself).
+ */
+export declare function printStyleAccent(style: PrintStyle): string;
+/**
+ * The UI theme of a book style, in light and dark. The name is
+ * `print-<style name>`; the label is the style's own.
+ */
+export declare function printStyleToTheme(style: PrintStyle, override?: PrintThemeOverride): ThemeConfig;
+/**
+ * Exact print colours the derivation had to give up for contrast, per mode
+ * (role -> the print colour that was dropped and regenerated).
+ */
+export declare function printThemeDroppedPins(style: PrintStyle, override?: PrintThemeOverride): Record<Mode, Partial<Record<RoleName, string>>>;
+/** Every book style as a UI theme, in the order of `printPresets`. */
+export declare const printThemePresets: readonly ThemeConfig[];
+/** Stylesheet URL of the families of each print theme, by theme name (for ThemeProvider's `fonts`). */
+export declare const printThemeFontUrls: Readonly<Record<string, string>>;
+//#endregion
+//#region src/index.d.ts
+export declare const allThemes: readonly ThemeConfig[];
+//#endregion
+export { PRINT_STYLE_ALIASES, PRINT_THEME_ALIASES, PRINT_THEME_PREFIX, PrintStyleAlias, resolvePrintThemeName, warnDeprecatedPrintId };
+//# sourceMappingURL=index.d.ts.map