@jini-ai/vibecoding 0.4.0

package/dist/react/use-vibecoding-session.js

@@ -0,0 +1,44 @@
+/**
+ * @module react/use-vibecoding-session
+ *
+ * The one hook every component in `./react` is built on: subscribes a component to a
+ * `VibecodingSession` (`./session.js`) via `useSyncExternalStore` — React's own sanctioned way to
+ * read a store that lives outside React, which `VibecodingSession` deliberately is (see that
+ * module's doc for why: a tool handler invoked from the chat's execution path needs to reach the
+ * same object a mounted component reads, and that object cannot be React state).
+ */
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+/**
+ * Subscribes to `session` and triggers its first `refresh()` on mount (and again if `session`
+ * itself changes identity — a host swapping in a different artifact mid-session gets a fresh list
+ * rather than a stale one left over from the previous session). Re-running `refresh()` a second
+ * time for the same session instance is the caller's own choice via the returned `refresh`.
+ *
+ * A `refresh()` rejection is intentionally swallowed here rather than thrown from the effect —
+ * `session.getSnapshot().lastError` already carries it (see `./session.js`), and an effect that
+ * threw would only produce an uncatchable render-cycle error for a failure the snapshot already
+ * reports. A caller that wants to react to it reads `lastError` or calls `refresh()` itself and
+ * awaits/catches that promise directly.
+ *
+ * @param requiredArgs - the session port created by `createVibecodingSession`.
+ * @returns the current snapshot plus the session's actions, bound to `session`.
+ * @complexity O(1) beyond whatever `session`'s own methods cost — see `./session.js`.
+ */
+export function useVibecodingSession({ session }) {
+    // React supplies a positional listener; keep its adapter stable across renders so reading
+    // the session does not unsubscribe and resubscribe after each snapshot change.
+    const subscribe = useCallback((listener) => session.subscribe({ listener }), [session]);
+    const snapshot = useSyncExternalStore(subscribe, session.getSnapshot, session.getSnapshot);
+    useEffect(() => {
+        session.refresh().catch(() => {
+            // Already recorded on the snapshot as `lastError` — see this function's doc.
+        });
+    }, [session]);
+    const refresh = useCallback(() => session.refresh(), [session]);
+    const readPart = useCallback((args) => session.readPart(args), [session]);
+    const applyEdits = useCallback((args, options) => session.applyEdits(args, options), [session]);
+    const undo = useCallback(() => session.undo(), [session]);
+    const redo = useCallback(() => session.redo(), [session]);
+    return { ...snapshot, session, refresh, readPart, applyEdits, undo, redo };
+}
+//# sourceMappingURL=use-vibecoding-session.js.map

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@jini-ai/vibecoding",
+  "version": "0.4.0",
+  "description": "Conversational artifact authoring: a target-agnostic edit loop \u2014 addressable parts, validated replace, operation-level undo/redo, and per-turn snapshot/rewind. Framework-free in `/core`; tagged-region HTML documents behind ./html; filesystem targets behind ./node and the chat/preview surface behind ./react.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AINSEP/Jini.git",
+    "directory": "packages/vibecoding"
+  },
+  "jini": {
+    "domain": "capability",
+    "kind": "authoring",
+    "runtime": "universal",
+    "entries": {
+      ".": "universal",
+      "./core": "universal",
+      "./html": "universal",
+      "./html/node": "node",
+      "./react": "browser"
+    }
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "default": "./dist/core/index.js"
+    },
+    "./html": {
+      "types": "./dist/html/index.d.ts",
+      "import": "./dist/html/index.js",
+      "default": "./dist/html/index.js"
+    },
+    "./html/node": {
+      "types": "./dist/html/node/index.d.ts",
+      "import": "./dist/html/node/index.js",
+      "default": "./dist/html/node/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/__tests__/**",
+    "!dist/**/*.map"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "jsdom": "^25.0.1",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@jini-ai/core": "workspace:*",
+    "parse5": "^8.0.1"
+  },
+  "peerDependencies": {
+    "react": "^18.3.0 || ^19.0.0",
+    "react-dom": "^18.3.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  }
+}