@ethisyscore/plugin-ui 1.10.0

package/dist/a11y/index.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var react = require('react');
+var plugin = require('@ethisyscore/extension-runtime/plugin');
+
+// src/a11y/useA11yAnnounce.ts
+function useA11yAnnounce(politeness = "polite") {
+  const client = plugin.useBridgeClient();
+  return react.useCallback(
+    (message) => client.announceA11y(message, politeness),
+    [client, politeness]
+  );
+}
+
+exports.useA11yAnnounce = useA11yAnnounce;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/a11y/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/a11y/useA11yAnnounce.ts"],"names":["useBridgeClient","useCallback"],"mappings":";;;;;;AAcO,SAAS,eAAA,CACd,aAAqC,QAAA,EACV;AAC3B,EAAA,MAAM,SAASA,sBAAA,EAAgB;AAC/B,EAAA,OAAOC,iBAAA;AAAA,IACL,CAAC,OAAA,KAAoB,MAAA,CAAO,YAAA,CAAa,SAAS,UAAU,CAAA;AAAA,IAC5D,CAAC,QAAQ,UAAU;AAAA,GACrB;AACF","file":"index.cjs","sourcesContent":["import { useCallback } from \"react\";\nimport { useBridgeClient } from \"@ethisyscore/extension-runtime/plugin\";\n\n/**\n * Returns a stable callback that asks the host to make a live-region\n * announcement on behalf of the plugin.\n *\n * Prefer this over writing to the DOM directly — the host manages ARIA live\n * regions centrally so announcements from different plugins don't clobber\n * each other.\n *\n * @param politeness \"polite\" (default) or \"assertive\". Use \"assertive\" for\n *   critical errors only — it interrupts screen reader speech immediately.\n */\nexport function useA11yAnnounce(\n  politeness: \"polite\" | \"assertive\" = \"polite\",\n): (message: string) => void {\n  const client = useBridgeClient();\n  return useCallback(\n    (message: string) => client.announceA11y(message, politeness),\n    [client, politeness],\n  );\n}\n"]}

package/dist/a11y/index.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Returns a stable callback that asks the host to make a live-region
+ * announcement on behalf of the plugin.
+ *
+ * Prefer this over writing to the DOM directly — the host manages ARIA live
+ * regions centrally so announcements from different plugins don't clobber
+ * each other.
+ *
+ * @param politeness "polite" (default) or "assertive". Use "assertive" for
+ *   critical errors only — it interrupts screen reader speech immediately.
+ */
+declare function useA11yAnnounce(politeness?: "polite" | "assertive"): (message: string) => void;
+
+export { useA11yAnnounce };

package/dist/a11y/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns a stable callback that asks the host to make a live-region
+ * announcement on behalf of the plugin.
+ *
+ * Prefer this over writing to the DOM directly — the host manages ARIA live
+ * regions centrally so announcements from different plugins don't clobber
+ * each other.
+ *
+ * @param politeness "polite" (default) or "assertive". Use "assertive" for
+ *   critical errors only — it interrupts screen reader speech immediately.
+ */
+declare function useA11yAnnounce(politeness?: "polite" | "assertive"): (message: string) => void;
+
+export { useA11yAnnounce };

package/dist/a11y/index.js

@@ -0,0 +1,15 @@
+import { useCallback } from 'react';
+import { useBridgeClient } from '@ethisyscore/extension-runtime/plugin';
+
+// src/a11y/useA11yAnnounce.ts
+function useA11yAnnounce(politeness = "polite") {
+  const client = useBridgeClient();
+  return useCallback(
+    (message) => client.announceA11y(message, politeness),
+    [client, politeness]
+  );
+}
+
+export { useA11yAnnounce };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/a11y/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/a11y/useA11yAnnounce.ts"],"names":[],"mappings":";;;;AAcO,SAAS,eAAA,CACd,aAAqC,QAAA,EACV;AAC3B,EAAA,MAAM,SAAS,eAAA,EAAgB;AAC/B,EAAA,OAAO,WAAA;AAAA,IACL,CAAC,OAAA,KAAoB,MAAA,CAAO,YAAA,CAAa,SAAS,UAAU,CAAA;AAAA,IAC5D,CAAC,QAAQ,UAAU;AAAA,GACrB;AACF","file":"index.js","sourcesContent":["import { useCallback } from \"react\";\nimport { useBridgeClient } from \"@ethisyscore/extension-runtime/plugin\";\n\n/**\n * Returns a stable callback that asks the host to make a live-region\n * announcement on behalf of the plugin.\n *\n * Prefer this over writing to the DOM directly — the host manages ARIA live\n * regions centrally so announcements from different plugins don't clobber\n * each other.\n *\n * @param politeness \"polite\" (default) or \"assertive\". Use \"assertive\" for\n *   critical errors only — it interrupts screen reader speech immediately.\n */\nexport function useA11yAnnounce(\n  politeness: \"polite\" | \"assertive\" = \"polite\",\n): (message: string) => void {\n  const client = useBridgeClient();\n  return useCallback(\n    (message: string) => client.announceA11y(message, politeness),\n    [client, politeness],\n  );\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+var plugin = require('@ethisyscore/extension-runtime/plugin');
+var componentsReact = require('@ethisyscore/components-react');
+
+
+
+Object.defineProperty(exports, "BridgeClientContext", {
+  enumerable: true,
+  get: function () { return plugin.BridgeClientContext; }
+});
+Object.defineProperty(exports, "ExtensionRuntimeProvider", {
+  enumerable: true,
+  get: function () { return plugin.ExtensionRuntimeProvider; }
+});
+Object.defineProperty(exports, "createPortBridgeClient", {
+  enumerable: true,
+  get: function () { return plugin.createPortBridgeClient; }
+});
+Object.defineProperty(exports, "unwrapItems", {
+  enumerable: true,
+  get: function () { return plugin.unwrapItems; }
+});
+Object.defineProperty(exports, "useBridgeClient", {
+  enumerable: true,
+  get: function () { return plugin.useBridgeClient; }
+});
+Object.defineProperty(exports, "useBridgeLocale", {
+  enumerable: true,
+  get: function () { return plugin.useBridgeLocale; }
+});
+Object.defineProperty(exports, "useBridgeTheme", {
+  enumerable: true,
+  get: function () { return plugin.useBridgeTheme; }
+});
+Object.defineProperty(exports, "useMcpQuery", {
+  enumerable: true,
+  get: function () { return plugin.useMcpQuery; }
+});
+Object.defineProperty(exports, "useMcpResource", {
+  enumerable: true,
+  get: function () { return plugin.useMcpResource; }
+});
+Object.defineProperty(exports, "useMcpTool", {
+  enumerable: true,
+  get: function () { return plugin.useMcpTool; }
+});
+Object.defineProperty(exports, "definePlatformReactPage", {
+  enumerable: true,
+  get: function () { return componentsReact.definePlatformReactPage; }
+});
+Object.defineProperty(exports, "emitNavigation", {
+  enumerable: true,
+  get: function () { return componentsReact.emitNavigation; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs","sourcesContent":[]}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+export { A11yPayload, BridgeClientContext, BridgePortShim, DensityPayload, ExtensionRuntimeProvider, ExtensionRuntimeProviderProps, ItemsResponse, LocalePayload, McpTransport, NavPayload, PortBridgeClient, SessionTokenPayload, ThemePayload, UseMcpQueryOptions, UseMcpQueryResult, UseMcpResourceOptions, UseMcpResourceResult, UseMcpToolOptions, UseMcpToolResult, createPortBridgeClient, unwrapItems, useBridgeClient, useBridgeLocale, useBridgeTheme, useMcpQuery, useMcpResource, useMcpTool } from '@ethisyscore/extension-runtime/plugin';
+export { PlatformReactPageProps, definePlatformReactPage, emitNavigation } from '@ethisyscore/components-react';

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { A11yPayload, BridgeClientContext, BridgePortShim, DensityPayload, ExtensionRuntimeProvider, ExtensionRuntimeProviderProps, ItemsResponse, LocalePayload, McpTransport, NavPayload, PortBridgeClient, SessionTokenPayload, ThemePayload, UseMcpQueryOptions, UseMcpQueryResult, UseMcpResourceOptions, UseMcpResourceResult, UseMcpToolOptions, UseMcpToolResult, createPortBridgeClient, unwrapItems, useBridgeClient, useBridgeLocale, useBridgeTheme, useMcpQuery, useMcpResource, useMcpTool } from '@ethisyscore/extension-runtime/plugin';
+export { PlatformReactPageProps, definePlatformReactPage, emitNavigation } from '@ethisyscore/components-react';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { BridgeClientContext, ExtensionRuntimeProvider, createPortBridgeClient, unwrapItems, useBridgeClient, useBridgeLocale, useBridgeTheme, useMcpQuery, useMcpResource, useMcpTool } from '@ethisyscore/extension-runtime/plugin';
+export { definePlatformReactPage, emitNavigation } from '@ethisyscore/components-react';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/l10n/index.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var plugin = require('@ethisyscore/extension-runtime/plugin');
+
+// src/l10n/usePluginLocale.ts
+function usePluginLocale(fallbackLocale = "en-US") {
+  const pushed = plugin.useBridgeLocale();
+  if (pushed === void 0) {
+    return { locale: fallbackLocale, dir: "ltr" };
+  }
+  return { locale: pushed.locale, dir: pushed.dir };
+}
+
+exports.usePluginLocale = usePluginLocale;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/l10n/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/l10n/usePluginLocale.ts"],"names":["useBridgeLocale"],"mappings":";;;;;AAkBO,SAAS,eAAA,CAAgB,iBAAiB,OAAA,EAAuB;AACtE,EAAA,MAAM,SAASA,sBAAA,EAAgB;AAC/B,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,OAAO,EAAE,MAAA,EAAQ,cAAA,EAAgB,GAAA,EAAK,KAAA,EAAM;AAAA,EAC9C;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAQ,GAAA,EAAK,OAAO,GAAA,EAAI;AAClD","file":"index.cjs","sourcesContent":["import { useBridgeLocale } from \"@ethisyscore/extension-runtime/plugin\";\n\nexport interface PluginLocale {\n  /** BCP 47 tag, e.g. \"en-GB\". Falls back to the supplied `fallbackLocale`. */\n  locale: string;\n  /** \"ltr\" | \"rtl\" — derived from the host locale push. */\n  dir: \"ltr\" | \"rtl\";\n}\n\n/**\n * Returns the current locale and text direction as pushed by the host.\n *\n * Before the host sends the first `BRIDGE_PUSH_LOCALE` message (e.g. during\n * SSR or very early render), returns the `fallbackLocale` (default `\"en-US\"`)\n * with `dir: \"ltr\"`.\n *\n * @param fallbackLocale BCP 47 tag to use before the first locale push.\n */\nexport function usePluginLocale(fallbackLocale = \"en-US\"): PluginLocale {\n  const pushed = useBridgeLocale();\n  if (pushed === undefined) {\n    return { locale: fallbackLocale, dir: \"ltr\" };\n  }\n  return { locale: pushed.locale, dir: pushed.dir };\n}\n"]}

package/dist/l10n/index.d.cts

@@ -0,0 +1,18 @@
+interface PluginLocale {
+    /** BCP 47 tag, e.g. "en-GB". Falls back to the supplied `fallbackLocale`. */
+    locale: string;
+    /** "ltr" | "rtl" — derived from the host locale push. */
+    dir: "ltr" | "rtl";
+}
+/**
+ * Returns the current locale and text direction as pushed by the host.
+ *
+ * Before the host sends the first `BRIDGE_PUSH_LOCALE` message (e.g. during
+ * SSR or very early render), returns the `fallbackLocale` (default `"en-US"`)
+ * with `dir: "ltr"`.
+ *
+ * @param fallbackLocale BCP 47 tag to use before the first locale push.
+ */
+declare function usePluginLocale(fallbackLocale?: string): PluginLocale;
+
+export { type PluginLocale, usePluginLocale };

package/dist/l10n/index.d.ts

@@ -0,0 +1,18 @@
+interface PluginLocale {
+    /** BCP 47 tag, e.g. "en-GB". Falls back to the supplied `fallbackLocale`. */
+    locale: string;
+    /** "ltr" | "rtl" — derived from the host locale push. */
+    dir: "ltr" | "rtl";
+}
+/**
+ * Returns the current locale and text direction as pushed by the host.
+ *
+ * Before the host sends the first `BRIDGE_PUSH_LOCALE` message (e.g. during
+ * SSR or very early render), returns the `fallbackLocale` (default `"en-US"`)
+ * with `dir: "ltr"`.
+ *
+ * @param fallbackLocale BCP 47 tag to use before the first locale push.
+ */
+declare function usePluginLocale(fallbackLocale?: string): PluginLocale;
+
+export { type PluginLocale, usePluginLocale };

package/dist/l10n/index.js

@@ -0,0 +1,14 @@
+import { useBridgeLocale } from '@ethisyscore/extension-runtime/plugin';
+
+// src/l10n/usePluginLocale.ts
+function usePluginLocale(fallbackLocale = "en-US") {
+  const pushed = useBridgeLocale();
+  if (pushed === void 0) {
+    return { locale: fallbackLocale, dir: "ltr" };
+  }
+  return { locale: pushed.locale, dir: pushed.dir };
+}
+
+export { usePluginLocale };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/l10n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/l10n/usePluginLocale.ts"],"names":[],"mappings":";;;AAkBO,SAAS,eAAA,CAAgB,iBAAiB,OAAA,EAAuB;AACtE,EAAA,MAAM,SAAS,eAAA,EAAgB;AAC/B,EAAA,IAAI,WAAW,MAAA,EAAW;AACxB,IAAA,OAAO,EAAE,MAAA,EAAQ,cAAA,EAAgB,GAAA,EAAK,KAAA,EAAM;AAAA,EAC9C;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAQ,GAAA,EAAK,OAAO,GAAA,EAAI;AAClD","file":"index.js","sourcesContent":["import { useBridgeLocale } from \"@ethisyscore/extension-runtime/plugin\";\n\nexport interface PluginLocale {\n  /** BCP 47 tag, e.g. \"en-GB\". Falls back to the supplied `fallbackLocale`. */\n  locale: string;\n  /** \"ltr\" | \"rtl\" — derived from the host locale push. */\n  dir: \"ltr\" | \"rtl\";\n}\n\n/**\n * Returns the current locale and text direction as pushed by the host.\n *\n * Before the host sends the first `BRIDGE_PUSH_LOCALE` message (e.g. during\n * SSR or very early render), returns the `fallbackLocale` (default `\"en-US\"`)\n * with `dir: \"ltr\"`.\n *\n * @param fallbackLocale BCP 47 tag to use before the first locale push.\n */\nexport function usePluginLocale(fallbackLocale = \"en-US\"): PluginLocale {\n  const pushed = useBridgeLocale();\n  if (pushed === undefined) {\n    return { locale: fallbackLocale, dir: \"ltr\" };\n  }\n  return { locale: pushed.locale, dir: pushed.dir };\n}\n"]}

package/dist/token/index.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var plugin = require('@ethisyscore/extension-runtime/plugin');
+
+
+
+Object.defineProperty(exports, "useFrontendSessionToken", {
+  enumerable: true,
+  get: function () { return plugin.useFrontendSessionToken; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/token/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs","sourcesContent":[]}

package/dist/token/index.d.cts

@@ -0,0 +1 @@
+export { UseFrontendSessionTokenResult, useFrontendSessionToken } from '@ethisyscore/extension-runtime/plugin';

package/dist/token/index.d.ts

@@ -0,0 +1 @@
+export { UseFrontendSessionTokenResult, useFrontendSessionToken } from '@ethisyscore/extension-runtime/plugin';

package/dist/token/index.js

@@ -0,0 +1,3 @@
+export { useFrontendSessionToken } from '@ethisyscore/extension-runtime/plugin';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/token/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@ethisyscore/plugin-ui",
+  "version": "1.10.0",
+  "description": "Plugin-UI umbrella SDK: client bridge + a11y/l10n primitives + brokered-MCP client (WI 4858).",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./a11y": {
+      "types": "./dist/a11y/index.d.ts",
+      "import": "./dist/a11y/index.js",
+      "require": "./dist/a11y/index.cjs"
+    },
+    "./l10n": {
+      "types": "./dist/l10n/index.d.ts",
+      "import": "./dist/l10n/index.js",
+      "require": "./dist/l10n/index.cjs"
+    },
+    "./token": {
+      "types": "./dist/token/index.d.ts",
+      "import": "./dist/token/index.js",
+      "require": "./dist/token/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ethisyscore/components-react": "^1.10.0",
+    "@ethisyscore/extension-runtime": "^1.10.0"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.6.0",
+    "@testing-library/react": "^16.0.0",
+    "@types/node": "^20.19.41",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "jsdom": "^25.0.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.0",
+    "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "ethisyscore",
+    "plugin",
+    "bridge",
+    "sdk",
+    "4858"
+  ],
+  "license": "Apache-2.0"
+}