@ethisyscore/plugin-ui 1.16.0 → 1.18.0

package/dist/platform-react/index.js

@@ -0,0 +1,229 @@
+import { createContext, useEffect, createElement, useContext, useMemo } from 'react';
+import { QueryClient, useQuery, useQueries, QueryClientProvider } from '@tanstack/react-query';
+import { definePlatformReactPage, emitNavigation } from '@ethisyscore/components-react';
+import { useMcpTool } from '@ethisyscore/extension-runtime/plugin';
+
+// src/platform-react/definePlatformReactPluginPage.tsx
+var TemplateContext = createContext(null);
+function injectPluginStyles(id, css) {
+  if (typeof document === "undefined") return;
+  if (document.getElementById(id)) return;
+  const el = document.createElement("style");
+  el.id = id;
+  el.textContent = css;
+  document.head.appendChild(el);
+}
+function PluginStyleScope({ id, css }) {
+  useEffect(() => {
+    injectPluginStyles(id, css);
+  }, [id, css]);
+  return null;
+}
+
+// src/platform-react/definePlatformReactPluginPage.tsx
+function makeDefaultQueryClient() {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        retry: 1,
+        refetchOnWindowFocus: false,
+        staleTime: 3e4
+      }
+    }
+  });
+}
+var defaultQueryClient = makeDefaultQueryClient();
+function definePlatformReactPluginPage(Page, options) {
+  const {
+    manifest = {},
+    rootClassName,
+    styleId,
+    css,
+    queryClient = defaultQueryClient
+  } = options;
+  function PluginPage(props) {
+    return createElement(
+      QueryClientProvider,
+      { client: queryClient },
+      createElement(
+        TemplateContext.Provider,
+        { value: manifest },
+        createElement(PluginStyleScope, { id: styleId, css }),
+        createElement("div", { className: rootClassName }, createElement(Page, props))
+      )
+    );
+  }
+  return definePlatformReactPage(PluginPage);
+}
+function createPluginPageDefiner(config) {
+  const { module, ...rest } = config;
+  return function definePluginPage(Page, views = {}) {
+    return definePlatformReactPluginPage(Page, { ...rest, manifest: { [module]: views } });
+  };
+}
+var MissingViewFallback = () => createElement(
+  "div",
+  {
+    style: {
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "center",
+      padding: "2rem"
+    }
+  },
+  createElement(
+    "div",
+    {
+      style: {
+        maxWidth: "28rem",
+        padding: "1.5rem",
+        border: "1px solid rgba(0,0,0,0.12)",
+        borderRadius: "0.5rem",
+        textAlign: "center"
+      }
+    },
+    createElement("p", { style: { margin: "0 0 0.5rem", fontWeight: 600 } }, "View not available"),
+    createElement(
+      "p",
+      { style: { margin: 0, opacity: 0.7, fontSize: "0.875rem" } },
+      "This view has not been implemented by the current template."
+    )
+  )
+);
+
+// src/platform-react/useView.ts
+var REACT_LAZY_TYPE = /* @__PURE__ */ Symbol.for("react.lazy");
+function isComponent(value) {
+  if (typeof value === "function") return true;
+  if (typeof value === "object" && value !== null) {
+    return value.$$typeof === REACT_LAZY_TYPE;
+  }
+  return false;
+}
+function createUseView(fallback) {
+  return function useView2(module, viewName) {
+    const manifest = useContext(TemplateContext);
+    if (!manifest) {
+      return fallback;
+    }
+    const slice = manifest[module];
+    if (slice && typeof slice === "object" && viewName in slice) {
+      const component = slice[viewName];
+      if (isComponent(component)) {
+        return component;
+      }
+    }
+    return fallback;
+  };
+}
+var useView = createUseView(MissingViewFallback);
+var BaseMcpService = class {
+  constructor(invoker) {
+    this.invoker = invoker;
+  }
+  invoker;
+  async tool(name, args = {}) {
+    return await this.invoker(name, args);
+  }
+};
+function notViaMcp(serviceName, method) {
+  throw new Error(`${serviceName}.${method} has no MCP tool \u2014 pending per-surface aggregation.`);
+}
+function useToolInvoker(toolName) {
+  return useMcpTool(toolName).invoke;
+}
+function useToolInvokerMap(tools) {
+  const invokers = {};
+  for (const name of tools) {
+    invokers[name] = useMcpTool(name).invoke;
+  }
+  return useMemo(
+    () => (name, args) => {
+      const fn = invokers[name];
+      if (!fn) {
+        throw new Error(`No MCP invoker registered for tool "${name}"`);
+      }
+      return fn(args);
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps -- per-tool invoke refs are stable; rebuild only if one changes.
+    tools.map((t) => invokers[t])
+  );
+}
+function useAuthenticatedQuery(options) {
+  const result = useQuery(options);
+  return {
+    ...result,
+    isLoading: result.isLoading,
+    isAuthLoading: false
+  };
+}
+function useAuthenticatedQueries(queries) {
+  return useQueries({ queries });
+}
+function createReactRouterShim(options = {}) {
+  const paramKeys = options.paramKeys ?? ["id"];
+  function useNavigate() {
+    return (to) => {
+      if (typeof to === "number") {
+        if (typeof window !== "undefined") window.history.go(to);
+        return;
+      }
+      emitNavigation(to);
+    };
+  }
+  function useParams() {
+    const path = typeof window !== "undefined" ? window.location.pathname : "";
+    const segments = path.split("/").filter(Boolean);
+    const last = segments[segments.length - 1];
+    const params = {};
+    if (last) {
+      for (const key of paramKeys) {
+        params[key] = last;
+      }
+    }
+    return params;
+  }
+  function useSearchParams() {
+    const search = typeof window !== "undefined" ? window.location.search : "";
+    const params = new URLSearchParams(search);
+    const setSearchParams = (next) => {
+      const usp = next instanceof URLSearchParams ? next : new URLSearchParams(next);
+      const qs = usp.toString();
+      if (typeof window !== "undefined") {
+        window.history.replaceState(
+          {},
+          "",
+          qs ? `${window.location.pathname}?${qs}` : window.location.pathname
+        );
+      }
+    };
+    return [params, setSearchParams];
+  }
+  function useMatch(_pattern) {
+    return null;
+  }
+  function useLocation() {
+    const path = typeof window !== "undefined" ? window.location.pathname : "/";
+    return { pathname: path, search: "", hash: "", state: null, key: "default" };
+  }
+  function Link({ to, children, onClick, ...rest }) {
+    return createElement(
+      "a",
+      {
+        href: to,
+        onClick: (e) => {
+          e.preventDefault();
+          onClick?.(e);
+          emitNavigation(to);
+        },
+        ...rest
+      },
+      children
+    );
+  }
+  return { useNavigate, useParams, useSearchParams, useMatch, useLocation, Link, NavLink: Link };
+}
+
+export { BaseMcpService, MissingViewFallback, PluginStyleScope, TemplateContext, createPluginPageDefiner, createReactRouterShim, createUseView, definePlatformReactPluginPage, injectPluginStyles, isComponent, notViaMcp, useAuthenticatedQueries, useAuthenticatedQuery, useToolInvoker, useToolInvokerMap, useView };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/platform-react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/platform-react/templateContext.ts","../../src/platform-react/injectStyles.ts","../../src/platform-react/definePlatformReactPluginPage.tsx","../../src/platform-react/MissingViewFallback.tsx","../../src/platform-react/useView.ts","../../src/platform-react/mcpService.ts","../../src/platform-react/useAuthenticatedQuery.ts","../../src/platform-react/reactRouterShim.tsx"],"names":["createElement","useView"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext, type ComponentType } from \"react\";\n\n/** A view component resolved from the template manifest. Props are open. */\nexport type ViewComponent = ComponentType<Record<string, unknown>>;\n\n/**\n * Static port of the monolith's gogo-ui adapter mechanism for PlatformReact.\n *\n * A monolith feature picks its adapter view at runtime via `import.meta.glob`;\n * a PlatformReact page is a single self-contained ESM bundle where that glob is\n * unavailable, so each page declares its view slice statically and provides it\n * through this context. The shape is `manifest[module][viewName] = Component`.\n */\nexport type TemplateManifest = Record<string, Partial<Record<string, ViewComponent>>>;\n\nexport const TemplateContext = createContext<TemplateManifest | null>(null);\n","import { useEffect } from \"react\";\n\n/**\n * Injects a plugin's compiled CSS into the host document once, keyed by a\n * stable element id (idempotent across pages and re-mounts).\n *\n * Each PlatformReact page is a separate ESM bundle with no companion CSS asset\n * the host would load, so the styles travel inside the bundle (typically via a\n * `*.css?inline` import) and are mounted at runtime. Scope the CSS to a plugin\n * root class (never `:root`) so it cannot override the host theme.\n */\nexport function injectPluginStyles(id: string, css: string): void {\n  if (typeof document === \"undefined\") return;\n  if (document.getElementById(id)) return;\n  const el = document.createElement(\"style\");\n  el.id = id;\n  el.textContent = css;\n  document.head.appendChild(el);\n}\n\n/** Component form of {@link injectPluginStyles}; renders nothing. */\nexport function PluginStyleScope({ id, css }: { id: string; css: string }): null {\n  useEffect(() => {\n    injectPluginStyles(id, css);\n  }, [id, css]);\n  return null;\n}\n","import { createElement, type ComponentType } from \"react\";\nimport { QueryClient, QueryClientProvider } from \"@tanstack/react-query\";\nimport {\n  definePlatformReactPage,\n  type PlatformReactPageProps,\n} from \"@ethisyscore/components-react\";\nimport { TemplateContext, type TemplateManifest, type ViewComponent } from \"./templateContext\";\nimport { PluginStyleScope } from \"./injectStyles\";\n\n/**\n * Default per-page `QueryClient`. Each PlatformReact page is an isolated ESM\n * bundle, so this module-level singleton is scoped to that page — exactly the\n * lifetime a page wants. Plugins needing different options pass their own.\n */\nfunction makeDefaultQueryClient(): QueryClient {\n  return new QueryClient({\n    defaultOptions: {\n      queries: {\n        retry: 1,\n        refetchOnWindowFocus: false,\n        staleTime: 30_000,\n      },\n    },\n  });\n}\n\nconst defaultQueryClient = makeDefaultQueryClient();\n\nexport interface DefinePlatformReactPluginPageOptions {\n  /** The page's static `useView` manifest slice (no `import.meta.glob` in a single-file bundle). */\n  manifest?: TemplateManifest;\n  /** Scoped style-root class wrapped around the page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element (idempotent across pages). */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n}\n\n/**\n * Wraps a lifted page as a PlatformReact entry with the providers the monolith\n * took for granted: react-query, the static `useView` manifest, and the scoped\n * style root. The host already provides the MCP transport (it mounts pages\n * inside its own runtime provider), so this adds only the in-page providers.\n */\nexport function definePlatformReactPluginPage(\n  Page: ComponentType<PlatformReactPageProps>,\n  options: DefinePlatformReactPluginPageOptions,\n): ComponentType<PlatformReactPageProps> {\n  const {\n    manifest = {},\n    rootClassName,\n    styleId,\n    css,\n    queryClient = defaultQueryClient,\n  } = options;\n\n  function PluginPage(props: PlatformReactPageProps) {\n    return createElement(\n      QueryClientProvider,\n      { client: queryClient },\n      createElement(\n        TemplateContext.Provider,\n        { value: manifest },\n        createElement(PluginStyleScope, { id: styleId, css }),\n        createElement(\"div\", { className: rootClassName }, createElement(Page, props)),\n      ),\n    );\n  }\n\n  return definePlatformReactPage(PluginPage);\n}\n\nexport interface PluginPageDefinerConfig {\n  /**\n   * The plugin's `useView` module key (e.g. `\"timesheets\"`). Each page's `views`\n   * are registered under it, so a page's `useView(module, name)` resolves them.\n   */\n  module: string;\n  /** Scoped style-root class wrapped around every page (e.g. `ethisys-<plugin>-root`). */\n  rootClassName: string;\n  /** Stable id for the injected `<style>` element. */\n  styleId: string;\n  /** The plugin's compiled CSS string (typically a `*.css?inline` import). */\n  css: string;\n  /** Override the per-page `QueryClient`. */\n  queryClient?: QueryClient;\n}\n\n/**\n * Builds a plugin-bound `definePluginPage(Page, views)` from one config, so a\n * plugin writes the four plugin-specific values (module key, root class, style\n * id, CSS) ONCE instead of in every page entry. Each surface entry then calls\n * `definePluginPage(Page, { ViewName })`; the flat `views` map is wrapped into\n * the `{ [module]: views }` manifest slice the page's `useView(module, name)`\n * reads. The generic provider/manifest/style wrapping stays in\n * {@link definePlatformReactPluginPage}.\n */\nexport function createPluginPageDefiner(config: PluginPageDefinerConfig) {\n  const { module, ...rest } = config;\n  return function definePluginPage(\n    Page: ComponentType<PlatformReactPageProps>,\n    views: Record<string, ViewComponent> = {},\n  ): ComponentType<PlatformReactPageProps> {\n    return definePlatformReactPluginPage(Page, { ...rest, manifest: { [module]: views } });\n  };\n}\n","import { createElement, type ComponentType } from \"react\";\n\n/**\n * Dependency-light fallback rendered when a view is not present in the current\n * template manifest. Kept to plain elements + inline styles so the foundation\n * package carries no UI-library dependency; plugins that want a branded\n * fallback pass their own via {@link createUseView}.\n */\nexport const MissingViewFallback: ComponentType<Record<string, unknown>> = () =>\n  createElement(\n    \"div\",\n    {\n      style: {\n        display: \"flex\",\n        alignItems: \"center\",\n        justifyContent: \"center\",\n        padding: \"2rem\",\n      },\n    },\n    createElement(\n      \"div\",\n      {\n        style: {\n          maxWidth: \"28rem\",\n          padding: \"1.5rem\",\n          border: \"1px solid rgba(0,0,0,0.12)\",\n          borderRadius: \"0.5rem\",\n          textAlign: \"center\",\n        },\n      },\n      createElement(\"p\", { style: { margin: \"0 0 0.5rem\", fontWeight: 600 } }, \"View not available\"),\n      createElement(\n        \"p\",\n        { style: { margin: 0, opacity: 0.7, fontSize: \"0.875rem\" } },\n        \"This view has not been implemented by the current template.\",\n      ),\n    ),\n  );\n","import { useContext, type ComponentType } from \"react\";\nimport { TemplateContext } from \"./templateContext\";\nimport { MissingViewFallback } from \"./MissingViewFallback\";\n\nconst REACT_LAZY_TYPE = Symbol.for(\"react.lazy\");\n\n/** Matches regular function components and `React.lazy` wrappers. */\nexport function isComponent(value: unknown): value is ComponentType {\n  if (typeof value === \"function\") return true;\n  if (typeof value === \"object\" && value !== null) {\n    return (value as Record<string, unknown>).$$typeof === REACT_LAZY_TYPE;\n  }\n  return false;\n}\n\n/**\n * Builds a `useView` hook bound to a fallback component. The hook is a safe\n * view accessor that never throws: it returns `manifest[module][viewName]` when\n * present, or the supplied fallback when the manifest, module slice, or view is\n * missing or is not a component.\n */\nexport function createUseView(fallback: ComponentType<Record<string, unknown>>) {\n  return function useView(\n    module: string,\n    viewName: string,\n  ): ComponentType<Record<string, unknown>> {\n    const manifest = useContext(TemplateContext);\n    if (!manifest) {\n      return fallback;\n    }\n\n    const slice = manifest[module];\n    if (slice && typeof slice === \"object\" && viewName in (slice as Record<string, unknown>)) {\n      const component = (slice as Record<string, unknown>)[viewName];\n      if (isComponent(component)) {\n        return component as ComponentType<Record<string, unknown>>;\n      }\n    }\n\n    return fallback;\n  };\n}\n\n/** Default `useView` bound to the built-in {@link MissingViewFallback}. */\nexport const useView = createUseView(MissingViewFallback);\n","import { useMemo } from \"react\";\nimport { useMcpTool } from \"@ethisyscore/extension-runtime/plugin\";\n\n/** Dispatches an MCP tool call by name. The seam a lifted REST service binds to. */\nexport type ToolInvoker = (toolName: string, args: unknown) => Promise<unknown>;\n\n/**\n * Base for service classes lifted from a monolith REST plane onto MCP.\n *\n * The monolith versions extend a REST base (`this.get`/`this.post` over axios).\n * The plugin runtime exposes no imperative MCP transport — only the\n * `useMcpTool` hook — so a `useXService()` hook composes per-tool invokers (see\n * {@link useToolInvokerMap}) into a single {@link ToolInvoker} and constructs\n * the class with it. Method bodies call `this.tool(\"<tool-name>\", args)`.\n */\nexport abstract class BaseMcpService {\n  constructor(private readonly invoker: ToolInvoker) {}\n\n  protected async tool<TRes>(name: string, args: unknown = {}): Promise<TRes> {\n    return (await this.invoker(name, args)) as TRes;\n  }\n}\n\n/**\n * Thrown by a lifted service method whose monolith REST route has no MCP tool\n * yet (typically because it needs client-side aggregation over a coarser tool).\n */\nexport function notViaMcp(serviceName: string, method: string): never {\n  throw new Error(`${serviceName}.${method} has no MCP tool — pending per-surface aggregation.`);\n}\n\n/** Imperative invoker for a single MCP tool (the hook's `.invoke`, stable across renders). */\nexport function useToolInvoker<TReq, TRes>(toolName: string): (req: TReq) => Promise<TRes> {\n  return useMcpTool<TReq, TRes>(toolName).invoke;\n}\n\n/**\n * Composes one {@link ToolInvoker} dispatching over every tool in `tools`, so a\n * service class can call tools by name.\n *\n * Rules of hooks: `tools` MUST be a frozen, constant-length list (e.g. a\n * module-level `as const` array) so the per-tool `useMcpTool` calls run in a\n * stable order on every render. Passing a list whose length varies between\n * renders is a violation and will break.\n */\nexport function useToolInvokerMap(tools: readonly string[]): ToolInvoker {\n  const invokers: Record<string, (args: unknown) => Promise<unknown>> = {};\n  for (const name of tools) {\n    // eslint-disable-next-line react-hooks/rules-of-hooks -- `tools` is required to be frozen; call order is stable.\n    invokers[name] = useMcpTool(name).invoke;\n  }\n  return useMemo<ToolInvoker>(\n    () => (name, args) => {\n      const fn = invokers[name];\n      if (!fn) {\n        throw new Error(`No MCP invoker registered for tool \"${name}\"`);\n      }\n      return fn(args);\n    },\n    // eslint-disable-next-line react-hooks/exhaustive-deps -- per-tool invoke refs are stable; rebuild only if one changes.\n    tools.map((t) => invokers[t]),\n  );\n}\n","import {\n  useQueries,\n  useQuery,\n  type QueryKey,\n  type UseQueryOptions,\n  type UseQueryResult,\n} from \"@tanstack/react-query\";\n\n/**\n * Plugin shim for the monolith's `useAuthenticatedQuery`.\n *\n * In the host realm the MCP transport is already authenticated and scoped to\n * the active organisation, so there is no auth gate to apply. The hook keeps\n * the monolith's return shape (`isLoading` + `isAuthLoading`) so lifted data\n * hooks and pages consume it unchanged — `isAuthLoading` is always `false`.\n */\nexport interface AuthenticatedQueryResult<TData, TError>\n  extends Omit<UseQueryResult<TData, TError>, \"isLoading\"> {\n  isLoading: boolean;\n  isAuthLoading: boolean;\n}\n\nexport function useAuthenticatedQuery<\n  TQueryFnData = unknown,\n  TError = Error,\n  TData = TQueryFnData,\n  TQueryKey extends QueryKey = QueryKey,\n>(\n  options: UseQueryOptions<TQueryFnData, TError, TData, TQueryKey>,\n): AuthenticatedQueryResult<TData, TError> {\n  const result = useQuery(options);\n  return {\n    ...result,\n    isLoading: result.isLoading,\n    isAuthLoading: false,\n  };\n}\n\nexport function useAuthenticatedQueries<TQueryFnData = unknown, TError = Error>(\n  queries: UseQueryOptions<TQueryFnData, TError>[],\n) {\n  return useQueries({ queries });\n}\n","import { createElement, type AnchorHTMLAttributes, type MouseEvent, type ReactNode } from \"react\";\nimport { emitNavigation } from \"@ethisyscore/components-react\";\n\n/**\n * Minimal `react-router-dom` compatibility shim for lifted monolith code.\n *\n * A PlatformReact plugin has no client router — navigation is brokered to the\n * host via {@link emitNavigation}, and route params come from the surface URL's\n * trailing segment(s). {@link createReactRouterShim} returns a module-shaped\n * object of the hooks/components lifted code expects; alias `react-router-dom`\n * to a tiny file that re-exports this object's members so call sites resolve\n * unchanged.\n *\n * `paramKeys` names the keys the single trailing path segment is exposed under,\n * so a route like `/…/<page>/<value>` satisfies `useParams<{ id }>()` /\n * `useParams<{ date }>()` regardless of which key the lifted code destructures.\n */\nexport interface ReactRouterShimOptions {\n  /** Keys the trailing path segment is exposed under (default: `[\"id\"]`). */\n  paramKeys?: readonly string[];\n}\n\ntype LinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {\n  to: string;\n  children?: ReactNode;\n};\n\nexport function createReactRouterShim(options: ReactRouterShimOptions = {}) {\n  const paramKeys = options.paramKeys ?? [\"id\"];\n\n  function useNavigate(): (to: string | number) => void {\n    return (to) => {\n      if (typeof to === \"number\") {\n        if (typeof window !== \"undefined\") window.history.go(to);\n        return;\n      }\n      emitNavigation(to);\n    };\n  }\n\n  function useParams<\n    T extends Record<string, string | undefined> = Record<string, string | undefined>,\n  >(): T {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"\";\n    const segments = path.split(\"/\").filter(Boolean);\n    const last = segments[segments.length - 1];\n    const params: Record<string, string | undefined> = {};\n    if (last) {\n      for (const key of paramKeys) {\n        params[key] = last;\n      }\n    }\n    return params as T;\n  }\n\n  function useSearchParams(): [\n    URLSearchParams,\n    (next: URLSearchParams | Record<string, string>) => void,\n  ] {\n    const search = typeof window !== \"undefined\" ? window.location.search : \"\";\n    const params = new URLSearchParams(search);\n    const setSearchParams = (next: URLSearchParams | Record<string, string>) => {\n      const usp = next instanceof URLSearchParams ? next : new URLSearchParams(next);\n      const qs = usp.toString();\n      if (typeof window !== \"undefined\") {\n        window.history.replaceState(\n          {},\n          \"\",\n          qs ? `${window.location.pathname}?${qs}` : window.location.pathname,\n        );\n      }\n    };\n    return [params, setSearchParams];\n  }\n\n  function useMatch(\n    _pattern: string,\n  ): { params: Record<string, string | undefined>; pathname: string } | null {\n    return null;\n  }\n\n  function useLocation() {\n    const path = typeof window !== \"undefined\" ? window.location.pathname : \"/\";\n    return { pathname: path, search: \"\", hash: \"\", state: null, key: \"default\" };\n  }\n\n  function Link({ to, children, onClick, ...rest }: LinkProps) {\n    return createElement(\n      \"a\",\n      {\n        href: to,\n        onClick: (e: MouseEvent<HTMLAnchorElement>) => {\n          e.preventDefault();\n          onClick?.(e);\n          emitNavigation(to);\n        },\n        ...rest,\n      },\n      children,\n    );\n  }\n\n  return { useNavigate, useParams, useSearchParams, useMatch, useLocation, Link, NavLink: Link };\n}\n"]}

package/dist/types/index.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/types/index.cjs.map

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

package/dist/types/index.d.cts

@@ -0,0 +1,53 @@
+/**
+ * `@ethisyscore/plugin-ui/types` — generic base DTO/query types a lifted monolith
+ * feature shares (audit stamps, optimistic-concurrency row version, branded GUID,
+ * paging). Pure types — zero runtime — so a plugin's lifted `types/core.ts` becomes a
+ * one-line `export type * from "@ethisyscore/plugin-ui/types"` with no imports to change.
+ */
+/**
+ * A branded GUID string. The `__brand` doesn't exist at runtime; it forces TS to
+ * treat this as distinct from a plain string.
+ */
+type Guid = string & {
+    readonly __brand: unique symbol;
+};
+/** Items that carry audit stamps (names + timestamps). */
+interface Auditable {
+    /** Name of who created this item. */
+    createdByName?: string;
+    /** When the item was created. */
+    createdUtc?: string;
+    /** Name of who last updated this item. */
+    lastUpdatedByName?: string;
+    /** When the item was last updated. */
+    lastUpdatedUtc?: string;
+}
+/** {@link Auditable} plus the actor ids. */
+interface AuditableDetailed extends Auditable {
+    /** Id of who created this item. */
+    createdBy?: Guid;
+    /** Id of who last updated this item. */
+    lastUpdatedBy?: Guid;
+}
+/**
+ * Detail DTOs that support optimistic concurrency. The backend DTO guarantees this,
+ * so it is non-optional; echo it in the `If-Match` header on updates.
+ */
+interface HasRowVersion {
+    /** The version stamp for optimistic concurrency. */
+    rowVersion: string;
+}
+/** A 1-based pagination request. */
+interface PagedQuery {
+    /** The current page number (1-based). */
+    page: number;
+    /** The number of items to return per page. */
+    pageSize: number;
+}
+/** {@link PagedQuery} plus a free-text search term. */
+interface SearchQuery extends PagedQuery {
+    /** The search term. */
+    search?: string | null;
+}
+
+export type { Auditable, AuditableDetailed, Guid, HasRowVersion, PagedQuery, SearchQuery };

package/dist/types/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `@ethisyscore/plugin-ui/types` — generic base DTO/query types a lifted monolith
+ * feature shares (audit stamps, optimistic-concurrency row version, branded GUID,
+ * paging). Pure types — zero runtime — so a plugin's lifted `types/core.ts` becomes a
+ * one-line `export type * from "@ethisyscore/plugin-ui/types"` with no imports to change.
+ */
+/**
+ * A branded GUID string. The `__brand` doesn't exist at runtime; it forces TS to
+ * treat this as distinct from a plain string.
+ */
+type Guid = string & {
+    readonly __brand: unique symbol;
+};
+/** Items that carry audit stamps (names + timestamps). */
+interface Auditable {
+    /** Name of who created this item. */
+    createdByName?: string;
+    /** When the item was created. */
+    createdUtc?: string;
+    /** Name of who last updated this item. */
+    lastUpdatedByName?: string;
+    /** When the item was last updated. */
+    lastUpdatedUtc?: string;
+}
+/** {@link Auditable} plus the actor ids. */
+interface AuditableDetailed extends Auditable {
+    /** Id of who created this item. */
+    createdBy?: Guid;
+    /** Id of who last updated this item. */
+    lastUpdatedBy?: Guid;
+}
+/**
+ * Detail DTOs that support optimistic concurrency. The backend DTO guarantees this,
+ * so it is non-optional; echo it in the `If-Match` header on updates.
+ */
+interface HasRowVersion {
+    /** The version stamp for optimistic concurrency. */
+    rowVersion: string;
+}
+/** A 1-based pagination request. */
+interface PagedQuery {
+    /** The current page number (1-based). */
+    page: number;
+    /** The number of items to return per page. */
+    pageSize: number;
+}
+/** {@link PagedQuery} plus a free-text search term. */
+interface SearchQuery extends PagedQuery {
+    /** The search term. */
+    search?: string | null;
+}
+
+export type { Auditable, AuditableDetailed, Guid, HasRowVersion, PagedQuery, SearchQuery };

package/dist/types/index.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ethisyscore/plugin-ui",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "Plugin-UI umbrella SDK: client bridge + a11y/l10n primitives + brokered-MCP client (WI 4858).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -26,6 +26,36 @@
       "types": "./dist/token/index.d.ts",
       "import": "./dist/token/index.js",
       "require": "./dist/token/index.cjs"
+    },
+    "./platform-react": {
+      "types": "./dist/platform-react/index.d.ts",
+      "import": "./dist/platform-react/index.js",
+      "require": "./dist/platform-react/index.cjs"
+    },
+    "./icons": {
+      "types": "./dist/icons/index.d.ts",
+      "import": "./dist/icons/index.js",
+      "require": "./dist/icons/index.cjs"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js",
+      "require": "./dist/types/index.cjs"
+    },
+    "./components/ui": {
+      "types": "./dist/components/ui/index.d.ts",
+      "import": "./dist/components/ui/index.js",
+      "require": "./dist/components/ui/index.cjs"
+    },
+    "./components/layout": {
+      "types": "./dist/components/layout/index.d.ts",
+      "import": "./dist/components/layout/index.js",
+      "require": "./dist/components/layout/index.cjs"
+    },
+    "./components/shared": {
+      "types": "./dist/components/shared/index.d.ts",
+      "import": "./dist/components/shared/index.js",
+      "require": "./dist/components/shared/index.cjs"
     }
   },
   "files": [
@@ -44,9 +74,23 @@
     "@ethisyscore/extension-runtime": "^1.10.0"
   },
   "peerDependencies": {
+    "@mui/material": ">=5",
+    "@tanstack/react-query": ">=5",
     "react": ">=18"
   },
+  "peerDependenciesMeta": {
+    "@mui/material": {
+      "optional": true
+    },
+    "@tanstack/react-query": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.1",
+    "@mui/material": "^7.3.0",
+    "@tanstack/react-query": "^5.90.0",
     "@testing-library/jest-dom": "^6.6.0",
     "@testing-library/react": "^16.0.0",
     "@types/node": "^20.19.41",