@intent-framework/core 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,67 @@
+# @intent-framework/core
+
+Platformless semantic graph and runtime for Intent applications.
+
+## Install
+
+```sh
+pnpm add @intent-framework/core@0.1.0-alpha.1
+```
+
+```sh
+npm install @intent-framework/core@0.1.0-alpha.1
+```
+
+## What it provides
+
+- `screen()` — define a semantic interaction space
+- `$.state.text()` / `$.state.boolean()` / `$.state.choice()` — reactive state
+- `$.ask()` — user-facing question with validation
+- `$.act()` — executable action with conditions, lifecycle, and feedback
+- `$.resource()` — async state with load/reload lifecycle
+- `$.surface()` — named containment surface
+- `createScreenRuntime()` — runtime that owns screen state and resources
+- `inspectScreen()` — semantic graph snapshot with diagnostics
+- Condition and signal primitives
+
+## Minimal example
+
+```ts
+import { screen, inspectScreen } from "@intent-framework/core"
+
+const InviteMember = screen("InviteMember", $ => {
+  const email = $.state.text("email")
+
+  const emailAsk = $.ask("Email", email)
+    .required("Email is required")
+    .validate(value => value.includes("@") ? true : "Enter a valid email")
+
+  const invite = $.act("Invite member")
+    .primary()
+    .when(emailAsk.valid, "Enter a valid email first")
+    .does(() => {
+      console.log("invite", email.value)
+    })
+
+  $.surface("main").contains(emailAsk, invite)
+})
+
+const graph = inspectScreen(InviteMember)
+console.log(graph.diagnostics)
+```
+
+## Where this fits
+
+Core defines the product graph. It has no DOM, React, Node, or framework dependencies. Renderers (`@intent-framework/dom`), the router (`@intent-framework/router`), and testing (`@intent-framework/testing`) all build on core.
+
+## Learn more
+
+- [Root README](../../README.md) — project overview and philosophy
+- [Quickstart](../../docs/Quickstart.md) — step-by-step guide
+- [Inspect Screen and Diagnostics Guide](../../docs/Inspect-Screen.md) — graph inspection and diagnostics
+- [Resources Guide](../../docs/Resources.md) — resource lifecycle and runtime scoping
+- [MVP Checkpoint](../../docs/MVP-Checkpoint.md) — current implementation boundaries
+
+## Status
+
+Experimental alpha. Version `0.1.0-alpha.1`. APIs may change. Not recommended for production use.

package/dist/index.js

@@ -761,6 +761,22 @@ function computeDiagnostics(screenDef) {
 		message: "Action is defined but not included in any surface.",
 		nodeId: act.id
 	});
+	if (screenDef.flows.length > 0) {
+		const flowNodeIds = /* @__PURE__ */ new Set();
+		for (const flow of screenDef.flows) for (const step of flow.steps) flowNodeIds.add(step.node.id);
+		for (const ask of screenDef.asks) if (surfacedNodeIds.has(ask.id) && !flowNodeIds.has(ask.id)) diagnostics.push({
+			severity: "info",
+			code: "surfaced-node-not-in-any-flow",
+			message: `"${ask.label}" is surfaced but not referenced in any flow.`,
+			nodeId: ask.id
+		});
+		for (const act of screenDef.acts) if (surfacedNodeIds.has(act.id) && !flowNodeIds.has(act.id)) diagnostics.push({
+			severity: "info",
+			code: "surfaced-node-not-in-any-flow",
+			message: `"${act.label}" is surfaced but not referenced in any flow.`,
+			nodeId: act.id
+		});
+	}
 	return diagnostics;
 }
 function inspectScreen(screenDef, runtimeResources) {

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.2",
   "description": "Platformless semantic graph and runtime for Intent applications",
   "license": "MIT",
   "repository": {