@arbor-css/tokens 0.0.59 → 0.0.62

package/dist/createToken.d.ts

@@ -0,0 +1,147 @@
+export declare const DEFAULT_TOKEN_PREFIX = "--x-";
+export declare const DEFAULT_MIXIN_TOKEN_PREFIX = "--mx-";
+export interface TokenOptions {
+    /** Inferred from purpose if not provided, defaults to "*" */
+    type?: PropertyType;
+    purpose?: TokenPurpose;
+    group?: string;
+    description?: string;
+    fallback?: string | number;
+    tag?: string;
+    inherits?: boolean;
+    /**
+     * Force the generation of a @property rule definition, even if it's not meaningful.
+     * Otherwise tokens whose properties have no special concerns like inherit:false will
+     * skip generating an @property
+     */
+    forceDefinition?: boolean;
+}
+/**
+ * Allowed types of properties - specifying one allows defining
+ * a custom property in CSS which enables interpolation in animations
+ * and other optimizations.
+ *
+ * "*" doesn't really do much but does allow any kind of value.
+ *
+ * "computed" will not generate a property definition and is assumed
+ * to be a complex CSS property value like calc() or other things.
+ */
+export type PropertyType = 'angle' | 'color' | 'custom-ident' | 'image' | 'integer' | 'length' | 'length-percentage' | 'number' | 'percentage' | 'resolution' | 'string' | 'time' | 'transform-function' | 'transform-list' | 'url' | '*';
+/**
+ * Roughly mapped / inspired by designtokens.org.
+ * Not currently used... but I wrote them down, so...
+ */
+export type TokenType = 'color' | 'dimension' | 'font-family' | 'font-weight' | 'duration' | 'cubic-bezier' | 'number' | 'font-style' | 'ratio' | 'url' | TokenCompositeType;
+export type TokenCompositeTypeShapes = {
+    strokeStyle: {
+        dashArray: {
+            value: string;
+            unit: string;
+        }[];
+        lineCap: string;
+    } | string;
+    border: {
+        color: string;
+        width: string;
+        style: string;
+    };
+    transition: {
+        duration: string;
+        delay: string;
+        timingFunction: string;
+    };
+    shadow: {
+        offsetX: string;
+        offsetY: string;
+        blur: string;
+        spread: string;
+        color: string;
+    } | {
+        offsetX: string;
+        offsetY: string;
+        blur: string;
+        spread: string;
+        color: string;
+    }[];
+    gradient: {
+        color: string;
+        position: string;
+    }[];
+    typography: {
+        fontFamily: string;
+        fontSize: string;
+        fontWeight: string;
+        letterSpacing: string;
+        lineHeight: string;
+    };
+};
+export type TokenCompositeType = keyof TokenCompositeTypeShapes;
+export type TokenPurpose = 'color' | 'font-size' | 'font-weight' | 'font-family' | 'line-height' | 'spacing' | 'shadow' | 'border-radius' | 'border-width' | 'shadow-x' | 'shadow-y' | 'shadow-blur' | 'shadow-spread' | 'shadow-color' | 'size' | 'other';
+export declare function getTypeFromPurpose(purpose: TokenPurpose): PropertyType;
+export declare function createTokenFactory({ tokenPrefix }: {
+    tokenPrefix: string;
+}): (name: string, { fallback, inherits, forceDefinition, purpose, type, group, description, tag, }?: TokenOptions) => {
+    "@@TOKEN@@": true;
+    name: string;
+    type: PropertyType;
+    tag: string | undefined;
+    purpose: TokenPurpose;
+    group: string | undefined;
+    description: string | undefined;
+    fallback: string | number | undefined;
+    var: string;
+    varFallback: (fallbackOverride?: string | number) => string;
+    assign: (value?: string | number) => string;
+    readonly definition: string;
+    suffixed: (suffix: string) => {
+        "@@TOKEN@@": true;
+        name: string;
+        type: PropertyType;
+        tag: string | undefined;
+        purpose: TokenPurpose;
+        group: string | undefined;
+        description: string | undefined;
+        fallback: string | number | undefined;
+        var: string;
+        varFallback: (fallbackOverride?: string | number) => string;
+        assign: (value?: string | number) => string;
+        readonly definition: string;
+        suffixed: /*elided*/ any;
+        prefixed: (prefix: string) => /*elided*/ any;
+    };
+    prefixed: (prefix: string) => {
+        "@@TOKEN@@": true;
+        name: string;
+        type: PropertyType;
+        tag: string | undefined;
+        purpose: TokenPurpose;
+        group: string | undefined;
+        description: string | undefined;
+        fallback: string | number | undefined;
+        var: string;
+        varFallback: (fallbackOverride?: string | number) => string;
+        assign: (value?: string | number) => string;
+        readonly definition: string;
+        suffixed: (suffix: string) => /*elided*/ any;
+        prefixed: /*elided*/ any;
+    };
+};
+export type Token = ReturnType<ReturnType<typeof createTokenFactory>>;
+export type CreateToken = ReturnType<typeof createTokenFactory>;
+export type TokenSchema = {
+    [Key: string]: Token | TokenSchema;
+};
+export declare function isToken(value: any): value is Token;
+/**
+ * Maps all token values to themselves - i.e.
+ * {
+ * '--🌗-black': 'var(--🌗-black)',
+ * ...
+ * }
+ */
+export declare function selfReferencedProps(schema: TokenSchema, { valuePrefix: prefix, }?: {
+    /** Apply a prefix to the referenced value, i.e. '$' = '--$system-black': '--$system-$-black' */
+    valuePrefix?: string;
+}): Record<string, string>;
+export declare function tokenSchemaToList(schema: TokenSchema): Token[];
+//# sourceMappingURL=createToken.d.ts.map

package/dist/createToken.d.ts.map

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

package/dist/createToken.js

@@ -0,0 +1,113 @@
+export const DEFAULT_TOKEN_PREFIX = '--x-';
+export const DEFAULT_MIXIN_TOKEN_PREFIX = '--mx-';
+export function getTypeFromPurpose(purpose) {
+    switch (purpose) {
+        case 'color':
+            return 'color';
+        case 'font-size':
+            return 'length';
+        case 'font-weight':
+            return 'number';
+        case 'line-height':
+            return 'length-percentage';
+        case 'font-family':
+            return 'string';
+        case 'spacing':
+            return 'length';
+        case 'shadow':
+            return 'string';
+        default:
+            return '*';
+    }
+}
+const TOKEN_BRAND = '@@TOKEN@@';
+function normalizeName(name) {
+    return name.replaceAll('$', '').replace(/\s+/g, '-');
+}
+export function createTokenFactory({ tokenPrefix }) {
+    return function createToken(name, { fallback, inherits = true, forceDefinition, purpose = 'other', type = getTypeFromPurpose(purpose), group, description, tag, } = {}) {
+        const taggedName = tag ? `${tag}-${name}` : name;
+        const resolvedName = `${tokenPrefix}${normalizeName(taggedName)}`;
+        return {
+            [TOKEN_BRAND]: true,
+            name: resolvedName,
+            type,
+            tag,
+            purpose,
+            group,
+            description,
+            fallback,
+            var: `var(${resolvedName}${fallback ? `, ${fallback}` : ''})`,
+            varFallback: (fallbackOverride) => `var(${resolvedName}, ${fallbackOverride ?? fallback ?? 'initial'})`,
+            assign: (value) => `${resolvedName}: ${value ?? fallback};`,
+            get definition() {
+                if (inherits === false || forceDefinition) {
+                    return `@property ${resolvedName} { syntax: '${type === '*' ? '*' : `<${type}>`}'; inherits: ${inherits}; initial-value: ${fallback ?? 'initial'}; }`;
+                }
+                return '';
+            },
+            suffixed: (suffix) => createToken(`${name}-${suffix}`, {
+                type,
+                fallback,
+                inherits,
+                description,
+                tag,
+            }),
+            prefixed: (prefix) => createToken(`${prefix}-${name}`, {
+                type,
+                fallback,
+                inherits,
+                description,
+                tag,
+            }),
+        };
+    };
+}
+export function isToken(value) {
+    return typeof value === 'object' && value !== null && TOKEN_BRAND in value;
+}
+/**
+ * Maps all token values to themselves - i.e.
+ * {
+ * '--🌗-black': 'var(--🌗-black)',
+ * ...
+ * }
+ */
+export function selfReferencedProps(schema, { valuePrefix: prefix, } = {}) {
+    const result = {};
+    function walk(node) {
+        for (const key in node) {
+            const value = node[key];
+            if (isToken(value)) {
+                if (prefix) {
+                    result[value.name] = value.prefixed(prefix).var;
+                }
+                else {
+                    result[value.name] = value.var;
+                }
+            }
+            else if (typeof value === 'object') {
+                walk(value);
+            }
+        }
+    }
+    walk(schema);
+    return result;
+}
+export function tokenSchemaToList(schema) {
+    const result = [];
+    function walk(node) {
+        for (const key in node) {
+            const value = node[key];
+            if (isToken(value)) {
+                result.push(value);
+            }
+            else if (typeof value === 'object') {
+                walk(value);
+            }
+        }
+    }
+    walk(schema);
+    return result;
+}
+//# sourceMappingURL=createToken.js.map

package/dist/createToken.js.map

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

package/dist/createToken.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createToken.test.d.ts.map

package/dist/createToken.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createToken.test.d.ts","sourceRoot":"","sources":["../src/createToken.test.ts"],"names":[],"mappings":""}

package/dist/{index.test.js → createToken.test.js}

@@ -1,5 +1,5 @@
 import { expect, it } from 'vitest';
-import { createTokenFactory } from './index.js';
+import { createTokenFactory } from './createToken.js';
 const createToken = createTokenFactory({ tokenPrefix: '--x-' });
 it('stores token descriptions and preserves them on derived tokens', () => {
     const token = createToken('action-primary-bg', {
@@ -10,4 +10,4 @@ it('stores token descriptions and preserves them on derived tokens', () => {
     expect(token.suffixed('hover').description).toBe(token.description);
     expect(token.prefixed('data').description).toBe(token.description);
 });
-//# sourceMappingURL=index.test.js.map
+//# sourceMappingURL=createToken.test.js.map

package/dist/createToken.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createToken.test.js","sourceRoot":"","sources":["../src/createToken.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhE,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;IACzE,MAAM,KAAK,GAAG,WAAW,CAAC,mBAAmB,EAAE;QAC9C,WAAW,EAAE,oDAAoD;QACjE,IAAI,EAAE,OAAO;KACb,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAC7B,oDAAoD,CACpD,CAAC;IACF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,146 +1,3 @@
-export declare const DEFAULT_TOKEN_PREFIX = "--x-";
-export interface TokenOptions {
-    /** Inferred from purpose if not provided, defaults to "*" */
-    type?: PropertyType;
-    purpose?: TokenPurpose;
-    group?: string;
-    description?: string;
-    fallback?: string | number;
-    tag?: string;
-    inherits?: boolean;
-    /**
-     * Force the generation of a @property rule definition, even if it's not meaningful.
-     * Otherwise tokens whose properties have no special concerns like inherit:false will
-     * skip generating an @property
-     */
-    forceDefinition?: boolean;
-}
-/**
- * Allowed types of properties - specifying one allows defining
- * a custom property in CSS which enables interpolation in animations
- * and other optimizations.
- *
- * "*" doesn't really do much but does allow any kind of value.
- *
- * "computed" will not generate a property definition and is assumed
- * to be a complex CSS property value like calc() or other things.
- */
-export type PropertyType = 'angle' | 'color' | 'custom-ident' | 'image' | 'integer' | 'length' | 'length-percentage' | 'number' | 'percentage' | 'resolution' | 'string' | 'time' | 'transform-function' | 'transform-list' | 'url' | '*';
-/**
- * Roughly mapped / inspired by designtokens.org.
- * Not currently used... but I wrote them down, so...
- */
-export type TokenType = 'color' | 'dimension' | 'font-family' | 'font-weight' | 'duration' | 'cubic-bezier' | 'number' | 'font-style' | 'ratio' | 'url' | TokenCompositeType;
-export type TokenCompositeTypeShapes = {
-    strokeStyle: {
-        dashArray: {
-            value: string;
-            unit: string;
-        }[];
-        lineCap: string;
-    } | string;
-    border: {
-        color: string;
-        width: string;
-        style: string;
-    };
-    transition: {
-        duration: string;
-        delay: string;
-        timingFunction: string;
-    };
-    shadow: {
-        offsetX: string;
-        offsetY: string;
-        blur: string;
-        spread: string;
-        color: string;
-    } | {
-        offsetX: string;
-        offsetY: string;
-        blur: string;
-        spread: string;
-        color: string;
-    }[];
-    gradient: {
-        color: string;
-        position: string;
-    }[];
-    typography: {
-        fontFamily: string;
-        fontSize: string;
-        fontWeight: string;
-        letterSpacing: string;
-        lineHeight: string;
-    };
-};
-export type TokenCompositeType = keyof TokenCompositeTypeShapes;
-export type TokenPurpose = 'color' | 'font-size' | 'font-weight' | 'font-family' | 'line-height' | 'spacing' | 'shadow' | 'border-radius' | 'border-width' | 'shadow-x' | 'shadow-y' | 'shadow-blur' | 'shadow-spread' | 'shadow-color' | 'size' | 'other';
-export declare function getTypeFromPurpose(purpose: TokenPurpose): PropertyType;
-export declare function createTokenFactory({ tokenPrefix }: {
-    tokenPrefix: string;
-}): (name: string, { fallback, inherits, forceDefinition, purpose, type, group, description, tag, }?: TokenOptions) => {
-    "@@TOKEN@@": true;
-    name: string;
-    type: PropertyType;
-    tag: string | undefined;
-    purpose: TokenPurpose;
-    group: string | undefined;
-    description: string | undefined;
-    fallback: string | number | undefined;
-    var: string;
-    varFallback: (fallbackOverride?: string | number) => string;
-    assign: (value?: string | number) => string;
-    readonly definition: string;
-    suffixed: (suffix: string) => {
-        "@@TOKEN@@": true;
-        name: string;
-        type: PropertyType;
-        tag: string | undefined;
-        purpose: TokenPurpose;
-        group: string | undefined;
-        description: string | undefined;
-        fallback: string | number | undefined;
-        var: string;
-        varFallback: (fallbackOverride?: string | number) => string;
-        assign: (value?: string | number) => string;
-        readonly definition: string;
-        suffixed: /*elided*/ any;
-        prefixed: (prefix: string) => /*elided*/ any;
-    };
-    prefixed: (prefix: string) => {
-        "@@TOKEN@@": true;
-        name: string;
-        type: PropertyType;
-        tag: string | undefined;
-        purpose: TokenPurpose;
-        group: string | undefined;
-        description: string | undefined;
-        fallback: string | number | undefined;
-        var: string;
-        varFallback: (fallbackOverride?: string | number) => string;
-        assign: (value?: string | number) => string;
-        readonly definition: string;
-        suffixed: (suffix: string) => /*elided*/ any;
-        prefixed: /*elided*/ any;
-    };
-};
-export type Token = ReturnType<ReturnType<typeof createTokenFactory>>;
-export type CreateToken = ReturnType<typeof createTokenFactory>;
-export type TokenSchema = {
-    [Key: string]: Token | TokenSchema;
-};
-export declare function isToken(value: any): value is Token;
-/**
- * Maps all token values to themselves - i.e.
- * {
- * '--🌗-black': 'var(--🌗-black)',
- * ...
- * }
- */
-export declare function selfReferencedProps(schema: TokenSchema, { valuePrefix: prefix, }?: {
-    /** Apply a prefix to the referenced value, i.e. '$' = '--$system-black': '--$system-$-black' */
-    valuePrefix?: string;
-}): Record<string, string>;
-export declare function tokenSchemaToList(schema: TokenSchema): Token[];
+export * from './createToken.js';
+export * from './simple.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -1,112 +1,3 @@
-export const DEFAULT_TOKEN_PREFIX = '--x-';
-export function getTypeFromPurpose(purpose) {
-    switch (purpose) {
-        case 'color':
-            return 'color';
-        case 'font-size':
-            return 'length';
-        case 'font-weight':
-            return 'number';
-        case 'line-height':
-            return 'length-percentage';
-        case 'font-family':
-            return 'string';
-        case 'spacing':
-            return 'length';
-        case 'shadow':
-            return 'string';
-        default:
-            return '*';
-    }
-}
-const TOKEN_BRAND = '@@TOKEN@@';
-function normalizeName(name) {
-    return name.replaceAll('$', '').replace(/\s+/g, '-');
-}
-export function createTokenFactory({ tokenPrefix }) {
-    return function createToken(name, { fallback, inherits = true, forceDefinition, purpose = 'other', type = getTypeFromPurpose(purpose), group, description, tag, } = {}) {
-        const taggedName = tag ? `${tag}-${name}` : name;
-        const resolvedName = `${tokenPrefix}${normalizeName(taggedName)}`;
-        return {
-            [TOKEN_BRAND]: true,
-            name: resolvedName,
-            type,
-            tag,
-            purpose,
-            group,
-            description,
-            fallback,
-            var: `var(${resolvedName}${fallback ? `, ${fallback}` : ''})`,
-            varFallback: (fallbackOverride) => `var(${resolvedName}, ${fallbackOverride ?? fallback ?? 'initial'})`,
-            assign: (value) => `${resolvedName}: ${value ?? fallback};`,
-            get definition() {
-                if (inherits === false || forceDefinition) {
-                    return `@property ${resolvedName} { syntax: '${type === '*' ? '*' : `<${type}>`}'; inherits: ${inherits}; initial-value: ${fallback ?? 'initial'}; }`;
-                }
-                return '';
-            },
-            suffixed: (suffix) => createToken(`${name}-${suffix}`, {
-                type,
-                fallback,
-                inherits,
-                description,
-                tag,
-            }),
-            prefixed: (prefix) => createToken(`${prefix}-${name}`, {
-                type,
-                fallback,
-                inherits,
-                description,
-                tag,
-            }),
-        };
-    };
-}
-export function isToken(value) {
-    return typeof value === 'object' && value !== null && TOKEN_BRAND in value;
-}
-/**
- * Maps all token values to themselves - i.e.
- * {
- * '--🌗-black': 'var(--🌗-black)',
- * ...
- * }
- */
-export function selfReferencedProps(schema, { valuePrefix: prefix, } = {}) {
-    const result = {};
-    function walk(node) {
-        for (const key in node) {
-            const value = node[key];
-            if (isToken(value)) {
-                if (prefix) {
-                    result[value.name] = value.prefixed(prefix).var;
-                }
-                else {
-                    result[value.name] = value.var;
-                }
-            }
-            else if (typeof value === 'object') {
-                walk(value);
-            }
-        }
-    }
-    walk(schema);
-    return result;
-}
-export function tokenSchemaToList(schema) {
-    const result = [];
-    function walk(node) {
-        for (const key in node) {
-            const value = node[key];
-            if (isToken(value)) {
-                result.push(value);
-            }
-            else if (typeof value === 'object') {
-                walk(value);
-            }
-        }
-    }
-    walk(schema);
-    return result;
-}
+export * from './createToken.js';
+export * from './simple.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC"}

package/dist/simple.d.ts

@@ -0,0 +1,40 @@
+import { CreateToken, Token, TokenPurpose } from './createToken.js';
+/**
+ * Simple token syntax for end users to quickly and easily
+ * define tokens without worrying about naming conventions,
+ * prefixes, etc.
+ *
+ * Used in all public-facing token creation: modes, mixin contributions, etc.
+ */
+/**
+ * Defines the purpose of a token.
+ */
+export type SimpleTokenDefinition = TokenPurpose | {
+    purpose: TokenPurpose;
+    description?: string;
+};
+type SimpleTokenDefinitionObject = Exclude<SimpleTokenDefinition, TokenPurpose>;
+type NestedSimpleTokenSchema<T> = T extends SimpleTokenDefinitionObject ? never : T extends SimpleTokenSchema ? T : never;
+/**
+ * A structured object of tokens.
+ */
+export type SimpleTokenSchema = {
+    /**
+     * Special key: creates a token at the current group path without appending
+     * a `-$root` segment. For example, `{ colors: { main: { $root: 'color', mid: 'color' } } }`
+     * generates `--$-colors-main` (for `$root`) and `--$-colors-main-mid` (for `mid`).
+     * Optional at any level.
+     */
+    $root?: SimpleTokenDefinition;
+    [key: string]: SimpleTokenDefinition | SimpleTokenSchema | undefined;
+};
+export type SimpleTokensAsTokenDefinitions<T extends SimpleTokenSchema> = T extends object ? {
+    [P in keyof T]: NonNullable<T[P]> extends string ? Token : NonNullable<T[P]> extends SimpleTokenDefinitionObject ? Token : SimpleTokensAsTokenDefinitions<NestedSimpleTokenSchema<NonNullable<T[P]>>>;
+} : never;
+/**
+ * Converts simple, data-only, user-provided token definitions into
+ * full-fledged Tokens, retaining object structure
+ */
+export declare function convertSimpleTokenSchema<T extends SimpleTokenSchema>(root: T, tag: string, createTokenValue: CreateToken): SimpleTokensAsTokenDefinitions<T>;
+export {};
+//# sourceMappingURL=simple.d.ts.map

package/dist/simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.d.ts","sourceRoot":"","sources":["../src/simple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEpE;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC9B,YAAY,GACZ;IACA,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEL,KAAK,2BAA2B,GAAG,OAAO,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC;AAEhF,KAAK,uBAAuB,CAAC,CAAC,IAC7B,CAAC,SAAS,2BAA2B,GAAG,KAAK,GAC3C,CAAC,SAAS,iBAAiB,GAAG,CAAC,GAC/B,KAAK,CAAC;AAET;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,SAAS,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,iBAAiB,IACrE,CAAC,SAAS,MAAM,GACf;KACE,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,GACtD,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,2BAA2B,GAAG,KAAK,GAC7D,8BAA8B,CAC9B,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1C;CACF,GACA,KAAK,CAAC;AAqCT;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,iBAAiB,EACnE,IAAI,EAAE,CAAC,EACP,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,WAAW,GAC3B,8BAA8B,CAAC,CAAC,CAAC,CAoCnC"}

package/dist/simple.js

@@ -0,0 +1,50 @@
+function isProbablySimpleTokenDefinition(value) {
+    return (value &&
+        (typeof value === 'string' ||
+            (typeof value === 'object' &&
+                'purpose' in value &&
+                typeof value.purpose === 'string')));
+}
+function getSimpleTokenPurpose(value) {
+    return typeof value === 'string' ? value : value.purpose;
+}
+function getSimpleTokenDescription(value) {
+    return typeof value === 'string' ? undefined : value.description;
+}
+function convertSimpleToken(name, prop, createTokenValue, group) {
+    return createTokenValue(name, {
+        purpose: getSimpleTokenPurpose(prop),
+        description: getSimpleTokenDescription(prop),
+        group,
+    });
+}
+/**
+ * Converts simple, data-only, user-provided token definitions into
+ * full-fledged Tokens, retaining object structure
+ */
+export function convertSimpleTokenSchema(root, tag, createTokenValue) {
+    function generatePropsForSchemaLevel(schemaLevel, propPrefix) {
+        const propsLevel = {};
+        for (const key in schemaLevel) {
+            const value = schemaLevel[key];
+            if (key === '$root') {
+                // $root generates a token at the current group path (no segment appended)
+                if (isProbablySimpleTokenDefinition(value)) {
+                    propsLevel.$root = convertSimpleToken(propPrefix, value, createTokenValue, propPrefix);
+                }
+                continue;
+            }
+            const currentPrefix = [propPrefix, key].filter(Boolean).join('-');
+            if (isProbablySimpleTokenDefinition(value)) {
+                const propertyDefinition = convertSimpleToken(currentPrefix, value, createTokenValue, propPrefix);
+                propsLevel[key] = propertyDefinition;
+            }
+            else if (typeof value === 'object' && value !== null) {
+                propsLevel[key] = generatePropsForSchemaLevel(value, currentPrefix);
+            }
+        }
+        return propsLevel;
+    }
+    return generatePropsForSchemaLevel(root, tag);
+}
+//# sourceMappingURL=simple.js.map

package/dist/simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../src/simple.ts"],"names":[],"mappings":"AAoDA,SAAS,+BAA+B,CACvC,KAAU;IAEV,OAAO,CACN,KAAK;QACL,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,OAAO,KAAK,KAAK,QAAQ;gBACzB,SAAS,IAAI,KAAK;gBAClB,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CACrC,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAA4B;IAC1D,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;AAC1D,CAAC;AAED,SAAS,yBAAyB,CACjC,KAA4B;IAE5B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC;AAClE,CAAC;AAED,SAAS,kBAAkB,CAC1B,IAAY,EACZ,IAA2B,EAC3B,gBAA6B,EAC7B,KAAc;IAEd,OAAO,gBAAgB,CAAC,IAAI,EAAE;QAC7B,OAAO,EAAE,qBAAqB,CAAC,IAAI,CAAC;QACpC,WAAW,EAAE,yBAAyB,CAAC,IAAI,CAAC;QAC5C,KAAK;KACL,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACvC,IAAO,EACP,GAAW,EACX,gBAA6B;IAE7B,SAAS,2BAA2B,CACnC,WAAgB,EAChB,UAAkB;QAElB,MAAM,UAAU,GAAQ,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;gBACrB,0EAA0E;gBAC1E,IAAI,+BAA+B,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5C,UAAU,CAAC,KAAK,GAAG,kBAAkB,CACpC,UAAU,EACV,KAAK,EACL,gBAAgB,EAChB,UAAU,CACV,CAAC;gBACH,CAAC;gBACD,SAAS;YACV,CAAC;YACD,MAAM,aAAa,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClE,IAAI,+BAA+B,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC5C,MAAM,kBAAkB,GAAG,kBAAkB,CAC5C,aAAa,EACb,KAAK,EACL,gBAAgB,EAChB,UAAU,CACV,CAAC;gBACF,UAAU,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC;YACtC,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACxD,UAAU,CAAC,GAAG,CAAC,GAAG,2BAA2B,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YACrE,CAAC;QACF,CAAC;QACD,OAAO,UAAU,CAAC;IACnB,CAAC;IACD,OAAO,2BAA2B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC"}

package/dist/simple.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=simple.test.d.ts.map

package/dist/simple.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.test.d.ts","sourceRoot":"","sources":["../src/simple.test.ts"],"names":[],"mappings":""}

package/dist/simple.test.js

@@ -0,0 +1,20 @@
+import { expect, it } from 'vitest';
+import { createTokenFactory } from './createToken.js';
+import { convertSimpleTokenSchema } from './simple.js';
+const createToken = createTokenFactory({ tokenPrefix: '--x-' });
+it('converts object-form simple token definitions with descriptions', () => {
+    const tokens = convertSimpleTokenSchema({
+        colors: {
+            main: {
+                $root: {
+                    purpose: 'color',
+                    description: 'Main color used by the palette.',
+                },
+                bg: 'color',
+            },
+        },
+    }, 'root', createToken);
+    expect(tokens.colors.main.$root.description).toBe('Main color used by the palette.');
+    expect(tokens.colors.main.bg.description).toBeUndefined();
+});
+//# sourceMappingURL=simple.test.js.map

package/dist/simple.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.test.js","sourceRoot":"","sources":["../src/simple.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhE,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC1E,MAAM,MAAM,GAAG,wBAAwB,CACtC;QACC,MAAM,EAAE;YACP,IAAI,EAAE;gBACL,KAAK,EAAE;oBACN,OAAO,EAAE,OAAO;oBAChB,WAAW,EAAE,iCAAiC;iBAC9C;gBACD,EAAE,EAAE,OAAO;aACX;SACD;KACD,EACD,MAAM,EACN,WAAW,CACX,CAAC;IAEF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAChD,iCAAiC,CACjC,CAAC;IACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;AAC3D,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbor-css/tokens",
-  "version": "0.0.59",
+  "version": "0.0.62",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -23,8 +23,8 @@
   "devDependencies": {
     "@vitest/browser-playwright": "^4.1.5",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5",
-    "vite": "^8.0.10"
+    "vitest": "^4.1.7",
+    "vite": "^8.0.13"
   },
   "dependencies": {},
   "scripts": {

package/dist/index.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.test.d.ts.map

package/dist/index.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":""}

package/dist/index.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,GAAG,kBAAkB,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;AAEhE,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;IACzE,MAAM,KAAK,GAAG,WAAW,CAAC,mBAAmB,EAAE;QAC9C,WAAW,EAAE,oDAAoD;QACjE,IAAI,EAAE,OAAO;KACb,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAC7B,oDAAoD,CACpD,CAAC;IACF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACpE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC"}