@larose-ui/contracts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 laRose contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+interface ContractField {
+    name: string;
+    type?: string;
+    required?: boolean;
+}
+interface ContractSchema {
+    name: string;
+    fields: ContractField[];
+}
+interface ContractMismatch {
+    field: string;
+    issue: 'missing_in_api' | 'missing_in_ui' | 'type_mismatch' | 'required_mismatch';
+    message: string;
+    severity: 'error' | 'warning';
+}
+interface ContractValidationResult {
+    valid: boolean;
+    mismatches: ContractMismatch[];
+}
+declare function validateContract(ui: ContractSchema, api: ContractSchema): ContractValidationResult;
+declare function formatContractReport(result: ContractValidationResult): string;
+
+export { type ContractField, type ContractMismatch, type ContractSchema, type ContractValidationResult, formatContractReport, validateContract };

package/dist/index.js

@@ -0,0 +1,64 @@
+// src/index.ts
+function validateContract(ui, api) {
+  const mismatches = [];
+  const apiFields = new Map(api.fields.map((f) => [f.name, f]));
+  const uiFields = new Map(ui.fields.map((f) => [f.name, f]));
+  for (const uiField of ui.fields) {
+    const apiField = apiFields.get(uiField.name);
+    if (!apiField) {
+      mismatches.push({
+        field: uiField.name,
+        issue: "missing_in_api",
+        message: `UI expects "${uiField.name}" but API schema does not include it`,
+        severity: uiField.required ? "error" : "warning"
+      });
+      continue;
+    }
+    if (uiField.type && apiField.type && uiField.type !== apiField.type) {
+      mismatches.push({
+        field: uiField.name,
+        issue: "type_mismatch",
+        message: `Type mismatch for "${uiField.name}": UI=${uiField.type}, API=${apiField.type}`,
+        severity: "error"
+      });
+    }
+    if (uiField.required && !apiField.required) {
+      mismatches.push({
+        field: uiField.name,
+        issue: "required_mismatch",
+        message: `"${uiField.name}" is required in UI but optional in API`,
+        severity: "warning"
+      });
+    }
+  }
+  for (const apiField of api.fields) {
+    if (!uiFields.has(apiField.name) && apiField.required) {
+      mismatches.push({
+        field: apiField.name,
+        issue: "missing_in_ui",
+        message: `API requires "${apiField.name}" but UI schema does not include it`,
+        severity: "error"
+      });
+    }
+  }
+  return {
+    valid: mismatches.filter((m) => m.severity === "error").length === 0,
+    mismatches
+  };
+}
+function formatContractReport(result) {
+  if (result.valid && result.mismatches.length === 0) {
+    return "Contract validation passed.";
+  }
+  const lines = ["Contract validation report:", ""];
+  for (const m of result.mismatches) {
+    lines.push(`[${m.severity.toUpperCase()}] ${m.field}: ${m.message}`);
+  }
+  lines.push("");
+  lines.push(result.valid ? "Result: PASS (warnings only)" : "Result: FAIL");
+  return lines.join("\n");
+}
+export {
+  formatContractReport,
+  validateContract
+};

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@larose-ui/contracts",
+  "version": "0.1.0",
+  "description": "UI/API contract validation for laRose platform",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@larose-ui/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/larose-ui/larose.git",
+    "directory": "packages/contracts"
+  },
+  "keywords": [
+    "larose",
+    "react",
+    "ui-platform",
+    "design-system",
+    "saas"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}