@sxl-studio/token-transformer 1.0.0 → 2.0.0

package/dist/core/token-types.js

@@ -0,0 +1,132 @@
+const LEGACY_TYPE_ALIASES = {
+    fontFamilies: "fontFamily",
+    fontWeights: "fontWeight",
+    fontStyles: "fontStyle",
+    fontSizes: "fontSize",
+    lineHeights: "lineHeight",
+    letterSpacings: "letterSpacing",
+    paragraphSpacings: "paragraphSpacing",
+    paragraphIndents: "paragraphIndent",
+    borderRadii: "borderRadius",
+    textCases: "textCase",
+    textDecorations: "textDecoration",
+    size: "sizing",
+    space: "spacing",
+    string: "text",
+    backdropBlur: "backdrop-blur",
+    backgroundBlur: "backdrop-blur",
+    "background-blur": "backdrop-blur",
+    layerBlur: "blur",
+    boxShadow: "shadow",
+};
+export const SIMPLE_TOKEN_TYPES = new Set([
+    "color",
+    "dimension",
+    "sizing",
+    "spacing",
+    "borderRadius",
+    "borderWidth",
+    "opacity",
+    "number",
+    "fontFamily",
+    "fontWeight",
+    "fontStyle",
+    "fontSize",
+    "lineHeight",
+    "letterSpacing",
+    "paragraphSpacing",
+    "paragraphIndent",
+    "textCase",
+    "textDecoration",
+    "boolean",
+    "text",
+    "duration",
+    "cubicBezier",
+    "strokeStyle",
+]);
+export const COMPOSITE_TOKEN_TYPES = new Set([
+    "typography",
+    "shadow",
+    "border",
+    "fill",
+    "gradient",
+    "effects",
+    "blur",
+    "backdrop-blur",
+    "glass",
+    "grid",
+    "transition",
+    "template",
+    "composition",
+]);
+const CANONICAL = new Set([...SIMPLE_TOKEN_TYPES, ...COMPOSITE_TOKEN_TYPES]);
+const EXTRA_ALIASES = {
+    color: "color",
+    gradient: "gradient",
+    img: "img",
+    fill: "fill",
+    dimension: "dimension",
+    number: "number",
+    spacing: "spacing",
+    sizing: "sizing",
+    border: "border",
+    borderWidth: "borderWidth",
+    borderRadius: "borderRadius",
+    strokeStyle: "strokeStyle",
+    shadow: "shadow",
+    blur: "blur",
+    glass: "glass",
+    effects: "effects",
+    typography: "typography",
+    fontFamily: "fontFamily",
+    fontWeight: "fontWeight",
+    fontStyle: "fontStyle",
+    fontSize: "fontSize",
+    lineHeight: "lineHeight",
+    letterSpacing: "letterSpacing",
+    paragraphSpacing: "paragraphSpacing",
+    paragraphIndent: "paragraphIndent",
+    textCase: "textCase",
+    textDecoration: "textDecoration",
+    text: "text",
+    opacity: "opacity",
+    duration: "duration",
+    cubicBezier: "cubicBezier",
+    transition: "transition",
+    grid: "grid",
+    boolean: "boolean",
+    template: "template",
+    composition: "composition",
+};
+const ALIAS_MAP = buildAliasMap();
+function buildAliasMap() {
+    const map = { ...LEGACY_TYPE_ALIASES };
+    for (const [alias, canonical] of Object.entries(EXTRA_ALIASES)) {
+        map[alias] = canonical;
+    }
+    for (const canonical of CANONICAL) {
+        map[canonical] = canonical;
+    }
+    return map;
+}
+export function normalizeTokenTypeKey(raw) {
+    const value = raw.trim();
+    if (!value)
+        return value;
+    return ALIAS_MAP[value] ?? value;
+}
+export function isSimpleType(type) {
+    return SIMPLE_TOKEN_TYPES.has(normalizeTokenTypeKey(type));
+}
+export function isCompositeType(type) {
+    return COMPOSITE_TOKEN_TYPES.has(normalizeTokenTypeKey(type));
+}
+export function isTokenType(type) {
+    const normalized = normalizeTokenTypeKey(type);
+    return SIMPLE_TOKEN_TYPES.has(normalized) || COMPOSITE_TOKEN_TYPES.has(normalized);
+}
+export function shouldSkipByType(type) {
+    const normalized = normalizeTokenTypeKey(type);
+    return normalized === "template" || normalized === "composition";
+}
+//# sourceMappingURL=token-types.js.map

package/dist/core/token-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-types.js","sourceRoot":"","sources":["../../src/core/token-types.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAA2B;IAClD,YAAY,EAAE,YAAY;IAC1B,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,UAAU;IACrB,WAAW,EAAE,YAAY;IACzB,cAAc,EAAE,eAAe;IAC/B,iBAAiB,EAAE,kBAAkB;IACrC,gBAAgB,EAAE,iBAAiB;IACnC,WAAW,EAAE,cAAc;IAC3B,SAAS,EAAE,UAAU;IACrB,eAAe,EAAE,gBAAgB;IACjC,IAAI,EAAE,QAAQ;IACd,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,MAAM;IACd,YAAY,EAAE,eAAe;IAC7B,cAAc,EAAE,eAAe;IAC/B,iBAAiB,EAAE,eAAe;IAClC,SAAS,EAAE,MAAM;IACjB,SAAS,EAAE,QAAQ;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,OAAO;IACP,WAAW;IACX,QAAQ;IACR,SAAS;IACT,cAAc;IACd,aAAa;IACb,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,UAAU;IACV,YAAY;IACZ,eAAe;IACf,kBAAkB;IAClB,iBAAiB;IACjB,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,MAAM;IACN,UAAU;IACV,aAAa;IACb,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IAC3C,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,UAAU;IACV,SAAS;IACT,MAAM;IACN,eAAe;IACf,OAAO;IACP,MAAM;IACN,YAAY;IACZ,UAAU;IACV,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,kBAAkB,EAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC;AAE7E,MAAM,aAAa,GAA2B;IAC5C,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,eAAe,EAAE,iBAAiB;IAClC,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEF,MAAM,SAAS,GAA2B,aAAa,EAAE,CAAC;AAE1D,SAAS,aAAa;IACpB,MAAM,GAAG,GAA2B,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAE/D,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,GAAG,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,kBAAkB,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,qBAAqB,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,OAAO,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,aAAa,CAAC;AACnE,CAAC"}

package/dist/core/types.d.ts

@@ -1,83 +1,174 @@
-export type Platform = "css" | "swiftui" | "kotlin";
-export type SimpleTokenType = "color" | "dimension" | "sizing" | "spacing" | "borderRadius" | "borderWidth" | "opacity" | "number" | "fontFamily" | "fontWeight" | "fontStyle" | "fontSize" | "lineHeight" | "letterSpacing" | "paragraphSpacing" | "paragraphIndent" | "textCase" | "textDecoration" | "boolean" | "text" | "string" | "duration" | "cubicBezier" | "strokeStyle";
-export type CompositeTokenType = "typography" | "shadow" | "border" | "fill" | "gradient" | "effects" | "blur" | "backdrop-blur" | "glass" | "grid" | "transition";
-export type TokenType = SimpleTokenType | CompositeTokenType;
+import type { CollisionStrategy, OptionsConfig, OutputConfig, OutputFileConfig, Platform, SplitBySourceFileConfig, SourceConfig, TokenFilterConfig, TokenSetConfig, TokenSetSelectorConfig, TransformerConfig, UnresolvedAliasAction, UnsupportedTypeAction } from "../config/schema.js";
+export type { CollisionStrategy, OptionsConfig, OutputConfig, OutputFileConfig, Platform, SplitBySourceFileConfig, SourceConfig, TokenFilterConfig, TokenSetConfig, TokenSetSelectorConfig, TransformerConfig, UnresolvedAliasAction, UnsupportedTypeAction, };
+export type ColorModifyType = "lighten" | "darken" | "alpha" | "mix";
+export type ColorSpace = "srgb" | "hsl" | "lch" | "oklch" | "p3";
+export type FigmaModify = {
+    type: ColorModifyType;
+    value: number | string;
+    space: ColorSpace;
+    color?: string;
+};
+export type FigmaCodeSyntax = {
+    Web?: string;
+    Android?: string;
+    iOS?: string;
+};
+export type TokenExtensions = {
+    "figma.scopes"?: string[];
+    "figma.codeSyntax"?: FigmaCodeSyntax;
+    "figma.hide"?: boolean;
+    "figma.modify"?: FigmaModify | FigmaModify[];
+};
 export type FlatToken = {
     path: string;
-    name: string;
-    type: TokenType | string;
+    type: string;
     value: unknown;
     resolvedValue?: unknown;
+    description?: string;
+    extensions?: TokenExtensions;
+    id?: string;
     isAlias: boolean;
     aliasPath?: string;
-    description?: string;
-    extensions?: Record<string, unknown>;
-    sourceFile?: string;
+    sourceFile: string;
+    sourceCollection?: string;
+    sourceMode?: string;
+};
+export type CollectionConfig = {
+    name: string;
+    enabled: boolean;
+    modes: ModeConfig[];
+    ref?: RefRuleConfig[];
+};
+export type ModeConfig = {
+    name: string;
+    enabled: boolean;
+    files: Record<string, string>;
+    ref?: RefRuleConfig[];
 };
-export type TransformConfig = {
-    source: SourceConfig;
-    platforms: Partial<Record<Platform, PlatformConfig>>;
-    settings?: GlobalSettings;
+export type RefRuleConfig = {
+    type: string;
+    collection: string;
+    mode?: string;
 };
-export type SourceConfig = {
+export type TokensProjectConfig = {
+    settings?: {
+        remBase?: number;
+    };
+    collections?: CollectionConfig[];
+};
+export type ResolvedSourceConfig = {
     tokenDir: string;
-    configFile?: string;
-    include?: string[];
-    exclude?: string[];
+    configFile: string;
+    include: string[];
+    exclude: string[];
 };
-export type PlatformConfig = {
+export type ResolvedOutputConfig = Omit<OutputConfig, "outputDir"> & {
     outputDir: string;
-    fileMapping?: FileMapping[];
-    prefix?: string;
-    codeSyntax?: CodeSyntaxConfig;
-    resolveAliases?: boolean;
-    splitEffects?: boolean;
-    showDescriptions?: boolean;
-    options?: Record<string, unknown>;
-};
-export type FileMapping = {
-    sources: string[];
-    output: string;
-    filter?: TokenFilter;
-};
-export type TokenFilter = {
-    types?: string[];
-    paths?: string[];
-    excludePaths?: string[];
-};
-export type CodeSyntaxConfig = {
-    variableTemplate?: string;
-    colorFormat?: "hex" | "rgb" | "rgba" | "hsl";
-    dimensionUnit?: string;
-    prefix?: string;
-};
-export type GlobalSettings = {
-    remBase?: number;
-    colorFormat?: "hex" | "rgb" | "rgba" | "hsl";
-    verbose?: boolean;
 };
-export type TransformResult = {
-    platform: Platform;
-    files: OutputFile[];
-    tokenCount: number;
-    errors: string[];
+export type ResolvedTransformerConfig = Omit<TransformerConfig, "source" | "outputs"> & {
+    source: ResolvedSourceConfig;
+    outputs: ResolvedOutputConfig[];
 };
 export type OutputFile = {
     path: string;
     content: string;
     tokenCount: number;
+    outputId?: string;
+    tokenSetId?: string;
+    sourceFiles?: string[];
 };
-export type CollectionConfig = {
-    name: string;
-    enabled: boolean;
-    modes: ModeConfig[];
-    ref?: {
-        type: string;
-        collection: string;
-    }[];
+export type DiagnosticsLevel = "info" | "warn" | "error";
+export type Diagnostic = {
+    level: DiagnosticsLevel;
+    message: string;
+    code?: string;
+    tokenPath?: string;
+    outputId?: string;
 };
-export type ModeConfig = {
-    name: string;
-    enabled: boolean;
-    files: Record<string, string>;
+export type TransformResult = {
+    files: OutputFile[];
+    diagnostics: Diagnostic[];
+    removedFiles?: string[];
+};
+export type SelectorResolvedFiles = {
+    selector: TokenSetSelectorConfig;
+    files: string[];
+    resolverFiles: string[];
+};
+export type TokenSetResolved = {
+    id: string;
+    unresolvedAliases: UnresolvedAliasAction;
+    tokens: FlatToken[];
+    resolverTokens: FlatToken[];
+    selectors: SelectorResolvedFiles[];
+};
+export type SourceFileFingerprint = {
+    size: number;
+    mtimeMs: number;
+};
+export type SmartOutputState = {
+    path: string;
+    outputId: string;
+    tokenSetId?: string;
+    contentHash: string;
+    sourceFiles: string[];
+};
+export type SmartTransformState = {
+    version: 1;
+    configHash: string;
+    generatedAt: string;
+    sourceFiles: Record<string, SourceFileFingerprint>;
+    outputs: Record<string, SmartOutputState>;
+};
+export type SmartTransformMode = "smart" | "force";
+export type SmartTransformMeta = {
+    mode: SmartTransformMode;
+    fullRebuild: boolean;
+    reason: string;
+    changedSourceFiles: string[];
+    removedSourceFiles: string[];
+    affectedTokenSets: string[];
+    affectedOutputIds: string[];
+    skippedOutputCount: number;
+};
+export type NameCollision = {
+    requested: string;
+    resolved: string;
+    tokenPath: string;
+    strategy: CollisionStrategy;
+};
+export type AliasResolutionContext = {
+    remBase: number;
+    maxDepth: number;
+};
+export type UnsupportedTypeResolution = {
+    action: UnsupportedTypeAction;
+    type: string;
+};
+export type EmitterInput = {
+    tokens: FlatToken[];
+    platform: Platform;
+    prefix?: string;
+    resolveAliases: boolean;
+    splitEffects: boolean;
+    showDescriptions: boolean;
+    collisions: CollisionStrategy;
+    outputId: string;
+    remBase?: number;
+};
+export type PlatformConfig = {
+    outputDir: string;
+    prefix?: string;
+    resolveAliases?: boolean;
+    splitEffects?: boolean;
+    showDescriptions?: boolean;
+};
+export type EmitResult = {
+    content: string;
+    diagnostics: Diagnostic[];
+    extraFiles?: {
+        relativePath: string;
+        content: string;
+        tokenCount?: number;
+    }[];
 };

package/dist/core/writer.d.ts

@@ -1,6 +1,19 @@
-import { TransformConfig, TransformResult } from "./types.js";
-export declare function runTransform(config: TransformConfig): Promise<TransformResult[]>;
-export declare function writeOutputFiles(results: TransformResult[]): {
-    written: number;
-    errors: string[];
+import type { Diagnostic, OutputFile, ResolvedTransformerConfig, SmartTransformMeta, SmartTransformMode, SmartTransformState, TokenSetResolved, TransformResult } from "./types.js";
+export type RunTransformResult = TransformResult & {
+    tokenSets: TokenSetResolved[];
+    state: SmartTransformState;
+    meta: SmartTransformMeta;
+};
+export type RunTransformOptions = {
+    autoFixAliasSyntax?: boolean;
+    skipTokensWithIssues?: boolean;
+    mode?: SmartTransformMode;
+    previousState?: SmartTransformState | null;
+    configHash?: string;
 };
+export declare function runTransform(config: ResolvedTransformerConfig, runOptions?: RunTransformOptions): Promise<RunTransformResult>;
+export declare function writeOutputFiles(files: OutputFile[], removedFiles?: string[]): Promise<{
+    written: number;
+    removed: number;
+    diagnostics: Diagnostic[];
+}>;