@payfit/unity-components 2.55.22 → 2.55.23

package/dist/esm/docs/reference/catalog/catalog.generated.d.ts

@@ -13,7 +13,7 @@ export declare const catalogEntries: ({
     };
     related: never[];
     section: "components";
-    tags: ("type:component" | "type:primitive" | "category:foundations")[];
+    tags: ("type:component" | "category:actions" | "category:tabular-data")[];
     title: string;
     principal?: undefined;
 } | {
@@ -31,7 +31,7 @@ export declare const catalogEntries: ({
     };
     related: never[];
     section: "components";
-    tags: ("type:component" | "category:actions" | "category:tabular-data")[];
+    tags: ("type:component" | "type:primitive" | "category:foundations")[];
     title: string;
     principal?: undefined;
 } | {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payfit/unity-components",
-  "version": "2.55.22",
+  "version": "2.55.23",
   "module": "./dist/esm/index.js",
   "type": "module",
   "sideEffects": false,
@@ -50,18 +50,21 @@
       }
     },
     "./i18n/*.json": "./i18n/*.json",
+    "./agent-references/*": "./src/agent-references/*",
     "./package.json": "./package.json"
   },
   "files": [
     "dist",
     "i18n",
-    "skills"
+    "skills",
+    "src/agent-references"
   ],
   "dependencies": {
     "@formatjs/intl": "4.1.12",
     "@hookform/devtools": "4.4.0",
     "@hookform/resolvers": "5.2.1",
     "@internationalized/date": "3.12.2",
+    "minimatch": "10.2.5",
     "@radix-ui/react-avatar": "1.2.2",
     "@radix-ui/react-slot": "1.3.0",
     "@react-aria/interactions": "3.28.1",
@@ -93,7 +96,7 @@
     "tailwind-variants": "3.2.2",
     "usehooks-ts": "3.1.1",
     "zod": "4.4.3",
-    "@payfit/unity-illustrations": "2.55.22"
+    "@payfit/unity-illustrations": "2.55.23"
   },
   "peerDependencies": {
     "@hookform/devtools": "^4",
@@ -105,8 +108,8 @@
     "react-hook-form": "^7",
     "react-router-dom": "^5",
     "zod": "^3 || ^4",
-    "@payfit/unity-icons": "2.55.22",
-    "@payfit/unity-themes": "2.55.22"
+    "@payfit/unity-icons": "2.55.23",
+    "@payfit/unity-themes": "2.55.23"
   },
   "devDependencies": {
     "@figma/code-connect": "1.4.9",
@@ -156,10 +159,10 @@
     "@payfit/hr-apps-tsconfigs": "0.0.0-use.local",
     "@payfit/storybook-addon-console-errors": "0.0.0-use.local",
     "@payfit/storybook-config": "0.0.0-use.local",
-    "@payfit/unity-icons": "2.55.22",
-    "@payfit/unity-illustrations": "2.55.22",
-    "@payfit/vite-configs": "0.0.0-use.local",
-    "@payfit/unity-themes": "2.55.22"
+    "@payfit/unity-icons": "2.55.23",
+    "@payfit/unity-illustrations": "2.55.23",
+    "@payfit/unity-themes": "2.55.23",
+    "@payfit/vite-configs": "0.0.0-use.local"
   },
   "peerDependenciesMeta": {
     "@hookform/devtools": {

package/skills/unity-find-component/SKILL.md

@@ -9,23 +9,34 @@ metadata:
   type: core
   library: '@payfit/unity-components'
   library_version: '2.x'
-sources:
-  - 'PayFit/hr-apps:libs/shared/unity/components/src/index.ts'
-  - 'PayFit/hr-apps:libs/shared/unity/icons/src/components/icon/parts/IconSprite.tsx'
-  - 'PayFit/hr-apps:libs/shared/unity/icons/src/generated/index.ts'
-  - 'PayFit/hr-apps:libs/shared/unity/components/OVERVIEW.md'
-  - 'PayFit/hr-apps:AGENTS.md'
 ---
 
 Routing skill for selecting a Unity component before writing UI code. Walk
 the catalog, then the decision tree, then the commonly-confused pairs.
 
-## Component Catalog
+## Component catalog
 
-Inspect the current exports in `src/index.ts`, then use the decision tree below.
-For a categorized catalog of commonly used exports, read
-[references/component-catalog.md](references/component-catalog.md) only when
-component discovery requires it.
+Inspect the canonical [component catalog](../../src/agent-references/component-catalog.json)
+before searching component source. It contains exact component ids, titles,
+descriptions, keywords, sections, tags, related entries, and Storybook preview
+metadata. There is no separate canonical Markdown catalog.
+
+For a targeted lookup, search the full JSON and compare all plausible matches. Use whatever reliable local search tool is available (for example `rg`, a JSON-aware CLI, or a short Node script); do not assume `jq` is installed:
+
+```sh
+rg -i -C 2 'dialog|confirmation|modal' \
+  libs/shared/unity/components/src/agent-references/component-catalog.json
+```
+
+## Standard operating procedure
+
+1. Extract the user's intent and expand it into synonyms, interaction patterns, and adjacent component terms.
+2. Search the complete catalog; do not stop at the first slice or plausible hit.
+3. Rank candidates by intent fit, description, keywords, tags, section, and related entries.
+4. Return the best match first. Mention an alternative only when the evidence is genuinely ambiguous.
+5. Search `libs/shared/unity/components/src` to confirm implementation details or locate nearby source.
+6. Inspect Storybook stories only for props, API details, or usage examples after a likely component has been identified. When the Storybook MCP is available, use its curated component manifest or matching Storybook entry as a complementary source for rendered examples; the canonical JSON catalog remains the source of truth for discovery.
+7. Walk the decision tree below before creating a custom primitive.
 
 ## Decision Tree
 

package/skills/unity-layout-and-styling/SKILL.md

@@ -21,6 +21,14 @@ sources:
 Layout primitives, the `uy:` utility-class system, and the variant/merge tools
 used inside `@payfit/unity-components`.
 
+## Token lookup SOP
+
+Before adding a token-based utility, search the canonical [Unity token catalog](../../../themes/src/agent-references/tokens-catalog.json).
+Use its exact `name` and `cssVariable`, then consult the generated theme
+blueprints under `../../../themes/src/storybook-mcp/` for common class
+patterns. Do not infer token names from raw DTCG paths or standard Tailwind
+conventions when the catalog can provide the transformed name.
+
 ## Setup
 
 ```tsx