@endora-commerce/mod-megamenu 0.100.0

package/docs/megamenu/index.md

@@ -0,0 +1,159 @@
+---
+title: Megamenu
+sidebar_position: 1
+description: Configurable navigation tree with per-channel + per-language bindings
+---
+
+# Megamenu
+
+The Megamenu module owns the storefront's primary navigation. It introduces a configurable tree of menu items authored in the admin panel, scoped to `(sales channel × language)` pairs, and rendered server-side on Next.js with a hover-revealed full-width drop-down panel on desktop and a stacked drill-down drawer on mobile.
+
+## Entities and item kinds
+
+| Entity              | Identifier                          | Notes                                                  |
+| ------------------- | ----------------------------------- | ------------------------------------------------------ |
+| **Megamenu**        | `id` (uuid)                         | Configuration row — name, description, version.        |
+| **MegamenuItem**    | `id` (uuid) + `parentId` (self-FK)  | Adjacency-list tree node with kind-specific `target`.  |
+| **MegamenuBinding** | `(megamenuId, salesChannelId, language)` | Per-scope `active` flag enforced by a partial unique index. |
+
+The closed set of item kinds:
+
+| `kind`            | Target shape                                                          |
+| ----------------- | --------------------------------------------------------------------- |
+| `category-link`   | `{ categoryId, iconAssetId?, iconPosition? }`                         |
+| `cms-page-link`   | `{ pageId, iconAssetId?, iconPosition? }`                             |
+| `external-link`   | `{ url, iconAssetId?, iconPosition? }` (URL: `http\|https\|tel\|mailto`) |
+| `button`          | `{ url, variant: 'primary'\|'secondary'\|'ghost' }`                   |
+| `asset`           | `{ assetId, kind: 'image'\|'video' }`                                 |
+| `cms-block-embed` | `{ blockId, embedSide: 'left'\|'right' }`                             |
+
+The optional `iconAssetId` accepts only `image`-kind Library assets; the validator refuses non-image targets.
+
+## Activation contract
+
+At most one megamenu may be `active` per `(sales channel, language)` pair at any time. The DB enforces this with:
+
+```sql
+CREATE UNIQUE INDEX megamenu_bindings_active_uniq
+  ON megamenu_bindings (sales_channel_id, language)
+  WHERE active = true;
+```
+
+The activate transaction:
+
+1. `UPDATE megamenu_bindings SET active = false WHERE sales_channel_id = ? AND language = ? AND active = true;` — deactivates the prior holder (if any).
+2. `UPDATE megamenu_bindings SET active = true WHERE megamenu_id = ? AND sales_channel_id = ? AND language = ?;` — activates the requested binding.
+
+Both run in a single transaction, so the partial unique index never sees a dual-active state. The activate endpoint surfaces the prior holder in `previouslyActive` so the admin's confirmation dialog can read "switched from `<name>`".
+
+Activate refuses on an empty tree with `400 MEGAMENU_EMPTY_TREE`. Configuration delete refuses while at least one binding has `active = true` with `409 MEGAMENU_HAS_ACTIVE_BINDINGS` (admins must deactivate first).
+
+## Sales-channel + language scoping
+
+A configuration may carry many `(salesChannelId, language)` bindings. The binding endpoint refuses a language outside the channel's configured language set with `400 MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE`. Removing a binding falls back to "no megamenu" for that scope until another configuration activates.
+
+Per-language label fallback: when an item's label is missing in the requested language, the storefront resolver falls back to the channel's default language. Items with no label in either is silently omitted from the resolved tree (admin sees the warning in the editor).
+
+## Tree depth
+
+Tree depth is a UX guideline, not a hard constraint. The data model imposes no cap. The admin form surfaces a non-blocking warning past 4 levels:
+
+```
+meta.warnings: [{ code: "MEGAMENU_DEPTH_EXCEEDED", message: "..." }]
+```
+
+Save still succeeds; every level renders on the storefront.
+
+## Reference protection
+
+Megamenu items hold soft references to upstream entities (Categories, CMS Pages, CMS Blocks, Library Assets). Deletion of any of those is refused while a megamenu still references them:
+
+| Upstream entity | Registry / module                       | Match path on megamenu_items.target  |
+| --------------- | --------------------------------------- | ------------------------------------ |
+| Library Asset   | `AssetReferenceRegistry`                | `assetId` OR `iconAssetId`           |
+| CMS Page        | `CmsReferenceRegistry`                  | `kind='cms-page-link' AND pageId = ?` |
+| CMS Block       | `CmsReferenceRegistry`                  | `kind='cms-block-embed' AND blockId = ?` |
+| Category        | (catalog category-reference registry)   | `kind='category-link' AND categoryId = ?` (planned) |
+
+Each registration is a one-line surface change wired in `composition.ts`. The CMS module's existing `findBlockReferences` / `findTemplateReferences` were extended to consult external scanners; the megamenu module's `registerMegamenuCmsReferences` registers its scanner there.
+
+The category-reference registry surface is planned for the catalog module; until it lands, category-delete protection from megamenu references is enforced at the validator boundary (a megamenu cannot save an item pointing at a deleted category — the category check returns `false` and the admin sees a clear error).
+
+## Storefront resolution + Redis cache
+
+Single read endpoint:
+
+```
+GET /api/v1/megamenu/by-channel?language=<bcp-47>
+X-Sales-Channel: <channel-code>
+```
+
+The resolver:
+
+1. Looks up the active binding via the partial unique index (1 query).
+2. Reads every item under that megamenu in `(parent_id, position)` order (1 query).
+3. Walks the tree, dispatching by `kind`: resolves Category / CMS-page URLs from their slugs, signs Asset URLs through the Assets Library, inlines CMS Blocks via the CMS module's storefront resolver, populates icons.
+4. Returns the recursive `ResolvedMegamenu` payload.
+
+Resolved payloads are cached in Redis under `megamenu:v1:<channel>:<language>` with a 5-minute TTL. Invalidation:
+
+- `POST /menus`, `PATCH /menus/:id`, `PUT /menus/:id/items`, `DELETE /menus/:id` → coarse drop of `megamenu:v1:*` (one menu may serve N bindings).
+- `POST /menus/:id/bindings` / `DELETE /menus/:id/bindings/:channel/:language` → drop the affected scope.
+- `POST /menus/:id/activate` / `POST /menus/:id/deactivate` → drop the activated/deactivated scope.
+
+The cache implementation mirrors the CMS module's `CmsCache` exactly (same prefix scheme, same TTL, same SCAN-based invalidation).
+
+## Storefront rendering
+
+### Desktop
+
+Reproduces the Industria design's `.mega` panel: a full-width drop-down beneath the nav bar, opened by hover (`onMouseEnter`) and closed by `onMouseLeave`. The panel uses a 3-column grid `220px 1fr 280px` with `gap: 32px` and `padding: 28px 0`. The third column is filled by the first `cms-block-embed` child whose `embedSide === 'right'` (a `left`-side embed appears in column 1 instead, shifting the link grid right).
+
+### Mobile
+
+Burger trigger renders below `768px`. Tapping opens a stacked drill-down drawer; tapping a parent slides to the next level via component state with a "Back" affordance. Embedded CMS Blocks, Buttons, and Assets render stacked inline (no off-canvas side-by-side layout). Browser-native scroll restoration covers the "preserves scroll on parent levels" requirement.
+
+## HTTP surface
+
+### Admin (`/api/v1/admin/megamenu`)
+
+| Method  | Path                                                        | Purpose                                              |
+| ------- | ----------------------------------------------------------- | ---------------------------------------------------- |
+| GET     | `/menus`                                                    | List configurations with binding counts.             |
+| POST    | `/menus`                                                    | Create a Megamenu (no items, no bindings).           |
+| GET     | `/menus/:id`                                                | Detail with tree + bindings.                         |
+| PATCH   | `/menus/:id`                                                | Edit metadata. Honours `If-Match` via `version`.     |
+| DELETE  | `/menus/:id`                                                | Refused while any binding has `active = true`.       |
+| PUT     | `/menus/:id/items`                                          | Save the entire item tree (full overwrite).          |
+| GET     | `/menus/:id/bindings`                                       | List every binding for a configuration.              |
+| POST    | `/menus/:id/bindings`                                       | Add a `(channel, language)` binding (always staged). |
+| DELETE  | `/menus/:id/bindings/:salesChannelId/:language`             | Remove a binding (idempotent).                       |
+| POST    | `/menus/:id/activate`                                       | Atomic swap activation.                              |
+| POST    | `/menus/:id/deactivate`                                     | Deactivate a binding.                                |
+
+### Storefront (`/api/v1/megamenu`)
+
+| Method | Path                              | Returns                                                                 |
+| ------ | --------------------------------- | ----------------------------------------------------------------------- |
+| GET    | `/by-channel?language=…`          | Resolved megamenu for the requested scope; `404 MEGAMENU_NOT_FOUND` when no active binding. |
+
+## Migration from no-megamenu
+
+The migration `036_megamenu_init.ts` adds three new tables and the partial unique index. There are no seeded rows; first-time admins create a configuration through the admin UI.
+
+Mounted in the storefront's root layout between `<Header>` and the existing `header.bottom` Hook. The CMS Hooks integration is unaffected.
+
+## Error codes
+
+`MEGAMENU_NOT_FOUND`, `MEGAMENU_HAS_ACTIVE_BINDINGS`, `MEGAMENU_EMPTY_TREE`, `MEGAMENU_BINDING_NOT_FOUND`, `MEGAMENU_BINDING_ALREADY_EXISTS`, `MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE`, `MEGAMENU_TARGET_OUT_OF_SCOPE`, `MEGAMENU_ASSET_KIND_MISMATCH`, `MEGAMENU_REFERENCED`, `MEGAMENU_DEPTH_EXCEEDED`.
+
+All envelopes follow the platform-wide error contract in `packages/contracts/src/errors.ts`.
+
+## Out of scope (v1)
+
+- Per-customer-group / per-organization megamenu variants.
+- A/B testing of menu variants.
+- An admin "preview without publishing" surface.
+- Item URL targets that point directly at product PDPs (use a Category link or an External link).
+- Free-URL asset items: a server-side `importFromUrl` on the Assets Library is the natural home for fetching, validating, and storing externally-sourced bytes; the Megamenu module's validator refuses free-URL asset items until that surface lands. Admins upload the asset via the Library first and reference it by id.
+- Drag-and-drop tree authoring in the admin: the v1 editor uses up/down/delete/add-child arrow controls. `@dnd-kit` is not bundled in the admin app and the brief's emphasis is on tree editing, not gesture sophistication.

package/i18n/en.json

@@ -0,0 +1,96 @@
+{
+  "assetKind.image": "Image",
+  "assetKind.video": "Video",
+  "bindings.activate": "Activate",
+  "bindings.activatedWithPrevious": "Activated. Previously active megamenu in this scope: \"{name}\" (deactivated automatically).",
+  "bindings.add": "Add binding",
+  "bindings.deactivate": "Deactivate",
+  "bindings.empty": "No bindings yet - add one to publish this megamenu to a storefront scope.",
+  "bindings.languagePlaceholder": "Language...",
+  "bindings.salesChannelPlaceholder": "Sales channel...",
+  "columns.actions": "Actions",
+  "columns.active": "Active",
+  "columns.bindings": "Bindings",
+  "columns.channel": "Channel",
+  "columns.language": "Language",
+  "columns.name": "Name",
+  "columns.version": "Version",
+  "common.back": "Back",
+  "common.create": "Create",
+  "common.loading": "Loading...",
+  "common.moveDown": "Move down",
+  "common.moveUp": "Move up",
+  "common.saveMetadata": "Save metadata",
+  "common.saveTree": "Save tree",
+  "editor.description": "Author the navigation tree, scope it to (channel, language), activate it.",
+  "editor.fallbackTitle": "Megamenu",
+  "editor.newItemLabel": "New item",
+  "fields.assetId": "Asset id",
+  "fields.categoryId": "Category id",
+  "fields.cmsBlockId": "CMS block id",
+  "fields.cmsPageId": "CMS page id",
+  "fields.description": "Description",
+  "fields.embedSide": "Embed side",
+  "fields.kind": "Kind",
+  "fields.labelsPerLanguage": "Labels (per language)",
+  "fields.linkTarget": "Link target",
+  "fields.name": "Name",
+  "fields.url": "URL",
+  "fields.variant": "Variant",
+  "itemConfig.addBindingFirst": "Add a binding first - the tree's labels are scoped to the languages of the megamenu's bindings.",
+  "itemConfig.empty": "Select a menu item from the tree (or add one) to edit its fields.",
+  "itemConfig.labelPlaceholder": "Label in {language}",
+  "itemKind.asset": "Asset",
+  "itemKind.button": "Button",
+  "itemKind.categoryLink": "Category link",
+  "itemKind.cmsBlockEmbed": "CMS block embed",
+  "itemKind.cmsPageLink": "CMS page link",
+  "itemKind.externalLink": "External link",
+  "list.activeScopes": "{count} scopes",
+  "list.cardTitle": "Configurations",
+  "list.description": "Storefront navigation configurations. One active megamenu per (sales channel x language) at a time.",
+  "list.empty": "No megamenus yet.",
+  "list.newNamePlaceholder": "New megamenu name",
+  "list.title": "Megamenu",
+  "placeholders.assetUuid": "Library asset UUID",
+  "placeholders.categoryUuid": "Category UUID",
+  "placeholders.cmsBlockUuid": "CMS block UUID",
+  "placeholders.cmsPageUuid": "CMS page UUID",
+  "placeholders.externalUrl": "https://example.com / tel:+48... / mailto:...",
+  "sections.bindings": "Bindings",
+  "sections.item": "Item",
+  "sections.items": "Items",
+  "sections.metadata": "Metadata",
+  "side.left": "Left",
+  "side.right": "Right",
+  "state.active": "active",
+  "state.staged": "staged",
+  "tree.addChild": "Add child item",
+  "tree.addTopLevel": "Add top-level item",
+  "tree.deleteItem": "Delete item",
+  "tree.empty": "No items yet - add one above.",
+  "tree.noLabel": "(no label)",
+  "tree.title": "Tree",
+  "treeKind.asset": "Asset",
+  "treeKind.button": "Button",
+  "treeKind.category-link": "Category",
+  "treeKind.cms-block-embed": "Block embed",
+  "treeKind.cms-page-link": "CMS Page",
+  "treeKind.external-link": "External link",
+  "variant.ghost": "Ghost",
+  "variant.primary": "Primary",
+  "variant.secondary": "Secondary",
+  "actions.editMegamenu.label": "Edit megamenu",
+  "actions.editMegamenu.description": "Configure the storefront navigation menu",
+  "errors.MEGAMENU_NOT_FOUND": "Megamenu Not Found.",
+  "errors.MEGAMENU_HAS_ACTIVE_BINDINGS": "Megamenu Has Active Bindings.",
+  "errors.MEGAMENU_EMPTY_TREE": "Megamenu Empty Tree.",
+  "errors.MEGAMENU_BINDING_NOT_FOUND": "Megamenu Binding Not Found.",
+  "errors.MEGAMENU_BINDING_ALREADY_EXISTS": "Megamenu Binding Already Exists.",
+  "errors.MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE": "Megamenu Language Not In Channel Scope.",
+  "errors.MEGAMENU_TARGET_OUT_OF_SCOPE": "Megamenu Target Out Of Scope.",
+  "errors.MEGAMENU_ASSET_KIND_MISMATCH": "Megamenu Asset Kind Mismatch.",
+  "errors.MEGAMENU_REFERENCED": "Megamenu Referenced.",
+  "errors.MEGAMENU_DEPTH_EXCEEDED": "Megamenu Depth Exceeded.",
+  "nav.megamenu.label": "Megamenu"
+}

package/i18n/pl.json

@@ -0,0 +1,96 @@
+{
+  "assetKind.image": "Obraz",
+  "assetKind.video": "Wideo",
+  "bindings.activate": "Aktywuj",
+  "bindings.activatedWithPrevious": "Aktywowano. Poprzednio aktywne megamenu w tym zakresie: \"{name}\" (automatycznie dezaktywowane).",
+  "bindings.add": "Dodaj powiązanie",
+  "bindings.deactivate": "Dezaktywuj",
+  "bindings.empty": "Brak powiązań - dodaj jedno, aby opublikować megamenu w zakresie sklepu.",
+  "bindings.languagePlaceholder": "Język...",
+  "bindings.salesChannelPlaceholder": "Kanał sprzedaży...",
+  "columns.actions": "Akcje",
+  "columns.active": "Aktywne",
+  "columns.bindings": "Powiązania",
+  "columns.channel": "Kanał",
+  "columns.language": "Język",
+  "columns.name": "Nazwa",
+  "columns.version": "Wersja",
+  "common.back": "Wróć",
+  "common.create": "Utwórz",
+  "common.loading": "Ładowanie...",
+  "common.moveDown": "Przesuń w dół",
+  "common.moveUp": "Przesuń w górę",
+  "common.saveMetadata": "Zapisz metadane",
+  "common.saveTree": "Zapisz drzewo",
+  "editor.description": "Twórz drzewo nawigacji, przypisz je do zakresu (kanał, język) i aktywuj.",
+  "editor.fallbackTitle": "Megamenu",
+  "editor.newItemLabel": "Nowy element",
+  "fields.assetId": "ID zasobu",
+  "fields.categoryId": "ID kategorii",
+  "fields.cmsBlockId": "ID bloku CMS",
+  "fields.cmsPageId": "ID strony CMS",
+  "fields.description": "Opis",
+  "fields.embedSide": "Strona osadzenia",
+  "fields.kind": "Typ",
+  "fields.labelsPerLanguage": "Etykiety (na język)",
+  "fields.linkTarget": "Cel linku",
+  "fields.name": "Nazwa",
+  "fields.url": "URL",
+  "fields.variant": "Wariant",
+  "itemConfig.addBindingFirst": "Najpierw dodaj powiązanie - etykiety drzewa są ograniczone do języków powiązań megamenu.",
+  "itemConfig.empty": "Wybierz element menu z drzewa (albo dodaj nowy), aby edytować jego pola.",
+  "itemConfig.labelPlaceholder": "Etykieta w {language}",
+  "itemKind.asset": "Zasób",
+  "itemKind.button": "Przycisk",
+  "itemKind.categoryLink": "Link do kategorii",
+  "itemKind.cmsBlockEmbed": "Osadzony blok CMS",
+  "itemKind.cmsPageLink": "Link do strony CMS",
+  "itemKind.externalLink": "Link zewnętrzny",
+  "list.activeScopes": "{count} zakresów",
+  "list.cardTitle": "Konfiguracje",
+  "list.description": "Konfiguracje nawigacji sklepu. Jedno aktywne megamenu na raz dla pary (kanał sprzedaży x język).",
+  "list.empty": "Brak megamenu.",
+  "list.newNamePlaceholder": "Nazwa nowego megamenu",
+  "list.title": "Megamenu",
+  "placeholders.assetUuid": "UUID zasobu z biblioteki",
+  "placeholders.categoryUuid": "UUID kategorii",
+  "placeholders.cmsBlockUuid": "UUID bloku CMS",
+  "placeholders.cmsPageUuid": "UUID strony CMS",
+  "placeholders.externalUrl": "https://example.com / tel:+48... / mailto:...",
+  "sections.bindings": "Powiązania",
+  "sections.item": "Element",
+  "sections.items": "Elementy",
+  "sections.metadata": "Metadane",
+  "side.left": "Lewa",
+  "side.right": "Prawa",
+  "state.active": "aktywne",
+  "state.staged": "robocze",
+  "tree.addChild": "Dodaj element podrzędny",
+  "tree.addTopLevel": "Dodaj element główny",
+  "tree.deleteItem": "Usuń element",
+  "tree.empty": "Brak elementów - dodaj jeden powyżej.",
+  "tree.noLabel": "(brak etykiety)",
+  "tree.title": "Drzewo",
+  "treeKind.asset": "Zasób",
+  "treeKind.button": "Przycisk",
+  "treeKind.category-link": "Kategoria",
+  "treeKind.cms-block-embed": "Osadzony blok",
+  "treeKind.cms-page-link": "Strona CMS",
+  "treeKind.external-link": "Link zewnętrzny",
+  "variant.ghost": "Ghost",
+  "variant.primary": "Primary",
+  "variant.secondary": "Secondary",
+  "actions.editMegamenu.label": "Edytuj megamenu",
+  "actions.editMegamenu.description": "Skonfiguruj menu nawigacji witryny",
+  "errors.MEGAMENU_NOT_FOUND": "Błąd: megamenu not found.",
+  "errors.MEGAMENU_HAS_ACTIVE_BINDINGS": "Błąd: megamenu has active bindings.",
+  "errors.MEGAMENU_EMPTY_TREE": "Błąd: megamenu empty tree.",
+  "errors.MEGAMENU_BINDING_NOT_FOUND": "Błąd: megamenu binding not found.",
+  "errors.MEGAMENU_BINDING_ALREADY_EXISTS": "Błąd: megamenu binding already exists.",
+  "errors.MEGAMENU_LANGUAGE_NOT_IN_CHANNEL_SCOPE": "Błąd: megamenu language not in channel scope.",
+  "errors.MEGAMENU_TARGET_OUT_OF_SCOPE": "Błąd: megamenu target out of scope.",
+  "errors.MEGAMENU_ASSET_KIND_MISMATCH": "Błąd: megamenu asset kind mismatch.",
+  "errors.MEGAMENU_REFERENCED": "Błąd: megamenu referenced.",
+  "errors.MEGAMENU_DEPTH_EXCEEDED": "Błąd: megamenu depth exceeded.",
+  "nav.megamenu.label": "Megamenu"
+}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@endora-commerce/mod-megamenu",
+  "version": "0.100.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Multi-column dropdown navigation builder.",
+  "license": "MIT",
+  "endora": {
+    "type": "module",
+    "id": "megamenu"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/modules/megamenu"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
+    },
+    "./migrations": {
+      "types": "./dist/migrations/index.d.ts",
+      "default": "./dist/migrations/index.js"
+    },
+    "./admin": {
+      "types": "./dist/admin/index.d.ts",
+      "default": "./dist/admin/index.js"
+    },
+    "./tailwind.css": "./tailwind.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "i18n",
+    "docs",
+    "tailwind.css"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "peerDependencies": {
+    "@mikro-orm/core": "^6",
+    "@mikro-orm/migrations": "^6",
+    "@mikro-orm/postgresql": "^6",
+    "fastify": "^5",
+    "ioredis": "^5",
+    "lucide-react": "^1",
+    "react": "^19",
+    "react-router-dom": "^7",
+    "@endora-commerce/admin-kit": "0.100.0",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "peerDependenciesMeta": {
+    "@endora-commerce/admin-kit": {
+      "optional": true
+    },
+    "lucide-react": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-router-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mikro-orm/core": "^6.6.13",
+    "@mikro-orm/migrations": "^6.6.13",
+    "@mikro-orm/postgresql": "^6.6.13",
+    "@types/node": "^22.9.0",
+    "@types/react": "^19.2.14",
+    "fastify": "^5.12.5",
+    "ioredis": "^5.10.1",
+    "lucide-react": "^1.11.0",
+    "react": "^19.2.5",
+    "react-router-dom": "^7.18.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11",
+    "@endora-commerce/admin-kit": "0.100.0",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsc -p tsconfig.ui.json",
+    "typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.ui.json --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  }
+}

package/tailwind.css

@@ -0,0 +1,14 @@
+/* @endora-commerce/mod-megamenu — AUTO-GENERATED by `pnpm --filter backend run manifests:generate`.
+ *
+ * The `@source` directives this package asks its host to scan
+ * (`specs/110-instance-repository/contracts/admin-stylesheet-composition.md` R1).
+ * They resolve relative to **this file**, so they hold wherever the package is
+ * installed — a workspace link here, `node_modules` in a client's instance.
+ *
+ * The `dist` line is what a published tarball ships and is what an instance
+ * scans; the `src` line is inert there and is what keeps `pnpm --filter admin
+ * run dev` reading source in this repository. Do not edit: run
+ * `pnpm --filter backend run manifests:generate`.
+ */
+@source "./dist/admin";
+@source "./src/admin";