@refrakt-md/types 0.14.0 → 0.14.1

package/dist/token-contract.d.ts

@@ -145,16 +145,20 @@ export interface PrimaryScale {
 /** Syntax-highlighting roles. Variables and ordinary identifiers fall through
  *  to body `text`; only the meaning-bearing roles get distinct colours.
  *
+ *  The contract is **tiered** (SPEC-056): seven required core roles cover
+ *  everything a theme must define to render code at all, and nine optional
+ *  extended roles let preset authors faithfully carry palettes that
+ *  intentionally split distinctions the core collapses. Each optional role
+ *  falls back to a documented core role via a `var()` chain emitted by the
+ *  CSS generator — so a preset that doesn't set the optional role still
+ *  renders correctly, just with less fidelity than a preset that does.
+ *
  *  Naming follows Shiki's `token-*` vocabulary rather than language-specific
- *  intuition. Two roles that might surprise you:
- *  - `constant` covers numeric literals AND boolean/null/Symbol-style
- *    language constants — Shiki paints them all from one slot, so the
- *    contract reflects that rather than pretending `number` is distinct.
- *  - There is no `type` field. Shiki's css-variables theme has no
- *    `token-type` slot — type names get painted as `token-function`
- *    (entity-name) and built-in types like `string` as `token-constant`.
- *    Themes that want a distinct type colour need a custom highlighter
- *    or grammar-level CSS, not a contract token. */
+ *  intuition. One role that might surprise you: `constant` covers boolean/
+ *  null/Symbol-style language constants AND numeric literals by default —
+ *  Shiki paints them all from one slot. Palettes that distinguish numbers
+ *  (e.g. Tokyo Night, One Dark) can set the optional `number` role to split
+ *  them out. */
 export interface SyntaxTokens {
     keyword: string;
     function: string;
@@ -163,17 +167,50 @@ export interface SyntaxTokens {
     comment: string;
     punctuation: string;
     variable: string;
-    /** URL/link tokens — markdown links, autolinks, comment URLs. Optional;
-     *  the generator defaults `--rf-syntax-token-link` to `function` when this
-     *  isn't set, so themes that don't care about distinguishing link from
-     *  function can omit it. Set explicitly when you want a distinct colour. */
+    /** URL/link tokens — markdown links, autolinks, comment URLs. Falls back
+     *  to `function` when unset, so themes that don't care about distinguishing
+     *  link from function can omit it. Set explicitly when you want a distinct
+     *  colour. */
     link?: string;
     /** Interpolated expressions inside template literals (the `${foo}` part
-     *  of a backtick string). Optional; the generator defaults
-     *  `--rf-syntax-token-string-expression` to `string` when this isn't set.
-     *  Set explicitly when you want template-literal expressions to read
-     *  distinctly from the surrounding string. */
+     *  of a backtick string). Falls back to `string` when unset. Set explicitly
+     *  when you want template-literal expressions to read distinctly from the
+     *  surrounding string. */
     'string-expression'?: string;
+    /** Type names, class names, interface names, generic parameters. Falls
+     *  back to `function` when unset. Palettes that intentionally split type
+     *  from function (Nord's Frost-7 vs Frost-8, Dracula's Cyan vs Green,
+     *  Tokyo Night, One Dark, Catppuccin) set this; minimal palettes leave
+     *  it unset and accept that types and functions share a colour. */
+    type?: string;
+    /** Object property access (`foo.bar`), object literal keys. Falls back
+     *  to `variable` when unset. Some palettes paint properties as muted
+     *  text; others give them a dedicated hue. */
+    property?: string;
+    /** Function/method parameters in declaration position. Falls back to
+     *  `variable` when unset. Palettes that italicise or hue-shift
+     *  parameters in declarations set this. */
+    parameter?: string;
+    /** JSX/HTML/XML element tag names. Falls back to `keyword` when unset —
+     *  most palettes paint tags like keywords because both read as
+     *  "control structure." Set explicitly when you want tags to read
+     *  distinctly. */
+    tag?: string;
+    /** JSX/HTML/XML attribute names. Falls back to `function` when unset.
+     *  Many palettes paint attributes the same as function names because
+     *  they're both "named callables / addressable bindings." */
+    attribute?: string;
+    /** Arithmetic, comparison, logical operators (`+`, `===`, `&&`, etc.).
+     *  Falls back to `punctuation` when unset. Most palettes don't split
+     *  operators from punctuation; the ones that do (Tokyo Night, some
+     *  Solarized variants) get a dedicated hue. */
+    operator?: string;
+    /** Numeric literals — split out when a palette colours numbers distinctly
+     *  from booleans/null/Symbol-style constants. Falls back to `constant`
+     *  when unset. */
+    number?: string;
+    /** Regular expression literals. Falls back to `string` when unset. */
+    regex?: string;
 }
 /** Recursive deep-partial. Every namespace optional; every leaf optional. */
 export type DeepPartial<T> = T extends object ? {

package/dist/token-contract.d.ts.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/types",
   "description": "Shared type definitions for refrakt.md",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "type": "module",
   "license": "MIT",
   "repository": {