@payfit/unity-themes 2.55.22 → 2.55.23

package/dist/esm/scripts/style-dictionary-config.d.ts

@@ -0,0 +1,14 @@
+import { default as StyleDictionary } from 'style-dictionary';
+export declare const sharedTransforms: string[];
+export declare const sharedLogConfig: {
+    readonly warnings: "warn";
+    readonly verbosity: "verbose";
+    readonly errors: {
+        readonly brokenReferences: "throw";
+    };
+};
+export declare const createThemeStyleDictionary: ({ projectRoot, theme, }: {
+    projectRoot: string;
+    theme: "legacy" | "rebrand";
+}) => StyleDictionary;
+export default StyleDictionary;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payfit/unity-themes",
-  "version": "2.55.22",
+  "version": "2.55.23",
   "main": "./dist/esm/index.js",
   "types": "./dist/esm/index.d.ts",
   "style": "./dist/css/unity.css",
@@ -8,11 +8,17 @@
   "files": [
     "dist",
     "tokens",
-    "src"
+    "skills",
+    "src/agent-references"
   ],
   "storybook": {
     "url": "https://unity-theme.payfit.io/"
   },
+  "intent": {
+    "version": 1,
+    "repo": "PayFit/hr-apps",
+    "docs": "../../../../apps/shared/docsite/src/content/docs"
+  },
   "exports": {
     ".": {
       "import": {
@@ -83,5 +89,8 @@
     "tailwind-merge": "3.6.0",
     "tailwind-variants": "3.2.2",
     "tailwindcss": "4.3.3"
-  }
+  },
+  "keywords": [
+    "tanstack-intent"
+  ]
 }

package/skills/unity-themes/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: unity-themes
+description: >
+  Use when selecting a Unity design token, resolving a token reference or CSS
+  variable, or writing uy: utility classes. Search the canonical token catalog
+  first and use the generated class blueprints only for class syntax.
+metadata:
+  type: core
+  library: '@payfit/unity-themes'
+---
+
+## Source order
+
+1. Read [src/agent-references/tokens-catalog.json](../../src/agent-references/tokens-catalog.json) for exact catalog names, CSS variables, token families, resolved legacy/rebrand values, and references.
+2. If the match is ambiguous or the raw definition is needed, inspect the DTCG files under `tokens/`.
+3. For utility-class syntax and common blueprints, inspect the generated projections under `src/storybook-mcp/` (for example `semantic-surface-colors.mdx`). These files are optimized guides, not the canonical token index.
+
+Targeted lookup example:
+
+```sh
+jq '.tokens[] | select(.name | test("border-neutral"; "i"))' \
+  libs/shared/unity/themes/src/agent-references/tokens-catalog.json
+```
+
+## Standard operating procedure
+
+1. Classify the request as a token name, CSS variable, generated class, resolved value, or design-intent question.
+2. Search the entire catalog and compare exact semantic matches before considering primitives.
+3. Use the catalog's `name` and `cssVariable`; do not reconstruct names from the DTCG path when a transform may have changed them.
+4. Preserve token references. Inspect `values.legacy` and `values.rebrand` to understand theme-specific resolution, and inspect `references` when explaining an alias.
+5. For classes, use the generated `src/storybook-mcp` blueprint for the relevant family and substitute only a catalog-confirmed token name. Do not enumerate or invent the complete class space.
+6. Prefer semantic tokens for product UI. Use primitives only when the intent has no semantic equivalent or the user explicitly asks for a raw palette value.
+7. Keep the `uy:` prefix on every Unity utility class and use `uyMerge`/`uyTv` from `@payfit/unity-themes` when composing classes or variants.
+
+```tsx
+<div className="uy:bg-surface-primary uy:text-content-primary" />
+```
+
+Never assume that a plausible Tailwind name exists. If it is not represented by the catalog or an applicable blueprint, keep searching or state that no confirmed class was found.
+
+Prefer semantic tokens over primitive values and use the `uy:` prefix for Tailwind utilities. Do not invent utility names or expand the full class space; consult the catalog and use the semantic family that matches the element's role.

package/src/agent-references/manifest.json

@@ -0,0 +1,16 @@
+{
+  "package": "@payfit/unity-themes",
+  "generatedBy": "@payfit/nx-tools:sync-unity-agent-references",
+  "references": [
+    {
+      "id": "tokens",
+      "title": "Unity raw token catalog",
+      "description": "Style Dictionary-resolved Unity tokens with transformed names, CSS variables, and DTCG reference metadata.",
+      "format": "json",
+      "path": "./tokens-catalog.json",
+      "contentType": "application/json",
+      "useFor": ["token lookup", "theme selection", "styling"],
+      "sources": ["tokens/**/*.json", "src/scripts/style-dictionary-config.ts"]
+    }
+  ]
+}