@ama-styling/style-dictionary 12.5.0-prerelease.10

package/LICENSE

@@ -0,0 +1,26 @@
+Copyright Amadeus SAS
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation and/or
+other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+may be used to endorse or promote products derived from this software without
+specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,255 @@
+<h1 align="center">Otter Style Dictionary</h1>
+<p align="center">
+  <img src="https://raw.githubusercontent.com/AmadeusITGroup/otter/main/assets/logo/otter.png" alt="Super cute Otter!" width="40%"/>
+</p>
+
+This package is an [Otter Framework Module](https://github.com/AmadeusITGroup/otter/tree/main/docs/core/MODULE.md).
+<br />
+<br />
+
+## Description
+
+[![Stable Version](https://img.shields.io/npm/v/@ama-styling/style-dictionary?style=for-the-badge)](https://www.npmjs.com/package/@ama-styling/style-dictionary)
+[![Bundle Size](https://img.shields.io/bundlephobia/min/@ama-styling/style-dictionary?color=green&style=for-the-badge)](https://www.npmjs.com/package/@ama-styling/style-dictionary)
+
+This package exposes a set of **Hooks** and **Modules** for the [Style Dictionary](https://styledictionary.com/) to enhance the capabilities of Design Tokens.
+
+## Get Started
+
+Set up your [Style Dictionary](https://styledictionary.com/) in your project thanks to the command:
+
+```shell
+ng add @ama-styling/style-dictionary
+```
+
+By default, the command will do the following updates:
+
+- Add a dev dependency to the [Style Dictionary package](https://www.npmjs.com/package/style-dictionary).
+- Create a minimal [config.mjs](https://styledictionary.com/reference/config/#_top) configuration file with the required setup for CSS and Metadata generation.
+- Add the `generate:theme` and `generate:metadata` scripts in the project *package.json*.
+
+You will then be able to customize this setup with your project's specifications:
+
+- Customize the [Style Dictionary configuration](https://styledictionary.com/reference/config/#_top) in the generated *config.mjs* file.
+- Add [extensions](https://tr.designtokens.org/format/#extensions) to your source Design Token via the [enhancement mechanism](#enhancement).
+- Configure output files thanks to the [`getTargetFiles` helper](#gettargetfiles).
+
+## Enhancement
+
+### Design Token Extensions
+
+The [Design Tokens](https://tr.designtokens.org/format/#extensions) format allows to provide the `$extensions` property to enhance the Token it is applied to.\
+The property can be applied to the Token directly as follows:
+
+```json5
+// colors.token.json
+{
+  "colors": {
+    "primary": {
+      "$value": "#000000",
+      "$extensions": {
+        "o3rPrivate": true
+      }
+    }
+  }
+}
+```
+
+or in a dedicated `.extensions.json` file (when the [o3r/json-parser/extensions](#parsers) parser is loaded):
+
+```json5
+// color.token.json
+{
+  "colors": {
+    "primary": {
+      "$value": "#000000"
+    }
+  }
+}
+```
+
+```json5
+// custom.extensions.json
+{
+  "colors.primary": {
+    "$description": "Primary private color",
+    "$extensions": {
+      "o3rPrivate": true
+    }
+  }
+}
+```
+
+### Available Otter Extensions
+
+| Extensions        | Type                                                                                                                                            | Description                                                                                                                                                                                                                                                                                         | Required hooks                                                                            |
+| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| o3rPrivate        | `boolean`                                                                                                                                       | Determine if the token is flagged as private                                                                                                                                                                                                                                                        | pre-processor: **o3r/pre-processor/extensions** <br />formatter: **o3r/css/variable**     |
+| o3rImportant      | `boolean`                                                                                                                                       | Determine if the token should be flagged as important when generated                                                                                                                                                                                                                                | pre-processor: **o3r/pre-processor/extensions** <br />formatter: **o3r/css/variable**     |
+| o3rScope          | `string`                                                                                                                                        | Scope to apply to the generated variable                                                                                                                                                                                                                                                            | pre-processor: **o3r/pre-processor/extensions** <br />formatter: **o3r/css/variable**     |
+| o3rMetadata       | [CMS Metadata](https://github.com/AmadeusITGroup/otter/blob/main/packages/%40ama-styling/style-dictionary/src/interfaces/style-dictionary.interface.mts) | Additional information to provide to the metadata if generated                                                                                                                                                                                                                                      | pre-processor: **o3r/pre-processor/extensions** <br />formatter: **o3r/json/metadata**    |
+| o3rUnit           | `string`                                                                                                                                        | Convert a numeric value from the specified unit to the new unit. It will add a unit to the tokens of type \"number\" for which the unit is not specified.<br />In the case of complex types (such as shadow, transition, etc...), the unit will be applied to all numeric types they contain.       | pre-processor: **o3r/pre-processor/extensions** <br />transforms: **o3r/transform/unit**  |
+| o3rRatio          | `number`                                                                                                                                        | Ratio to apply to the previous value. The ratio will only be applied to tokens of type \"number\" or to the first numbers determined in \"string\" like types.<br />In the case of complex types (such as shadow, transition, etc...), the ratio will be applied to all numeric types they contain. | pre-processor: **o3r/pre-processor/extensions** <br />transforms: **o3r/transform/ratio** |
+| o3rExpectOverride | `boolean`                                                                                                                                       | Indicate that the token is expected to be overridden by external rules                                                                                                                                                                                                                              | pre-processor: **o3r/pre-processor/extensions**                                           |
+
+> [!WARNING]
+> The **required hooks** need to be registered to the [Style Dictionary configuration](https://styledictionary.com/reference/config/) to fully support the extension.
+
+## Modules
+
+### [Parsers](https://styledictionary.com/reference/hooks/parsers/)
+
+| Name                           | Matching files         | Description                                                                      |
+| ------------------------------ | ---------------------- | -------------------------------------------------------------------------------- |
+| o3r/json-parser/one-line-token | `**/*.json`            | Allow *dot notation* Token in JSON file                                          |
+| o3r/json-parser/extensions     | `**/*.extensions.json` | Parse file containing `$extensions` instructions to apply on top of Design Token |
+
+### [Pre-processor](https://styledictionary.com/reference/hooks/preprocessors/)
+
+| Name                         | Description                                                                                                                                                                 |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| o3r/pre-processor/extensions | Pre-processor to add the support of the `$extensions` instructions in the Token (or dedicated `extensions.json` file). This pre-processor is mandatory for any Otter hooks. |
+
+### [Transforms](https://styledictionary.com/reference/hooks/transforms/)
+
+| Name                | Type    | Criteria                         | Description                                                                             |
+| ------------------- | ------- | -------------------------------- | --------------------------------------------------------------------------------------- |
+| o3r/transform/ratio | `value` | `o3rRatio` extension is provided | Apply the given `o3rRatio` to the numeric values of the Token(s) it refers to.          |
+| o3r/transform/unit  | `value` | `o3rUnit` extension is provided  | Replace the unit of the values of the Token(s) it refers to, by the provided `o3rUnit`. |
+
+### [Transform-groups](https://styledictionary.com/reference/hooks/transform-groups/)
+
+| Name                | Description                                                                                                                                                                       |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| o3r/css/recommended | Extend the official [CSS transform groups](https://styledictionary.com/reference/hooks/transform-groups/predefined/#css) by adding `o3r/transform/ratio` and `o3r/transform/unit` |
+
+### [Formats](https://styledictionary.com/reference/hooks/formats/)
+
+| Name              | Options                                                                                                                                 | Description                                                                                                                                                                                               |
+| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| o3r/css/variable  | See [css/variables options](https://styledictionary.com/reference/hooks/formats/predefined/#cssvariables)                               | Render CSS variable block (based on the [built-in format](https://styledictionary.com/reference/hooks/formats/predefined/#cssvariables)) supporting additional [Otter Extensions features](#enhancement). |
+| o3r/json/metadata | See [css/variables options](https://styledictionary.com/reference/hooks/formats/predefined/#cssvariables) *(applied to `defaultValue`)*<br />- **keepPrivate**: include private variables | Render [CMS style metadata](https://github.com/AmadeusITGroup/otter/blob/main/docs/styling/THEME.md).                                                                                                     |
+
+### Registration process
+
+The different hooks/modules can be registered individually via the different [register...()](https://styledictionary.com/getting-started/using_the_npm_module/) functions from `StyleDictionary` or all at once with the `register` function as follows:
+
+```typescript
+import { register, baseConfig } from '@ama-styling/style-dictionary';
+
+const sd = new StyleDictionary({
+  ...baseConfig,
+  // custom configs ...
+});
+
+register(sd); // Register all Otter modules
+```
+
+> [!IMPORTANT]
+> To be able to use any of the listed modules/hooks, they have to be registered to the `StyleDefinition` instance.
+
+> [!TIP]
+> The helper `baseConfig` will provide the minimal configuration for Otter extension support.
+
+### Helpers
+
+To enhance and facilitate the configuration of the `StyleDictionary` instance, the `@ama-styling/style-dictionary` exposes a set of helpers.
+
+#### getTargetFiles
+
+The `getTargetFiles` function is used to parameterize the generated file based on Design Token (following the same logic as `$extensions`):
+
+```typescript
+// Example to generate the `color-primary-**` variables in `my-color-primary.css`
+
+import { getTargetFiles } from '@ama-styling/style-dictionary';
+
+const rule = {
+  'color.primary': 'my-color-primary.css'
+};
+
+// or `const rule = {color: {primary: 'my-color-primary.css'}}`
+// or `const rule = {'color.primary': {$extensions: {o3rTargetFile: 'my-color-primary.css'}}}`
+// or `const rule = {'color: {primary': {$extensions: {o3rTargetFile: 'my-color-primary.css'}}}}`
+
+const sd = new StyleDictionary({
+  //...
+  plateforms: {
+    css: {
+      files: [
+        ...getTargetFiles({ rule, { format: 'css', defaultFile: 'default-file.css' } })
+      ]
+    }
+  }
+});
+
+register(sd); // Register all Otter modules
+```
+
+> [!NOTE]
+> The `format` option will be applied to all the files provided to the `getTargetFiles` function (including `defaultFile`).
+> `defaultFile` defines the default file where variables not matching any rule will be generated.
+
+## Advanced
+
+### Basic Node Configuration Example
+
+```typescript
+// style-builder.mjs
+
+import { register, getTargetFiles, baseConfiguration } from '@ama-styling/style-dictionary';
+import StyleDictionary from 'style-dictionary';
+
+// Rules to generate different CSS files according to Token name
+const fileRules = {
+  colors: 'style/colors.tokens.css',
+  'components.panel': 'components/panel/panel.tokens.css'
+}
+
+const sd = new StyleDictionary({
+  ...baseConfiguration, // Use basic Otter configuration setup
+  usesDtcg: true, // Use Design Token Standard format
+
+  source: ['tokens/*.tokens.json'], // Design Token files
+  include: ['token.extensions.json'], // Custom extensions
+
+  platforms: {
+    // Generate CSS Files
+    css: {
+      options: {
+        outputReferences: true // to output `--var: var(--other-var)` instead of the value of `--other-var`
+      },
+      transformGroup: 'o3r/css/recommended',
+      files: [
+        ...getTargetFiles(fileRules, { format: 'css' }),
+        // default CSS file where generate variables
+        { destination: 'style/default.tokens.css', format: 'css' }
+      ]
+    },
+    cms: {
+      options: {
+        outputReferences: true
+      },
+      transformGroup: 'o3r/css/recommended',
+      files: [
+        { destination: 'style.metadata.json', format: 'o3r/json/metadata' }
+      ]
+    }
+  }
+});
+
+// Register otter hooks/modules
+register(sd);
+
+if (process.env.CSS_ONLY){
+  sd.buildPlatform('css');
+} else {
+  sd.buildAllPlatforms();
+}
+```
+
+Can be run with the following command:
+
+```bash
+node ./style-builder.mjs
+```

package/collection.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://raw.githubusercontent.com/angular/angular-cli/master/packages/angular_devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Add Otter Style-Dictionary to the project.",
+      "factory": "./schematics/ng-add/index#ngAdd",
+      "schema": "./schematics/ng-add/schema.json",
+      "aliases": [
+        "install",
+        "i"
+      ]
+    }
+  }
+}

package/package.json

@@ -0,0 +1,199 @@
+{
+  "name": "@ama-styling/style-dictionary",
+  "version": "12.5.0-prerelease.10",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "typings": "./src/public_api.d.mts",
+  "main": "./src/public_api.mjs",
+  "description": "Package exposing modules and hooks for Style Dictionary",
+  "keywords": [
+    "design",
+    "otter",
+    "otter-module",
+    "style-dictionary"
+  ],
+  "scripts": {
+    "nx": "nx",
+    "ng": "yarn nx",
+    "copy:schemas": "yarn cpy 'schemas/**/*' dist/schemas",
+    "copy:templates": "yarn cpy 'schematics/**/templates/**' dist/schematics",
+    "build:builders": "tsc -b tsconfig.builders.json --pretty && yarn generate-cjs-manifest",
+    "build:source": "tsc -b tsconfig.build.json && yarn cpy package.json dist/",
+    "build": "yarn nx build design",
+    "prepare:build:builders": "yarn cpy 'schematics/**/*.json' dist/schematics && yarn cpy 'collection.json' dist && yarn copy:templates",
+    "postbuild": "patch-package-json-main"
+  },
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    "./schemas/*.json": {
+      "default": "./schemas/*.json"
+    },
+    ".": {
+      "module": "./src/public_api.mjs",
+      "typings": "./src/public_api.d.mts",
+      "default": "./src/public_api.mjs"
+    }
+  },
+  "dependencies": {
+    "@angular-devkit/architect": "~0.1902.0",
+    "@angular-devkit/schematics": "~19.2.0",
+    "@o3r/schematics": "^12.5.0-prerelease.10",
+    "@schematics/angular": "~19.2.0",
+    "tslib": "^2.6.2"
+  },
+  "peerDependencies": {
+    "@o3r/core": "^12.5.0-prerelease.10",
+    "@o3r/schematics": "^12.5.0-prerelease.10",
+    "@o3r/telemetry": "^12.5.0-prerelease.10",
+    "style-dictionary": "^4.3.2",
+    "type-fest": "^4.30.1"
+  },
+  "peerDependenciesMeta": {
+    "@o3r/core": {
+      "optional": true
+    },
+    "@o3r/schematics": {
+      "optional": true
+    },
+    "@o3r/telemetry": {
+      "optional": true
+    },
+    "chokidar": {
+      "optional": true
+    },
+    "globby": {
+      "optional": true
+    },
+    "type-fest": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@babel/core": "~7.27.0",
+    "@babel/preset-env": "~7.27.0",
+    "@babel/preset-typescript": "~7.27.0",
+    "@compodoc/compodoc": "^1.1.19",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
+    "@nx/eslint": "~20.8.0",
+    "@nx/eslint-plugin": "~20.8.0",
+    "@nx/jest": "~20.8.0",
+    "@nx/js": "~20.8.0",
+    "@o3r/build-helpers": "^12.5.0-prerelease.10",
+    "@o3r/core": "^12.5.0-prerelease.10",
+    "@o3r/eslint-plugin": "^12.5.0-prerelease.10",
+    "@o3r/telemetry": "^12.5.0-prerelease.10",
+    "@o3r/test-helpers": "^12.5.0-prerelease.10",
+    "@schematics/angular": "~19.2.0",
+    "@stylistic/eslint-plugin": "~3.1.0",
+    "@types/jest": "~29.5.2",
+    "@types/minimist": "^1.2.2",
+    "@types/node": "^20.0.0",
+    "@types/semver": "^7.3.13",
+    "@typescript-eslint/parser": "~8.34.0",
+    "angular-eslint": "~19.4.0",
+    "babel-jest": "^29.7.0",
+    "chokidar": "^4.0.3",
+    "cpy-cli": "^5.0.0",
+    "eslint": "~9.29.0",
+    "eslint-import-resolver-node": "~0.3.9",
+    "eslint-import-resolver-typescript": "~3.10.0",
+    "eslint-plugin-import": "~2.31.0",
+    "eslint-plugin-import-newlines": "~1.4.0",
+    "eslint-plugin-jest": "~28.14.0",
+    "eslint-plugin-jsdoc": "~50.8.0",
+    "eslint-plugin-prefer-arrow": "~1.2.3",
+    "eslint-plugin-unicorn": "~56.0.0",
+    "eslint-plugin-unused-imports": "~4.1.4",
+    "globals": "^15.9.0",
+    "jest": "~29.7.0",
+    "jest-junit": "~16.0.0",
+    "jest-resolve": "~29.7.0",
+    "jsonc-eslint-parser": "~2.4.0",
+    "nx": "~20.8.0",
+    "pid-from-port": "^1.1.3",
+    "style-dictionary": "~4.4.0",
+    "ts-jest": "~29.3.0",
+    "ts-node": "~10.9.2",
+    "type-fest": "^4.30.1",
+    "typescript": "~5.8.2",
+    "typescript-eslint": "~8.34.0",
+    "zone.js": "~0.15.0"
+  },
+  "engines": {
+    "node": "^20.11.1 || >=22.0.0"
+  },
+  "schematics": "./collection.json",
+  "contributors": [
+    {
+      "name": "Yannick Adam",
+      "url": "https://github.com/yannickadam",
+      "email": "yannickadam@users.noreply.github.com"
+    },
+    {
+      "name": "Kilian Panot",
+      "url": "https://github.com/kpanot",
+      "email": "kpanot@users.noreply.github.com"
+    },
+    {
+      "name": "Jeremy Bourgeois",
+      "url": "https://github.com/jbourgeois-1A",
+      "email": "jbourgeois-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Pierre Henri Ginoux",
+      "url": "https://github.com/pginoux-1A",
+      "email": "pginoux-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Mircea Vasile Rednic",
+      "url": "https://github.com/mrednic-1A",
+      "email": "mrednic-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Stephane Dalle",
+      "url": "https://github.com/sdalle-1A",
+      "email": "sdalle-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Nicolas Hoffmann",
+      "url": "https://github.com/nhoffmann-1A",
+      "email": "nhoffmann-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Victor Scaiceanu",
+      "url": "https://github.com/vscaiceanu-1a",
+      "email": "vscaiceanu-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Florian Paul",
+      "url": "https://github.com/fpaul-1A",
+      "email": "fpaul-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Corinne Paulve",
+      "url": "https://github.com/cpaulve-1A",
+      "email": "cpaulve-1A@users.noreply.github.com"
+    },
+    {
+      "name": "Matthieu Crouzet",
+      "url": "https://github.com/matthieu-crouzet",
+      "email": "matthieu-crouzet@users.noreply.github.com"
+    },
+    {
+      "name": "Salome Do",
+      "url": "https://github.com/sdo-1A",
+      "email": "sdo-1A@users.noreply.github.com"
+    }
+  ],
+  "bugs": "https://github.com/AmadeusITGroup/otter/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AmadeusITGroup/otter.git"
+  },
+  "license": "BSD-3-Clause",
+  "homepage": "https://amadeusitgroup.github.io/otter/"
+}

package/schemas/design-token.extensions.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "DesignTokenTemplateSchema",
+  "description": "Schema Describing the structure of the Design Token template, to enhance a Design Token structure",
+  "allOf": [
+    {
+      "$ref": "#/definitions/tokenTemplateGroup"
+    }
+  ],
+  "definitions": {
+    "otterExtensionMetadata": {
+      "type": "object",
+      "properties": {
+        "tags": {
+          "type": "array",
+          "description": "List of tags associated to the variable",
+          "items": {
+            "type": "string"
+          }
+        },
+        "label": {
+          "type": "string",
+          "description": "Label of the variable, it will be used to display the variable name in the CMS if specified"
+        },
+        "category": {
+          "type": "string",
+          "description": "Category of the variable"
+        },
+        "component": {
+          "type": "object",
+          "description": "Component reference if the variable is linked to one",
+          "properties": {
+            "library": {
+              "type": "string",
+              "description": "Name of the library containing the component"
+            },
+            "name": {
+              "type": "string",
+              "description": "Name of the component"
+            }
+          },
+          "required": [
+            "library",
+            "name"
+          ],
+          "additionalProperties": false
+        }
+      }
+    },
+    "otterExtension": {
+      "type": "object",
+      "properties": {
+        "o3rPrivate": {
+          "description": "Determine if the token is flagged as private",
+          "type": "boolean",
+          "default": false
+        },
+        "o3rImportant": {
+          "description": "Determine if the token should be flagged as important when generated",
+          "examples": [
+            "Css Generation of `my-var` with `o3rImportant: true` will result to `:root { --my-var: #000 !important; }`"
+          ],
+          "type": "boolean",
+          "default": false
+        },
+        "o3rScope": {
+          "description": "Scope to apply to the generated variable",
+          "examples": [
+            "Css Generation of `my-var` with `o3rScope: 'html .my-class'` will result to `:root { html .my-class { --my-var: #000; } }`"
+          ],
+          "type": "string"
+        },
+        "o3rMetadata": {
+          "description": "Additional information to provide to the metadata if generated. The metadata properties will be used only with the `o3r/<type>/metadata` formats.",
+          "$ref": "#/definitions/otterExtensionMetadata"
+        },
+        "o3rUnit": {
+          "description": "Convert a numeric value from the specified unit to the new unit. It will add a unit to the token with type \"number\" for which the unit is not specified.\nIn case of complex type (such as shadow, transition, etc...), the unit will be applied to all numeric types in it.",
+          "type": "string"
+        },
+        "o3rRatio": {
+          "description": "Ratio to apply to previous value. The ratio will be applied only on token with \"number\" type or on the first numbers determined in \"string\" like types.\nIn case of complex type (such as shadow, transition, etc...), the ratio will be applied to all numeric types in it.",
+          "type": "number"
+        },
+        "o3rExpectOverride": {
+          "description": "Indicate that the token is expected to be overridden by external rules. This is converted to the Style Dictionary themeable attribute",
+          "type": "boolean",
+          "default": false
+        }
+      }
+    },
+    "extensions": {
+      "description": "Information to enhance generation",
+      "allOf": [
+        {
+          "$ref": "#/definitions/otterExtension"
+        }
+      ]
+    },
+    "tokenTemplateGroup": {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "$description": {
+          "type": "string"
+        },
+        "$extensions": {
+          "$ref": "#/definitions/extensions"
+        }
+      },
+      "patternProperties": {
+        "^[^$.].*$": {
+          "$ref": "#/definitions/tokenTemplateGroup"
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schematics/ng-add/index.d.ts

@@ -0,0 +1,8 @@
+import { Rule } from '@angular-devkit/schematics';
+import type { NgAddSchematicsSchema } from './schema';
+/**
+ * Add Otter Style Dictionary to an Angular Project
+ * @param options
+ */
+export declare const ngAdd: (options: NgAddSchematicsSchema) => Rule;
+//# sourceMappingURL=index.d.ts.map

package/schematics/ng-add/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../schematics/ng-add/index.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,IAAI,EAGL,MAAM,4BAA4B,CAAC;AAiBpC,OAAO,KAAK,EACV,qBAAqB,EACtB,MAAM,UAAU,CAAC;AA+FlB;;;GAGG;AACH,eAAO,MAAM,KAAK,GAAI,SAAS,qBAAqB,SAA2C,CAAC"}