@o3r/design 10.0.0-alpha.1

package/src/core/design-token/design-token-specification.interface.d.ts

@@ -0,0 +1,195 @@
+/** Metadata information added in the design token extension for Metadata extraction */
+export interface DesignTokenMetadata {
+    tags?: string[];
+    /** Description of the variable */
+    label?: string;
+    /** Name of a group of variables */
+    category?: string;
+}
+/** Design Token Group Extension fields supported by the default renderer */
+export interface DesignTokenGroupExtensions {
+    /** Indicate the file where to generate the token */
+    o3rTargetFile?: string;
+    /**
+     * Indicate that the variable does not need to be generated.
+     * It is up to the generator to describe how to render private variables.
+     * It can choose to ignore the private extension, it can provide a dedicated renderer (for example to prefix it with '_') or it can decide to skip the generation straight to its referenced value.
+     */
+    o3rPrivate?: boolean;
+    /** Indicate that the value of this token is flagged as important */
+    o3rImportant?: boolean;
+    /** Metadata specific information */
+    o3rMetadata?: DesignTokenMetadata;
+    /** Scope of the Design Token value */
+    o3rScope?: string;
+}
+/** Design Token Extension fields supported by the default renderer */
+export interface DesignTokenExtensions extends DesignTokenGroupExtensions {
+}
+interface DesignTokenBase<T> {
+    /** Value of the Token */
+    $value: T;
+    /** Type of the Design Token */
+    $type: string;
+}
+/** Design Token without explicit type (mainly alias) */
+export interface DesignTokenTypeImplicit {
+    /** Value of the Token */
+    $value: string;
+    /** @inheritdoc */
+    $type?: undefined;
+}
+/** Design Token Color */
+export interface DesignTokenTypeColor extends DesignTokenBase<string> {
+    /** @inheritdoc */
+    $type: 'color';
+}
+/** Design Token Dimension */
+export interface DesignTokenTypeDimension extends DesignTokenBase<string> {
+    /** @inheritdoc */
+    $type: 'dimension';
+}
+/** Design Token Font Family */
+export interface DesignTokenTypeFontFamily extends DesignTokenBase<string> {
+    /** @inheritdoc */
+    $type: 'fontFamily';
+}
+/** Design Token Duration */
+export interface DesignTokenTypeDuration extends DesignTokenBase<number | string> {
+    /** @inheritdoc */
+    $type: 'duration';
+}
+type DesignTokenTypeCubicBezierValue = (number | string)[];
+/** Design Token Cubic Bezier */
+export interface DesignTokenTypeCubicBezier extends DesignTokenBase<DesignTokenTypeCubicBezierValue> {
+    /** @inheritdoc */
+    $type: 'cubicBezier';
+}
+type DesignTokenTypeFontWeightValue = number | string;
+/** Design Token Font Weight */
+export interface DesignTokenTypeFontWeight extends DesignTokenBase<DesignTokenTypeFontWeightValue> {
+    /** @inheritdoc */
+    $type: 'fontWeight';
+}
+/** Design Token Number */
+export interface DesignTokenTypeNumber extends DesignTokenBase<number | string> {
+    /** @inheritdoc */
+    $type: 'number';
+}
+type DesignTokenTypeStrokeStyleDetailsValue = {
+    dashArray: string[];
+    lineCap: 'round' | 'butt' | 'square';
+};
+/** Value of the Design Token Stroke Style */
+export type DesignTokenTypeStrokeStyleValue = DesignTokenTypeStrokeStyleDetailsValue | 'solid' | 'dashed' | 'dotted' | 'double' | 'groove' | 'ridge' | 'outset' | 'inset';
+/** Design Token Stroke Style */
+export interface DesignTokenTypeStrokeStyle<T extends DesignTokenTypeStrokeStyleValue = DesignTokenTypeStrokeStyleValue> extends DesignTokenBase<T> {
+    /** @inheritdoc */
+    $type: 'strokeStyle';
+}
+type DesignTokenTypeBorderValue = {
+    color: string;
+    width: string;
+    style: string | DesignTokenTypeStrokeStyleValue;
+};
+/** Design Token Border */
+export interface DesignTokenTypeBorder extends DesignTokenBase<DesignTokenTypeBorderValue> {
+    /** @inheritdoc */
+    $type: 'border';
+}
+type DesignTokenTypeTransitionValue = {
+    duration: string;
+    delay: string;
+    timingFunction: string | DesignTokenTypeCubicBezierValue;
+};
+/** Design Token Transition */
+export interface DesignTokenTypeTransition extends DesignTokenBase<DesignTokenTypeTransitionValue> {
+    /** @inheritdoc */
+    $type: 'transition';
+}
+type DesignTokenTypeShadowValue = {
+    color: string;
+    offsetX: string;
+    offsetY: string;
+    blur: string;
+    spread: string;
+};
+/** Design Token Shadow */
+export interface DesignTokenTypeShadow extends DesignTokenBase<DesignTokenTypeShadowValue> {
+    /** @inheritdoc */
+    $type: 'shadow';
+}
+type DesignTokenTypeGradientValue = {
+    color: string;
+    position: string | number;
+}[];
+/** Design Token Gradient */
+export interface DesignTokenTypeGradient extends DesignTokenBase<DesignTokenTypeGradientValue> {
+    /** @inheritdoc */
+    $type: 'gradient';
+}
+type DesignTokenTypeTypographyValue = {
+    fontFamily: string;
+    fontSize: string;
+    letterSpacing: string;
+    fontWeight: DesignTokenTypeFontWeightValue;
+    lineHeight: string | number;
+};
+/** Design Token Typography */
+export interface DesignTokenTypeTypography extends DesignTokenBase<DesignTokenTypeTypographyValue> {
+    /** @inheritdoc */
+    $type: 'typography';
+}
+/** Common field for the Design Token Groups */
+export interface DesignTokenGroupCommonFields<G extends DesignTokenExtensions> {
+    /** Description of the Group */
+    $description?: string;
+    /** Design Token Extension */
+    $extensions?: G;
+}
+/** Common field for the Design Token */
+export type DesignTokenCommonFields<E extends DesignTokenExtensions = DesignTokenExtensions> = DesignTokenGroupCommonFields<E>;
+/** Available Design Token types */
+export type DesignToken<E extends DesignTokenExtensions = DesignTokenExtensions> = DesignTokenCommonFields<E> & (DesignTokenTypeColor | DesignTokenTypeDimension | DesignTokenTypeFontFamily | DesignTokenTypeDuration | DesignTokenTypeCubicBezier | DesignTokenTypeFontWeight | DesignTokenTypeNumber | DesignTokenTypeStrokeStyle | DesignTokenTypeBorder | DesignTokenTypeTransition | DesignTokenTypeShadow | DesignTokenTypeGradient | DesignTokenTypeTypography | DesignTokenTypeImplicit);
+/** Design Token Node (Design Token Group or Item) */
+export type DesignTokenNode<E extends DesignTokenExtensions = DesignTokenExtensions, G extends DesignTokenGroupExtensions = E> = DesignTokenGroup<E, G> | DesignToken<E>;
+/** Design Token Group */
+export type DesignTokenGroup<E extends DesignTokenExtensions = DesignTokenExtensions, G extends DesignTokenGroupExtensions = E> = DesignTokenGroupCommonFields<G> & {
+    [x: string]: DesignTokenNode<E, G> | E | string | boolean | undefined;
+};
+/** Context of the Design Token specification document */
+export type DesignTokenContext = {
+    /** Base path used to compute the path of the file to render the Tokens into */
+    basePath?: string;
+};
+/** Design Token specification */
+export type DesignTokenSpecification<C extends DesignTokenContext = DesignTokenContext, E extends DesignTokenExtensions = DesignTokenExtensions, G extends DesignTokenGroupExtensions = E> = {
+    /** Specification as described on {@link https://design-tokens.github.io/community-group/format/} */
+    document: DesignTokenGroup<E, G>;
+    /** Specification document context information */
+    context?: C;
+};
+/**
+ * Determine if the Design Token Node is a Token (not a Group)
+ * @param node Design Token Node
+ */
+export declare const isDesignToken: (node?: any) => node is DesignToken<DesignTokenExtensions>;
+/**
+ * Determine if the Design Token Node is a Group (not a Token)
+ * @param node Design Token Node
+ */
+export declare const isDesignTokenGroup: (node?: any) => node is DesignTokenGroup<DesignTokenExtensions, DesignTokenExtensions>;
+/**
+ * Determine if the Stroke Style value is defined or is a reference
+ * @param value Stroke Style value
+ * @returns true if it is a defined value
+ */
+export declare const isTokenTypeStrokeStyleValueComplex: (value?: DesignTokenTypeStrokeStyleValue | string) => value is DesignTokenTypeStrokeStyleDetailsValue;
+/**
+ * Determine if the Stroke Style Token has a value defined or is a reference
+ * @param node Stroke Style Token
+ * @returns true if it is a token with defined value
+ */
+export declare const isTokenTypeStrokeStyleComplex: (node?: DesignTokenTypeStrokeStyle) => node is DesignTokenTypeStrokeStyle<DesignTokenTypeStrokeStyleDetailsValue>;
+export {};
+//# sourceMappingURL=design-token-specification.interface.d.ts.map

package/src/core/design-token/design-token-specification.interface.d.ts.map

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

package/src/core/design-token/design-token-specification.interface.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTokenTypeStrokeStyleComplex = exports.isTokenTypeStrokeStyleValueComplex = exports.isDesignTokenGroup = exports.isDesignToken = void 0;
+/**
+ * Determine if the Design Token Node is a Token (not a Group)
+ * @param node Design Token Node
+ */
+const isDesignToken = (node) => {
+    return !!node && (typeof node.$type !== 'undefined' || typeof node.$value === 'string');
+};
+exports.isDesignToken = isDesignToken;
+/**
+ * Determine if the Design Token Node is a Group (not a Token)
+ * @param node Design Token Node
+ */
+const isDesignTokenGroup = (node) => {
+    return typeof node === 'object' && Object.keys(node).some((k) => !k.startsWith('$'));
+};
+exports.isDesignTokenGroup = isDesignTokenGroup;
+/**
+ * Determine if the Stroke Style value is defined or is a reference
+ * @param value Stroke Style value
+ * @returns true if it is a defined value
+ */
+// eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
+const isTokenTypeStrokeStyleValueComplex = (value) => {
+    return !!value && typeof value !== 'string';
+};
+exports.isTokenTypeStrokeStyleValueComplex = isTokenTypeStrokeStyleValueComplex;
+/**
+ * Determine if the Stroke Style Token has a value defined or is a reference
+ * @param node Stroke Style Token
+ * @returns true if it is a token with defined value
+ */
+const isTokenTypeStrokeStyleComplex = (node) => {
+    return !!node && (0, exports.isTokenTypeStrokeStyleValueComplex)(node.$value);
+};
+exports.isTokenTypeStrokeStyleComplex = isTokenTypeStrokeStyleComplex;
+//# sourceMappingURL=design-token-specification.interface.js.map

package/src/core/design-token/design-token-specification.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-specification.interface.js","sourceRoot":"","sources":["../../../../src/core/design-token/design-token-specification.interface.ts"],"names":[],"mappings":";;;AAsOA;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,IAAU,EAAuB,EAAE;IAC/D,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;AAC1F,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEF;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAU,EAA4B,EAAE;IACzE,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACvF,CAAC,CAAC;AAFW,QAAA,kBAAkB,sBAE7B;AAEF;;;;GAIG;AACH,6EAA6E;AACtE,MAAM,kCAAkC,GAAG,CAAC,KAAgD,EAAmD,EAAE;IACtJ,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AAC9C,CAAC,CAAC;AAFW,QAAA,kCAAkC,sCAE7C;AAEF;;;;GAIG;AACI,MAAM,6BAA6B,GAAG,CAAC,IAAiC,EAA8E,EAAE;IAC7J,OAAO,CAAC,CAAC,IAAI,IAAI,IAAA,0CAAkC,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnE,CAAC,CAAC;AAFW,QAAA,6BAA6B,iCAExC"}

package/src/core/design-token/index.d.ts

@@ -0,0 +1,4 @@
+export * from './renderers/index';
+export * from './parsers/index';
+export * from './design-token-specification.interface';
+//# sourceMappingURL=index.d.ts.map

package/src/core/design-token/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/design-token/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wCAAwC,CAAC"}

package/src/core/design-token/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./renderers/index"), exports);
+tslib_1.__exportStar(require("./parsers/index"), exports);
+tslib_1.__exportStar(require("./design-token-specification.interface"), exports);
+//# sourceMappingURL=index.js.map

package/src/core/design-token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/design-token/index.ts"],"names":[],"mappings":";;;AAAA,4DAAkC;AAClC,0DAAgC;AAChC,iFAAuD"}

package/src/core/design-token/parsers/design-token-parser.interface.d.ts

@@ -0,0 +1,70 @@
+import type { DesignToken, DesignTokenContext, DesignTokenExtensions, DesignTokenGroup, DesignTokenGroupExtensions } from '../design-token-specification.interface';
+/** Reference to a parent node*/
+export interface ParentReference {
+    /** Design Token name */
+    name: string;
+    /** Design Token Group node */
+    tokenNode: DesignTokenGroup;
+}
+/**
+ * Function rendering the Design Token Value
+ * @param tokenStructure Parsed Design Token
+ * @param variableSet Complete list of the parsed Design Token
+ */
+export type TokenValueRenderer = (tokenStructure: DesignTokenVariableStructure, variableSet: Map<string, DesignTokenVariableStructure>) => string;
+/**
+ * Function rendering the Design Token Key
+ * @param tokenStructure Parsed Design Token
+ */
+export type TokenKeyRenderer = (tokenStructure: DesignTokenVariableStructure) => string;
+/** Complete list of the parsed Design Token */
+export type DesignTokenVariableSet = Map<string, DesignTokenVariableStructure>;
+/** Parsed Design Token variable */
+export interface DesignTokenVariableStructure {
+    /** Context of the Token determined or provided during the parsing process */
+    context?: DesignTokenContext;
+    /** Design Token Extension */
+    extensions: DesignTokenGroupExtensions & DesignTokenExtensions;
+    /** Reference to the Design Token node */
+    node: DesignToken;
+    /** Name of the token in references */
+    tokenReferenceName: string;
+    /** Description of the Token */
+    description?: string;
+    /** List of the Ancestors references */
+    ancestors: ParentReference[];
+    /** Reference to the direct parent node */
+    parent?: ParentReference;
+    /**
+     * Retrieve the list of the references of the Design Token
+     * @param variableSet Complete list of the parsed Design Token
+     */
+    getReferences: (variableSet?: DesignTokenVariableSet) => string[];
+    /**
+     * Raw CSS value of the Token
+     * @param variableSet Complete list of the parsed Design Token
+     */
+    getCssRawValue: (variableSet?: DesignTokenVariableSet) => string;
+    /**
+     * Determine if the Token is an alias
+     * @param variableSet Complete list of the parsed Design Token
+     */
+    getIsAlias: (variableSet?: DesignTokenVariableSet) => boolean;
+    /**
+     * Retrieve the type calculated for the Token
+     * @param followReference Determine if the references should be follow to calculate the type
+     * @param variableSet Complete list of the parsed Design Token
+     */
+    getType: (variableSet?: DesignTokenVariableSet, followReference?: boolean) => DesignToken['$type'];
+    /**
+     * Retrieve the list of the references of the Design Token node
+     * @param followReference Determine if the references should be follow to calculate the type
+     */
+    getReferencesNode: (variableSet?: DesignTokenVariableSet) => DesignTokenVariableStructure[];
+    /**
+     * Retrieve the Design Token Key as rendered by the provided renderer
+     * @param keyRenderer Renderer for the Design Token key
+     */
+    getKey: (keyRenderer?: TokenKeyRenderer) => string;
+}
+//# sourceMappingURL=design-token-parser.interface.d.ts.map

package/src/core/design-token/parsers/design-token-parser.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-parser.interface.d.ts","sourceRoot":"","sources":["../../../../../src/core/design-token/parsers/design-token-parser.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAEpK,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;;GAIG;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,4BAA4B,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,KAAK,MAAM,CAAC;AAElJ;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,cAAc,EAAE,4BAA4B,KAAK,MAAM,CAAC;AAExF,+CAA+C;AAE/C,MAAM,MAAM,sBAAsB,GAAG,GAAG,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;AAE/E,mCAAmC;AACnC,MAAM,WAAW,4BAA4B;IAC3C,6EAA6E;IAC7E,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,6BAA6B;IAC7B,UAAU,EAAE,0BAA0B,GAAG,qBAAqB,CAAC;IAC/D,yCAAyC;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,aAAa,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB,KAAK,MAAM,EAAE,CAAC;IAClE;;;OAGG;IACH,cAAc,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC;IACjE;;;OAGG;IACH,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;IAC9D;;;;OAIG;IACH,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB,EAAE,eAAe,CAAC,EAAE,OAAO,KAAK,WAAW,CAAC,OAAO,CAAC,CAAC;IACnG;;;OAGG;IACH,iBAAiB,EAAE,CAAC,WAAW,CAAC,EAAE,sBAAsB,KAAK,4BAA4B,EAAE,CAAC;IAC5F;;;OAGG;IACH,MAAM,EAAE,CAAC,WAAW,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC;CACpD"}

package/src/core/design-token/parsers/design-token-parser.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=design-token-parser.interface.js.map

package/src/core/design-token/parsers/design-token-parser.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-parser.interface.js","sourceRoot":"","sources":["../../../../../src/core/design-token/parsers/design-token-parser.interface.ts"],"names":[],"mappings":""}

package/src/core/design-token/parsers/design-token.parser.d.ts

@@ -0,0 +1,25 @@
+import type { DesignTokenVariableSet } from './design-token-parser.interface';
+import type { DesignTokenContext, DesignTokenSpecification } from '../design-token-specification.interface';
+/**
+ * Parse a Design Token Object to provide the map of Token with helpers to generate the different output
+ * @param specification Design Token content as specified on https://design-tokens.github.io/community-group/format/
+ */
+export declare const parseDesignToken: (specification: DesignTokenSpecification) => DesignTokenVariableSet;
+interface ParseDesignTokenFileOptions {
+    /**
+     * Custom function to read a file required by the token renderer
+     * @default {@see fs.promises.readFile}
+     * @param filePath Path to the file to read
+     */
+    readFile?: (filePath: string) => string | Promise<string>;
+    /** Custom context to provide to the parser and override the information determined by the specification parse process */
+    specificationContext?: DesignTokenContext;
+}
+/**
+ * Parse a Design Token File to provide the map of Token with helpers to generate the different output
+ * @param specificationFilePath Path to the a Design Token file following the specification on https://design-tokens.github.io/community-group/format/
+ * @param options
+ */
+export declare const parseDesignTokenFile: (specificationFilePath: string, options?: ParseDesignTokenFileOptions) => Promise<DesignTokenVariableSet>;
+export {};
+//# sourceMappingURL=design-token.parser.d.ts.map

package/src/core/design-token/parsers/design-token.parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token.parser.d.ts","sourceRoot":"","sources":["../../../../../src/core/design-token/parsers/design-token.parser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAiD,MAAM,iCAAiC,CAAC;AAC7H,OAAO,KAAK,EAEV,kBAAkB,EAKlB,wBAAwB,EACzB,MAAM,yCAAyC,CAAC;AA4IjD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,kBAAmB,wBAAwB,2BAEvE,CAAC;AAEF,UAAU,2BAA2B;IACnC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1D,yHAAyH;IACzH,oBAAoB,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,0BAAiC,MAAM,YAAY,2BAA2B,oCAM9G,CAAC"}

package/src/core/design-token/parsers/design-token.parser.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDesignTokenFile = exports.parseDesignToken = void 0;
+const node_fs_1 = require("node:fs");
+const design_token_specification_interface_1 = require("../design-token-specification.interface");
+const node_path_1 = require("node:path");
+const tokenReferenceRegExp = /\{([^}]+)\}/g;
+const getTokenReferenceName = (tokenName, parents) => (`${parents.join('.')}.${tokenName}`);
+const getExtensions = (parentNode) => parentNode.reduce((acc, node) => ({ ...acc, ...node.$extensions }), {});
+const getReferences = (cssRawValue) => Array.from(cssRawValue.matchAll(tokenReferenceRegExp)).map(([, tokenRef]) => tokenRef);
+// eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents
+const renderCssTypeStrokeStyleValue = (value) => (0, design_token_specification_interface_1.isTokenTypeStrokeStyleValueComplex)(value) ? `${value.lineCap} ${value.dashArray.join(' ')}` : value;
+const getCssRawValue = (variableSet, { node, getType }) => {
+    const nodeType = getType(variableSet, false);
+    if (!nodeType && node.$value) {
+        return typeof node.$value.toString !== undefined ? node.$value.toString() : JSON.stringify(node.$value);
+    }
+    const checkNode = {
+        ...node,
+        $type: node.$type || nodeType
+    };
+    // TODO in the following code, `typeof checkNode.$value === 'string' ? checkNode.$value :` is defined to please Jest TS compilation. It should be removed when supported
+    switch (checkNode.$type) {
+        case 'color':
+        case 'number':
+        case 'duration':
+        case 'fontWeight':
+        case 'fontFamily':
+        case 'dimension': {
+            return checkNode.$value.toString();
+        }
+        case 'strokeStyle': {
+            return renderCssTypeStrokeStyleValue(checkNode.$value);
+        }
+        case 'cubicBezier': {
+            return typeof checkNode.$value === 'string' ? checkNode.$value :
+                checkNode.$value.join(', ');
+        }
+        case 'border': {
+            return typeof checkNode.$value === 'string' ? checkNode.$value :
+                `${checkNode.$value.width} ${renderCssTypeStrokeStyleValue(checkNode.$value.style)} ${checkNode.$value.color}`;
+        }
+        case 'gradient': {
+            return typeof checkNode.$value === 'string' ? checkNode.$value :
+                // TODO: add support of different gradient type when design-tokens/community-group#101 is fixed.
+                `linear-gradient(0deg, ${checkNode.$value.map(({ color, position }) => `${color} ${position}`).join(', ')})`;
+        }
+        case 'shadow': {
+            return typeof checkNode.$value === 'string' ? checkNode.$value :
+                `${checkNode.$value.offsetX} ${checkNode.$value.offsetY} ${checkNode.$value.blur}  ${checkNode.$value.spread} ${checkNode.$value.color}`;
+        }
+        case 'transition': {
+            return typeof checkNode.$value === 'string' ? checkNode.$value :
+                typeof checkNode.$value.timingFunction === 'string' ? checkNode.$value.timingFunction : checkNode.$value.timingFunction.join(' ') +
+                    ` ${checkNode.$value.duration} ${checkNode.$value.delay}`;
+        }
+        case 'typography': {
+            return typeof checkNode.$value === 'string' ? checkNode.$value :
+                `${checkNode.$value.fontWeight} ${checkNode.$value.fontFamily} ${checkNode.$value.fontSize} ${checkNode.$value.letterSpacing} ${checkNode.$value.lineHeight}`;
+        }
+        default: {
+            throw new Error(`Not supported type ${checkNode.$type || 'unknown'} (value: ${checkNode.$value || 'unknown'})`);
+        }
+    }
+};
+const walkThroughDesignTokenNodes = (node, context, ancestors, mem, nodeName) => {
+    if ((0, design_token_specification_interface_1.isDesignTokenGroup)(node)) {
+        Object.entries(node)
+            .filter(([tokenName, tokenNode]) => !tokenName.startsWith('$') && ((0, design_token_specification_interface_1.isDesignToken)(tokenNode) || (0, design_token_specification_interface_1.isDesignTokenGroup)(tokenNode)))
+            .forEach(([tokenName, tokenNode]) => walkThroughDesignTokenNodes(tokenNode, context, nodeName ? [...ancestors, { name: nodeName, tokenNode: node }] : ancestors, mem, tokenName));
+    }
+    if ((0, design_token_specification_interface_1.isDesignToken)(node)) {
+        if (!nodeName) {
+            throw new Error('The first node of the Design Specification can not be a token');
+        }
+        const parentNames = ancestors.map(({ name }) => name);
+        const tokenReferenceName = getTokenReferenceName(nodeName, parentNames);
+        const tokenVariable = {
+            context,
+            extensions: getExtensions([...ancestors.map(({ tokenNode }) => tokenNode), node]),
+            node,
+            tokenReferenceName,
+            ancestors,
+            parent: ancestors.slice(-1)[0],
+            description: node.$description,
+            getCssRawValue: function (variableSet = mem) {
+                return getCssRawValue(variableSet, this);
+            },
+            getReferences: function (variableSet = mem) {
+                return getReferences(this.getCssRawValue(variableSet));
+            },
+            getIsAlias: function (variableSet = mem) {
+                return this.getReferences(variableSet).length === 1 && typeof node.$value === 'string' && !!node.$value?.toString().match(/^\{[^}]*\}$/);
+            },
+            getReferencesNode: function (variableSet = mem) {
+                return this.getReferences(variableSet)
+                    .map((ref) => {
+                    if (!variableSet.has(ref)) {
+                        throw new Error(`Reference to ${ref} not found`);
+                    }
+                    return variableSet.get(ref);
+                });
+            },
+            getType: function (variableSet = mem, followReference = true) {
+                return node.$type ||
+                    followReference && this.getIsAlias(variableSet) && this.getReferencesNode(variableSet)[0]?.getType(variableSet, followReference) ||
+                    followReference && this.parent?.name && variableSet.get(this.parent.name)?.getType(variableSet, followReference) ||
+                    undefined;
+            },
+            getKey: function (keyRenderer) {
+                return keyRenderer ? keyRenderer(this) : this.tokenReferenceName.replace(/[ .]+/g, '-');
+            }
+        };
+        mem.set(tokenReferenceName, tokenVariable);
+    }
+    else if (!(0, design_token_specification_interface_1.isDesignTokenGroup)(node)) {
+        throw new Error('Fail to determine the Design Token Node type');
+    }
+    return mem;
+};
+/**
+ * Parse a Design Token Object to provide the map of Token with helpers to generate the different output
+ * @param specification Design Token content as specified on https://design-tokens.github.io/community-group/format/
+ */
+const parseDesignToken = (specification) => {
+    return walkThroughDesignTokenNodes(specification.document, specification.context, [], new Map());
+};
+exports.parseDesignToken = parseDesignToken;
+/**
+ * Parse a Design Token File to provide the map of Token with helpers to generate the different output
+ * @param specificationFilePath Path to the a Design Token file following the specification on https://design-tokens.github.io/community-group/format/
+ * @param options
+ */
+const parseDesignTokenFile = async (specificationFilePath, options) => {
+    const readFile = options?.readFile || ((filePath) => node_fs_1.promises.readFile(filePath, { encoding: 'utf-8' }));
+    const context = {
+        basePath: (0, node_path_1.dirname)(specificationFilePath)
+    };
+    return (0, exports.parseDesignToken)({ document: JSON.parse(await readFile(specificationFilePath)), context });
+};
+exports.parseDesignTokenFile = parseDesignTokenFile;
+//# sourceMappingURL=design-token.parser.js.map

package/src/core/design-token/parsers/design-token.parser.js.map

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

package/src/core/design-token/parsers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './design-token-parser.interface';
+export * from './design-token.parser';
+//# sourceMappingURL=index.d.ts.map

package/src/core/design-token/parsers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/design-token/parsers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC"}

package/src/core/design-token/parsers/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./design-token-parser.interface"), exports);
+tslib_1.__exportStar(require("./design-token.parser"), exports);
+//# sourceMappingURL=index.js.map

package/src/core/design-token/parsers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/core/design-token/parsers/index.ts"],"names":[],"mappings":";;;AAAA,0EAAgD;AAChD,gEAAsC"}

package/src/core/design-token/renderers/css/design-token-definition.renderers.d.ts

@@ -0,0 +1,47 @@
+import type { DesignTokenVariableStructure, TokenKeyRenderer, TokenValueRenderer } from '../../parsers/design-token-parser.interface';
+import { TokenDefinitionRenderer } from '../design-token.renderer.interface';
+/** Options for {@link CssTokenDefinitionRendererOptions} */
+export interface CssTokenDefinitionRendererOptions {
+    /**
+     * Determine if the variable is private and should not be rendered
+     * @default {@see isO3rPrivateVariable}
+     */
+    isPrivateVariable?: (variable: DesignTokenVariableStructure) => boolean;
+    /** Custom Design Token value renderer */
+    tokenValueRenderer?: TokenValueRenderer;
+    /**
+     * Renderer the name of the CSS Variable (with the initial --)
+     */
+    tokenVariableNameRenderer?: TokenKeyRenderer;
+    /**
+     * Private Design Token definition renderer
+     * The private variable will not be rendered if not provided
+     */
+    privateDefinitionRenderer?: TokenDefinitionRenderer;
+}
+/**
+ * Retrieve the Design Token variable renderer for CSS
+ * @param options
+ * @returns
+ * @example CSS renderer with Sass fallback
+ * ```typescript
+ * import { getSassTokenDefinitionRenderer } from '@o3r/design';
+ *
+ * // List of parsed Design Token items
+ * const parsedTokenDesign = await parseDesignTokenFile('./path/to/spec.json');
+ *
+ * // Sass variable renderer
+ * const sassTokenDefinitionRenderer = getSassTokenDefinitionRenderer();
+ *
+ * // CSS variable renderer
+ * const cssTokenDefinitionRenderer = getCssTokenDefinitionRenderer({
+ *   // Specify that the private variable should be rendered in Sass variable
+ *   privateDefinitionRenderer: sassTokenDefinitionRenderer
+ * });
+ *
+ * // Render the CSS variables
+ * await renderDesignTokens(parsedTokenDesign, { tokenDefinitionRenderer: cssTokenDefinitionRenderer });
+ * ```
+ */
+export declare const getCssTokenDefinitionRenderer: (options?: CssTokenDefinitionRendererOptions) => TokenDefinitionRenderer;
+//# sourceMappingURL=design-token-definition.renderers.d.ts.map

package/src/core/design-token/renderers/css/design-token-definition.renderers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-definition.renderers.d.ts","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/design-token-definition.renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEtI,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,4DAA4D;AAC5D,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,4BAA4B,KAAK,OAAO,CAAC;IAExE,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,yBAAyB,CAAC,EAAE,gBAAgB,CAAC;IAE7C;;;OAGG;IACH,yBAAyB,CAAC,EAAE,uBAAuB,CAAC;CACrD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,6BAA6B,aAAc,iCAAiC,KAAG,uBAqB3F,CAAC"}