agentic-zi-ui 0.0.1 → 0.0.3

package/RELEASE.md

@@ -8,3 +8,5 @@
    - `pnpm -C packages/ui-renderer build`
 4) Publish
    - `pnpm -C packages/ui-renderer publish:public`
+
+See `VERSIONING.md` for when to bump patch/minor/major.

package/VERSIONING.md

@@ -0,0 +1,20 @@
+# Versioning policy (agentic-zi-ui)
+
+## No breaking changes
+Use patch/minor if the external contract stays the same:
+- No new tags, events, actions, or state model changes
+- No schema changes that affect validation
+- Internal refactors, bug fixes, performance improvements
+
+Suggested bumps:
+- Patch: fixes only (0.0.1 -> 0.0.2)
+- Minor: additive, backwards-compatible exports or optional features
+
+## Breaking changes
+Use major if any of the following change:
+- Allowed tags/props/events/actions behavior
+- Template schema or validation rules
+- State binding or interpolation semantics
+- Required prop changes for `ZijusCustomWidget`
+
+Rule of thumb: if existing templates could render differently or fail, bump major.

package/dist/UiRenderer.d.ts

@@ -1,4 +1,4 @@
-import type { UiNode, UiTemplate, UiActionType, WidgetDefinition } from "@acme/ui-schema";
+import type { UiNode, UiTemplate, UiActionType, WidgetDefinition } from "agentic-zi-ui-schema";
 export type RenderPolicy = {
     allowedTags?: string[];
     allowedProps?: string[];

package/dist/UiRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UiRenderer.d.ts","sourceRoot":"","sources":["../src/UiRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAEV,YAAY,EACZ,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAczB,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACvE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAkQF,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,aAAa,EACb,KAAK,EACL,MAAM,GACP,EAAE,eAAe,2CAkPjB"}
+{"version":3,"file":"UiRenderer.d.ts","sourceRoot":"","sources":["../src/UiRenderer.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAEV,YAAY,EACZ,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAc9B,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACvE,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AA8QF,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,IAAI,EACJ,WAAW,EACX,aAAa,EACb,KAAK,EACL,MAAM,GACP,EAAE,eAAe,2CAkPjB"}

package/dist/UiRenderer.js

@@ -1,7 +1,7 @@
 import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import React, { useMemo, useReducer, useEffect, useState } from "react";
-import { UI_ALLOWED_TAGS, UI_ALLOWED_PROPS, UiActionTypeSchema, } from "@acme/ui-schema";
+import { UI_ALLOWED_TAGS, UI_ALLOWED_PROPS, UiActionTypeSchema, } from "agentic-zi-ui-schema";
 import { runAction } from "./actions";
 const BASE_ALLOWED_TAGS = new Set(UI_ALLOWED_TAGS);
 const BASE_ALLOWED_PROPS = new Set(UI_ALLOWED_PROPS);

package/dist/actions.d.ts

@@ -1,4 +1,4 @@
-import type { UiAction, UiActionType } from "@acme/ui-schema";
+import type { UiAction, UiActionType } from "agentic-zi-ui-schema";
 export type ActionContext = {
     sendFlowEvent: (name: string, payload?: Record<string, unknown>) => void;
     patchState: (key: string, value: unknown) => void;

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAWF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,aAAa,EAClB,EAAE,CAAC,EAAE,OAAO,EACZ,cAAc,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAuDf"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM,MAAM,aAAa,GAAG;IAC1B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAWF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,aAAa,EAClB,EAAE,CAAC,EAAE,OAAO,EACZ,cAAc,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/autoStyles.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureAgenticStylesLoaded(configUrl?: string): Promise<void>;
+//# sourceMappingURL=autoStyles.d.ts.map

package/dist/autoStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoStyles.d.ts","sourceRoot":"","sources":["../src/autoStyles.ts"],"names":[],"mappings":"AAwCA,wBAAsB,yBAAyB,CAC7C,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/autoStyles.js

@@ -0,0 +1,51 @@
+const DEFAULT_CONFIG_URL = "/agentic-zi-ui.config.json";
+let loadPromise = null;
+function isBrowser() {
+    return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function getGlobalConfig() {
+    const anyGlobal = globalThis;
+    return anyGlobal.__AGENTIC_ZI_UI_CONFIG__ ?? null;
+}
+async function fetchConfig(url) {
+    try {
+        const res = await fetch(url, { headers: { "Accept": "application/json" } });
+        if (!res.ok)
+            return null;
+        const json = (await res.json());
+        if (!json?.baseUrl || !Array.isArray(json.botIdList))
+            return null;
+        return json;
+    }
+    catch {
+        return null;
+    }
+}
+function ensureLink(href) {
+    const existing = document.querySelector(`link[data-agentic-zi-ui="${href}"]`);
+    if (existing)
+        return;
+    const link = document.createElement("link");
+    link.rel = "stylesheet";
+    link.href = href;
+    link.setAttribute("data-agentic-zi-ui", href);
+    document.head.appendChild(link);
+}
+export async function ensureAgenticStylesLoaded(configUrl = DEFAULT_CONFIG_URL) {
+    if (!isBrowser())
+        return;
+    if (loadPromise)
+        return loadPromise;
+    loadPromise = (async () => {
+        const config = getGlobalConfig() ?? (await fetchConfig(configUrl));
+        if (!config)
+            return;
+        const baseUrl = config.cssBaseUrl ?? config.baseUrl;
+        const botIds = Array.isArray(config.botIdList) ? config.botIdList : [];
+        for (const botId of botIds) {
+            const href = `${baseUrl.replace(/\/$/, "")}/safelist/current/${encodeURIComponent(botId)}.css`;
+            ensureLink(href);
+        }
+    })();
+    return loadPromise;
+}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+import * as fs from "node:fs";
+import * as path from "node:path";
+const CONFIG_NAME = "agentic-zi-ui.config.json";
+function readConfig(cwd) {
+    const configPath = path.resolve(cwd, CONFIG_NAME);
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Missing ${CONFIG_NAME} in ${cwd}`);
+    }
+    const raw = fs.readFileSync(configPath, "utf8");
+    const json = JSON.parse(raw);
+    if (!json.baseUrl || typeof json.baseUrl !== "string") {
+        throw new Error("config.baseUrl is required");
+    }
+    if (!Array.isArray(json.botIdList) || json.botIdList.length === 0) {
+        throw new Error("config.botIdList must be a non-empty array");
+    }
+    return {
+        baseUrl: json.baseUrl.replace(/\/$/, ""),
+        botIdList: json.botIdList,
+        outputPath: json.outputPath,
+    };
+}
+function parseTokens(payload) {
+    if (Array.isArray(payload)) {
+        return payload.map(String).filter(Boolean);
+    }
+    if (payload && typeof payload === "object") {
+        const obj = payload;
+        const tokens = obj.tokens ?? obj.safelist ?? obj.classes ?? obj.classNames ?? null;
+        if (Array.isArray(tokens)) {
+            return tokens.map(String).filter(Boolean);
+        }
+    }
+    if (typeof payload === "string") {
+        return payload
+            .split(/\s+/)
+            .map((t) => t.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+async function fetchSafelist(baseUrl, botId) {
+    const url = `${baseUrl}/safelist/current/${encodeURIComponent(botId)}`;
+    const res = await fetch(url, { headers: { "Accept": "application/json" } });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Failed ${res.status} ${url}: ${text}`);
+    }
+    const contentType = res.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+        const json = await res.json();
+        return parseTokens(json);
+    }
+    const text = await res.text();
+    return parseTokens(text);
+}
+async function main() {
+    const cwd = process.cwd();
+    const config = readConfig(cwd);
+    const outputPath = path.resolve(cwd, config.outputPath ?? "apps/client/src/ui/tailwindSafelist.txt");
+    const tokens = new Set();
+    for (const botId of config.botIdList) {
+        const list = await fetchSafelist(config.baseUrl, botId);
+        for (const token of list)
+            tokens.add(token);
+    }
+    const output = Array.from(tokens).sort().join("\n");
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, `${output}\n`, "utf8");
+    console.log(`Safelist updated: ${outputPath} (${tokens.size} classes) from ${config.botIdList.length} bot(s).`);
+}
+main().catch((err) => {
+    console.error(err?.message ?? err);
+    process.exit(1);
+});

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import type { UiRendererProps } from "./UiRenderer";
+import { ensureAgenticStylesLoaded } from "./autoStyles";
 export type { UiRendererProps, RenderPolicy } from "./UiRenderer";
 export type { UiRendererProps as ZijusCustomWidgetProps } from "./UiRenderer";
 export declare function ZijusCustomWidget(props: UiRendererProps): import("react/jsx-runtime").JSX.Element;
+export { ensureAgenticStylesLoaded };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAElE,YAAY,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,2CAEvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAElE,YAAY,EAAE,eAAe,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,2CAKvD;AAED,OAAO,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/index.js

@@ -1,5 +1,11 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
 import { UiRenderer } from "./UiRenderer";
+import { ensureAgenticStylesLoaded } from "./autoStyles";
 export function ZijusCustomWidget(props) {
+    React.useEffect(() => {
+        ensureAgenticStylesLoaded();
+    }, []);
     return _jsx(UiRenderer, { ...props });
 }
+export { ensureAgenticStylesLoaded };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-zi-ui",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "private": false,
@@ -11,6 +11,9 @@
       "import": "./dist/index.js"
     }
   },
+  "bin": {
+    "agentic-zi-ui-safelist": "./dist/cli.js"
+  },
   "scripts": {
     "dev": "tsc -w",
     "build": "tsc",
@@ -18,16 +21,18 @@
     "release:patch": "npm version patch -m \"chore(release): %s\"",
     "release:minor": "npm version minor -m \"chore(release): %s\"",
     "release:major": "npm version major -m \"chore(release): %s\"",
-    "publish:public": "npm publish --access public"
-  },
-  "dependencies": {
-    "@acme/ui-schema": "workspace:*"
+    "publish:public": "npm publish --access public",
+    "safelist:pull": "agentic-zi-ui-safelist"
   },
+  "dependencies": {},
   "peerDependencies": {
-    "react": "^18 || ^19"
+    "react": "^18 || ^19",
+    "agentic-zi-ui-schema": "^0.0.1"
   },
   "devDependencies": {
     "@types/react": "^19.2.5",
+    "@types/node": "^24.10.1",
+    "agentic-zi-ui-schema": "^0.0.1",
     "typescript": "~5.9.3"
   }
 }