@contractspec/lib.presentation-runtime-core 0.0.0-canary-20260113162409

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+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/README.md

@@ -0,0 +1,67 @@
+# @contractspec/lib.presentation-runtime-core
+
+Website: https://contractspec.io/
+
+
+Core logic for ContractSpec presentation runtimes.
+
+## Purpose
+
+To provide the shared, framework-agnostic state management and logic for executing workflows and rendering presentations defined in ContractSpec.
+
+## Installation
+
+```bash
+npm install @contractspec/lib.presentation-runtime-core
+# or
+bun add @contractspec/lib.presentation-runtime-core
+```
+
+## Key Concepts
+
+- **Workflow State**: Manages the progression of steps in a `WorkflowSpec`.
+- **Step Navigation**: Logic for next/previous/submit actions.
+- **Validation**: Integration with Zod schemas for step validation.
+
+## Exports
+
+- Types and state machines for workflows.
+- Validation helpers.
+
+## Usage
+
+Typically used internally by `@contractspec/lib.presentation-runtime-react` or `@contractspec/lib.presentation-runtime-react-native`.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+//#region src/index.d.ts
+interface ListState<TFilters extends Record<string, unknown>> {
+  q: string;
+  page: number;
+  limit: number;
+  sort?: string | null;
+  filters: TFilters;
+}
+type ListFetcher<TVars, TItem> = (vars: TVars) => Promise<{
+  items: TItem[];
+  totalItems?: number;
+  totalPages?: number;
+}>;
+interface NextAliasOptions {
+  uiKitWeb?: string;
+  uiKitNative?: string;
+  presentationReact?: string;
+  presentationNative?: string;
+}
+declare function withPresentationNextAliases(config: any, opts?: NextAliasOptions): any;
+type MetroAliasOptions = NextAliasOptions & {
+  monorepoRoot?: string;
+};
+declare function withPresentationMetroAliases(config: any, opts?: MetroAliasOptions): any;
+//#endregion
+export { ListFetcher, ListState, MetroAliasOptions, NextAliasOptions, withPresentationMetroAliases, withPresentationNextAliases };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";UAAiB,2BAA2B;EAA3B,CAAA,EAAA,MAAA;EAQL,IAAA,EAAA,MAAA;EACJ,KAAA,EAAA,MAAA;EACc,IAAA,CAAA,EAAA,MAAA,GAAA,IAAA;EAAjB,OAAA,EALM,QAKN;;AAGY,KALL,WAKqB,CAAA,KAAA,EAAA,KAAA,CAAA,GAAA,CAAA,IAAA,EAJzB,KAIyB,EAAA,GAH5B,OAG4B,CAAA;EAOjB,KAAA,EAVM,KAUN,EAAA;EA6BJ,UAAA,CAAA,EAAA,MAAA;EAII,UAAA,CAAA,EAAA,MAAA;;UAxCC,gBAAA;;;;;;iBAOD,2BAAA,qBAGR;KA0BI,iBAAA,GAAoB;;;iBAIhB,4BAAA,qBAGR"}

package/dist/index.js

@@ -0,0 +1,53 @@
+//#region src/index.ts
+function withPresentationNextAliases(config, opts = {}) {
+	const uiWeb = opts.uiKitWeb ?? "@contractspec/lib.ui-kit-web";
+	const uiNative = opts.uiKitNative ?? "@contractspec/lib.ui-kit";
+	const presReact = opts.presentationReact ?? "@contractspec/lib.presentation-runtime-react";
+	const presNative = opts.presentationNative ?? "@contractspec/lib.presentation-runtime-react-native";
+	config.resolve ??= {};
+	config.resolve.alias = {
+		...config.resolve.alias || {},
+		[uiNative]: uiWeb,
+		[presNative]: presReact
+	};
+	config.resolve.extensions = [
+		".web.js",
+		".web.jsx",
+		".web.ts",
+		".web.tsx",
+		...config.resolve.extensions || []
+	];
+	return config;
+}
+function withPresentationMetroAliases(config, opts = {}) {
+	const uiWeb = opts.uiKitWeb ?? "@contractspec/lib.ui-kit-web";
+	const uiNative = opts.uiKitNative ?? "@contractspec/lib.ui-kit";
+	const presReact = opts.presentationReact ?? "@contractspec/lib.presentation-runtime-react";
+	const presNative = opts.presentationNative ?? "@contractspec/lib.presentation-runtime-react-native";
+	config.resolver ??= {};
+	config.resolver.unstable_enablePackageExports = true;
+	config.resolver.platforms = [
+		"ios",
+		"android",
+		"native",
+		"mobile",
+		"web",
+		...config.resolver.platforms || []
+	];
+	const original = config.resolver.resolveRequest;
+	config.resolver.resolveRequest = (ctx, moduleName, platform) => {
+		if (platform === "ios" || platform === "android" || platform === "native") {
+			if (typeof moduleName === "string" && moduleName.startsWith(uiWeb + "/ui")) {
+				const mapped = moduleName.replace(uiWeb + "/ui", uiNative + "/ui");
+				return (original ?? ctx.resolveRequest)(ctx, mapped, platform);
+			}
+			if (moduleName === presReact) return (original ?? ctx.resolveRequest)(ctx, presNative, platform);
+		}
+		return (original ?? ctx.resolveRequest)(ctx, moduleName, platform);
+	};
+	return config;
+}
+
+//#endregion
+export { withPresentationMetroAliases, withPresentationNextAliases };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["export interface ListState<TFilters extends Record<string, unknown>> {\n  q: string;\n  page: number;\n  limit: number;\n  sort?: string | null;\n  filters: TFilters;\n}\n\nexport type ListFetcher<TVars, TItem> = (\n  vars: TVars\n) => Promise<{ items: TItem[]; totalItems?: number; totalPages?: number }>;\n\n// ---- Framework config helpers (Next / Metro) ----\nexport interface NextAliasOptions {\n  uiKitWeb?: string; // default '@contractspec/lib.ui-kit-web'\n  uiKitNative?: string; // default '@contractspec/lib.ui-kit'\n  presentationReact?: string; // default '@contractspec/lib.presentation-runtime-react'\n  presentationNative?: string; // default '@contractspec/lib.presentation-runtime-react-native'\n}\n\nexport function withPresentationNextAliases(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  config: any,\n  opts: NextAliasOptions = {}\n) {\n  const uiWeb = opts.uiKitWeb ?? '@contractspec/lib.ui-kit-web';\n  const uiNative = opts.uiKitNative ?? '@contractspec/lib.ui-kit';\n  const presReact =\n    opts.presentationReact ?? '@contractspec/lib.presentation-runtime-react';\n  const presNative =\n    opts.presentationNative ??\n    '@contractspec/lib.presentation-runtime-react-native';\n\n  config.resolve ??= {};\n  config.resolve.alias = {\n    ...(config.resolve.alias || {}),\n    [uiNative]: uiWeb,\n    [presNative]: presReact,\n  };\n  config.resolve.extensions = [\n    '.web.js',\n    '.web.jsx',\n    '.web.ts',\n    '.web.tsx',\n    ...((config.resolve.extensions as string[]) || []),\n  ];\n  return config;\n}\n\nexport type MetroAliasOptions = NextAliasOptions & {\n  monorepoRoot?: string;\n};\n\nexport function withPresentationMetroAliases(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  config: any,\n  opts: MetroAliasOptions = {}\n) {\n  const uiWeb = opts.uiKitWeb ?? '@contractspec/lib.ui-kit-web';\n  const uiNative = opts.uiKitNative ?? '@contractspec/lib.ui-kit';\n  const presReact =\n    opts.presentationReact ?? '@contractspec/lib.presentation-runtime-react';\n  const presNative =\n    opts.presentationNative ??\n    '@contractspec/lib.presentation-runtime-react-native';\n\n  // Prefer package exports resolution\n  config.resolver ??= {};\n  config.resolver.unstable_enablePackageExports = true;\n\n  // Platform resolution ordering\n  config.resolver.platforms = [\n    'ios',\n    'android',\n    'native',\n    'mobile',\n    'web',\n    ...((config.resolver.platforms as string[]) || []),\n  ];\n\n  // Map web kit → native at resolver-level\n  const original = config.resolver.resolveRequest;\n  config.resolver.resolveRequest = (\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    ctx: any,\n    moduleName: string,\n    platform: string\n  ) => {\n    if (platform === 'ios' || platform === 'android' || platform === 'native') {\n      if (\n        typeof moduleName === 'string' &&\n        moduleName.startsWith(uiWeb + '/ui')\n      ) {\n        const mapped = moduleName.replace(uiWeb + '/ui', uiNative + '/ui');\n        return (original ?? ctx.resolveRequest)(ctx, mapped, platform);\n      }\n      if (moduleName === presReact) {\n        return (original ?? ctx.resolveRequest)(ctx, presNative, platform);\n      }\n    }\n    return (original ?? ctx.resolveRequest)(ctx, moduleName, platform);\n  };\n\n  return config;\n}\n"],"mappings":";AAoBA,SAAgB,4BAEd,QACA,OAAyB,EAAE,EAC3B;CACA,MAAM,QAAQ,KAAK,YAAY;CAC/B,MAAM,WAAW,KAAK,eAAe;CACrC,MAAM,YACJ,KAAK,qBAAqB;CAC5B,MAAM,aACJ,KAAK,sBACL;AAEF,QAAO,YAAY,EAAE;AACrB,QAAO,QAAQ,QAAQ;EACrB,GAAI,OAAO,QAAQ,SAAS,EAAE;GAC7B,WAAW;GACX,aAAa;EACf;AACD,QAAO,QAAQ,aAAa;EAC1B;EACA;EACA;EACA;EACA,GAAK,OAAO,QAAQ,cAA2B,EAAE;EAClD;AACD,QAAO;;AAOT,SAAgB,6BAEd,QACA,OAA0B,EAAE,EAC5B;CACA,MAAM,QAAQ,KAAK,YAAY;CAC/B,MAAM,WAAW,KAAK,eAAe;CACrC,MAAM,YACJ,KAAK,qBAAqB;CAC5B,MAAM,aACJ,KAAK,sBACL;AAGF,QAAO,aAAa,EAAE;AACtB,QAAO,SAAS,gCAAgC;AAGhD,QAAO,SAAS,YAAY;EAC1B;EACA;EACA;EACA;EACA;EACA,GAAK,OAAO,SAAS,aAA0B,EAAE;EAClD;CAGD,MAAM,WAAW,OAAO,SAAS;AACjC,QAAO,SAAS,kBAEd,KACA,YACA,aACG;AACH,MAAI,aAAa,SAAS,aAAa,aAAa,aAAa,UAAU;AACzE,OACE,OAAO,eAAe,YACtB,WAAW,WAAW,QAAQ,MAAM,EACpC;IACA,MAAM,SAAS,WAAW,QAAQ,QAAQ,OAAO,WAAW,MAAM;AAClE,YAAQ,YAAY,IAAI,gBAAgB,KAAK,QAAQ,SAAS;;AAEhE,OAAI,eAAe,UACjB,SAAQ,YAAY,IAAI,gBAAgB,KAAK,YAAY,SAAS;;AAGtE,UAAQ,YAAY,IAAI,gBAAgB,KAAK,YAAY,SAAS;;AAGpE,QAAO"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@contractspec/lib.presentation-runtime-core",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "Core presentation runtime for contract-driven UIs",
+  "keywords": [
+    "contractspec",
+    "presentation",
+    "runtime",
+    "ui",
+    "core",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit -p tsconfig.json",
+    "clean": "rimraf dist .turbo",
+    "dev": "bun run build:bundle --watch",
+    "lint": "bun run lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./metro.cjs": "./src/metro.cjs",
+      "./next.mjs": "./src/next.mjs"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/presentation-runtime-core"
+  },
+  "homepage": "https://contractspec.io"
+}