@ethisyscore/host-ui-externals 1.10.0

package/dist/index.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+// src/index.ts
+var GOGO_EXTERNALS_SPECIFIER_MAP = Object.freeze({
+  "@ethisyscore/host-ui-externals": "@ethisyscore/host-ui-externals"
+});
+
+exports.GOGO_EXTERNALS_SPECIFIER_MAP = GOGO_EXTERNALS_SPECIFIER_MAP;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAgFO,IAAM,4BAAA,GAAiE,OAAO,MAAA,CAAO;AAAA,EAC1F,gCAAA,EAAkC;AACpC,CAAC","file":"index.cjs","sourcesContent":["/**\n * @ethisyscore/host-ui-externals\n *\n * Type contracts for the Gogo UI components that the host exposes to\n * Tier T plugin remotes as shared externals. At runtime the host's\n * `hostModuleRegistry.ts` registers the actual `@coreconnect/gogo-ui`\n * instances under `\"@ethisyscore/host-ui-externals\"`; the rewriter maps\n * the plugin's bare import to that registry entry.\n *\n * Plugin builds:\n * 1. Add this package as a devDependency.\n * 2. In `vite.config.ts`, add `\"@ethisyscore/host-ui-externals\"` to the\n *    `external` list (the `ethisysPlatformReactPlugin` handles this\n *    automatically in the next build-plugin update).\n * 3. Import types from `\"@ethisyscore/host-ui-externals\"` — these are\n *    erased at compile time and replaced at runtime with the host instance.\n *\n * For local standalone development (plugin CI, Storybook), replace the\n * production import with the mock sub-path:\n * `import { GogoThemeProvider } from \"@ethisyscore/host-ui-externals/mock\";`\n */\n\n// ── Re-exported type contracts ─────────────────────────────────────\n// These are TYPE-ONLY exports. They carry no runtime bundle weight —\n// the actual implementations live in the host's `@coreconnect/gogo-ui`.\n// Imported (not just re-exported) so `ReactNode` is in local scope for the\n// interface declarations below.\nimport type { ComponentType, ReactNode } from \"react\";\nexport type { ComponentType, ReactNode };\n\n/**\n * Gogo theme colour preset union.\n * Mirrors `GogoTheme` from `@coreconnect/gogo-ui` — kept in sync manually\n * until `gogo-ui` is published to npm.\n */\nexport type GogoTheme = \"theme-purple\" | \"theme-blue\" | \"theme-green\" | \"theme-orange\";\n\n/**\n * Gogo light/dark/system mode.\n */\nexport type GogoMode = \"light\" | \"dark\" | \"system\";\n\n/**\n * Props accepted by the host's `GogoThemeProvider`. Plugin remotes that need\n * to wrap their own subtree in the provider use this type.\n */\nexport interface GogoThemeProviderProps {\n  theme?: GogoTheme;\n  mode?: GogoMode;\n  direction?: \"ltr\" | \"rtl\";\n  children: ReactNode;\n}\n\nexport type { ReactNode as GogoChildren };\n\n/**\n * The menu item shape from `@coreconnect/gogo-ui`.\n */\nexport interface GogoMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  href?: string;\n  onClick?: () => void;\n}\n\n// ── Specifier map ──────────────────────────────────────────────────\n\n/**\n * Maps the npm specifier that plugin code imports from to the registry key\n * that `hostModuleRegistry.ts` registers the live instance under.\n *\n * Both keys are `\"@ethisyscore/host-ui-externals\"` because the registry key\n * equals the npm specifier — the rewriter looks up `spec in MODULES` where\n * `spec` is the bare specifier from the plugin's import statement.\n *\n * Plugin Vite configs add the key to `build.rollupOptions.external`.\n * The `ethisysPlatformReactPlugin` vite plugin will auto-add this in its\n * config hook (see `page-bundles.ts` follow-up).\n */\nexport const GOGO_EXTERNALS_SPECIFIER_MAP: Readonly<Record<string, string>> = Object.freeze({\n  \"@ethisyscore/host-ui-externals\": \"@ethisyscore/host-ui-externals\",\n});\n"]}

package/dist/index.d.cts

@@ -0,0 +1,71 @@
+import { ReactNode } from 'react';
+export { ComponentType, ReactNode as GogoChildren, ReactNode } from 'react';
+
+/**
+ * @ethisyscore/host-ui-externals
+ *
+ * Type contracts for the Gogo UI components that the host exposes to
+ * Tier T plugin remotes as shared externals. At runtime the host's
+ * `hostModuleRegistry.ts` registers the actual `@coreconnect/gogo-ui`
+ * instances under `"@ethisyscore/host-ui-externals"`; the rewriter maps
+ * the plugin's bare import to that registry entry.
+ *
+ * Plugin builds:
+ * 1. Add this package as a devDependency.
+ * 2. In `vite.config.ts`, add `"@ethisyscore/host-ui-externals"` to the
+ *    `external` list (the `ethisysPlatformReactPlugin` handles this
+ *    automatically in the next build-plugin update).
+ * 3. Import types from `"@ethisyscore/host-ui-externals"` — these are
+ *    erased at compile time and replaced at runtime with the host instance.
+ *
+ * For local standalone development (plugin CI, Storybook), replace the
+ * production import with the mock sub-path:
+ * `import { GogoThemeProvider } from "@ethisyscore/host-ui-externals/mock";`
+ */
+
+/**
+ * Gogo theme colour preset union.
+ * Mirrors `GogoTheme` from `@coreconnect/gogo-ui` — kept in sync manually
+ * until `gogo-ui` is published to npm.
+ */
+type GogoTheme = "theme-purple" | "theme-blue" | "theme-green" | "theme-orange";
+/**
+ * Gogo light/dark/system mode.
+ */
+type GogoMode = "light" | "dark" | "system";
+/**
+ * Props accepted by the host's `GogoThemeProvider`. Plugin remotes that need
+ * to wrap their own subtree in the provider use this type.
+ */
+interface GogoThemeProviderProps {
+    theme?: GogoTheme;
+    mode?: GogoMode;
+    direction?: "ltr" | "rtl";
+    children: ReactNode;
+}
+
+/**
+ * The menu item shape from `@coreconnect/gogo-ui`.
+ */
+interface GogoMenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    href?: string;
+    onClick?: () => void;
+}
+/**
+ * Maps the npm specifier that plugin code imports from to the registry key
+ * that `hostModuleRegistry.ts` registers the live instance under.
+ *
+ * Both keys are `"@ethisyscore/host-ui-externals"` because the registry key
+ * equals the npm specifier — the rewriter looks up `spec in MODULES` where
+ * `spec` is the bare specifier from the plugin's import statement.
+ *
+ * Plugin Vite configs add the key to `build.rollupOptions.external`.
+ * The `ethisysPlatformReactPlugin` vite plugin will auto-add this in its
+ * config hook (see `page-bundles.ts` follow-up).
+ */
+declare const GOGO_EXTERNALS_SPECIFIER_MAP: Readonly<Record<string, string>>;
+
+export { GOGO_EXTERNALS_SPECIFIER_MAP, type GogoMenuItem, type GogoMode, type GogoTheme, type GogoThemeProviderProps };

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { ReactNode } from 'react';
+export { ComponentType, ReactNode as GogoChildren, ReactNode } from 'react';
+
+/**
+ * @ethisyscore/host-ui-externals
+ *
+ * Type contracts for the Gogo UI components that the host exposes to
+ * Tier T plugin remotes as shared externals. At runtime the host's
+ * `hostModuleRegistry.ts` registers the actual `@coreconnect/gogo-ui`
+ * instances under `"@ethisyscore/host-ui-externals"`; the rewriter maps
+ * the plugin's bare import to that registry entry.
+ *
+ * Plugin builds:
+ * 1. Add this package as a devDependency.
+ * 2. In `vite.config.ts`, add `"@ethisyscore/host-ui-externals"` to the
+ *    `external` list (the `ethisysPlatformReactPlugin` handles this
+ *    automatically in the next build-plugin update).
+ * 3. Import types from `"@ethisyscore/host-ui-externals"` — these are
+ *    erased at compile time and replaced at runtime with the host instance.
+ *
+ * For local standalone development (plugin CI, Storybook), replace the
+ * production import with the mock sub-path:
+ * `import { GogoThemeProvider } from "@ethisyscore/host-ui-externals/mock";`
+ */
+
+/**
+ * Gogo theme colour preset union.
+ * Mirrors `GogoTheme` from `@coreconnect/gogo-ui` — kept in sync manually
+ * until `gogo-ui` is published to npm.
+ */
+type GogoTheme = "theme-purple" | "theme-blue" | "theme-green" | "theme-orange";
+/**
+ * Gogo light/dark/system mode.
+ */
+type GogoMode = "light" | "dark" | "system";
+/**
+ * Props accepted by the host's `GogoThemeProvider`. Plugin remotes that need
+ * to wrap their own subtree in the provider use this type.
+ */
+interface GogoThemeProviderProps {
+    theme?: GogoTheme;
+    mode?: GogoMode;
+    direction?: "ltr" | "rtl";
+    children: ReactNode;
+}
+
+/**
+ * The menu item shape from `@coreconnect/gogo-ui`.
+ */
+interface GogoMenuItem {
+    id: string;
+    label: string;
+    icon?: string;
+    href?: string;
+    onClick?: () => void;
+}
+/**
+ * Maps the npm specifier that plugin code imports from to the registry key
+ * that `hostModuleRegistry.ts` registers the live instance under.
+ *
+ * Both keys are `"@ethisyscore/host-ui-externals"` because the registry key
+ * equals the npm specifier — the rewriter looks up `spec in MODULES` where
+ * `spec` is the bare specifier from the plugin's import statement.
+ *
+ * Plugin Vite configs add the key to `build.rollupOptions.external`.
+ * The `ethisysPlatformReactPlugin` vite plugin will auto-add this in its
+ * config hook (see `page-bundles.ts` follow-up).
+ */
+declare const GOGO_EXTERNALS_SPECIFIER_MAP: Readonly<Record<string, string>>;
+
+export { GOGO_EXTERNALS_SPECIFIER_MAP, type GogoMenuItem, type GogoMode, type GogoTheme, type GogoThemeProviderProps };

package/dist/index.js

@@ -0,0 +1,8 @@
+// src/index.ts
+var GOGO_EXTERNALS_SPECIFIER_MAP = Object.freeze({
+  "@ethisyscore/host-ui-externals": "@ethisyscore/host-ui-externals"
+});
+
+export { GOGO_EXTERNALS_SPECIFIER_MAP };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AAgFO,IAAM,4BAAA,GAAiE,OAAO,MAAA,CAAO;AAAA,EAC1F,gCAAA,EAAkC;AACpC,CAAC","file":"index.js","sourcesContent":["/**\n * @ethisyscore/host-ui-externals\n *\n * Type contracts for the Gogo UI components that the host exposes to\n * Tier T plugin remotes as shared externals. At runtime the host's\n * `hostModuleRegistry.ts` registers the actual `@coreconnect/gogo-ui`\n * instances under `\"@ethisyscore/host-ui-externals\"`; the rewriter maps\n * the plugin's bare import to that registry entry.\n *\n * Plugin builds:\n * 1. Add this package as a devDependency.\n * 2. In `vite.config.ts`, add `\"@ethisyscore/host-ui-externals\"` to the\n *    `external` list (the `ethisysPlatformReactPlugin` handles this\n *    automatically in the next build-plugin update).\n * 3. Import types from `\"@ethisyscore/host-ui-externals\"` — these are\n *    erased at compile time and replaced at runtime with the host instance.\n *\n * For local standalone development (plugin CI, Storybook), replace the\n * production import with the mock sub-path:\n * `import { GogoThemeProvider } from \"@ethisyscore/host-ui-externals/mock\";`\n */\n\n// ── Re-exported type contracts ─────────────────────────────────────\n// These are TYPE-ONLY exports. They carry no runtime bundle weight —\n// the actual implementations live in the host's `@coreconnect/gogo-ui`.\n// Imported (not just re-exported) so `ReactNode` is in local scope for the\n// interface declarations below.\nimport type { ComponentType, ReactNode } from \"react\";\nexport type { ComponentType, ReactNode };\n\n/**\n * Gogo theme colour preset union.\n * Mirrors `GogoTheme` from `@coreconnect/gogo-ui` — kept in sync manually\n * until `gogo-ui` is published to npm.\n */\nexport type GogoTheme = \"theme-purple\" | \"theme-blue\" | \"theme-green\" | \"theme-orange\";\n\n/**\n * Gogo light/dark/system mode.\n */\nexport type GogoMode = \"light\" | \"dark\" | \"system\";\n\n/**\n * Props accepted by the host's `GogoThemeProvider`. Plugin remotes that need\n * to wrap their own subtree in the provider use this type.\n */\nexport interface GogoThemeProviderProps {\n  theme?: GogoTheme;\n  mode?: GogoMode;\n  direction?: \"ltr\" | \"rtl\";\n  children: ReactNode;\n}\n\nexport type { ReactNode as GogoChildren };\n\n/**\n * The menu item shape from `@coreconnect/gogo-ui`.\n */\nexport interface GogoMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  href?: string;\n  onClick?: () => void;\n}\n\n// ── Specifier map ──────────────────────────────────────────────────\n\n/**\n * Maps the npm specifier that plugin code imports from to the registry key\n * that `hostModuleRegistry.ts` registers the live instance under.\n *\n * Both keys are `\"@ethisyscore/host-ui-externals\"` because the registry key\n * equals the npm specifier — the rewriter looks up `spec in MODULES` where\n * `spec` is the bare specifier from the plugin's import statement.\n *\n * Plugin Vite configs add the key to `build.rollupOptions.external`.\n * The `ethisysPlatformReactPlugin` vite plugin will auto-add this in its\n * config hook (see `page-bundles.ts` follow-up).\n */\nexport const GOGO_EXTERNALS_SPECIFIER_MAP: Readonly<Record<string, string>> = Object.freeze({\n  \"@ethisyscore/host-ui-externals\": \"@ethisyscore/host-ui-externals\",\n});\n"]}

package/dist/mock.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+var react = require('react');
+
+// src/mock.ts
+
+// src/index.ts
+var GOGO_EXTERNALS_SPECIFIER_MAP = Object.freeze({
+  "@ethisyscore/host-ui-externals": "@ethisyscore/host-ui-externals"
+});
+
+// src/mock.ts
+var GogoThemeProvider = ({ children }) => react.createElement("div", { "data-testid": "mock-gogo-theme-provider" }, children);
+function useGogoTheme() {
+  return {
+    theme: "theme-blue",
+    setTheme: (_) => {
+    },
+    mode: "light",
+    isDarkMode: false,
+    direction: "ltr",
+    setMode: (_) => {
+    }
+  };
+}
+
+exports.GOGO_EXTERNALS_SPECIFIER_MAP = GOGO_EXTERNALS_SPECIFIER_MAP;
+exports.GogoThemeProvider = GogoThemeProvider;
+exports.useGogoTheme = useGogoTheme;
+//# sourceMappingURL=mock.cjs.map
+//# sourceMappingURL=mock.cjs.map

package/dist/mock.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/mock.ts"],"names":["createElement"],"mappings":";;;;;;;AAgFO,IAAM,4BAAA,GAAiE,OAAO,MAAA,CAAO;AAAA,EAC1F,gCAAA,EAAkC;AACpC,CAAC;;;AC9DM,IAAM,iBAAA,GAAgD,CAAC,EAAE,QAAA,EAAS,KACvEA,mBAAA,CAAc,KAAA,EAAO,EAAE,aAAA,EAAe,0BAAA,EAA2B,EAAG,QAAqB;AAKpF,SAAS,YAAA,GAAe;AAC7B,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,YAAA;AAAA,IACP,QAAA,EAAU,CAAC,CAAA,KAAc;AAAA,IAAC,CAAA;AAAA,IAC1B,IAAA,EAAM,OAAA;AAAA,IACN,UAAA,EAAY,KAAA;AAAA,IACZ,SAAA,EAAW,KAAA;AAAA,IACX,OAAA,EAAS,CAAC,CAAA,KAAc;AAAA,IAAC;AAAA,GAC3B;AACF","file":"mock.cjs","sourcesContent":["/**\n * @ethisyscore/host-ui-externals\n *\n * Type contracts for the Gogo UI components that the host exposes to\n * Tier T plugin remotes as shared externals. At runtime the host's\n * `hostModuleRegistry.ts` registers the actual `@coreconnect/gogo-ui`\n * instances under `\"@ethisyscore/host-ui-externals\"`; the rewriter maps\n * the plugin's bare import to that registry entry.\n *\n * Plugin builds:\n * 1. Add this package as a devDependency.\n * 2. In `vite.config.ts`, add `\"@ethisyscore/host-ui-externals\"` to the\n *    `external` list (the `ethisysPlatformReactPlugin` handles this\n *    automatically in the next build-plugin update).\n * 3. Import types from `\"@ethisyscore/host-ui-externals\"` — these are\n *    erased at compile time and replaced at runtime with the host instance.\n *\n * For local standalone development (plugin CI, Storybook), replace the\n * production import with the mock sub-path:\n * `import { GogoThemeProvider } from \"@ethisyscore/host-ui-externals/mock\";`\n */\n\n// ── Re-exported type contracts ─────────────────────────────────────\n// These are TYPE-ONLY exports. They carry no runtime bundle weight —\n// the actual implementations live in the host's `@coreconnect/gogo-ui`.\n// Imported (not just re-exported) so `ReactNode` is in local scope for the\n// interface declarations below.\nimport type { ComponentType, ReactNode } from \"react\";\nexport type { ComponentType, ReactNode };\n\n/**\n * Gogo theme colour preset union.\n * Mirrors `GogoTheme` from `@coreconnect/gogo-ui` — kept in sync manually\n * until `gogo-ui` is published to npm.\n */\nexport type GogoTheme = \"theme-purple\" | \"theme-blue\" | \"theme-green\" | \"theme-orange\";\n\n/**\n * Gogo light/dark/system mode.\n */\nexport type GogoMode = \"light\" | \"dark\" | \"system\";\n\n/**\n * Props accepted by the host's `GogoThemeProvider`. Plugin remotes that need\n * to wrap their own subtree in the provider use this type.\n */\nexport interface GogoThemeProviderProps {\n  theme?: GogoTheme;\n  mode?: GogoMode;\n  direction?: \"ltr\" | \"rtl\";\n  children: ReactNode;\n}\n\nexport type { ReactNode as GogoChildren };\n\n/**\n * The menu item shape from `@coreconnect/gogo-ui`.\n */\nexport interface GogoMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  href?: string;\n  onClick?: () => void;\n}\n\n// ── Specifier map ──────────────────────────────────────────────────\n\n/**\n * Maps the npm specifier that plugin code imports from to the registry key\n * that `hostModuleRegistry.ts` registers the live instance under.\n *\n * Both keys are `\"@ethisyscore/host-ui-externals\"` because the registry key\n * equals the npm specifier — the rewriter looks up `spec in MODULES` where\n * `spec` is the bare specifier from the plugin's import statement.\n *\n * Plugin Vite configs add the key to `build.rollupOptions.external`.\n * The `ethisysPlatformReactPlugin` vite plugin will auto-add this in its\n * config hook (see `page-bundles.ts` follow-up).\n */\nexport const GOGO_EXTERNALS_SPECIFIER_MAP: Readonly<Record<string, string>> = Object.freeze({\n  \"@ethisyscore/host-ui-externals\": \"@ethisyscore/host-ui-externals\",\n});\n","/**\n * @ethisyscore/host-ui-externals/mock\n *\n * Stub implementations of every host-ui-externals export for use in\n * plugin CI, Storybook, and local development (when no host is running).\n * Renders plain semantic HTML with the correct `data-testid` attributes so\n * plugin tests can assert on structure without a real MUI/Gogo tree.\n *\n * Uses `createElement` (not JSX) so this stays a plain `.ts` module — no\n * `jsx` tsconfig setting required for the package's type-check/build.\n */\nimport { createElement, type FC, type ReactNode } from \"react\";\nimport type { GogoThemeProviderProps } from \"./index\";\nexport type { GogoTheme, GogoMode, GogoThemeProviderProps, GogoMenuItem } from \"./index\";\nexport { GOGO_EXTERNALS_SPECIFIER_MAP } from \"./index\";\n\n/**\n * Mock `GogoThemeProvider` — simply renders `children` inside a `<div>`.\n * Does NOT apply any MUI theme; sufficient for unit/smoke tests.\n */\nexport const GogoThemeProvider: FC<GogoThemeProviderProps> = ({ children }) =>\n  createElement(\"div\", { \"data-testid\": \"mock-gogo-theme-provider\" }, children as ReactNode);\n\n/**\n * Mock `useGogoTheme` — returns stable no-op values.\n */\nexport function useGogoTheme() {\n  return {\n    theme: \"theme-blue\" as const,\n    setTheme: (_: string) => {},\n    mode: \"light\" as const,\n    isDarkMode: false,\n    direction: \"ltr\" as const,\n    setMode: (_: string) => {},\n  };\n}\n"]}

package/dist/mock.d.cts

@@ -0,0 +1,34 @@
+import { FC } from 'react';
+import { GogoThemeProviderProps } from './index.cjs';
+export { GOGO_EXTERNALS_SPECIFIER_MAP, GogoMenuItem, GogoMode, GogoTheme } from './index.cjs';
+
+/**
+ * @ethisyscore/host-ui-externals/mock
+ *
+ * Stub implementations of every host-ui-externals export for use in
+ * plugin CI, Storybook, and local development (when no host is running).
+ * Renders plain semantic HTML with the correct `data-testid` attributes so
+ * plugin tests can assert on structure without a real MUI/Gogo tree.
+ *
+ * Uses `createElement` (not JSX) so this stays a plain `.ts` module — no
+ * `jsx` tsconfig setting required for the package's type-check/build.
+ */
+
+/**
+ * Mock `GogoThemeProvider` — simply renders `children` inside a `<div>`.
+ * Does NOT apply any MUI theme; sufficient for unit/smoke tests.
+ */
+declare const GogoThemeProvider: FC<GogoThemeProviderProps>;
+/**
+ * Mock `useGogoTheme` — returns stable no-op values.
+ */
+declare function useGogoTheme(): {
+    theme: "theme-blue";
+    setTheme: (_: string) => void;
+    mode: "light";
+    isDarkMode: boolean;
+    direction: "ltr";
+    setMode: (_: string) => void;
+};
+
+export { GogoThemeProvider, GogoThemeProviderProps, useGogoTheme };

package/dist/mock.d.ts

@@ -0,0 +1,34 @@
+import { FC } from 'react';
+import { GogoThemeProviderProps } from './index.js';
+export { GOGO_EXTERNALS_SPECIFIER_MAP, GogoMenuItem, GogoMode, GogoTheme } from './index.js';
+
+/**
+ * @ethisyscore/host-ui-externals/mock
+ *
+ * Stub implementations of every host-ui-externals export for use in
+ * plugin CI, Storybook, and local development (when no host is running).
+ * Renders plain semantic HTML with the correct `data-testid` attributes so
+ * plugin tests can assert on structure without a real MUI/Gogo tree.
+ *
+ * Uses `createElement` (not JSX) so this stays a plain `.ts` module — no
+ * `jsx` tsconfig setting required for the package's type-check/build.
+ */
+
+/**
+ * Mock `GogoThemeProvider` — simply renders `children` inside a `<div>`.
+ * Does NOT apply any MUI theme; sufficient for unit/smoke tests.
+ */
+declare const GogoThemeProvider: FC<GogoThemeProviderProps>;
+/**
+ * Mock `useGogoTheme` — returns stable no-op values.
+ */
+declare function useGogoTheme(): {
+    theme: "theme-blue";
+    setTheme: (_: string) => void;
+    mode: "light";
+    isDarkMode: boolean;
+    direction: "ltr";
+    setMode: (_: string) => void;
+};
+
+export { GogoThemeProvider, GogoThemeProviderProps, useGogoTheme };

package/dist/mock.js

@@ -0,0 +1,27 @@
+import { createElement } from 'react';
+
+// src/mock.ts
+
+// src/index.ts
+var GOGO_EXTERNALS_SPECIFIER_MAP = Object.freeze({
+  "@ethisyscore/host-ui-externals": "@ethisyscore/host-ui-externals"
+});
+
+// src/mock.ts
+var GogoThemeProvider = ({ children }) => createElement("div", { "data-testid": "mock-gogo-theme-provider" }, children);
+function useGogoTheme() {
+  return {
+    theme: "theme-blue",
+    setTheme: (_) => {
+    },
+    mode: "light",
+    isDarkMode: false,
+    direction: "ltr",
+    setMode: (_) => {
+    }
+  };
+}
+
+export { GOGO_EXTERNALS_SPECIFIER_MAP, GogoThemeProvider, useGogoTheme };
+//# sourceMappingURL=mock.js.map
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/mock.ts"],"names":[],"mappings":";;;;;AAgFO,IAAM,4BAAA,GAAiE,OAAO,MAAA,CAAO;AAAA,EAC1F,gCAAA,EAAkC;AACpC,CAAC;;;AC9DM,IAAM,iBAAA,GAAgD,CAAC,EAAE,QAAA,EAAS,KACvE,aAAA,CAAc,KAAA,EAAO,EAAE,aAAA,EAAe,0BAAA,EAA2B,EAAG,QAAqB;AAKpF,SAAS,YAAA,GAAe;AAC7B,EAAA,OAAO;AAAA,IACL,KAAA,EAAO,YAAA;AAAA,IACP,QAAA,EAAU,CAAC,CAAA,KAAc;AAAA,IAAC,CAAA;AAAA,IAC1B,IAAA,EAAM,OAAA;AAAA,IACN,UAAA,EAAY,KAAA;AAAA,IACZ,SAAA,EAAW,KAAA;AAAA,IACX,OAAA,EAAS,CAAC,CAAA,KAAc;AAAA,IAAC;AAAA,GAC3B;AACF","file":"mock.js","sourcesContent":["/**\n * @ethisyscore/host-ui-externals\n *\n * Type contracts for the Gogo UI components that the host exposes to\n * Tier T plugin remotes as shared externals. At runtime the host's\n * `hostModuleRegistry.ts` registers the actual `@coreconnect/gogo-ui`\n * instances under `\"@ethisyscore/host-ui-externals\"`; the rewriter maps\n * the plugin's bare import to that registry entry.\n *\n * Plugin builds:\n * 1. Add this package as a devDependency.\n * 2. In `vite.config.ts`, add `\"@ethisyscore/host-ui-externals\"` to the\n *    `external` list (the `ethisysPlatformReactPlugin` handles this\n *    automatically in the next build-plugin update).\n * 3. Import types from `\"@ethisyscore/host-ui-externals\"` — these are\n *    erased at compile time and replaced at runtime with the host instance.\n *\n * For local standalone development (plugin CI, Storybook), replace the\n * production import with the mock sub-path:\n * `import { GogoThemeProvider } from \"@ethisyscore/host-ui-externals/mock\";`\n */\n\n// ── Re-exported type contracts ─────────────────────────────────────\n// These are TYPE-ONLY exports. They carry no runtime bundle weight —\n// the actual implementations live in the host's `@coreconnect/gogo-ui`.\n// Imported (not just re-exported) so `ReactNode` is in local scope for the\n// interface declarations below.\nimport type { ComponentType, ReactNode } from \"react\";\nexport type { ComponentType, ReactNode };\n\n/**\n * Gogo theme colour preset union.\n * Mirrors `GogoTheme` from `@coreconnect/gogo-ui` — kept in sync manually\n * until `gogo-ui` is published to npm.\n */\nexport type GogoTheme = \"theme-purple\" | \"theme-blue\" | \"theme-green\" | \"theme-orange\";\n\n/**\n * Gogo light/dark/system mode.\n */\nexport type GogoMode = \"light\" | \"dark\" | \"system\";\n\n/**\n * Props accepted by the host's `GogoThemeProvider`. Plugin remotes that need\n * to wrap their own subtree in the provider use this type.\n */\nexport interface GogoThemeProviderProps {\n  theme?: GogoTheme;\n  mode?: GogoMode;\n  direction?: \"ltr\" | \"rtl\";\n  children: ReactNode;\n}\n\nexport type { ReactNode as GogoChildren };\n\n/**\n * The menu item shape from `@coreconnect/gogo-ui`.\n */\nexport interface GogoMenuItem {\n  id: string;\n  label: string;\n  icon?: string;\n  href?: string;\n  onClick?: () => void;\n}\n\n// ── Specifier map ──────────────────────────────────────────────────\n\n/**\n * Maps the npm specifier that plugin code imports from to the registry key\n * that `hostModuleRegistry.ts` registers the live instance under.\n *\n * Both keys are `\"@ethisyscore/host-ui-externals\"` because the registry key\n * equals the npm specifier — the rewriter looks up `spec in MODULES` where\n * `spec` is the bare specifier from the plugin's import statement.\n *\n * Plugin Vite configs add the key to `build.rollupOptions.external`.\n * The `ethisysPlatformReactPlugin` vite plugin will auto-add this in its\n * config hook (see `page-bundles.ts` follow-up).\n */\nexport const GOGO_EXTERNALS_SPECIFIER_MAP: Readonly<Record<string, string>> = Object.freeze({\n  \"@ethisyscore/host-ui-externals\": \"@ethisyscore/host-ui-externals\",\n});\n","/**\n * @ethisyscore/host-ui-externals/mock\n *\n * Stub implementations of every host-ui-externals export for use in\n * plugin CI, Storybook, and local development (when no host is running).\n * Renders plain semantic HTML with the correct `data-testid` attributes so\n * plugin tests can assert on structure without a real MUI/Gogo tree.\n *\n * Uses `createElement` (not JSX) so this stays a plain `.ts` module — no\n * `jsx` tsconfig setting required for the package's type-check/build.\n */\nimport { createElement, type FC, type ReactNode } from \"react\";\nimport type { GogoThemeProviderProps } from \"./index\";\nexport type { GogoTheme, GogoMode, GogoThemeProviderProps, GogoMenuItem } from \"./index\";\nexport { GOGO_EXTERNALS_SPECIFIER_MAP } from \"./index\";\n\n/**\n * Mock `GogoThemeProvider` — simply renders `children` inside a `<div>`.\n * Does NOT apply any MUI theme; sufficient for unit/smoke tests.\n */\nexport const GogoThemeProvider: FC<GogoThemeProviderProps> = ({ children }) =>\n  createElement(\"div\", { \"data-testid\": \"mock-gogo-theme-provider\" }, children as ReactNode);\n\n/**\n * Mock `useGogoTheme` — returns stable no-op values.\n */\nexport function useGogoTheme() {\n  return {\n    theme: \"theme-blue\" as const,\n    setTheme: (_: string) => {},\n    mode: \"light\" as const,\n    isDarkMode: false,\n    direction: \"ltr\" as const,\n    setMode: (_: string) => {},\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ethisyscore/host-ui-externals",
+  "version": "1.10.0",
+  "description": "Type contracts and mock build for Tier T host-supplied Gogo UI externals. Plugin builds depend on this as a dev-dep; production bundles externalise the specifier so the host's registered module instance is used at runtime.",
+  "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"
+    },
+    "./mock": {
+      "types": "./dist/mock.d.ts",
+      "import": "./dist/mock.js",
+      "require": "./dist/mock.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "keywords": [
+    "ethisyscore",
+    "tier-t",
+    "gogo-ui",
+    "externals",
+    "plugin"
+  ],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ethisysltd/ethisyscore-plugin-sdk"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}