@payfit/unity-illustrations 2.55.22 → 2.56.0

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "@payfit/unity-illustrations",
-  "version": "2.55.22",
+  "version": "2.56.0",
   "module": "./dist/esm/index.js",
   "type": "module",
   "sideEffects": false,
   "storybook": {
     "url": "https://unity-illustrations.payfit.io/"
   },
+  "intent": {
+    "version": 1,
+    "repo": "PayFit/hr-apps",
+    "docs": "../../../../apps/shared/docsite/src/content/docs"
+  },
   "exports": {
     ".": {
       "import": {
@@ -37,7 +42,9 @@
   },
   "files": [
     "dist",
-    "src"
+    "skills",
+    "src/agent-references",
+    "src/generated"
   ],
   "dependencies": {
     "image-size": "1.0.2",
@@ -65,12 +72,12 @@
     "@payfit/hr-app-eslint": "0.0.0-use.local",
     "@payfit/hr-apps-tsconfigs": "0.0.0-use.local",
     "@payfit/storybook-config": "0.0.0-use.local",
-    "@payfit/unity-themes": "2.55.22",
+    "@payfit/unity-themes": "2.56.0",
     "@payfit/vite-configs": "0.0.0-use.local"
   },
   "peerDependencies": {
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "@payfit/unity-themes": "2.55.22"
+    "@payfit/unity-themes": "2.56.0"
   }
 }

package/skills/unity-illustrations/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: unity-illustrations
+description: Use when selecting a Unity illustration or animation, checking its category and asset type, or choosing eager versus lazy loading. Search the canonical illustration catalog first and inspect source usage only when needed.
+metadata:
+  type: core
+  library: '@payfit/unity-illustrations'
+---
+
+## Source of truth
+
+Read [src/agent-references/illustrations-catalog.json](../../src/agent-references/illustrations-catalog.json) first. Each entry contains `name`, `category`, `assetType`, and `qualifiedEagerImport`. The catalog is the authoritative index; the Storybook MCP projection is a secondary presentation of the same data.
+
+Search the complete catalog and compare plausible matches:
+
+```sh
+jq '.illustrations[] | select(.name | test("empty|success"; "i"))' \
+  libs/shared/unity/illustrations/src/agent-references/illustrations-catalog.json
+```
+
+## Standard operating procedure
+
+1. Extract the visual intent and expand it into synonyms and adjacent concepts.
+2. Search the full catalog; do not stop at the first plausible result.
+3. Rank matches by semantic fit, `category`, and `assetType`. Distinguish static pictures from animations.
+4. For eager loading, use the catalog's `qualifiedEagerImport` verbatim and pass the imported asset to `Illustration`.
+5. Prefer `LazyIllustration` with the catalog `name` when the artwork is not immediately visible or should be code-split.
+6. Read `src/docs/1-Introduction/3-Usage.mdx` and the component source only when props, loading behavior, or accessibility details are needed.
+7. Always provide meaningful `alt` text for non-decorative artwork. Use `isDecorative` only when the image conveys no information.
+
+```tsx
+import { Illustration, LazyIllustration } from '@payfit/unity-illustrations'
+import Accounting from '@payfit/unity-illustrations/assets/Accounting'
+;<>
+  <Illustration variant="picture" src={Accounting} alt="Accounting" />
+  <LazyIllustration variant="picture" name="Accounting" alt="Accounting" />
+</>
+```
+
+For broader browsing, use the [static illustration catalog](https://unity-illustrations.payfit.io/?path=/docs/reference-find-my-illustration--docs) or [animation catalog](https://unity-illustrations.payfit.io/?path=/docs/reference-find-my-animation--docs).