@terrazzo/parser 0.10.4 → 2.0.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,72 @@
 # @terrazzo/parser
 
+## 2.0.0
+
+### Minor Changes
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - ⚠️ Breaking change; DTCG 2nd Editors draft format will throw errors by default. This means converting all colors and dimensions to the new object format.
+
+  Though this is a breaking change in default behavior, you can opt back into the old behavior by adjusting your config’s lint settings. See https://terrazzo.app/docs/cli/lint/.
+
+  List of changes:
+  - **color**: `channels` is invalid; `components` is required (“channels” was never part of the spec; this just deprecates an in-progress draft that was briefly supported)
+  - **dimension**: object notation (`{ value: 16, unit: 'px' }`) required.
+  - **dimension**: `0` is no longer automatically expanded to`{ value: 0, unit: 'px' }`.
+  - **duration**: object notation (`{ value: 100, unit: 'ms' }`) required.
+  - **dimension**: `{ $value: 0 }` no longer allowed.
+  - **typography**: `fontFamily`, `fontSize`, `fontWeight`, `lineHeight`, and `letterSpacing` are all required at a minimum (additional properties are still allowed).
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Soft deprecate core/required-typography-properties in favor of core/valid-typography
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - ⚠️ Minor breaking change: the transform() API now returns the Momoa node as the 1st parameter. The 2nd parameter is now an object with more context. Lastly, it requires returning a momoa node, rather than raw JSON.
+
+  ```diff
+  + import * as momoa from "@humanwhocodes/momoa";
+
+    transform: {
+  -   color(json, path, node) {
+  +   color(node, { path, filename }) {
+  +     const json = momoa.evaluate(node);
+  -     return json;
+  +     return momoa.parse(json);
+      }
+  ```
+
+  This should result in a little less work overall. For example, instead of writing `if (typeof json === 'object' && !Array.isArray(json))` that could be shortened to `if (node.type === 'Object')`, among many other such advantages. You can call `evaluate()` manually if you’re more used to working with the raw JSON instead. Similarly, you can call `parse()` if you’re working with
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - ⚠️ Breaking change: lint on plugins no longer runs on individual files, rather, the full set once merged.
+
+  If your lint plugin is not using the `src` context value, no changes are needed. If it is, you’ll need to instead read from the `sources` array, and look up sources with a token’s `source.loc` filename manually. This change was because lint rules now run on all files in one pass, essentially.
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - ⚠️ [Plugin API] Minor breaking change: token.originalValue may be undefined for tokens created with $ref. This shouldn’t affect any tokens or plugins not using $refs. But going forward this value will be missing if the token was created dynamically via $ref.
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Minor breaking change: build() and buildEnd() plugin hooks are now executed in parallel. The other hooks are still executed sequentially.
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - ⚠️ Breaking change: the following token types have more strict requirements about all properties being present:
+  - Border
+  - Transition
+  - Typography
+
+  These behaviors may be opted out individually by adjusting the new lint rules ([see documentation](https://terrazzo.app/docs/cli/lint/)).
+
+### Patch Changes
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Fix bug where border tokens’ partial aliases would sometimes refer to themselves
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Fix bug of lint warning of rules turned off being unused
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Validation moved to lint rules, which means token validation can be individually configured, and optionally extended.
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Add first class support for JSON $refs, both remote and local.
+
+  Under-the-hood this transforms DTCG aliase to JSON $refs, so they’re interchangeable.
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Bugfix: fix strokeStyle partialAliasOf
+
+- [#530](https://github.com/terrazzoapp/terrazzo/pull/530) [`370ed7b`](https://github.com/terrazzoapp/terrazzo/commit/370ed7b0f578a64824124145d7f4936536b37bb3) Thanks [@drwpow](https://github.com/drwpow)! - Add missing $deprecated property to group types
+
+- [#553](https://github.com/terrazzoapp/terrazzo/pull/553) [`e63a627`](https://github.com/terrazzoapp/terrazzo/commit/e63a6277f61282fb608744a8348689b16f977076) Thanks [@Sidnioulz](https://github.com/Sidnioulz)! - Add support for the Token Listing format
+
 ## 0.10.4
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { AliasToken, AliasValue, BooleanToken, BooleanTokenNormalized, BooleanValue, BorderToken, BorderTokenNormalized, BorderValue, BorderValueNormalized, ColorSpace, ColorToken, ColorTokenNormalized, ColorValue, ColorValueNormalized, CubicBezierToken, CubicBezierTokenNormalized, CubicBezierValue, CustomTransformOptions, DimensionToken, DimensionTokenNormalized, DimensionValue, DurationToken, DurationTokenNormalized, DurationValue, FontFamilyToken, FontFamilyTokenNormalized, FontFamilyValue, FontFamilyValueNormalized, FontWeightToken, FontWeightTokenNormalized, FontWeightValue, FontWeightValueNormalized, GradientStop, GradientStopNormalized, GradientToken, GradientTokenNormalized, GradientValue, GradientValueNormalized, Group, GroupCore, GroupOrToken, LinkToken, LinkTokenNormalized, LinkValue, ModeMap, NumberToken, NumberTokenNormalized, NumberValue, ShadowToken, ShadowTokenNormalized, ShadowValue, ShadowValueNormalized, StringToken, StringTokenNormalized, StringValue, StrokeStyleToken, StrokeStyleTokenNormalized, StrokeStyleValue, StrokeStyleValueExpanded, Token, Token as Token$1, TokenCore, TokenMode, TokenNormalized, TokenNormalized as TokenNormalized$1, TokenNormalizedCore, TokenNormalizedSet, TokenNormalizedSet as TokenNormalizedSet$1, TokensSet, TransitionToken, TransitionTokenNormalized, TransitionValue, TransitionValueNormalized, TypographyToken, TypographyTokenNormalized, TypographyValue, TypographyValueNormalized } from "@terrazzo/token-tools";
-import { AnyNode, DocumentNode, MemberNode, ObjectNode, ParseOptions as ParseOptions$1, ValueNode } from "@humanwhocodes/momoa";
+import * as momoa from "@humanwhocodes/momoa";
+import { AliasToken, AliasValue, BooleanToken, BooleanTokenNormalized, BooleanValue, BorderToken, BorderTokenNormalized, BorderValue, BorderValueNormalized, ColorSpace, ColorToken, ColorTokenNormalized, ColorValue, ColorValueNormalized, CubicBezierToken, CubicBezierTokenNormalized, CubicBezierValue, CustomTransformOptions, DimensionToken, DimensionTokenNormalized, DimensionValue, DurationToken, DurationTokenNormalized, DurationValue, FontFamilyToken, FontFamilyTokenNormalized, FontFamilyValue, FontFamilyValueNormalized, FontWeightToken, FontWeightTokenNormalized, FontWeightValue, FontWeightValueNormalized, GradientStop, GradientStopNormalized, GradientToken, GradientTokenNormalized, GradientValue, GradientValueNormalized, Group, GroupCore, GroupOrToken, LinkToken, LinkTokenNormalized, LinkValue, ModeMap, NumberToken, NumberTokenNormalized, NumberValue, ShadowToken, ShadowTokenNormalized, ShadowValue, ShadowValueNormalized, StringToken, StringTokenNormalized, StringValue, StrokeStyleToken, StrokeStyleTokenNormalized, StrokeStyleValue, StrokeStyleValueExpanded, Token, TokenCore, TokenMode, TokenNormalized, TokenNormalized as TokenNormalized$1, TokenNormalizedCore, TokenNormalizedSet, TokenNormalizedSet as TokenNormalizedSet$1, TokensSet, TransitionToken, TransitionTokenNormalized, TransitionValue, TransitionValueNormalized, TypographyToken, TypographyTokenNormalized, TypographyValue, TypographyValueNormalized } from "@terrazzo/token-tools";
 import ytm from "yaml-to-momoa";
 
 //#region src/logger.d.ts
@@ -22,7 +22,7 @@ interface LogEntry {
    */
   continueOnError?: boolean;
   /** Show a code frame for the erring node */
-  node?: AnyNode;
+  node?: momoa.AnyNode;
   /** To show a code frame, provide the original source code */
   src?: string;
 }
@@ -60,13 +60,13 @@ declare class Logger {
   });
   setLevel(level: LogLevel): void;
   /** Log an error message (always; can’t be silenced) */
-  error(entry: LogEntry): void;
+  error(...entries: LogEntry[]): void;
   /** Log an info message (if logging level permits) */
-  info(entry: LogEntry): void;
+  info(...entries: LogEntry[]): void;
   /** Log a warning message (if logging level permits) */
-  warn(entry: LogEntry): void;
+  warn(...entries: LogEntry[]): void;
   /** Log a diagnostics message (if logging level permits) */
-  debug(entry: DebugEntry): void;
+  debug(...entries: DebugEntry[]): void;
   /** Get stats for current logger instance */
   stats(): {
     errorCount: number;
@@ -80,7 +80,12 @@ declare class TokensJSONError extends Error {
 }
 //#endregion
 //#region src/types.d.ts
+interface PluginHookContext {
+  logger: Logger;
+}
 interface BuildHookOptions {
+  /** Plugin hook context (provides access to shared logger) */
+  context: PluginHookContext;
   /** Map of tokens */
   tokens: Record<string, TokenNormalized$1>;
   /** Query transformed values */
@@ -92,9 +97,11 @@ interface BuildHookOptions {
   contents: string | Buffer) => void;
 }
 interface BuildRunnerResult {
-  outputFiles: OutputFile[];
+  outputFiles: OutputFileExpanded[];
 }
 interface BuildEndHookOptions {
+  /** Plugin hook context (provides access to shared logger) */
+  context: PluginHookContext;
   /** Map of tokens */
   tokens: Record<string, TokenNormalized$1>;
   /** Query transformed values */
@@ -138,6 +145,33 @@ interface Config {
     deprecated?: boolean;
   };
 }
+interface VisitorContext {
+  parent?: momoa.AnyNode;
+  filename: URL;
+  path: string[];
+}
+type Visitor<T extends momoa.AnyNode = momoa.ObjectNode | momoa.DocumentNode> = (node: T, context: VisitorContext) => T | void | null | undefined;
+interface TransformVisitors {
+  boolean?: Visitor;
+  border?: Visitor;
+  color?: Visitor;
+  cubicBezier?: Visitor;
+  dimension?: Visitor;
+  duration?: Visitor;
+  fontFamily?: Visitor;
+  fontWeight?: Visitor;
+  gradient?: Visitor;
+  group?: Visitor;
+  link?: Visitor;
+  number?: Visitor;
+  root?: Visitor;
+  shadow?: Visitor;
+  strokeStyle?: Visitor;
+  token?: Visitor;
+  transition?: Visitor;
+  typography?: Visitor;
+  [key: string]: Visitor | undefined;
+}
 interface ConfigInit {
   tokens: URL[];
   outDir: URL;
@@ -159,13 +193,13 @@ interface ConfigOptions {
 interface InputSource {
   filename?: URL;
   src: any;
-  document: DocumentNode;
+  document: momoa.DocumentNode;
 }
 interface LintNotice {
   /** Lint message shown to the user */
   message: string;
   /** Erring node (used to point to a specific line) */
-  node?: AnyNode;
+  node?: momoa.AnyNode;
 }
 type LintRuleSeverity = 'error' | 'warn' | 'off';
 type LintRuleShorthand = LintRuleSeverity | 0 | 1 | 2;
@@ -176,10 +210,10 @@ interface LintRuleNormalized<O = any> {
   options?: O;
 }
 type LintReportDescriptor<MessageIds extends string> = {
-  /** To error on a specific token source file, provide an erring node */
-  node?: AnyNode;
-  /** To error on a specific token source file, also provide the source */
-  source?: InputSource;
+  /** To error on a specific token source file, provide a Momoa node */
+  node?: momoa.AnyNode;
+  /** To provide correct line numbers, specify the filename (usually found on `token.source.loc`) */
+  filename?: string;
   /** Provide data for messages */
   data?: Record<string, unknown>;
 } & ({
@@ -191,7 +225,7 @@ type LintReportDescriptor<MessageIds extends string> = {
   /** Provide the error message ID */
   messageId: MessageIds;
 });
-interface LintRule<MessageIds extends string, LintRuleOptions extends object | undefined = undefined, LintRuleDocs = unknown> {
+interface LintRule<MessageIds extends string, LintRuleOptions extends Record<string, any> = Record<string, never>, LintRuleDocs = unknown> {
   meta?: LintRuleMetaData<MessageIds, LintRuleOptions, LintRuleDocs>;
   /**
    * Function which returns an object with methods that ESLint calls to “visit”
@@ -213,8 +247,11 @@ interface LintRuleContext<MessageIds extends string, LintRuleOptions extends obj
   options: LintRuleOptions;
   /** The current working directory. */
   cwd?: URL;
-  /** Source file the token came from. */
-  src: string;
+  /**
+   * All source files present in this run. To find the original source, match a
+   * token’s `source.loc` filename to one of the source’s `filename`s.
+   */
+  sources: InputSource[];
   /** Source file location. */
   filename?: URL;
   /** ID:Token map of all tokens. */
@@ -261,6 +298,29 @@ interface OutputFileExpanded extends OutputFile {
   /** How long this output took to make. */
   time: number;
 }
+interface ParseOptions {
+  logger?: Logger;
+  config: ConfigInit;
+  /**
+   * Skip lint step
+   * @default false
+   */
+  skipLint?: boolean;
+  /**
+   * Continue on error? (Useful for `tz check`)
+   * @default false
+   */
+  continueOnError?: boolean;
+  /** Provide yamlToMomoa module to parse YAML (by default, this isn’t shipped to cut down on package weight) */
+  yamlToMomoa?: typeof ytm;
+  /**
+   * Transform API
+   * @see https://terrazzo.app/docs/api/js#transform-api
+   */
+  transform?: TransformVisitors;
+  /** (internal cache; do not use) */
+  _sources?: Record<string, InputSource>;
+}
 interface Plugin {
   name: string;
   /** Read config, and optionally modify */
@@ -276,16 +336,13 @@ interface Plugin {
   lint?(): Record<string, LintRule<any, any, any>>;
   transform?(options: TransformHookOptions): Promise<void>;
   build?(options: BuildHookOptions): Promise<void>;
-  buildEnd?(result: BuildRunnerResult): Promise<void>;
+  buildEnd?(options: BuildEndHookOptions): Promise<void>;
 }
-/** Transformed token with a single value. Note that this may be any type! */
-interface TokenTransformedSingleValue {
+interface TokenTransformedBase {
   /** Original Token ID */
   id: string;
   /** ID unique to this format. */
   localID?: string;
-  type: 'SINGLE_VALUE';
-  value: string;
   /**
    * The mode of this value
    * @default "."
@@ -293,22 +350,27 @@ interface TokenTransformedSingleValue {
   mode: string;
   /** The original token. */
   token: TokenNormalized$1;
+  /** Arbitrary metadata set by plugins. */
+  meta?: Record<string | number | symbol, unknown> & {
+    /**
+     * Metadata for the token-listing plugin. Plugins can
+     * set this to be the name of a token as it appears in code,
+     * and the token-listing plugin will pick it up and use it.
+     */
+    'token-listing'?: {
+      name: string | undefined;
+    };
+  };
+}
+/** Transformed token with a single value. Note that this may be any type! */
+interface TokenTransformedSingleValue extends TokenTransformedBase {
+  type: 'SINGLE_VALUE';
+  value: string;
 }
 /** Transformed token with multiple values. Note that this may be any type! */
-interface TokenTransformedMultiValue {
-  /** Original Token ID */
-  id: string;
-  /** ID unique to this format.*/
-  localID?: string;
+interface TokenTransformedMultiValue extends TokenTransformedBase {
   type: 'MULTI_VALUE';
   value: Record<string, string>;
-  /**
-   * The mode of this value
-   * @default "."
-   */
-  mode: string;
-  /** The original token */
-  token: TokenNormalized$1;
 }
 type TokenTransformed = TokenTransformedSingleValue | TokenTransformedMultiValue;
 interface TransformParams {
@@ -325,6 +387,8 @@ interface TransformParams {
   mode?: string | string[];
 }
 interface TransformHookOptions {
+  /** Plugin hook context (provides access to shared logger) */
+  context: PluginHookContext;
   /** Map of tokens */
   tokens: Record<string, TokenNormalized$1>;
   /** Query transformed values */
@@ -335,17 +399,21 @@ interface TransformHookOptions {
     localID?: string;
     value: string | Record<string, string>;
     mode?: string;
+    meta?: TokenTransformedBase['meta'];
   }): void;
   /** Momoa documents */
   sources: InputSource[];
 }
+interface ReferenceObject {
+  $ref: string;
+}
 //#endregion
 //#region src/build/index.d.ts
 interface BuildRunnerOptions {
   sources: {
     filename?: URL;
     src: string;
-    document: DocumentNode;
+    document: momoa.DocumentNode;
   }[];
   config: ConfigInit;
   logger?: Logger;
@@ -370,308 +438,28 @@ declare function defineConfig(rawConfig: Config, {
 /** Merge configs */
 declare function mergeConfigs(a: Config, b: Config): Config;
 //#endregion
+//#region src/lint/plugin-core/index.d.ts
+declare const RECOMMENDED_CONFIG: Record<string, LintRuleLonghand>;
+//#endregion
 //#region src/lint/index.d.ts
 interface LintRunnerOptions {
-  tokens: Record<string, TokenNormalized$1>;
+  tokens: TokenNormalizedSet$1;
   filename?: URL;
   config: ConfigInit;
-  src: string;
+  sources: InputSource[];
   logger: Logger;
 }
 declare function lintRunner({
   tokens,
   filename,
   config,
-  src,
+  sources,
   logger
 }: LintRunnerOptions): Promise<void>;
 //#endregion
-//#region src/parse/normalize.d.ts
-declare const FONT_WEIGHT_MAP: {
-  thin: number;
-  hairline: number;
-  'extra-light': number;
-  'ultra-light': number;
-  light: number;
-  normal: number;
-  regular: number;
-  book: number;
-  medium: number;
-  'semi-bold': number;
-  'demi-bold': number;
-  bold: number;
-  'extra-bold': number;
-  'ultra-bold': number;
-  black: number;
-  heavy: number;
-  'extra-black': number;
-  'ultra-black': number;
-};
-/** Fill in defaults, and return predictable shapes for tokens */
-declare function normalizeValue<T extends Token$1>(token: T): T['$value'];
-//#endregion
-//#region src/parse/validate.d.ts
-interface ValidateOptions {
-  filename?: URL;
-  src: string;
-  logger: Logger;
-}
-interface Visitors {
-  color?: Visitor;
-  dimension?: Visitor;
-  fontFamily?: Visitor;
-  fontWeight?: Visitor;
-  duration?: Visitor;
-  cubicBezier?: Visitor;
-  number?: Visitor;
-  link?: Visitor;
-  boolean?: Visitor;
-  strokeStyle?: Visitor;
-  border?: Visitor;
-  transition?: Visitor;
-  shadow?: Visitor;
-  gradient?: Visitor;
-  typography?: Visitor;
-  root?: Visitor;
-  group?: Visitor;
-  [key: string]: Visitor | undefined;
-}
-type Visitor = (json: any, path: string, ast: AnyNode) => any | undefined | null;
-declare const VALID_COLORSPACES: Set<string>;
-declare const FONT_WEIGHT_VALUES: Set<string>;
-declare const STROKE_STYLE_VALUES: Set<string>;
-declare const STROKE_STYLE_LINE_CAP_VALUES: Set<string>;
-/** Verify an Alias $value is formatted correctly */
-declare function validateAliasSyntax($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Border token is valid */
-declare function validateBorder($value: ValueNode, node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Color token is valid */
-declare function validateColor($value: ValueNode, node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Cubic Bézier token is valid */
-declare function validateCubicBezier($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Dimension token is valid */
-declare function validateDimension($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Duration token is valid */
-declare function validateDuration($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/**  Verify a Font Family token is valid */
-declare function validateFontFamily($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Font Weight token is valid */
-declare function validateFontWeight($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Gradient token is valid */
-declare function validateGradient($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Number token is valid */
-declare function validateNumber($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Boolean token is valid */
-declare function validateBoolean($value: ValueNode, _node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Shadow token’s value is valid */
-declare function validateShadowLayer($value: ValueNode, node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Stroke Style token is valid. */
-declare function validateStrokeStyle($value: ValueNode, node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Verify a Transition token is valid */
-declare function validateTransition($value: ValueNode, node: AnyNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/**
- * Validate a MemberNode (the entire token object, plus its key in the parent
- * object) to see if it’s a valid DTCG token or not. Keeping the parent key
- * really helps in debug messages.
- */
-declare function validateTokenMemberNode(node: MemberNode, {
-  filename,
-  src,
-  logger
-}: ValidateOptions): void;
-/** Return whether a MemberNode is a group (has no `$value`).
- * Groups can have properties that their child nodes will inherit. */
-declare function isGroupNode(node: ObjectNode): boolean;
-/** Check if a token node has the specified property name, and if it does, stores
- * the value in the `inherited` object as a side effect for future use. If not,
- * traverses the `inherited` object to find the closest parent that has the property.
- *
- * Returns the property value if found locally or in a parent, otherwise undefined. */
-declare function computeInheritedProperty(node: MemberNode, propertyName: string, {
-  subpath,
-  inherited
-}: {
-  subpath: string[];
-  inherited?: Record<string, MemberNode>;
-}): MemberNode | undefined;
-interface ValidateTokenNodeOptions {
-  subpath: string[];
-  src: string;
-  filename: URL;
-  config: ConfigInit;
-  logger: Logger;
-  parent: AnyNode | undefined;
-  transform?: Visitors;
-  inheritedDeprecatedNode?: MemberNode;
-  inheritedTypeNode?: MemberNode;
-}
-/**
- * Validate does a little more than validate; it also converts to TokenNormalized
- * and sets up the basic data structure. But aliases are unresolved, and we need
- * a 2nd normalization pass afterward.
- */
-declare function validateTokenNode(node: MemberNode, {
-  config,
-  filename,
-  logger,
-  parent,
-  inheritedDeprecatedNode,
-  inheritedTypeNode,
-  src,
-  subpath
-}: ValidateTokenNodeOptions): TokenNormalized$1 | undefined;
-//#endregion
-//#region src/parse/alias.d.ts
-interface ApplyAliasOptions {
-  tokensSet: TokenNormalizedSet$1;
-  filename: URL;
-  src: string;
-  node: ObjectNode;
-  logger: Logger;
-}
-type PreAliased<T extends TokenNormalized$1> = {
-  $value: T['$value'] | string;
-  mode: Record<string, T['mode'][string] & {
-    $value: T['$value'] | string;
-  }>;
-};
-//#endregion
-//#region src/parse/json.d.ts
-interface JSONVisitor {
-  enter?: (node: AnyNode, parent: AnyNode | undefined, path: string[]) => void;
-  exit?: (node: AnyNode, parent: AnyNode | undefined, path: string[]) => void;
-}
-declare const CHILD_KEYS: {
-  Document: readonly ["body"];
-  Object: readonly ["members"];
-  Member: readonly ["name", "value"];
-  Element: readonly ["value"];
-  Array: readonly ["elements"];
-  String: readonly [];
-  Number: readonly [];
-  Boolean: readonly [];
-  Null: readonly [];
-  Identifier: readonly [];
-  NaN: readonly [];
-  Infinity: readonly [];
-};
-/** Determines if a given value is an AST node. */
-declare function isNode(value: unknown): boolean;
-type ValueNodeWithIndex = ValueNode & {
-  index: number;
-};
-/** Get ObjectNode members as object */
-declare function getObjMembers(node: ObjectNode): Record<string | number, ValueNodeWithIndex>;
-/** Inject members to ObjectNode */
-declare function injectObjMembers(node: ObjectNode, members?: MemberNode[]): void;
-/** Replace an ObjectNode’s contents outright with another */
-declare function replaceObjMembers(a: ObjectNode, b: DocumentNode | ObjectNode): void;
-/**
- * Variation of Momoa’s traverse(), which keeps track of global path.
- * Allows mutation of AST (along with any consequences)
- */
-declare function traverse(root: AnyNode, visitor: JSONVisitor): void;
-/** Determine if an input is likely a JSON string */
-declare function maybeRawJSON(input: string): boolean;
-/** Find Momoa node by traversing paths */
-declare function findNode<T = AnyNode>(node: AnyNode, path: string[]): T | undefined;
-interface ToMomoaOptions {
-  filename?: URL;
-  continueOnError?: boolean;
-  logger: Logger;
-  yamlToMomoa?: typeof ytm;
-}
-declare function toMomoa(input: string | Record<string, any>, {
-  continueOnError,
-  filename,
-  logger,
-  yamlToMomoa: ytm
-}: ToMomoaOptions): InputSource;
-/** Momoa, just with default options pre-set */
-declare function parseJSON(input: string | Record<string, any>, options?: ParseOptions$1): any;
-//#endregion
 //#region src/parse/index.d.ts
-interface ParseOptions {
-  logger?: Logger;
-  config: ConfigInit;
-  /**
-   * Skip lint step
-   * @default false
-   */
-  skipLint?: boolean;
-  /**
-   * Continue on error? (Useful for `tz check`)
-   * @default false
-   */
-  continueOnError?: boolean;
-  /** Provide yamlToMomoa module to parse YAML (by default, this isn’t shipped to cut down on package weight) */
-  yamlToMomoa?: typeof ytm;
-  /**
-   * Transform API
-   * @see https://terrazzo.app/docs/api/js#transform-api
-   */
-  transform?: Visitors;
-  /** (internal cache; do not use) */
-  _sources?: Record<string, InputSource>;
-}
 interface ParseResult {
-  tokens: Record<string, TokenNormalized$1>;
+  tokens: TokenNormalizedSet$1;
   sources: InputSource[];
 }
 /** Parse */
@@ -681,9 +469,8 @@ declare function parse(_input: Omit<InputSource, 'document'> | Omit<InputSource,
   config,
   continueOnError,
   yamlToMomoa,
-  transform,
-  _sources
+  transform
 }?: ParseOptions): Promise<ParseResult>;
 //#endregion
-export { type AliasToken, type AliasValue, ApplyAliasOptions, type BooleanToken, type BooleanTokenNormalized, type BooleanValue, type BorderToken, type BorderTokenNormalized, type BorderValue, type BorderValueNormalized, BuildEndHookOptions, BuildHookOptions, BuildRunnerOptions, BuildRunnerResult, CHILD_KEYS, type ColorSpace, type ColorToken, type ColorTokenNormalized, type ColorValue, type ColorValueNormalized, Config, ConfigInit, ConfigOptions, type CubicBezierToken, type CubicBezierTokenNormalized, type CubicBezierValue, type CustomTransformOptions, DebugEntry, type DimensionToken, type DimensionTokenNormalized, type DimensionValue, type DurationToken, type DurationTokenNormalized, type DurationValue, FONT_WEIGHT_MAP, FONT_WEIGHT_VALUES, type FontFamilyToken, type FontFamilyTokenNormalized, type FontFamilyValue, type FontFamilyValueNormalized, type FontWeightToken, type FontWeightTokenNormalized, type FontWeightValue, type FontWeightValueNormalized, type GradientStop, type GradientStopNormalized, type GradientToken, type GradientTokenNormalized, type GradientValue, type GradientValueNormalized, type Group, type GroupCore, type GroupOrToken, InputSource, JSONVisitor, LOG_ORDER, type LinkToken, type LinkTokenNormalized, type LinkValue, LintNotice, LintReportDescriptor, LintRule, LintRuleContext, LintRuleLonghand, LintRuleMetaData, LintRuleMetaDataDocs, LintRuleNormalized, LintRuleSeverity, LintRuleShorthand, LintRunnerOptions, LogEntry, LogGroup, LogLevel, LogSeverity, Logger, MULTI_VALUE, type ModeMap, type NumberToken, type NumberTokenNormalized, type NumberValue, OutputFile, OutputFileExpanded, ParseOptions, ParseResult, Plugin, PreAliased, SINGLE_VALUE, STROKE_STYLE_LINE_CAP_VALUES, STROKE_STYLE_VALUES, type ShadowToken, type ShadowTokenNormalized, type ShadowValue, type ShadowValueNormalized, type StringToken, type StringTokenNormalized, type StringValue, type StrokeStyleToken, type StrokeStyleTokenNormalized, type StrokeStyleValue, type StrokeStyleValueExpanded, ToMomoaOptions, type Token, type TokenCore, type TokenMode, type TokenNormalized, type TokenNormalizedCore, type TokenNormalizedSet, TokenTransformed, TokenTransformedMultiValue, TokenTransformedSingleValue, TokensJSONError, type TokensSet, TransformHookOptions, TransformParams, type TransitionToken, type TransitionTokenNormalized, type TransitionValue, type TransitionValueNormalized, type TypographyToken, type TypographyTokenNormalized, type TypographyValue, type TypographyValueNormalized, VALID_COLORSPACES, ValidateOptions, ValidateTokenNodeOptions, ValueNodeWithIndex, Visitor, Visitors, build, computeInheritedProperty, defineConfig, findNode, formatMessage, getObjMembers, injectObjMembers, isGroupNode, isNode, lintRunner, maybeRawJSON, mergeConfigs, normalizeValue as normalize, parse, parseJSON, replaceObjMembers, toMomoa, traverse, validateAliasSyntax, validateBoolean, validateBorder, validateColor, validateCubicBezier, validateDimension, validateDuration, validateFontFamily, validateFontWeight, validateGradient, validateNumber, validateShadowLayer, validateStrokeStyle, validateTokenMemberNode, validateTokenNode, validateTransition };
+export { type AliasToken, type AliasValue, type BooleanToken, type BooleanTokenNormalized, type BooleanValue, type BorderToken, type BorderTokenNormalized, type BorderValue, type BorderValueNormalized, BuildEndHookOptions, BuildHookOptions, BuildRunnerOptions, BuildRunnerResult, type ColorSpace, type ColorToken, type ColorTokenNormalized, type ColorValue, type ColorValueNormalized, Config, ConfigInit, ConfigOptions, type CubicBezierToken, type CubicBezierTokenNormalized, type CubicBezierValue, type CustomTransformOptions, DebugEntry, type DimensionToken, type DimensionTokenNormalized, type DimensionValue, type DurationToken, type DurationTokenNormalized, type DurationValue, type FontFamilyToken, type FontFamilyTokenNormalized, type FontFamilyValue, type FontFamilyValueNormalized, type FontWeightToken, type FontWeightTokenNormalized, type FontWeightValue, type FontWeightValueNormalized, type GradientStop, type GradientStopNormalized, type GradientToken, type GradientTokenNormalized, type GradientValue, type GradientValueNormalized, type Group, type GroupCore, type GroupOrToken, InputSource, LOG_ORDER, type LinkToken, type LinkTokenNormalized, type LinkValue, LintNotice, LintReportDescriptor, LintRule, LintRuleContext, LintRuleLonghand, LintRuleMetaData, LintRuleMetaDataDocs, LintRuleNormalized, LintRuleSeverity, LintRuleShorthand, LintRunnerOptions, LogEntry, LogGroup, LogLevel, LogSeverity, Logger, MULTI_VALUE, type ModeMap, type NumberToken, type NumberTokenNormalized, type NumberValue, OutputFile, OutputFileExpanded, ParseOptions, ParseResult, Plugin, PluginHookContext, RECOMMENDED_CONFIG, ReferenceObject, SINGLE_VALUE, type ShadowToken, type ShadowTokenNormalized, type ShadowValue, type ShadowValueNormalized, type StringToken, type StringTokenNormalized, type StringValue, type StrokeStyleToken, type StrokeStyleTokenNormalized, type StrokeStyleValue, type StrokeStyleValueExpanded, type Token, type TokenCore, type TokenMode, type TokenNormalized, type TokenNormalizedCore, type TokenNormalizedSet, TokenTransformed, TokenTransformedMultiValue, TokenTransformedSingleValue, TokensJSONError, type TokensSet, TransformHookOptions, TransformParams, TransformVisitors, type TransitionToken, type TransitionTokenNormalized, type TransitionValue, type TransitionValueNormalized, type TypographyToken, type TypographyTokenNormalized, type TypographyValue, type TypographyValueNormalized, Visitor, VisitorContext, build, defineConfig, formatMessage, lintRunner, mergeConfigs, parse };
 //# sourceMappingURL=index.d.ts.map