@syrin/iris 0.5.0 → 0.8.0

package/dist/vite.d.ts

@@ -0,0 +1,43 @@
+declare const IRIS_VITE_PLUGIN_NAME = "iris";
+interface IrisVitePluginOptions {
+    /** Bridge WebSocket port. Defaults to the SDK default; only baked into connect() when non-default. */
+    port?: number;
+    /** Stable session label for the bridge. Defaults to the SDK's auto-generated id. */
+    session?: string;
+    /** Auth token forwarded to connect() when the bridge requires one. */
+    token?: string;
+    /** Stamp data-iris-source for React 19 source mapping. Default true (harmless on React <=18). */
+    sourceMapping?: boolean;
+    /** Auto-inject the dev-gated iris.connect() call. Default true. */
+    inject?: boolean;
+}
+/** Structural Vite plugin shape — avoids a hard dependency on `vite` while staying assignable to its `Plugin`. */
+interface IrisVitePlugin {
+    name: string;
+    apply: 'serve';
+    enforce: 'pre';
+    transform: (code: string, id: string) => {
+        code: string;
+        map: string | null;
+    } | null;
+    resolveId: (id: string) => string | null;
+    load: (id: string) => string | null;
+    transformIndexHtml: (html: string) => HtmlTag[];
+}
+interface HtmlTag {
+    tag: string;
+    attrs: Record<string, string>;
+    injectTo: 'body';
+}
+/**
+ * Iris Vite plugin. Add to your `plugins` array and the entire integration is done:
+ *
+ *   import { iris } from '@syrin/iris/vite';
+ *   export default defineConfig({ plugins: [react(), iris()] });
+ *
+ * `apply: 'serve'` means Vite drops the plugin entirely from `vite build` — production bundles
+ * are never instrumented. Gating is the tool's job, not a user-managed env check.
+ */
+declare function iris(options?: IrisVitePluginOptions): IrisVitePlugin;
+
+export { IRIS_VITE_PLUGIN_NAME, type IrisVitePlugin, type IrisVitePluginOptions, iris };

package/dist/vite.js

@@ -0,0 +1,148 @@
+// ../vite-plugin/dist/index.js
+import { transformSync } from "@babel/core";
+
+// ../babel-plugin/dist/index.js
+import { relative } from "path";
+var SOURCE_ATTR = "data-iris-source";
+function irisSourcePlugin({ types: t }) {
+  return {
+    name: "iris-source",
+    visitor: {
+      JSXOpeningElement(path, state) {
+        const node = path.node;
+        if (node.name.type !== "JSXIdentifier")
+          return;
+        const first = node.name.name[0];
+        if (first === void 0 || first !== first.toLowerCase())
+          return;
+        const alreadyStamped = node.attributes.some((attr) => attr.type === "JSXAttribute" && attr.name.type === "JSXIdentifier" && attr.name.name === SOURCE_ATTR);
+        if (alreadyStamped)
+          return;
+        const loc = node.loc;
+        if (loc === null || loc === void 0)
+          return;
+        const filename = state.filename ?? "unknown";
+        const rel = relative(process.cwd(), filename);
+        const value = `${rel}:${String(loc.start.line)}:${String(loc.start.column)}`;
+        node.attributes.push(t.jsxAttribute(t.jsxIdentifier(SOURCE_ATTR), t.stringLiteral(value)));
+      }
+    }
+  };
+}
+
+// ../protocol/dist/constants.js
+var IRIS_DEFAULT_PORT = 4400;
+var IRIS_WS_PATH = "/iris";
+var TRANSPORT_LIMITS = {
+  MAX_MESSAGE_BYTES: 1024 * 1024,
+  MAX_MESSAGES_PER_SECOND: 1e3,
+  MAX_SESSIONS: 32,
+  MAX_PENDING_CONNECTIONS: 16,
+  HELLO_TIMEOUT_MS: 5e3,
+  MAX_BUFFER_BYTES: 8 * 1024 * 1024,
+  MAX_SESSION_ID_LENGTH: 128,
+  MAX_URL_LENGTH: 4096,
+  MAX_TITLE_LENGTH: 512,
+  MAX_ADAPTERS: 32,
+  MAX_ADAPTER_NAME_LENGTH: 128,
+  MAX_TOKEN_LENGTH: 512,
+  MAX_COMMAND_ID_LENGTH: 128,
+  MAX_COMMAND_NAME_LENGTH: 128,
+  MAX_REF_LENGTH: 128,
+  MAX_ERROR_LENGTH: 4096,
+  MAX_SERIALIZE_DEPTH: 8,
+  MAX_COLLECTION_ITEMS: 200,
+  MAX_OBJECT_KEYS: 200,
+  MAX_STRING_LENGTH: 64 * 1024,
+  /** Human review marks: the note the human types when flagging a mistake on the page. */
+  MAX_MARK_NOTE_LENGTH: 2e3,
+  /** Human review marks: the legible element label that pins the mark (e.g. "Submit button"). */
+  MAX_MARK_LABEL_LENGTH: 256
+};
+var UpdateCheckIntervalMs = 24 * 60 * 60 * 1e3;
+var RING_BUFFER_DEFAULTS = {
+  MAX_EVENTS: 2e3,
+  MAX_AGE_MS: 6e4,
+  MAX_BYTES: TRANSPORT_LIMITS.MAX_BUFFER_BYTES
+};
+
+// ../vite-plugin/dist/index.js
+var IRIS_VITE_PLUGIN_NAME = "iris";
+var IRIS_PACKAGE = "@syrin/iris";
+var JSX_FILE = /\.[jt]sx$/;
+var VIRTUAL_PREFIX = "\0";
+var NODE_MODULES = "node_modules";
+var IRIS_CONNECT_MODULE = "/@iris-connect";
+function shouldStamp(id) {
+  if (id.startsWith(VIRTUAL_PREFIX))
+    return false;
+  if (id.includes(NODE_MODULES))
+    return false;
+  const clean = id.split("?")[0] ?? id;
+  return JSX_FILE.test(clean);
+}
+function stamp(code, id) {
+  const out = transformSync(code, {
+    filename: id,
+    plugins: [irisSourcePlugin],
+    parserOpts: { plugins: ["jsx", "typescript"] },
+    sourceMaps: true,
+    configFile: false,
+    babelrc: false
+  });
+  if (out?.code === void 0 || out.code === null)
+    return null;
+  return {
+    code: out.code,
+    map: out.map === void 0 || out.map === null ? null : JSON.stringify(out.map)
+  };
+}
+function connectArgs(options) {
+  const args = {};
+  const port = options.port ?? IRIS_DEFAULT_PORT;
+  if (port !== IRIS_DEFAULT_PORT)
+    args["url"] = `ws://localhost:${String(port)}${IRIS_WS_PATH}`;
+  if (options.session !== void 0)
+    args["session"] = options.session;
+  if (options.token !== void 0)
+    args["token"] = options.token;
+  return Object.keys(args).length > 0 ? JSON.stringify(args) : "";
+}
+function connectModuleSource(options) {
+  const args = connectArgs(options);
+  return `import { iris, install } from '${IRIS_PACKAGE}';
+install();
+iris.connect(${args});
+`;
+}
+function iris(options = {}) {
+  const sourceMapping = options.sourceMapping !== false;
+  const inject = options.inject !== false;
+  return {
+    name: IRIS_VITE_PLUGIN_NAME,
+    apply: "serve",
+    enforce: "pre",
+    transform(code, id) {
+      if (!sourceMapping || !shouldStamp(id))
+        return null;
+      return stamp(code, id);
+    },
+    resolveId(id) {
+      return inject && id === IRIS_CONNECT_MODULE ? IRIS_CONNECT_MODULE : null;
+    },
+    load(id) {
+      return inject && id === IRIS_CONNECT_MODULE ? connectModuleSource(options) : null;
+    },
+    transformIndexHtml() {
+      if (!inject)
+        return [];
+      return [
+        { tag: "script", attrs: { type: "module", src: IRIS_CONNECT_MODULE }, injectTo: "body" }
+      ];
+    }
+  };
+}
+export {
+  IRIS_VITE_PLUGIN_NAME,
+  iris
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syrin/iris",
-  "version": "0.5.0",
+  "version": "0.8.0",
   "description": "One-install Iris: the dev-only SDK (browser + React adapter) and the spec runner under one package, with subpaths for the source-mapping plugins and the MCP server.",
   "type": "module",
   "license": "MIT",
@@ -32,6 +32,10 @@
       "types": "./dist/babel.d.ts",
       "default": "./dist/babel.js"
     },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
+    },
     "./eslint": {
       "types": "./dist/eslint.d.ts",
       "default": "./dist/eslint.js"
@@ -52,14 +56,15 @@
     "@types/ws": "^8.5.13",
     "tsup": "^8.3.5",
     "typescript": "^5.6.0",
-    "@syrin/iris-babel-plugin": "0.5.0",
-    "@syrin/iris-browser": "0.5.0",
-    "@syrin/iris-react": "0.5.0",
-    "@syrin/iris-next": "0.5.0",
-    "@syrin/iris-eslint-plugin": "0.5.0",
-    "@syrin/iris-server": "0.5.0",
-    "@syrin/iris-protocol": "0.5.0",
-    "@syrin/iris-test": "0.5.0"
+    "@syrin/iris-babel-plugin": "0.8.0",
+    "@syrin/iris-eslint-plugin": "0.8.0",
+    "@syrin/iris-browser": "0.8.0",
+    "@syrin/iris-next": "0.8.0",
+    "@syrin/iris-react": "0.8.0",
+    "@syrin/iris-server": "0.8.0",
+    "@syrin/iris-test": "0.8.0",
+    "@syrin/iris-protocol": "0.8.0",
+    "@syrin/iris-vite-plugin": "0.8.0"
   },
   "optionalDependencies": {
     "pixelmatch": "^7.2.0",
@@ -70,7 +75,7 @@
     "eslint": ">=9",
     "next": ">=13",
     "react": ">=18",
-    "vitest": "^3.0.0"
+    "vitest": "^3.2.6"
   },
   "peerDependenciesMeta": {
     "eslint": {