@vadimcomanescu/nadicode-design-system 2.0.7 → 2.0.8

package/contracts/consumer-contract.json

@@ -0,0 +1,178 @@
+{
+  "schemaVersion": "1.0.0",
+  "generatedAt": "2026-03-26T09:55:16.565Z",
+  "package": {
+    "name": "@vadimcomanescu/nadicode-design-system",
+    "version": "2.0.8",
+    "distributionModel": "package-backed",
+    "install": {
+      "canonicalStrategy": "exact-version-package-install",
+      "exactVersionPattern": "@vadimcomanescu/nadicode-design-system@<exact-version>",
+      "unpublishedLocalFallbackPattern": "file:.nadicode/packages/vadimcomanescu-nadicode-design-system-<version>.tgz",
+      "disallowedStrategies": [
+        "live repo directory installs",
+        "absolute machine path installs",
+        "parent-directory file: installs"
+      ]
+    }
+  },
+  "entrypoints": {
+    "machineReadable": {
+      "consumerContract": {
+        "exportSubpath": "./consumer-contract",
+        "relativePath": "contracts/consumer-contract.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Single machine-readable entrypoint for agent and scaffold consumers."
+      },
+      "catalog": {
+        "exportSubpath": "./catalog",
+        "relativePath": "dist/catalog.json",
+        "schemaVersion": "1.1.0",
+        "purpose": "Component and block metadata with stable export paths."
+      },
+      "publicSurfaceRegistry": {
+        "exportSubpath": "./public-surface-registry",
+        "relativePath": "contracts/public-surface-registry.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Stable public package surface and props schema references."
+      },
+      "blockPropsSchemas": {
+        "exportSubpath": "./block-props-schemas",
+        "relativePath": "contracts/block-props-schemas.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Block props metadata referenced by the registry."
+      },
+      "componentPropsSchemas": {
+        "exportSubpath": "./component-props-schemas",
+        "relativePath": "contracts/component-props-schemas.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Component props metadata referenced by the registry."
+      },
+      "pageKitPropsSchemas": {
+        "exportSubpath": "./page-kit-props-schemas",
+        "relativePath": "contracts/page-kit-props-schemas.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Page-kit props metadata referenced by the registry."
+      },
+      "consumerIntentMap": {
+        "exportSubpath": "./consumer-intent-map",
+        "relativePath": "contracts/consumer-intent-map.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Page-intent contract for scaffold-safe route ownership."
+      },
+      "messageCatalogContract": {
+        "exportSubpath": "./message-catalog-contract",
+        "relativePath": "contracts/message-catalog-contract.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "DS message ownership and locale catalog contract."
+      },
+      "specManifest": {
+        "exportSubpath": "./spec-manifest",
+        "relativePath": "contracts/spec-manifest.json",
+        "schemaVersion": "1.0.0",
+        "purpose": "Spec inventory for the maintained feature contract set."
+      }
+    },
+    "operationalDelegates": {
+      "dsCheck": {
+        "exportSubpath": "./ds-check",
+        "relativePath": "scripts/ds-check.mjs",
+        "purpose": "Consumer app contract verification delegate."
+      },
+      "dsUpdate": {
+        "exportSubpath": "./ds-update",
+        "relativePath": "scripts/ds-update.mjs",
+        "purpose": "Consumer package reinstall delegate."
+      }
+    },
+    "humanGuidance": {
+      "syncedSkillContractPath": ".agents/skills/seed/contract.md",
+      "scaffoldProcessDocPath": "docs/nadicode/SCAFFOLDING_PROCESS.md"
+    }
+  },
+  "ownership": {
+    "packageOwns": [
+      "Published components, blocks, page kits, tokens, and helpers.",
+      "Machine-readable contract artifacts exported from the installed package.",
+      "ESLint rules, Tailwind preset, and DS-owned locale catalogs.",
+      "Bundled synced Seed skill and agent contract guidance."
+    ],
+    "showcaseOwns": [
+      "src/app/* route runtime and showcase-only page composition.",
+      "src/i18n/* next-intl runtime wiring for the in-repo app.",
+      "Visual verification surfaces and local showcase state fixtures."
+    ],
+    "consumerAppOwns": [
+      {
+        "path": "src/app/globals.css",
+        "purpose": "Consumer-owned global runtime styles.",
+        "contract": "Must import @vadimcomanescu/nadicode-design-system/tokens.css before app palette overrides."
+      },
+      {
+        "path": "tailwind.config.*",
+        "purpose": "Consumer-owned Tailwind binding.",
+        "contract": "Must default-export the imported @vadimcomanescu/nadicode-design-system/tailwind preset result."
+      },
+      {
+        "path": "eslint.config.*",
+        "purpose": "Consumer-owned ESLint binding.",
+        "contract": "Must use the imported @vadimcomanescu/nadicode-design-system/eslint-config and eslint-plugin bindings."
+      },
+      {
+        "path": "src/components/providers.tsx",
+        "purpose": "Consumer-owned React provider composition.",
+        "contract": "Must wrap app runtime with the package ThemeProvider."
+      },
+      {
+        "path": "src/i18n/request.ts",
+        "purpose": "Consumer-owned next-intl request wiring.",
+        "contract": "Must merge app locale catalogs with package-backed DS message catalogs via mergeSeedMessages."
+      },
+      {
+        "path": "messages/<locale>.json",
+        "purpose": "Consumer-owned locale catalogs.",
+        "contract": "Must remain app-owned JSON catalogs, not repo-local seed-messages copies."
+      },
+      {
+        "path": "scripts/ds-check.mjs",
+        "purpose": "Consumer-owned delegate wrapper.",
+        "contract": "Must delegate to @vadimcomanescu/nadicode-design-system/ds-check."
+      },
+      {
+        "path": "scripts/ds-update.mjs",
+        "purpose": "Consumer-owned delegate wrapper.",
+        "contract": "Must delegate to @vadimcomanescu/nadicode-design-system/ds-update."
+      },
+      {
+        "path": "tsconfig.json",
+        "purpose": "Consumer-owned TypeScript runtime config.",
+        "contract": "Must keep baseUrl='.' and paths['@/*']=['./src/*'] for Seed consumer imports."
+      }
+    ]
+  },
+  "derivedFrom": {
+    "publicSurfaceRegistry": {
+      "relativePath": "contracts/public-surface-registry.json",
+      "stableEntryCount": 436
+    },
+    "consumerIntentMap": {
+      "relativePath": "contracts/consumer-intent-map.json",
+      "intentCount": 26,
+      "suiteCount": 4
+    },
+    "messageCatalogContract": {
+      "relativePath": "contracts/message-catalog-contract.json",
+      "localeCount": 2,
+      "stableMessageKeyCount": 258
+    },
+    "specManifest": {
+      "relativePath": "contracts/spec-manifest.json",
+      "entryCount": 4
+    },
+    "catalog": {
+      "relativePath": "dist/catalog.json",
+      "componentCount": 174,
+      "blockCount": 56
+    }
+  }
+}