design-token-library 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2023-05-16
+
+### Added
+
+Initial release of the package.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Nicholas Rice
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,4 @@
+![CI](https://github.com/nicholasrice/design-token-library/actions/workflows/ci.yml/badge.svg)
+![Docs](https://github.com/nicholasrice/design-token-library/actions/workflows/deploy.yml/badge.svg)
+
+[API Documentation](https://nicholasrice.github.io/design-token-library/)

package/dist/lib/css-reflector.d.ts

@@ -0,0 +1,24 @@
+import { DesignToken } from "./design-token.js";
+import { Library } from "./library.js";
+/**
+ * @public
+ */
+export declare function toCSS(library: Library.Library<any, any>): string;
+interface CSSPropertyValues {
+    readonly var: `var(--${string})`;
+    readonly property: `--${string}`;
+}
+/**
+ * A collection of {@link @CSSPropertyValues} that mirrors the
+ * structure of the source {@link Library.Library<any> | Library}.
+ * @public
+ */
+export type CSSPropertiesLibrary<T extends {}> = {
+    [K in keyof Readonly<T>]: T[K] extends DesignToken.Any ? CSSPropertyValues : K extends "type" ? DesignToken.Type : T[K] extends {} ? CSSPropertiesLibrary<T[K]> : never;
+};
+/**
+ * Construct an {@link CSSPropertiesLibrary} from a {@link Library.Library<any>}.
+ * @public
+ */
+export declare function toProperties<T extends Library.Library<any>>(library: T): CSSPropertiesLibrary<T["tokens"]>;
+export {};

package/dist/lib/css-reflector.js

@@ -0,0 +1,110 @@
+import { DesignToken } from "./design-token.js";
+/**
+ * @public
+ */
+export function toCSS(library) {
+    return recurseToCss(library.tokens);
+}
+/**
+ * Construct an {@link CSSPropertiesLibrary} from a {@link Library.Library<any>}.
+ * @public
+ */
+export function toProperties(library) {
+    const recurse = (section, properties) => {
+        for (const key in section) {
+            const sectionValue = section[key];
+            if (isToken(sectionValue)) {
+                // TODO add a strategy for name conversion
+                const property = `--${sectionValue.name.replaceAll(".", "-")}`;
+                const propertyValue = Object.freeze({
+                    var: `var(${property})`,
+                    property,
+                });
+                Reflect.defineProperty(properties, key, {
+                    value: propertyValue,
+                    enumerable: true,
+                });
+            }
+            else {
+                const value = {};
+                recurse(sectionValue, value);
+                Reflect.defineProperty(properties, key, {
+                    value: Object.freeze(value),
+                    enumerable: true,
+                });
+            }
+        }
+    };
+    const properties = {};
+    recurse(library.tokens, properties);
+    return properties;
+}
+const isToken = (value) => {
+    return "value" in value;
+};
+const recurseToCss = (librarySection) => {
+    let result = "";
+    for (const key in librarySection) {
+        const tokenOrGroup = librarySection[key];
+        if (isToken(tokenOrGroup)) {
+            let value = tokenOrGroup.value;
+            if (tokenOrGroup.type !== undefined &&
+                Reflect.has(TokenConverters, tokenOrGroup.type)) {
+                value = Reflect.get(TokenConverters, tokenOrGroup.type)(value);
+            }
+            result += `--${tokenOrGroup.name}:${value};`;
+        }
+        else {
+            result = recurseToCss(tokenOrGroup);
+        }
+    }
+    return result;
+};
+const joiner = (value) => {
+    return value.join(" ");
+};
+/**
+ * Convert a border value to CSS
+ */
+const borderConverter = (value) => {
+    return `${value.width} ${value.style} ${value.color}`;
+};
+const fontFamilyConverter = (value) => {
+    return typeof value === "string"
+        ? fontFamilyQuoter(value)
+        : value.map(fontFamilyQuoter).join();
+};
+const fontFamilyQuoter = (value) => {
+    const test = /^(\'|\")?(.*?)(\'|\")?$/;
+    const result = test.exec(value);
+    if (result !== null && (result[1] || result[3])) {
+        value = result[2];
+    }
+    return value.includes(" ") ? `"${value}"` : value;
+};
+const gradientReducer = (accumulated, value) => {
+    return accumulated + `${value.color} ${value.position * 100}%,`;
+};
+const gradientConverter = (value) => {
+    return value.reduce(gradientReducer, "").replace(/,$/, "");
+};
+const shadowConverter = (value) => {
+    return `${value.offsetX} ${value.offsetY} ${value.blur} ${value.spread} ${value.color}`;
+};
+const strokeStyleConverter = (value) => {
+    // CSS doesn't support customizing dashed borders at the time of authoring.
+    return typeof value === "string" ? value : "dashed";
+};
+const transitionConverter = (value) => {
+    return `${value.duration} ${value.delay} ${value.timingFunction}`;
+};
+const TokenConverters = {
+    [DesignToken.Type.Border]: borderConverter,
+    [DesignToken.Type.CubicBezier]: joiner,
+    [DesignToken.Type.FontFamily]: fontFamilyConverter,
+    [DesignToken.Type.Gradient]: gradientConverter,
+    [DesignToken.Type.Shadow]: shadowConverter,
+    [DesignToken.Type.StrokeStyle]: strokeStyleConverter,
+    [DesignToken.Type.Transition]: transitionConverter,
+};
+//# sourceMappingURL=css-reflector.js.map

package/dist/lib/css-reflector.js.map

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

package/dist/lib/design-token.d.ts

@@ -0,0 +1,195 @@
+/**
+ * @public
+ */
+export declare namespace DesignToken {
+    /**
+     * An enumeration of all supported types defined
+     * by {@link https://tr.designtokens.org/format/#types}
+     */
+    enum Type {
+        Border = "border",
+        Color = "color",
+        CubicBezier = "cubicBezier",
+        Dimension = "dimension",
+        Duration = "duration",
+        FontFamily = "fontFamily",
+        FontWeight = "fontWeight",
+        Gradient = "gradient",
+        Number = "number",
+        Shadow = "shadow",
+        StrokeStyle = "strokeStyle",
+        Transition = "transition",
+        Typography = "typography"
+    }
+    /**
+     * The values supported for each {@link DesignToken.Type | DesignToken type}.
+     */
+    namespace Values {
+        /**
+         * A six or 8 digit hexadecimal string.
+         *
+         * @see {@link https://tr.designtokens.org/format/#color}
+         *
+         * @remarks
+         * Ideally we would be able to enumerate a-zA-Z1-9 * 6 | 8 chars
+         * and narrow this type, however TypeScript cannot handle that
+         * many type union combinations and will fail to compile. This
+         * is the best representation of a 6 or 8 digit hex char that
+         * can be accomplished
+         *
+         */
+        type Color = `#${string}`;
+        /**
+         * A dimension value (floating or integer) with a 'px' or 'rm' unit.
+         *
+         * @see {@link https://tr.designtokens.org/format/#dimension}
+         */
+        type Dimension = `${Values.Number}px` | `${Values.Number}rm`;
+        /**
+         * The name of the font family;
+         *
+         * @see {@link https://tr.designtokens.org/format/#font-family}
+         */
+        type FontFamily = string | string[];
+        /**
+         * @see {@link https://tr.designtokens.org/format/#number}
+         */
+        type Number = number;
+        /**
+         * A number between 0 and 1000, or a font-weight keyword.
+         *
+         * @see {@link https://tr.designtokens.org/format/#font-weight}
+         */
+        type FontWeight = Values.Number | "thin" | "hairline" | "extra-light" | "ultra-light" | "light" | "normal" | "regular" | "book" | "medium" | "smi-bold" | "demi-bold" | "bold" | "extra-bold" | "ultra-bold" | "black" | "heavy" | "extra-black" | "ultra-black";
+        /**
+         * A duration value in milliseconds
+         *
+         * @see {@link https://tr.designtokens.org/format/#duration}
+         */
+        type Duration = `${Values.Number}ms`;
+        /**
+         * Cubic Bézier coordinates.
+         *
+         * @see {@link https://tr.designtokens.org/format/#cubic-bezier}
+         */
+        type CubicBezier = [
+            P1x: Values.Number,
+            P1y: Values.Number,
+            P2x: Values.Number,
+            P2y: Values.Number
+        ];
+        /**
+         * @see {@link https://tr.designtokens.org/format/#shadow}
+         */
+        interface Shadow {
+            color: Values.Color;
+            offsetX: Values.Dimension;
+            offsetY: Values.Dimension;
+            blur: Values.Dimension;
+            spread: Values.Dimension;
+        }
+        /**
+         *
+         * @see {@link https://tr.designtokens.org/format/#stroke-style}
+         */
+        type StrokeStyle = "solid" | "dashed" | "dotted" | "double" | "groove" | "ridge" | "outset" | "inset" | {
+            dashArray: Values.Dimension[];
+            lineCap: "round" | "butt" | "square";
+        };
+        /**
+         * @see {@link https://tr.designtokens.org/format/#border}
+         */
+        interface Border {
+            color: Values.Color;
+            width: Values.Dimension;
+            style: Values.StrokeStyle;
+        }
+        /**
+         * @see {@link https://tr.designtokens.org/format/#transition}
+         */
+        interface Transition {
+            duration: Values.Duration;
+            delay: Values.Duration;
+            timingFunction: Values.CubicBezier;
+        }
+        /**
+         * @see {@link https://tr.designtokens.org/format/#gradient}
+         * @remarks
+         * Position values must be a number withing [0, 1].
+         */
+        type Gradient = Array<{
+            color: Values.Color;
+            position: Values.Number;
+        }>;
+        /**
+         * @see {@link https://tr.designtokens.org/format/#typography}
+         */
+        interface Typography {
+            fontFamily: Values.FontFamily;
+            fontSize: Values.Dimension;
+            fontWeight: Values.FontWeight;
+            letterSpacing: Values.Dimension;
+            lineHeight: Values.Number;
+        }
+        /**
+         * @internal
+         */
+        type Any = Color | Dimension | FontFamily | Number | FontWeight | Duration | CubicBezier | Shadow | StrokeStyle | Border | Transition | Gradient | Typography;
+    }
+    /**
+     * @internal
+     */
+    type TokenByType<T extends DesignToken.Type> = T extends DesignToken.Type.Border ? DesignToken.Border : T extends DesignToken.Type.Color ? DesignToken.Color : T extends DesignToken.Type.CubicBezier ? DesignToken.CubicBezier : T extends DesignToken.Type.Dimension ? DesignToken.Dimension : T extends DesignToken.Type.Duration ? DesignToken.Duration : T extends DesignToken.Type.FontFamily ? DesignToken.FontFamily : T extends DesignToken.Type.FontWeight ? DesignToken.FontWeight : T extends DesignToken.Type.Gradient ? DesignToken.Gradient : T extends DesignToken.Type.Number ? DesignToken.Number : T extends DesignToken.Type.Shadow ? DesignToken.Shadow : T extends DesignToken.Type.StrokeStyle ? DesignToken.StrokeStyle : T extends DesignToken.Type.Transition ? DesignToken.Transition : T extends DesignToken.Type.Typography ? DesignToken.Typography : never;
+    /**
+     * @internal
+     */
+    type TypeByToken<T extends DesignToken.Any> = T extends DesignToken.Border ? DesignToken.Type.Border : T extends DesignToken.Color ? DesignToken.Type.Color : T extends DesignToken.CubicBezier ? DesignToken.Type.CubicBezier : T extends DesignToken.Dimension ? DesignToken.Type.Dimension : T extends DesignToken.Duration ? DesignToken.Type.Duration : T extends DesignToken.FontFamily ? DesignToken.Type.FontFamily : T extends DesignToken.FontWeight ? DesignToken.Type.FontWeight : T extends DesignToken.Gradient ? DesignToken.Type.Gradient : T extends DesignToken.Number ? DesignToken.Type.Number : T extends DesignToken.Shadow ? DesignToken.Type.Shadow : T extends DesignToken.StrokeStyle ? DesignToken.Type.StrokeStyle : T extends DesignToken.Transition ? DesignToken.Type.Transition : T extends DesignToken.Typography ? DesignToken.Type.Typography : never;
+    /**
+     * @internal
+     */
+    type TokenByValue<T> = T extends DesignToken.Values.Border ? DesignToken.Border : T extends DesignToken.Values.Color ? DesignToken.Color : T extends DesignToken.Values.CubicBezier ? DesignToken.CubicBezier : T extends DesignToken.Values.Dimension ? DesignToken.Dimension : T extends DesignToken.Values.Duration ? DesignToken.Duration : T extends DesignToken.Values.FontFamily ? DesignToken.FontFamily : T extends DesignToken.Values.FontWeight ? DesignToken.FontWeight : T extends DesignToken.Values.Gradient ? DesignToken.Gradient : T extends DesignToken.Values.Number ? DesignToken.Number : T extends DesignToken.Values.Shadow ? DesignToken.Shadow : T extends DesignToken.Values.StrokeStyle ? DesignToken.StrokeStyle : T extends DesignToken.Values.Transition ? DesignToken.Transition : T extends DesignToken.Values.Typography ? DesignToken.Typography : never;
+    /**
+     * @internal
+     */
+    type ValueByType<T> = T extends DesignToken.Values.Border ? DesignToken.Type.Border : T extends DesignToken.Values.Color ? DesignToken.Type.Color : T extends DesignToken.Values.CubicBezier ? DesignToken.Type.CubicBezier : T extends DesignToken.Values.Dimension ? DesignToken.Type.Dimension : T extends DesignToken.Values.Duration ? DesignToken.Type.Duration : T extends DesignToken.Values.FontFamily ? DesignToken.Type.FontFamily : T extends DesignToken.Values.FontWeight ? DesignToken.Type.FontWeight : T extends DesignToken.Values.Gradient ? DesignToken.Type.Gradient : T extends DesignToken.Values.Number ? DesignToken.Type.Number : T extends DesignToken.Values.Shadow ? DesignToken.Type.Shadow : T extends DesignToken.Values.StrokeStyle ? DesignToken.Type.StrokeStyle : T extends DesignToken.Values.Transition ? DesignToken.Type.Transition : T extends DesignToken.Values.Typography ? DesignToken.Type.Typography : never;
+    /**
+     * @internal
+     */
+    type ValueByToken<T extends DesignToken.Any> = T extends DesignToken.Border ? DesignToken.Values.Border : T extends Color ? DesignToken.Values.Color : T extends DesignToken.CubicBezier ? DesignToken.Values.CubicBezier : T extends DesignToken.Dimension ? DesignToken.Values.Dimension : T extends DesignToken.Duration ? DesignToken.Values.Duration : T extends DesignToken.FontFamily ? DesignToken.Values.FontFamily : T extends DesignToken.FontWeight ? DesignToken.Values.FontWeight : T extends DesignToken.Gradient ? DesignToken.Values.Gradient : T extends DesignToken.Number ? DesignToken.Values.Number : T extends DesignToken.Shadow ? DesignToken.Values.Shadow : T extends DesignToken.StrokeStyle ? DesignToken.Values.StrokeStyle : T extends DesignToken.Transition ? DesignToken.Values.Transition : T extends Typography ? DesignToken.Values.Typography : never;
+    /**
+     * All properties supported by a DesignToken
+     */
+    interface Properties<Type extends DesignToken.Type, Value extends DesignToken.Values.Any> {
+        description?: string;
+        type?: Type;
+        extensions?: Record<string, any>;
+        value: Value;
+    }
+    type Border = Properties<DesignToken.Type.Border, DesignToken.Values.Border>;
+    type Color = Properties<DesignToken.Type.Color, DesignToken.Values.Color>;
+    type CubicBezier = Properties<DesignToken.Type.CubicBezier, DesignToken.Values.CubicBezier>;
+    type Dimension = Properties<DesignToken.Type.Dimension, DesignToken.Values.Dimension>;
+    type Duration = Properties<DesignToken.Type.Duration, DesignToken.Values.Duration>;
+    type FontFamily = Properties<DesignToken.Type.FontFamily, DesignToken.Values.FontFamily>;
+    type FontWeight = Properties<DesignToken.Type.FontWeight, DesignToken.Values.FontWeight>;
+    type Gradient = Properties<DesignToken.Type.Gradient, DesignToken.Values.Gradient>;
+    type Number = Properties<DesignToken.Type.Number, DesignToken.Values.Number>;
+    type Shadow = Properties<DesignToken.Type.Shadow, DesignToken.Values.Shadow>;
+    type StrokeStyle = Properties<DesignToken.Type.StrokeStyle, DesignToken.Values.StrokeStyle>;
+    type Transition = Properties<DesignToken.Type.Transition, DesignToken.Values.Transition>;
+    type Typography = Properties<DesignToken.Type.Typography, DesignToken.Values.Typography>;
+    /**
+     * A group of DesignTokens.
+     */
+    type Group = {
+        /**
+         * If the group has a type, the type is inferred for all descendent design tokens,
+         * unless specified by the token.
+         */
+        type?: DesignToken.Type;
+    };
+    /**
+     * @internal
+     */
+    type Any = Border | Color | CubicBezier | Dimension | Duration | FontFamily | FontWeight | Gradient | Number | Shadow | StrokeStyle | Transition | Typography;
+}

package/dist/lib/design-token.js

@@ -0,0 +1,27 @@
+/**
+ * @public
+ */
+export var DesignToken;
+(function (DesignToken) {
+    /**
+     * An enumeration of all supported types defined
+     * by {@link https://tr.designtokens.org/format/#types}
+     */
+    let Type;
+    (function (Type) {
+        Type["Border"] = "border";
+        Type["Color"] = "color";
+        Type["CubicBezier"] = "cubicBezier";
+        Type["Dimension"] = "dimension";
+        Type["Duration"] = "duration";
+        Type["FontFamily"] = "fontFamily";
+        Type["FontWeight"] = "fontWeight";
+        Type["Gradient"] = "gradient";
+        Type["Number"] = "number";
+        Type["Shadow"] = "shadow";
+        Type["StrokeStyle"] = "strokeStyle";
+        Type["Transition"] = "transition";
+        Type["Typography"] = "typography";
+    })(Type = DesignToken.Type || (DesignToken.Type = {}));
+})(DesignToken || (DesignToken = {}));
+//# sourceMappingURL=design-token.js.map

package/dist/lib/design-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token.js","sourceRoot":"","sources":["../../src/lib/design-token.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,KAAW,WAAW,CA2b3B;AA3bD,WAAiB,WAAW;IAC1B;;;OAGG;IACH,IAAY,IAcX;IAdD,WAAY,IAAI;QACd,yBAAiB,CAAA;QACjB,uBAAe,CAAA;QACf,mCAA2B,CAAA;QAC3B,+BAAuB,CAAA;QACvB,6BAAqB,CAAA;QACrB,iCAAyB,CAAA;QACzB,iCAAyB,CAAA;QACzB,6BAAqB,CAAA;QACrB,yBAAiB,CAAA;QACjB,yBAAiB,CAAA;QACjB,mCAA2B,CAAA;QAC3B,iCAAyB,CAAA;QACzB,iCAAyB,CAAA;IAC3B,CAAC,EAdW,IAAI,GAAJ,gBAAI,KAAJ,gBAAI,QAcf;AAwaH,CAAC,EA3bgB,WAAW,KAAX,WAAW,QA2b3B"}

package/dist/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { DesignToken } from "./design-token.js";
+export * from "./library.js";
+export * from "./css-reflector.js";

package/dist/lib/index.js

@@ -0,0 +1,4 @@
+export { DesignToken } from "./design-token.js";
+export * from "./library.js";
+export * from "./css-reflector.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/lib/library.d.ts

@@ -0,0 +1,80 @@
+import { DesignToken } from "./design-token.js";
+import { DeepPartial } from "./utilities.js";
+/**
+ * @public
+ */
+export declare namespace Library {
+    interface Library<T extends {}, R extends {} = T> {
+        tokens: TokenLibrary<T, R>;
+        subscribe(subscriber: Library.Subscriber<R>): void;
+        unsubscribe(subscriber: Library.Subscriber<R>): void;
+        extend<K extends {} = any>(config: DeepPartial<T> & Config<K, R & K>): Library<T & K, R & K>;
+    }
+    interface Subscriber<R extends {}> {
+        onChange(records: ReadonlyArray<Library.Token<DesignToken.Any, R>>): void;
+    }
+    /**
+     * Defines a token library that can be interacted with
+     * to mutate token values.
+     *
+     * @public
+     */
+    type TokenLibrary<T extends {}, R extends {} = T> = {
+        [K in keyof Readonly<T>]: T[K] extends DesignToken.Any ? Token<T[K], R> : K extends "type" ? DesignToken.Type : T[K] extends {} ? TokenLibrary<T[K], R> : never;
+    };
+    /**
+     * A token value that serves as an alias to another token value
+     *
+     * @public
+     */
+    type Alias<T extends DesignToken.Any, R extends Context<any>> = (context: R) => T | DesignToken.ValueByToken<T>;
+    /**
+     * An {@link (Library:namespace).Alias} that supports complex token value types
+     * such as {@link DesignToken.Border}
+     *
+     * @public
+     */
+    type DeepAlias<V extends DesignToken.Values.Any, T extends Context<any>> = {
+        [K in keyof V]: V[K] extends DesignToken.Values.Any ? V[K] | Alias<DesignToken.TokenByValue<V[K]>, T> | DeepAlias<V[K], T> : never;
+    };
+    /**
+     * Context object provided to {@link (Library:namespace).Alias} values at runtime
+     *
+     * @public
+     */
+    type Context<T extends {}, R extends {} = T> = {
+        [K in keyof Readonly<T>]: T[K] extends DesignToken.Any ? Readonly<T[K]> : K extends "type" ? DesignToken.Type : T[K] extends {} ? Context<T[K], R> : never;
+    };
+    /**
+     * A token in a {@link (Library:namespace).TokenLibrary}
+     *
+     * @public
+     */
+    type Token<T extends DesignToken.Any, C extends {}> = {
+        set(value: DesignToken.ValueByToken<T> | Alias<T, C>): void;
+        toString(): string;
+        readonly type: DesignToken.TypeByToken<T>;
+        readonly extensions: Record<string, any>;
+        readonly value: DesignToken.ValueByToken<T>;
+        readonly description: string;
+        readonly name: string;
+    };
+    /**
+     * A configuration object provided to {@link Library.create}
+     *
+     * @public
+     */
+    type Config<T extends {}, R extends {} = T> = {
+        [K in keyof T]: T[K] extends DesignToken.Any ? ConfigValue<T[K], R> : T[K] extends {} ? Config<T[K], R> : never;
+    };
+    /**
+     * @public
+     */
+    type ConfigValue<T extends DesignToken.Any, R extends {}> = T | (Omit<T, "value"> & {
+        value: Library.Alias<T, Context<R>> | Library.DeepAlias<DesignToken.ValueByToken<T>, Context<R>>;
+    });
+    /**
+     * @public
+     */
+    const create: <T extends {} = any>(config: Library.Config<T, T>) => Library.Library<T>;
+}

package/dist/lib/library.js

@@ -0,0 +1,252 @@
+import { getNotifier } from "./notifier.js";
+import { Queue } from "./queue.js";
+import { empty } from "./utilities.js";
+import { Watcher } from "./watcher.js";
+/**
+ * @public
+ */
+export var Library;
+(function (Library) {
+    /**
+     * @public
+     */
+    Library.create = (config) => {
+        return LibraryImpl.create(config);
+    };
+})(Library || (Library = {}));
+const isObject = (value) => {
+    return typeof value === "object" && value !== null;
+};
+/**
+ * @internal
+ */
+const isToken = (value) => {
+    return isObject(value) && "value" in value;
+};
+const isGroup = (value) => {
+    return isObject(value) && !isToken(value);
+};
+const isAlias = (value) => {
+    return typeof value === "function";
+};
+const recurseCreate = (name, library, config, context, typeContext, queue) => {
+    for (const key in config) {
+        if (key === "type") {
+            typeContext = config[key];
+            continue;
+        }
+        const _name = name.length === 0 ? key : `${name}.${key}`;
+        if (isGroup(config[key])) {
+            Reflect.defineProperty(library, key, {
+                value: {},
+                enumerable: true,
+            });
+            recurseCreate(_name, library[key], config[key], context, config[key].type || typeContext, queue);
+            Object.freeze(library[key]);
+        }
+        else if (isToken(config[key])) {
+            const { value, type, description, extensions } = config[key];
+            if (!type && !typeContext) {
+                throw new Error(`No 'type' found for token '${key}'. Types cannot be inferred, please add a type to the token or to a group ancestor.`);
+            }
+            const token = new LibraryToken(_name, value, type || typeContext, context, description || "", extensions || {}, queue);
+            Reflect.defineProperty(library, key, {
+                get() {
+                    // Token access needs to be tracked because an alias token
+                    // is a function that returns a token
+                    Watcher.track(token);
+                    return token;
+                },
+                enumerable: true,
+            });
+        }
+    }
+};
+const recurseExtend = (name, sourceTokens, extendedTokens, config, // TODO allow new config options
+context, typeContext, queue) => {
+    const keys = new Set(Object.keys(sourceTokens).concat(Object.keys(config))); // Remove duplicate keys
+    for (const key of keys) {
+        const sourceHasKey = key in sourceTokens;
+        const configHasKey = key in config;
+        const _name = name.length === 0 ? key : `${name}.${key}`;
+        const keyIsGroup = isGroup(sourceTokens[key]) || isGroup(config[key]);
+        const keyIsToken = isToken(sourceTokens[key]) || isToken(config[key]);
+        if (key === "type") {
+            typeContext = sourceTokens[key];
+            continue;
+        }
+        if (keyIsGroup) {
+            Reflect.defineProperty(extendedTokens, key, Object.create(sourceTokens[key]));
+            if (sourceHasKey) {
+                recurseExtend(_name, sourceTokens[key], extendedTokens[key], config[key] || {}, context, (sourceTokens.type || typeContext), queue);
+            }
+            else if (configHasKey) {
+                // This will always be the case
+                recurseCreate(_name, sourceTokens[key], extendedTokens[key], context, (sourceTokens.type || typeContext), queue);
+            }
+        }
+        else if (keyIsToken) {
+            const token = sourceTokens[key] !== undefined
+                ? extendToken(sourceTokens[key], context, queue, config[key])
+                : new LibraryToken(_name, config[key].value, config[key].type || typeContext, context, config[key].description || "", config[key].extensions || {}, queue);
+            Reflect.defineProperty(extendedTokens, key, {
+                get() {
+                    // Token access needs to be tracked because an alias token
+                    // is a function that returns a token
+                    Watcher.track(token);
+                    return token;
+                },
+                enumerable: true,
+            });
+        }
+    }
+};
+function extendToken(token, context, queue, value) {
+    const extendingToken = Object.create(token);
+    extendingToken.context = context;
+    extendingToken.cached = empty;
+    extendingToken.watchContext = extendingToken;
+    extendingToken.queue = queue;
+    if (value !== undefined) {
+        extendingToken.raw = value;
+    }
+    else {
+        // Subscribe to changes
+        // spy on set, unsubscribe when set
+        const subscriber = {
+            onChange() {
+                extendingToken.onChange();
+            },
+        };
+        // token.value;
+        getNotifier(token).subscribe(subscriber);
+        const set = extendingToken.set;
+        extendingToken.set = (value) => {
+            getNotifier(token).unsubscribe(subscriber);
+            set.call(extendingToken, value);
+            extendingToken.set = set;
+        };
+    }
+    return extendingToken;
+}
+const recurseResolve = (value, context) => {
+    const r = Array.isArray(value) ? [] : {};
+    for (const key in value) {
+        let v = value[key];
+        if (isAlias(v)) {
+            v = v(context);
+        }
+        if (isToken(v)) {
+            v = v.value;
+        }
+        if (isObject(v)) {
+            r[key] = recurseResolve(v, context);
+        }
+        else {
+            r[key] = v;
+        }
+    }
+    return r;
+};
+class LibraryImpl {
+    tokens;
+    queue;
+    constructor(tokens, queue) {
+        this.tokens = tokens;
+        this.queue = queue;
+    }
+    subscribe(subscriber) {
+        this.queue.subscribe(subscriber);
+    }
+    unsubscribe(subscriber) {
+        this.queue.unsubscribe(subscriber);
+    }
+    extend(config) {
+        // TODO should not type Library.Config<any>
+        const queue = new Queue();
+        const tokens = {};
+        recurseExtend("", this.tokens, tokens, config, tokens, null, queue);
+        return new LibraryImpl(tokens, queue);
+    }
+    static create(config) {
+        const queue = new Queue();
+        const tokens = {};
+        recurseCreate("", tokens, config, tokens, null, queue);
+        return new LibraryImpl(tokens, queue);
+    }
+}
+/**
+ * An individual token value in a library
+ */
+class LibraryToken {
+    name;
+    _type;
+    context;
+    _description;
+    _extensions;
+    queue;
+    raw;
+    cached = empty;
+    subscriptions = new Set();
+    constructor(name, value, _type, context, _description, _extensions, queue) {
+        this.name = name;
+        this._type = _type;
+        this.context = context;
+        this._description = _description;
+        this._extensions = _extensions;
+        this.queue = queue;
+        this.raw = value;
+        this.context = context;
+    }
+    get type() {
+        return this._type;
+    }
+    get description() {
+        return this._description;
+    }
+    get extensions() {
+        return this._extensions;
+    }
+    /**
+     * Gets the token value
+     */
+    get value() {
+        if (this.cached !== empty) {
+            return this.cached;
+        }
+        this.disconnect();
+        const stopWatching = Watcher.use(this);
+        const raw = isAlias(this.raw) ? this.raw(this.context) : this.raw;
+        const normalized = isToken(raw) ? raw.value : raw;
+        const value = isObject(normalized)
+            ? recurseResolve(normalized, this.context)
+            : normalized;
+        this.cached = value;
+        stopWatching();
+        return value;
+    }
+    set(value) {
+        this.raw = value;
+        this.onChange();
+    }
+    onChange() {
+        this.queue.add(this);
+        this.cached = empty;
+        getNotifier(this).notify();
+    }
+    watch(source) {
+        const notifier = getNotifier(source);
+        notifier.subscribe(this);
+        this.subscriptions.add(notifier);
+    }
+    /**
+     * Disconnect the token from it's subscriptions
+     */
+    disconnect() {
+        for (const record of this.subscriptions.values()) {
+            record.unsubscribe(this);
+            this.subscriptions.delete(record);
+        }
+    }
+}
+//# sourceMappingURL=library.js.map

package/dist/lib/library.js.map

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

package/dist/lib/notifier.d.ts

@@ -0,0 +1,30 @@
+export declare abstract class Subscribable<T> implements ISubscribable<T> {
+    protected subscribers: Set<ISubscriber<T>>;
+    subscribe(target: ISubscriber<T>): void;
+    unsubscribe(target: ISubscriber<T>): void;
+}
+declare class Notifier<T = any> extends Subscribable<T> implements INotifier<T> {
+    #private;
+    static getNotifier<T>(target: T): INotifier<T>;
+    private static lookup;
+    constructor(subject: T);
+    notify(): void;
+}
+/**
+ * @internal
+ */
+export interface ISubscriber<T> {
+    onChange(target: T): void;
+}
+export interface ISubscribable<T> {
+    subscribe(target: ISubscriber<T>): void;
+    unsubscribe(target: ISubscriber<T>): void;
+}
+/**
+ * @internal
+ */
+export interface INotifier<T> extends ISubscribable<T> {
+    notify(): void;
+}
+export declare const getNotifier: typeof Notifier.getNotifier;
+export {};

package/dist/lib/notifier.js

@@ -0,0 +1,33 @@
+export class Subscribable {
+    subscribers = new Set();
+    subscribe(target) {
+        this.subscribers.add(target);
+    }
+    unsubscribe(target) {
+        this.subscribers.delete(target);
+    }
+}
+class Notifier extends Subscribable {
+    static getNotifier(target) {
+        let notifier = Notifier.lookup.get(target);
+        if (!notifier) {
+            notifier = new Notifier(target);
+            Notifier.lookup.set(target, notifier);
+        }
+        return notifier;
+    }
+    static lookup = new WeakMap();
+    #subject;
+    constructor(subject) {
+        super();
+        this.#subject = subject;
+    }
+    notify() {
+        const subject = this.#subject;
+        for (const value of this.subscribers) {
+            value.onChange(subject);
+        }
+    }
+}
+export const getNotifier = Notifier.getNotifier;
+//# sourceMappingURL=notifier.js.map

package/dist/lib/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../src/lib/notifier.ts"],"names":[],"mappings":"AAAA,MAAM,OAAgB,YAAY;IACtB,WAAW,GAAwB,IAAI,GAAG,EAAE,CAAC;IACvD,SAAS,CAAC,MAAsB;QAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,MAAsB;QAChC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,QAAkB,SAAQ,YAAe;IACtC,MAAM,CAAC,WAAW,CAAI,MAAS;QACpC,IAAI,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;YAChC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,MAAM,CAAC,MAAM,GAAqC,IAAI,OAAO,EAAE,CAAC;IAC/D,QAAQ,CAAI;IAErB,YAAY,OAAU;QACpB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;;AAqBH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC"}

package/dist/lib/queue.d.ts

@@ -0,0 +1,10 @@
+import { ISubscribable, Subscribable } from "./notifier.js";
+export interface IQueue<T extends {}> extends ISubscribable<ReadonlyArray<T>> {
+    add(target: T): void;
+}
+export declare class Queue<T extends {}> extends Subscribable<ReadonlyArray<T>> implements IQueue<T> {
+    private targets;
+    private needsQueue;
+    add(target: T): void;
+    private queue;
+}

package/dist/lib/queue.js

@@ -0,0 +1,23 @@
+import { Subscribable } from "./notifier.js";
+export class Queue extends Subscribable {
+    targets = new Set();
+    needsQueue = true;
+    add(target) {
+        this.targets.add(target);
+        if (this.needsQueue) {
+            this.queue();
+        }
+    }
+    queue() {
+        this.needsQueue = false;
+        queueMicrotask(() => {
+            const targets = Object.freeze(Array.from(this.targets));
+            this.targets.clear();
+            this.needsQueue = true;
+            for (const subscriber of this.subscribers) {
+                subscriber.onChange(targets);
+            }
+        });
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/lib/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/lib/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,eAAe,CAAC;AAM5D,MAAM,OAAO,KACX,SAAQ,YAA8B;IAG9B,OAAO,GAAW,IAAI,GAAG,EAAE,CAAC;IAC5B,UAAU,GAAY,IAAI,CAAC;IAE5B,GAAG,CAAC,MAAS;QAClB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAEO,KAAK;QACX,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,cAAc,CAAC,GAAG,EAAE;YAClB,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YAEvB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC1C,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/lib/utilities.d.ts

@@ -0,0 +1,5 @@
+import { DesignToken } from "./design-token.js";
+export declare const empty: unique symbol;
+export type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: T[P] extends DesignToken.Any ? T[P] : DeepPartial<T[P]>;
+} : T;

package/dist/lib/utilities.js

@@ -0,0 +1,2 @@
+export const empty = Symbol();
+//# sourceMappingURL=utilities.js.map

package/dist/lib/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../../src/lib/utilities.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC"}

package/dist/lib/watcher.d.ts

@@ -0,0 +1,12 @@
+export interface IWatcher {
+    watch(source: Object): void;
+}
+export declare namespace Watcher {
+    function track(source: any): void;
+    /**
+     * Use the provided watcher
+     * @param watcher - the watcher to use
+     * @returns - a function that instructs the watcher to stop using the provided watcher
+     */
+    function use(watcher: IWatcher): () => void;
+}

package/dist/lib/watcher.js

@@ -0,0 +1,25 @@
+import { empty } from "./utilities.js";
+let _watcher = empty;
+export var Watcher;
+(function (Watcher) {
+    function track(source) {
+        if (_watcher !== empty) {
+            _watcher.watch(source);
+        }
+    }
+    Watcher.track = track;
+    /**
+     * Use the provided watcher
+     * @param watcher - the watcher to use
+     * @returns - a function that instructs the watcher to stop using the provided watcher
+     */
+    function use(watcher) {
+        const previousWatcher = _watcher;
+        _watcher = watcher;
+        return () => {
+            _watcher = previousWatcher;
+        };
+    }
+    Watcher.use = use;
+})(Watcher || (Watcher = {}));
+//# sourceMappingURL=watcher.js.map

package/dist/lib/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/lib/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAMvC,IAAI,QAAQ,GAA4B,KAAK,CAAC;AAE9C,MAAM,KAAW,OAAO,CAoBvB;AApBD,WAAiB,OAAO;IACtB,SAAgB,KAAK,CAAC,MAAW;QAC/B,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YACvB,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAJe,aAAK,QAIpB,CAAA;IAED;;;;OAIG;IACH,SAAgB,GAAG,CAAC,OAAiB;QACnC,MAAM,eAAe,GAAG,QAAQ,CAAC;QACjC,QAAQ,GAAG,OAAO,CAAC;QAEnB,OAAO,GAAG,EAAE;YACV,QAAQ,GAAG,eAAe,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC;IAPe,WAAG,MAOlB,CAAA;AACH,CAAC,EApBgB,OAAO,KAAP,OAAO,QAoBvB"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "design-token-library",
+  "version": "0.1.0",
+  "description": "A library for managing design tokens",
+  "type": "module",
+  "main": "./dist/lib/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/lib/index.d.ts",
+      "default": "./dist/lib/index.js"
+    }
+  },
+  "types": "./dist/lib/index.d.ts",
+  "scripts": {
+    "build": "tsc -b",
+    "watch": "tsc -b -w",
+    "watch:test": "watchlist dist/test -- npm test",
+    "test": "npx uvu dist/test .spec.js$",
+    "report-size": "npx esbuild dist/lib/index.js --bundle --outfile=temp/bundle.js --minify; rm -rf temp",
+    "api-report": "npx api-extractor run --local --verbose",
+    "docs:api-reference": "npx api-documenter markdown --input-folder temp --output-folder doc-site/docs/api-reference"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nicholasrice/design-token-library.git"
+  },
+  "author": "https://github.com/nicholasrice",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/nicholasrice/design-token-library/issues"
+  },
+  "homepage": "https://github.com/nicholasrice/design-token-library#readme",
+  "devDependencies": {
+    "@microsoft/api-documenter": "^7.23.12",
+    "@microsoft/api-extractor": "^7.38.3",
+    "@types/sinon": "^17.0.1",
+    "esbuild": "0.19.8",
+    "sinon": "^17.0.1",
+    "typescript": "^5.4.5",
+    "uvu": "^0.5.6",
+    "watchlist": "^0.3.1"
+  }
+}