@pantoken/utils 1.0.1 → 1.0.2

package/dist/index.d.mts

@@ -19,7 +19,7 @@ import { Token } from "@pantoken/model";
  * Every elevation level and alias emitted as `--instui-elevation-<name>` (`resting`, `above`,
  * `topmost`, `depth1`–`depth3`, `card`, `cardHover`). Derived from the geometry + alias maps.
  */
-declare const ELEVATION_NAMES: readonly string[];
+export declare const ELEVATION_NAMES: readonly string[];
 /**
  * The `--instui-elevation-*` name/value pairs (each a multi-layer `box-shadow`). Values reference the
  * themed drop-shadow colour tokens, so they adapt per theme wherever a token sheet is loaded.
@@ -33,9 +33,9 @@ declare const ELEVATION_NAMES: readonly string[];
  * elevationDeclarations(); // [["--instui-elevation-resting", "…"], ["--instui-elevation-above", "…"], …]
  * ```
  */
-declare function elevationDeclarations(): [name: string, value: string][];
+export declare function elevationDeclarations(): [name: string, value: string][];
 /** The elements the ring applies to by default (the common interactive/focusable elements). */
-declare const FOCUSABLE_SELECTOR = "a, button, input, select, textarea, summary, [tabindex]";
+export declare const FOCUSABLE_SELECTOR = "a, button, input, select, textarea, summary, [tabindex]";
 /**
  * The `--instui-focus-outline-*` name/value pairs the ring rules read. Colour/width/offset reference
  * the themed shared focus tokens; the transition, line style, and inset are constants.
@@ -49,7 +49,7 @@ declare const FOCUSABLE_SELECTOR = "a, button, input, select, textarea, summary,
  * focusOutlineDeclarations(); // [["--instui-focus-outline-color", "…"], …]
  * ```
  */
-declare function focusOutlineDeclarations(): [name: string, value: string][];
+export declare function focusOutlineDeclarations(): [name: string, value: string][];
 /**
  * The focus-ring rules for a given focusable selector: a transparent resting ring that transitions in
  * on `:focus-visible`, plus the `-focus-color-*` / `-focus-position-inset` / `-focus-within` /
@@ -58,15 +58,15 @@ declare function focusOutlineDeclarations(): [name: string, value: string][];
  * @param selector - The focusable selector the base ring applies to (default {@link FOCUSABLE_SELECTOR}).
  * @returns The CSS rules string.
  */
-declare function focusOutlineRules(selector?: string): string;
+export declare function focusOutlineRules(selector?: string): string;
 //#endregion
 //#region src/resolver.d.ts
 /** The colour mode to collapse `light-dark()` to. */
 type Mode = "light" | "dark";
 /** A `var(--custom-prop)` reference (optional fallback); capture group 1 is the property name. */
-declare const VAR_RE: RegExp;
+export declare const VAR_RE: RegExp;
 /** A `light-dark(<light>, <dark>)` value; capture groups 1 and 2 are the two branches. */
-declare const LIGHT_DARK_RE: RegExp;
+export declare const LIGHT_DARK_RE: RegExp;
 /** Options for {@link makeResolver}. */
 interface ResolveOptions {
   /** Collapse `light-dark()` to this branch; omit to keep `light-dark()` intact. */
@@ -127,7 +127,7 @@ interface ResolveOptions {
  * makeResolver(ir, { overrides })("var(--instui-brand)"); // → "#000"
  * ```
  */
-declare function makeResolver(base: readonly Token[], options?: ResolveOptions): (value: string) => string;
+export declare function makeResolver(base: readonly Token[], options?: ResolveOptions): (value: string) => string;
 /**
  * Resolve every token's value against the set (see {@link makeResolver}), keyed by name.
  *
@@ -147,7 +147,7 @@ declare function makeResolver(base: readonly Token[], options?: ResolveOptions):
  * byName.get("--instui-bg");    // → "#000"
  * ```
  */
-declare function resolveTokens(base: readonly Token[], options?: ResolveOptions): Map<string, string>;
+export declare function resolveTokens(base: readonly Token[], options?: ResolveOptions): Map<string, string>;
 //#endregion
 //#region src/drift.d.ts
 /**
@@ -161,7 +161,7 @@ declare function resolveTokens(base: readonly Token[], options?: ResolveOptions)
  * // → Set { "--instui-color-text-base" }
  * ```
  */
-declare function extractInstuiRefs(text: string): Set<string>;
+export declare function extractInstuiRefs(text: string): Set<string>;
 /**
  * The set of token names an IR defines.
  *
@@ -176,7 +176,7 @@ declare function extractInstuiRefs(text: string): Set<string>;
  * tokenNames(ir); // → Set { "--instui-leaf" }
  * ```
  */
-declare function tokenNames(ir: readonly Token[]): Set<string>;
+export declare function tokenNames(ir: readonly Token[]): Set<string>;
 /**
  * Drift check: `--instui-*` names in `text` that the IR doesn't define (sorted; empty means no
  * drift). Use for outputs that *reference* tokens defined elsewhere — e.g. the docusaurus/vitepress
@@ -200,7 +200,7 @@ declare function tokenNames(ir: readonly Token[]): Set<string>;
  * unknownReferences("--x: var(--instui-leaf);", ir); // → []  (no drift)
  * ```
  */
-declare function unknownReferences(text: string, ir: readonly Token[]): string[];
+export declare function unknownReferences(text: string, ir: readonly Token[]): string[];
 /**
  * Self-containment check: `--instui-*` names referenced via `var()` in a stylesheet that it never
  * defines (as an `@property` registration or a `--x:` declaration). Sorted; empty means every
@@ -222,7 +222,7 @@ declare function unknownReferences(text: string, ir: readonly Token[]): string[]
  * ); // → ["--instui-b"]
  * ```
  */
-declare function danglingReferences(css: string): string[];
+export declare function danglingReferences(css: string): string[];
 //#endregion
 //#region src/case.d.ts
 /**
@@ -240,7 +240,7 @@ declare function danglingReferences(css: string): string[];
  * camelCase("color-background-brand"); // → "colorBackgroundBrand"
  * ```
  */
-declare function camelCase(kebab: string): string;
+export declare function camelCase(kebab: string): string;
 //#endregion
 //#region src/color.d.ts
 /**
@@ -268,7 +268,7 @@ interface Rgba {
  * parseHexColor("nope");      // → undefined
  * ```
  */
-declare function parseHexColor(hex: string): Rgba | undefined;
+export declare function parseHexColor(hex: string): Rgba | undefined;
 //#endregion
 //#region src/svg.d.ts
 /**
@@ -282,7 +282,7 @@ declare function parseHexColor(hex: string): Rgba | undefined;
  * Defense-in-depth for SVG decoded from vendored data URIs or contributed by plugins.
  * Not a full HTML parser — relies on the upstream source being trusted and pinned.
  */
-declare function sanitizeSvg(svg: string): string;
+export declare function sanitizeSvg(svg: string): string;
 //#endregion
 //#region src/spacing.d.ts
 /**
@@ -305,9 +305,9 @@ interface SpacingStep {
  * `@pantoken/components`' spacing/gap utilities and `@pantoken/interactions`' `resolveSpace`, so the
  * two never drift apart.
  */
-declare const SPACING_STEPS: readonly SpacingStep[];
+export declare const SPACING_STEPS: readonly SpacingStep[];
 /** The `auto` step — margin only, spelled the same both ways. */
-declare const SPACING_AUTO_STEP: SpacingStep;
+export declare const SPACING_AUTO_STEP: SpacingStep;
 //#endregion
 //#region src/utility-css.d.ts
 /**
@@ -337,7 +337,7 @@ interface UtilityOptions {
  * (`globalSelectors`/`chainTargets`), which couldn't reach plugin-authored components and didn't scale
  * to high-cardinality utilities like spacing.
  */
-declare function globalModifierSelector(p: string, name: string): string;
+export declare function globalModifierSelector(p: string, name: string): string;
 /** One semantic colour family entry: a bare name (resolved against `--instui-color-<family>-<name>`)
  *  or an explicit `[name, value]` pair — the second element is `var()`-wrapped if it's a `--custom-prop`
  *  name, or used verbatim otherwise (a `light-dark(…)` expression, a raw keyword like `transparent`). */
@@ -362,7 +362,7 @@ interface ColorUtilityNames {
  *
  * @demo self:color-utilities
  */
-declare function colorUtilitiesCss(names: ColorUtilityNames, options?: UtilityOptions): string;
+export declare function colorUtilitiesCss(names: ColorUtilityNames, options?: UtilityOptions): string;
 /** A set of tokens that all map to one CSS property (e.g. every `--instui-font-weight-*` → `font-weight`). */
 interface TokenUtilityGroup {
   /** The CSS property the tokens set (e.g. `"font-weight"`, `"border-radius"`, `"box-shadow"`). */
@@ -385,6 +385,6 @@ interface TokenUtilityGroup {
  *
  * @demo self:token-utilities
  */
-declare function tokenUtilitiesCss(groups: readonly TokenUtilityGroup[], options?: UtilityOptions): string;
+export declare function tokenUtilitiesCss(groups: readonly TokenUtilityGroup[], options?: UtilityOptions): string;
 //#endregion
-export { type ColorUtilityEntry, type ColorUtilityNames, ELEVATION_NAMES, FOCUSABLE_SELECTOR, LIGHT_DARK_RE, type Mode, type ResolveOptions, type Rgba, SPACING_AUTO_STEP, SPACING_STEPS, type SpacingStep, type TokenUtilityGroup, type UtilityOptions, VAR_RE, camelCase, colorUtilitiesCss, danglingReferences, elevationDeclarations, extractInstuiRefs, focusOutlineDeclarations, focusOutlineRules, globalModifierSelector, makeResolver, parseHexColor, resolveTokens, sanitizeSvg, tokenNames, tokenUtilitiesCss, unknownReferences };
+export type { ColorUtilityEntry, ColorUtilityNames, Mode, ResolveOptions, Rgba, SpacingStep, TokenUtilityGroup, UtilityOptions };

package/dist/token-syntax.d.mts

@@ -1,18 +1,18 @@
 import { Token } from "@pantoken/model";
 //#region src/token-syntax.d.ts
 /** A registered, real CSS property name (e.g. `"font-weight"`), matched via `matchProperty()`. */
-type PropertyName = string & {
+export type PropertyName = string & {
   readonly __brand: "PropertyName";
 };
 /**
  * A CSS Value Definition Syntax grammar string (CSS Values 4 §2.1: `|` `||` `&&` `[]` `?` `{a,b}`
  * `#`, e.g. `"<length>"` or `"none | <shadow>#"`), matched via `match()`.
  */
-type Grammar = string & {
+export type Grammar = string & {
   readonly __brand: "Grammar";
 };
 /** An ordered token-name-pattern → value table, checked first-match-wins via {@link firstMatch}. */
-type SyntaxRule<T> = readonly (readonly [RegExp, T])[];
+export type SyntaxRule<T> = readonly (readonly [RegExp, T])[];
 /**
  * Non-standard property grammars `css-tree`/`mdn-data` don't know about —
  * matched by token-name substring, most-specific first, as raw CSS Value Definition Syntax
@@ -21,7 +21,7 @@ type SyntaxRule<T> = readonly (readonly [RegExp, T])[];
  * NOT `<font-family-name>`, which only exists inline inside the real `font-family` property's own
  * definition — that's matched via `TOKEN_NAME_TO_PROPERTY` instead).
  */
-declare const BESPOKE_SYNTAX: SyntaxRule<Grammar>;
+export declare const BESPOKE_SYNTAX: SyntaxRule<Grammar>;
 /**
  * Real CSS properties, matched by token-name substring — the property name to validate against
  * via `css-tree`'s built-in (`mdn-data`-sourced) lexer. Intentionally conservative: a name pattern
@@ -47,9 +47,9 @@ declare const BESPOKE_SYNTAX: SyntaxRule<Grammar>;
  * here in practice — the bespoke icon-glyph rule above already claims every `instui-icon-*` name
  * first, so `gap` IS included, verified safe once that precedence is accounted for.
  */
-declare const TOKEN_NAME_TO_PROPERTY: SyntaxRule<PropertyName>;
+export declare const TOKEN_NAME_TO_PROPERTY: SyntaxRule<PropertyName>;
 /** A `namePattern`'s concrete, non-contextual matches against a candidate property, from the real IR. */
-interface PatternCoverage {
+export interface PatternCoverage {
   /** How many concrete (non-contextual) tokens matched `namePattern`. */
   matched: number;
   /** The matches that would FAIL the candidate property's real CSS grammar. */
@@ -75,12 +75,12 @@ interface PatternCoverage {
  * coverage.invalid; // → [] once every matching token is confirmed to be a valid <color>
  * ```
  */
-declare function candidatePropertyCoverage(tokens: readonly {
+export declare function candidatePropertyCoverage(tokens: readonly {
   name: string;
   value: string;
 }[], namePattern: RegExp, candidateProperty: string): PatternCoverage;
 /** One token whose value doesn't satisfy its property's CSS grammar, or whose name maps to none. */
-interface TokenSyntaxIssue {
+export interface TokenSyntaxIssue {
   /** The token's `--instui-*` name. */
   name: string;
   /** The token's resolved value. */
@@ -114,6 +114,5 @@ interface TokenSyntaxIssue {
  * // → [{ name: "--instui-content-quote-font-weight", value: "Medium Italic", kind: "mismatch" }]
  * ```
  */
-declare function syntaxMismatches(tokens: readonly Token[]): TokenSyntaxIssue[];
-//#endregion
-export { BESPOKE_SYNTAX, Grammar, PatternCoverage, PropertyName, SyntaxRule, TOKEN_NAME_TO_PROPERTY, TokenSyntaxIssue, candidatePropertyCoverage, syntaxMismatches };
+export declare function syntaxMismatches(tokens: readonly Token[]): TokenSyntaxIssue[];
+//#endregion

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@pantoken/utils",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Shared pantoken helpers: token reference resolver, typed regexes (arkregex), name-case, and hex-colour parsing.",
-  "homepage": "https://pantoken.iywahl.com",
+  "homepage": "https://pantoken.app",
   "bugs": "https://github.com/thedannywahl/pantoken/issues",
   "license": "MIT",
   "repository": {
@@ -25,16 +25,16 @@
     "provenance": true
   },
   "dependencies": {
-    "@pantoken/model": "0.3.1",
+    "@pantoken/model": "0.3.2",
     "arkregex": "^0.0.8",
     "css-tree": "^3.2.1"
   },
   "devDependencies": {
     "@types/css-tree": "^3.2.0",
-    "@types/node": "^26.3.0",
+    "@types/node": "^26.5.0",
     "typescript": "^7.0.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
-    "vite-plus": "0.3.0"
+    "vite": "npm:@voidzero-dev/vite-plus-core@0.3.1",
+    "vite-plus": "0.3.1"
   },
   "engines": {
     "node": ">=22.18.0"