@o3r/design 9.6.0-rc.4

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;AA6IjD;;;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,143 @@
+"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: {
+            // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+            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"}

package/src/core/design-token/renderers/css/design-token-definition.renderers.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCssTokenDefinitionRenderer = void 0;
+const design_token_renderer_helpers_1 = require("../design-token.renderer.helpers");
+const design_token_value_renderers_1 = require("./design-token-value.renderers");
+/**
+ * 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 });
+ * ```
+ */
+const getCssTokenDefinitionRenderer = (options) => {
+    const isPrivateVariable = options?.isPrivateVariable || design_token_renderer_helpers_1.isO3rPrivateVariable;
+    const tokenVariableNameRenderer = options?.tokenVariableNameRenderer;
+    const tokenValueRenderer = options?.tokenValueRenderer || (0, design_token_value_renderers_1.getCssTokenValueRenderer)({ isPrivateVariable, tokenVariableNameRenderer });
+    const renderer = (variable, variableSet) => {
+        let variableString;
+        if (!isPrivateVariable(variable)) {
+            variableString = `--${variable.getKey(tokenVariableNameRenderer)}: ${tokenValueRenderer(variable, variableSet)};`;
+            if (variable.extensions.o3rScope) {
+                variableString = `${variable.extensions.o3rScope} { ${variableString} }`;
+            }
+        }
+        else if (options?.privateDefinitionRenderer && variable.extensions.o3rPrivate) {
+            variableString = options.privateDefinitionRenderer(variable, variableSet);
+        }
+        if (variableString && variable.description) {
+            variableString = `/* ${variable.description} */\n${variableString}`;
+        }
+        return variableString;
+    };
+    return renderer;
+};
+exports.getCssTokenDefinitionRenderer = getCssTokenDefinitionRenderer;
+//# sourceMappingURL=design-token-definition.renderers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-definition.renderers.js","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/design-token-definition.renderers.ts"],"names":[],"mappings":";;;AACA,oFAAwE;AAExE,iFAA0E;AAyB1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACI,MAAM,6BAA6B,GAAG,CAAC,OAA2C,EAA2B,EAAE;IACpH,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,oDAAoB,CAAC;IAC7E,MAAM,yBAAyB,GAAG,OAAO,EAAE,yBAAyB,CAAC;IACrE,MAAM,kBAAkB,GAAG,OAAO,EAAE,kBAAkB,IAAI,IAAA,uDAAwB,EAAC,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAErI,MAAM,QAAQ,GAAG,CAAC,QAAsC,EAAE,WAAsD,EAAE,EAAE;QAClH,IAAI,cAAkC,CAAC;QACvC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE;YAChC,cAAc,GAAG,KAAK,QAAQ,CAAC,MAAM,CAAC,yBAAyB,CAAC,KAAK,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC;YAClH,IAAI,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE;gBAChC,cAAc,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,MAAM,cAAc,IAAI,CAAC;aAC1E;SACF;aAAM,IAAI,OAAO,EAAE,yBAAyB,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,EAAE;YAC/E,cAAc,GAAG,OAAO,CAAC,yBAAyB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;SAC3E;QACD,IAAI,cAAc,IAAI,QAAQ,CAAC,WAAW,EAAE;YAC1C,cAAc,GAAG,MAAM,QAAQ,CAAC,WAAW,QAAQ,cAAc,EAAE,CAAC;SACrE;QACD,OAAO,cAAc,CAAC;IACxB,CAAC,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AArBW,QAAA,6BAA6B,iCAqBxC"}

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

@@ -0,0 +1,24 @@
+import type { DesignContentFileUpdater } from '../design-token.renderer.interface';
+/** Default CSS starting tag */
+export declare const AUTO_GENERATED_START = "/* --- BEGIN THEME Auto-generated --- */";
+/** Default CSS ending tag */
+export declare const AUTO_GENERATED_END = "/* --- END THEME Auto-generated --- */";
+/** Options for {@link getCssStyleContentUpdater} */
+export interface CssStyleContentUpdaterOptions {
+    /**
+     * Opening tag marking the content edition part
+     * @default {@see AUTO_GENERATED_START}
+     */
+    startTag?: string;
+    /**
+     * Closing tag marking the content edition part
+     * @default {@see AUTO_GENERATED_END}
+     */
+    endTag?: string;
+}
+/**
+ * Retrieve a Content Updater function for CSS generator
+ * @param options
+ */
+export declare const getCssStyleContentUpdater: (options?: CssStyleContentUpdaterOptions) => DesignContentFileUpdater;
+//# sourceMappingURL=design-token-updater.renderers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-updater.renderers.d.ts","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/design-token-updater.renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAOnF,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,6CAA6C,CAAC;AAE/E,6BAA6B;AAC7B,eAAO,MAAM,kBAAkB,2CAA2C,CAAC;AAE3E,oDAAoD;AACpD,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAAc,6BAA6B,KAAG,wBAcnF,CAAC"}

package/src/core/design-token/renderers/css/design-token-updater.renderers.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCssStyleContentUpdater = exports.AUTO_GENERATED_END = exports.AUTO_GENERATED_START = void 0;
+const SANITIZE_TAG_INPUTS_REGEXP = /[.*+?^${}()|[\]\\]/g;
+const generateVars = (variables, startTag, endTag, addCssScope = false) => `${addCssScope ? ':root {\n' : ''}${startTag}\n${variables.join('\n')}\n${endTag}${addCssScope ? '\n}' : ''}`;
+/** Default CSS starting tag */
+exports.AUTO_GENERATED_START = '/* --- BEGIN THEME Auto-generated --- */';
+/** Default CSS ending tag */
+exports.AUTO_GENERATED_END = '/* --- END THEME Auto-generated --- */';
+/**
+ * Retrieve a Content Updater function for CSS generator
+ * @param options
+ */
+const getCssStyleContentUpdater = (options) => {
+    const startTag = options?.startTag || exports.AUTO_GENERATED_START;
+    const endTag = options?.endTag || exports.AUTO_GENERATED_END;
+    /** Regexp to replace the content between the detected tags. It also handle possible inputted special character sanitization */
+    const regexToReplace = new RegExp(`${startTag.replace(SANITIZE_TAG_INPUTS_REGEXP, '\\$&')}(:?(.|[\n\r])*)${endTag.replace(SANITIZE_TAG_INPUTS_REGEXP, '\\$&')}`);
+    return (variables, _file, styleContent = '') => {
+        if (styleContent.indexOf(startTag) >= 0 && styleContent.indexOf(endTag) >= 0) {
+            return styleContent.replace(regexToReplace, generateVars(variables, startTag, endTag));
+        }
+        else {
+            return styleContent + '\n' + generateVars(variables, startTag, endTag, true);
+        }
+    };
+};
+exports.getCssStyleContentUpdater = getCssStyleContentUpdater;
+//# sourceMappingURL=design-token-updater.renderers.js.map

package/src/core/design-token/renderers/css/design-token-updater.renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-updater.renderers.js","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/design-token-updater.renderers.ts"],"names":[],"mappings":";;;AAEA,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAEzD,MAAM,YAAY,GAAG,CAAC,SAAmB,EAAE,QAAgB,EAAE,MAAc,EAAE,WAAW,GAAG,KAAK,EAAE,EAAE,CAClG,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAEhH,+BAA+B;AAClB,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAE/E,6BAA6B;AAChB,QAAA,kBAAkB,GAAG,wCAAwC,CAAC;AAiB3E;;;GAGG;AACI,MAAM,yBAAyB,GAAG,CAAC,OAAuC,EAA4B,EAAE;IAC7G,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,4BAAoB,CAAC;IAC3D,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,0BAAkB,CAAC;IAErD,+HAA+H;IAC/H,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,0BAA0B,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAEjK,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,EAAE,EAAE,EAAE;QAC7C,IAAI,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC5E,OAAO,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;SACxF;aAAM;YACL,OAAO,YAAY,GAAG,IAAI,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;SAC9E;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAdW,QAAA,yBAAyB,6BAcpC"}

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

@@ -0,0 +1,19 @@
+import type { DesignTokenVariableStructure, TokenKeyRenderer, TokenValueRenderer } from '../../parsers/design-token-parser.interface';
+/** Options for {@link getCssTokenValueRenderer} */
+export interface CssTokenValueRendererOptions {
+    /**
+     * Determine if the variable is private and should not be rendered
+     * @default {@see isO3rPrivateVariable}
+     */
+    isPrivateVariable?: (variable: DesignTokenVariableStructure) => boolean;
+    /**
+     * Renderer the name of the CSS Variable (without initial --)
+     */
+    tokenVariableNameRenderer?: TokenKeyRenderer;
+}
+/**
+ * Retrieve the Design Token value renderer
+ * @param options
+ */
+export declare const getCssTokenValueRenderer: (options?: CssTokenValueRendererOptions) => TokenValueRenderer;
+//# sourceMappingURL=design-token-value.renderers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-value.renderers.d.ts","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/design-token-value.renderers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAGtI,mDAAmD;AACnD,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,4BAA4B,KAAK,OAAO,CAAC;IAExE;;OAEG;IACH,yBAAyB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,aAAc,4BAA4B,KAAG,kBAoBjF,CAAC"}

package/src/core/design-token/renderers/css/design-token-value.renderers.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCssTokenValueRenderer = void 0;
+const design_token_renderer_helpers_1 = require("../design-token.renderer.helpers");
+/**
+ * Retrieve the Design Token value renderer
+ * @param options
+ */
+const getCssTokenValueRenderer = (options) => {
+    const isPrivateVariable = options?.isPrivateVariable || design_token_renderer_helpers_1.isO3rPrivateVariable;
+    const tokenVariableNameRenderer = options?.tokenVariableNameRenderer;
+    const referenceRenderer = (variable, variableSet) => {
+        if (!isPrivateVariable(variable)) {
+            return `var(--${variable.getKey(tokenVariableNameRenderer)})`;
+        }
+        else {
+            // eslint-disable-next-line no-use-before-define
+            return `var(--${variable.getKey(tokenVariableNameRenderer)}, ${renderer(variable, variableSet)})`;
+        }
+    };
+    const renderer = (variable, variableSet) => {
+        let variableValue = variable.getCssRawValue(variableSet).replaceAll(/\{([^}]*)\}/g, (defaultValue, matcher) => (variableSet.has(matcher) ? referenceRenderer(variableSet.get(matcher), variableSet) : defaultValue));
+        variableValue += variableValue && variable.extensions.o3rImportant ? ' !important' : '';
+        return variableValue;
+    };
+    return renderer;
+};
+exports.getCssTokenValueRenderer = getCssTokenValueRenderer;
+//# sourceMappingURL=design-token-value.renderers.js.map

package/src/core/design-token/renderers/css/design-token-value.renderers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-value.renderers.js","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/design-token-value.renderers.ts"],"names":[],"mappings":";;;AACA,oFAAwE;AAgBxE;;;GAGG;AACI,MAAM,wBAAwB,GAAG,CAAC,OAAsC,EAAsB,EAAE;IACrG,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,oDAAoB,CAAC;IAC7E,MAAM,yBAAyB,GAAG,OAAO,EAAE,yBAAyB,CAAC;IAErE,MAAM,iBAAiB,GAAG,CAAC,QAAsC,EAAE,WAAsD,EAAU,EAAE;QACnI,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE;YAChC,OAAO,SAAS,QAAQ,CAAC,MAAM,CAAC,yBAAyB,CAAC,GAAG,CAAC;SAC/D;aAAM;YACL,gDAAgD;YAChD,OAAO,SAAS,QAAQ,CAAC,MAAM,CAAC,yBAAyB,CAAC,KAAK,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC;SACnG;IACH,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,QAAsC,EAAE,WAAsD,EAAE,EAAE;QAClH,IAAI,aAAa,GAAG,QAAQ,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,CAC5G,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CACtG,CAAC;QACF,aAAa,IAAI,aAAa,IAAI,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AApBW,QAAA,wBAAwB,4BAoBnC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kCAAkC,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/core/design-token/renderers/css/index.ts"],"names":[],"mappings":";;;AAAA,8EAAoD;AACpD,yEAA+C;AAC/C,2EAAiD"}

package/src/core/design-token/renderers/design-token-style.renderer.d.ts

@@ -0,0 +1,25 @@
+import type { DesignTokenVariableSet, DesignTokenVariableStructure } from '../parsers/design-token-parser.interface';
+import type { DesignTokenRendererOptions } from './design-token.renderer.interface';
+/**
+ * Retrieve the function that determines which file to update for a given token
+ * @param root Root path used if no base path
+ * @param defaultFile Default file if not requested by the Token
+ */
+export declare const computeFileToUpdatePath: (root?: string, defaultFile?: string) => (token: DesignTokenVariableStructure) => string;
+/**
+ * Process the parsed Design Token variables and render them according to the given options and renderers
+ * @param variableSet Complete list of the parsed Design Token
+ * @param options Parameters of the Design Token renderer
+ * @example Basic renderer usage
+ * ```typescript
+ * import { parseDesignTokenFile, renderDesignTokens } from '@o3r/design';
+ *
+ * // List of parsed Design Token items
+ * const parsedTokenDesign = await parseDesignTokenFile('./path/to/spec.json');
+ *
+ * // Render the CSS variables
+ * await renderDesignTokens(parsedTokenDesign, { logger: console });
+ * ```
+ */
+export declare const renderDesignTokens: (variableSet: DesignTokenVariableSet, options?: DesignTokenRendererOptions) => Promise<void>;
+//# sourceMappingURL=design-token-style.renderer.d.ts.map

package/src/core/design-token/renderers/design-token-style.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design-token-style.renderer.d.ts","sourceRoot":"","sources":["../../../../../src/core/design-token/renderers/design-token-style.renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,0CAA0C,CAAC;AAKrH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAEpF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,mDAAkE,4BAA4B,WAMjI,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,kBAAkB,kDAAyD,0BAA0B,kBAwBjH,CAAC"}