@aglyn/aglyn-node-renderer 1.0.0-beta.143

package/src/lib/contexts/renderer-components.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type ComponentType, type RefAttributes } from 'react';
+import type { BranchProps } from '../components/branch';
+import type { LeafProps } from '../components/leaf';
+import type { StemProps } from '../components/stem';
+import type { TrunkProps } from '../components/trunk';
+type RenderComponent<P> = ComponentType<P & RefAttributes<any>> | JSX.ForwardRefExoticComponent<P & RefAttributes<any>>;
+export interface RenderComponentsContext {
+    TrunkComponent: RenderComponent<TrunkProps>;
+    StemComponent: RenderComponent<StemProps>;
+    BranchComponent: JSX.FunctionComponent<BranchProps>;
+    LeafComponent: RenderComponent<LeafProps>;
+}
+export declare const RendererComponents: import("react").Context<RenderComponentsContext>;
+export default RendererComponents;

package/src/lib/contexts/renderer-components.js

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { createContext } from "react";
+export const RendererComponents = /*#__PURE__*/ createContext({
+    TrunkComponent: null,
+    StemComponent: null,
+    BranchComponent: null,
+    LeafComponent: null
+});
+RendererComponents.displayName = 'RendererComponents';
+RendererComponents['aglyn'] = true;
+export default RendererComponents;
+
+//# sourceMappingURL=renderer-components.js.map

package/src/lib/contexts/renderer-components.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn-node-renderer/src/lib/contexts/renderer-components.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  type ComponentType,\n  createContext,\n  type RefAttributes,\n} from 'react'\nimport type { BranchProps } from '../components/branch'\nimport type { LeafProps } from '../components/leaf'\nimport type { StemProps } from '../components/stem'\nimport type { TrunkProps } from '../components/trunk'\n\n// ComponentType unions cover both plain function components and the\n// FunctionComponent that mobx observer() returns when wrapping forwardRef.\ntype RenderComponent<P> =\n  | ComponentType<P & RefAttributes<any>>\n  | JSX.ForwardRefExoticComponent<P & RefAttributes<any>>\n\nexport interface RenderComponentsContext {\n  TrunkComponent: RenderComponent<TrunkProps>\n  StemComponent: RenderComponent<StemProps>\n  BranchComponent: JSX.FunctionComponent<BranchProps>\n  LeafComponent: RenderComponent<LeafProps>\n}\nexport const RendererComponents = createContext<RenderComponentsContext>({\n  TrunkComponent: null,\n  StemComponent: null,\n  BranchComponent: null,\n  LeafComponent: null,\n})\nRendererComponents.displayName = 'RendererComponents'\nRendererComponents['aglyn'] = true\n\nexport default RendererComponents\n"],"names":["createContext","RendererComponents","TrunkComponent","StemComponent","BranchComponent","LeafComponent","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAEEA,aAAa,QAER,QAAO;AAkBd,OAAO,MAAMC,mCAAqBD,cAAuC;IACvEE,gBAAgB;IAChBC,eAAe;IACfC,iBAAiB;IACjBC,eAAe;AACjB,GAAE;AACFJ,mBAAmBK,WAAW,GAAG;AACjCL,kBAAkB,CAAC,QAAQ,GAAG;AAE9B,eAAeA,mBAAkB"}

package/src/lib/hooks/use-aglyn-site-theme.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { HostTheme, HostThemeScheme } from '@aglyn/shared-data-types';
+export type UseAglynSiteThemeOptions = {
+    container?: Element | Node;
+    /** Persisted host theme customization; omitted → default light theme (legacy behavior). */
+    theme?: HostTheme;
+    scheme?: HostThemeScheme;
+    /**
+     * Which site this is — its attached domain, or its subdomain (AGL-3068).
+     *
+     * It decides the BASE the site's overrides are layered onto, which is the
+     * one thing the editor cannot derive from the theme document: the operator's
+     * own hosts keep the platform brand, every customer site resolves the
+     * neutral tenant default, and the published page has already made that
+     * choice from its own address. Unnamed resolves what a customer site
+     * resolves.
+     *
+     * `useAglynSiteTheme` falls back to `HostSiteKeyContext`, so a surface
+     * inside the console's host routes needs to pass nothing.
+     */
+    host?: string;
+};
+/**
+ * The theme a site renders with on the canvas and in Preview: the host's
+ * overrides layered onto the base that site publishes on, with MUI's portals
+ * pointed at the container. {@link useAglynSiteTheme} memoizes it; anything
+ * that renders a site outside React's hooks — the AI plugin's device-width
+ * audit of its golden pages (AGL-3020) — builds the same theme here.
+ */
+export declare function createAglynSiteTheme(options?: UseAglynSiteThemeOptions): import("@mui/material").Theme;
+export declare function useAglynSiteTheme(options?: UseAglynSiteThemeOptions): import("@mui/material").Theme;
+export default useAglynSiteTheme;

package/src/lib/hooks/use-aglyn-site-theme.js

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2022 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { _ as _extends } from "@swc/helpers/_/_extends";
+import { createResponsiveTheme, hostThemeToThemeOptions, mergeThemeOptions, siteBaseOptions, useHostSiteKey } from "@aglyn/shared-ui-theme";
+import { useMemo } from "react";
+/**
+ * The theme a site renders with on the canvas and in Preview: the host's
+ * overrides layered onto the base that site publishes on, with MUI's portals
+ * pointed at the container. {@link useAglynSiteTheme} memoizes it; anything
+ * that renders a site outside React's hooks — the AI plugin's device-width
+ * audit of its golden pages (AGL-3020) — builds the same theme here.
+ */ export function createAglynSiteTheme(options = {}) {
+    var _options_scheme;
+    var _themeOptions_components, _themeOptions_components_MuiPopover, _themeOptions_components1, _themeOptions_components2, _themeOptions_components_MuiPopper, _themeOptions_components3, _themeOptions_components4, _themeOptions_components_MuiModal, _themeOptions_components5;
+    const container = options.container;
+    const hostTheme = options.theme;
+    const scheme = (_options_scheme = options.scheme) != null ? _options_scheme : 'light';
+    // Layer the host's overrides onto the base the PUBLISHED PAGE uses, chosen
+    // from the same site key the tenant chooses from (AGL-1180/AGL-1205,
+    // AGL-3068). `hostThemeToThemeOptions` emits only what the host explicitly
+    // set, so building from it alone leaves every untouched slot on MUI's stock
+    // palette — and a site that keeps its theme all-`Default` has nothing else.
+    // Which base is not a constant: the operator's own hosts wear the platform
+    // brand and a customer site wears the neutral tenant default, so a canvas
+    // that always took the brand painted Aglyn cyan over a site that publishes
+    // in blue, including its contrast.
+    const themeOptions = mergeThemeOptions(siteBaseOptions(options.host, scheme), hostThemeToThemeOptions(hostTheme, scheme));
+    // createResponsiveTheme, not plain createTheme (AGL-593): the tenant
+    // builds host themes through it (HostThemeProvider), which bakes
+    // responsive font sizes into the typography variants — the canvas
+    // must carry the same media-keyed typography or device preview has
+    // nothing to re-resolve and canvas/tenant text sizes disagree.
+    return createResponsiveTheme({
+        themeOptions: _extends({}, themeOptions, {
+            components: _extends({}, themeOptions.components, {
+                // Spread the existing entry per component: now that the brand base
+                // is merged in, replacing these wholesale would drop any
+                // `styleOverrides` it ships for them. Only `defaultProps.container`
+                // is ours to set — it points MUI's portals at the canvas container.
+                MuiPopover: _extends({}, (_themeOptions_components = themeOptions.components) == null ? void 0 : _themeOptions_components.MuiPopover, {
+                    defaultProps: _extends({}, (_themeOptions_components1 = themeOptions.components) == null ? void 0 : (_themeOptions_components_MuiPopover = _themeOptions_components1.MuiPopover) == null ? void 0 : _themeOptions_components_MuiPopover.defaultProps, {
+                        container: container
+                    })
+                }),
+                MuiPopper: _extends({}, (_themeOptions_components2 = themeOptions.components) == null ? void 0 : _themeOptions_components2.MuiPopper, {
+                    defaultProps: _extends({}, (_themeOptions_components3 = themeOptions.components) == null ? void 0 : (_themeOptions_components_MuiPopper = _themeOptions_components3.MuiPopper) == null ? void 0 : _themeOptions_components_MuiPopper.defaultProps, {
+                        container: container
+                    })
+                }),
+                MuiModal: _extends({}, (_themeOptions_components4 = themeOptions.components) == null ? void 0 : _themeOptions_components4.MuiModal, {
+                    defaultProps: _extends({}, (_themeOptions_components5 = themeOptions.components) == null ? void 0 : (_themeOptions_components_MuiModal = _themeOptions_components5.MuiModal) == null ? void 0 : _themeOptions_components_MuiModal.defaultProps, {
+                        container: container
+                    })
+                })
+            })
+        })
+    });
+}
+export function useAglynSiteTheme(options = {}) {
+    var _options_scheme, _options_host;
+    const container = options.container;
+    const hostTheme = options.theme;
+    const scheme = (_options_scheme = options.scheme) != null ? _options_scheme : 'light';
+    // The surface names its site, or the route it is on does. Every besigner
+    // panel and preview reads the same context, so the base is decided once per
+    // editor rather than per component.
+    const contextHost = useHostSiteKey();
+    const host = (_options_host = options.host) != null ? _options_host : contextHost;
+    return useMemo(()=>createAglynSiteTheme({
+            container,
+            theme: hostTheme,
+            scheme,
+            host
+        }), [
+        container,
+        hostTheme,
+        scheme,
+        host
+    ]);
+}
+export default useAglynSiteTheme;
+
+//# sourceMappingURL=use-aglyn-site-theme.js.map

package/src/lib/hooks/use-aglyn-site-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn-node-renderer/src/lib/hooks/use-aglyn-site-theme.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2022 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { HostTheme, HostThemeScheme } from '@aglyn/shared-data-types'\nimport {\n  createResponsiveTheme,\n  hostThemeToThemeOptions,\n  mergeThemeOptions,\n  siteBaseOptions,\n  useHostSiteKey,\n} from '@aglyn/shared-ui-theme'\nimport { useMemo } from 'react'\n\nexport type UseAglynSiteThemeOptions = {\n  // Node covers ShadowRoot containers, which MUI accepts at runtime but\n  // types as Element only.\n  container?: Element | Node\n  /** Persisted host theme customization; omitted → default light theme (legacy behavior). */\n  theme?: HostTheme\n  scheme?: HostThemeScheme\n  /**\n   * Which site this is — its attached domain, or its subdomain (AGL-3068).\n   *\n   * It decides the BASE the site's overrides are layered onto, which is the\n   * one thing the editor cannot derive from the theme document: the operator's\n   * own hosts keep the platform brand, every customer site resolves the\n   * neutral tenant default, and the published page has already made that\n   * choice from its own address. Unnamed resolves what a customer site\n   * resolves.\n   *\n   * `useAglynSiteTheme` falls back to `HostSiteKeyContext`, so a surface\n   * inside the console's host routes needs to pass nothing.\n   */\n  host?: string\n}\n\n/**\n * The theme a site renders with on the canvas and in Preview: the host's\n * overrides layered onto the base that site publishes on, with MUI's portals\n * pointed at the container. {@link useAglynSiteTheme} memoizes it; anything\n * that renders a site outside React's hooks — the AI plugin's device-width\n * audit of its golden pages (AGL-3020) — builds the same theme here.\n */\nexport function createAglynSiteTheme(options: UseAglynSiteThemeOptions = {}) {\n  const container = options.container as Element | undefined\n  const hostTheme = options.theme\n  const scheme = options.scheme ?? 'light'\n  // Layer the host's overrides onto the base the PUBLISHED PAGE uses, chosen\n  // from the same site key the tenant chooses from (AGL-1180/AGL-1205,\n  // AGL-3068). `hostThemeToThemeOptions` emits only what the host explicitly\n  // set, so building from it alone leaves every untouched slot on MUI's stock\n  // palette — and a site that keeps its theme all-`Default` has nothing else.\n  // Which base is not a constant: the operator's own hosts wear the platform\n  // brand and a customer site wears the neutral tenant default, so a canvas\n  // that always took the brand painted Aglyn cyan over a site that publishes\n  // in blue, including its contrast.\n  const themeOptions = mergeThemeOptions(\n    siteBaseOptions(options.host, scheme),\n    hostThemeToThemeOptions(hostTheme, scheme),\n  )\n  // createResponsiveTheme, not plain createTheme (AGL-593): the tenant\n  // builds host themes through it (HostThemeProvider), which bakes\n  // responsive font sizes into the typography variants — the canvas\n  // must carry the same media-keyed typography or device preview has\n  // nothing to re-resolve and canvas/tenant text sizes disagree.\n  return createResponsiveTheme({\n    themeOptions: {\n      ...themeOptions,\n      components: {\n        ...themeOptions.components,\n        // Spread the existing entry per component: now that the brand base\n        // is merged in, replacing these wholesale would drop any\n        // `styleOverrides` it ships for them. Only `defaultProps.container`\n        // is ours to set — it points MUI's portals at the canvas container.\n        MuiPopover: {\n          ...themeOptions.components?.MuiPopover,\n          defaultProps: {\n            ...themeOptions.components?.MuiPopover?.defaultProps,\n            container: container,\n          },\n        },\n        MuiPopper: {\n          ...themeOptions.components?.MuiPopper,\n          defaultProps: {\n            ...themeOptions.components?.MuiPopper?.defaultProps,\n            container: container,\n          },\n        },\n        MuiModal: {\n          ...themeOptions.components?.MuiModal,\n          defaultProps: {\n            ...themeOptions.components?.MuiModal?.defaultProps,\n            container: container,\n          },\n        },\n      },\n    },\n  })\n}\n\nexport function useAglynSiteTheme(options: UseAglynSiteThemeOptions = {}) {\n  const container = options.container\n  const hostTheme = options.theme\n  const scheme = options.scheme ?? 'light'\n  // The surface names its site, or the route it is on does. Every besigner\n  // panel and preview reads the same context, so the base is decided once per\n  // editor rather than per component.\n  const contextHost = useHostSiteKey()\n  const host = options.host ?? contextHost\n\n  return useMemo(\n    () => createAglynSiteTheme({ container, theme: hostTheme, scheme, host }),\n    [container, hostTheme, scheme, host],\n  )\n}\nexport default useAglynSiteTheme\n"],"names":["createResponsiveTheme","hostThemeToThemeOptions","mergeThemeOptions","siteBaseOptions","useHostSiteKey","useMemo","createAglynSiteTheme","options","themeOptions","container","hostTheme","theme","scheme","host","components","MuiPopover","defaultProps","MuiPopper","MuiModal","useAglynSiteTheme","contextHost"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC;AAGD,SACEA,qBAAqB,EACrBC,uBAAuB,EACvBC,iBAAiB,EACjBC,eAAe,EACfC,cAAc,QACT,yBAAwB;AAC/B,SAASC,OAAO,QAAQ,QAAO;AAyB/B;;;;;;CAMC,GACD,OAAO,SAASC,qBAAqBC,UAAoC,CAAC,CAAC;QAG1DA;QA6BJC,0BAEEA,qCAAAA,2BAKFA,2BAEEA,oCAAAA,2BAKFA,2BAEEA,mCAAAA;IA/Cb,MAAMC,YAAYF,QAAQE,SAAS;IACnC,MAAMC,YAAYH,QAAQI,KAAK;IAC/B,MAAMC,UAASL,kBAAAA,QAAQK,MAAM,YAAdL,kBAAkB;IACjC,2EAA2E;IAC3E,qEAAqE;IACrE,2EAA2E;IAC3E,4EAA4E;IAC5E,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,2EAA2E;IAC3E,mCAAmC;IACnC,MAAMC,eAAeN,kBACnBC,gBAAgBI,QAAQM,IAAI,EAAED,SAC9BX,wBAAwBS,WAAWE;IAErC,qEAAqE;IACrE,iEAAiE;IACjE,kEAAkE;IAClE,mEAAmE;IACnE,+DAA+D;IAC/D,OAAOZ,sBAAsB;QAC3BQ,cAAc,aACTA;YACHM,YAAY,aACPN,aAAaM,UAAU;gBAC1B,mEAAmE;gBACnE,yDAAyD;gBACzD,oEAAoE;gBACpE,oEAAoE;gBACpEC,YAAY,cACPP,2BAAAA,aAAaM,UAAU,qBAAvBN,yBAAyBO,UAAU;oBACtCC,cAAc,cACTR,4BAAAA,aAAaM,UAAU,sBAAvBN,sCAAAA,0BAAyBO,UAAU,qBAAnCP,oCAAqCQ,YAAY;wBACpDP,WAAWA;;;gBAGfQ,WAAW,cACNT,4BAAAA,aAAaM,UAAU,qBAAvBN,0BAAyBS,SAAS;oBACrCD,cAAc,cACTR,4BAAAA,aAAaM,UAAU,sBAAvBN,qCAAAA,0BAAyBS,SAAS,qBAAlCT,mCAAoCQ,YAAY;wBACnDP,WAAWA;;;gBAGfS,UAAU,cACLV,4BAAAA,aAAaM,UAAU,qBAAvBN,0BAAyBU,QAAQ;oBACpCF,cAAc,cACTR,4BAAAA,aAAaM,UAAU,sBAAvBN,oCAAAA,0BAAyBU,QAAQ,qBAAjCV,kCAAmCQ,YAAY;wBAClDP,WAAWA;;;;;IAKrB;AACF;AAEA,OAAO,SAASU,kBAAkBZ,UAAoC,CAAC,CAAC;QAGvDA,iBAKFA;IAPb,MAAME,YAAYF,QAAQE,SAAS;IACnC,MAAMC,YAAYH,QAAQI,KAAK;IAC/B,MAAMC,UAASL,kBAAAA,QAAQK,MAAM,YAAdL,kBAAkB;IACjC,yEAAyE;IACzE,4EAA4E;IAC5E,oCAAoC;IACpC,MAAMa,cAAchB;IACpB,MAAMS,QAAON,gBAAAA,QAAQM,IAAI,YAAZN,gBAAgBa;IAE7B,OAAOf,QACL,IAAMC,qBAAqB;YAAEG;YAAWE,OAAOD;YAAWE;YAAQC;QAAK,IACvE;QAACJ;QAAWC;QAAWE;QAAQC;KAAK;AAExC;AACA,eAAeM,kBAAiB"}

package/src/lib/utils/create-aglyn-component.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type * as Aglyn from '@aglyn/aglyn';
+import type { AglynExoticComponent } from '@aglyn/aglyn/foundation/definitions/components.types';
+import { type ErrorBoundaryProps } from '@aglyn/shared-ui-jsx/components/error-boundary.component';
+export type ComponentRegisterPayload<P extends JSX.AnyProps = any> = {
+    schema: Aglyn.ComponentSchema<P>;
+    component: AglynExoticComponent<P>;
+};
+export declare function createAglynComponent<P extends JSX.AnyProps = any, C = any>(schema: Aglyn.ComponentSchema<P>, component: C | any, options?: Partial<ErrorBoundaryProps>): ComponentRegisterPayload<P>;
+export default createAglynComponent;

package/src/lib/utils/create-aglyn-component.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2023 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ // Type-only: a VALUE namespace import of the core barrel is opaque to a
+// bundler — it cannot know which exports are read, so every module the barrel
+// reaches is pinned into the published page's first load. The values this file
+// needs are named below, where the bundler can see them.
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { FEATURE_FLAG } from "@aglyn/aglyn/foundation/constants/shared";
+import { AGLYN_OF, COMPONENT_ELEMENT_TYPE } from "@aglyn/aglyn/foundation/constants/symbol";
+// Deep import, NOT the barrel — see the note in `leaf.tsx`.
+import { withErrorBoundary } from "@aglyn/shared-ui-jsx/components/error-boundary.component";
+import { styled } from "@aglyn/shared-ui-theme";
+import { cloneDeep } from "@aglyn/shared-util-tools";
+import { hoistNonReactStatics, pascalCase } from "@aglyn/shared-util-vendor";
+import { forwardRef } from "react";
+export function createAglynComponent(schema, component, options) {
+    const _schema = cloneDeep(schema);
+    const { $id, pluginId, flags, styledOptions } = _schema;
+    const pascalId = `${pluginId ? pascalCase(pluginId) + '-' : ''}${pascalCase($id)}`;
+    const Component = (flags == null ? void 0 : flags.emotion) === FEATURE_FLAG.DISABLED ? component : styled(component, styledOptions)({});
+    const AglynComponent = /*#__PURE__*/ forwardRef((props, ref)=>{
+        return /*#__PURE__*/ _jsx(Component, _extends({
+            ref: ref
+        }, props));
+    });
+    AglynComponent.displayName = `AglynComponent(${pascalId})`;
+    AglynComponent['$id'] = $id;
+    AglynComponent['pluginId'] = pluginId;
+    AglynComponent['aglyn'] = true;
+    AglynComponent[AGLYN_OF] = COMPONENT_ELEMENT_TYPE;
+    hoistNonReactStatics(AglynComponent, component);
+    return {
+        component: withErrorBoundary(AglynComponent, options),
+        schema: cloneDeep(schema)
+    };
+}
+export default createAglynComponent;
+
+//# sourceMappingURL=create-aglyn-component.js.map

package/src/lib/utils/create-aglyn-component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn-node-renderer/src/lib/utils/create-aglyn-component.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2023 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// Type-only: a VALUE namespace import of the core barrel is opaque to a\n// bundler — it cannot know which exports are read, so every module the barrel\n// reaches is pinned into the published page's first load. The values this file\n// needs are named below, where the bundler can see them.\nimport type * as Aglyn from '@aglyn/aglyn'\nimport type { AglynExoticComponent } from '@aglyn/aglyn/foundation/definitions/components.types'\nimport { FEATURE_FLAG } from '@aglyn/aglyn/foundation/constants/shared'\nimport {\n  AGLYN_OF,\n  COMPONENT_ELEMENT_TYPE,\n} from '@aglyn/aglyn/foundation/constants/symbol'\n// Deep import, NOT the barrel — see the note in `leaf.tsx`.\nimport {\n  type ErrorBoundaryProps,\n  withErrorBoundary,\n} from '@aglyn/shared-ui-jsx/components/error-boundary.component'\nimport { styled } from '@aglyn/shared-ui-theme'\nimport { cloneDeep } from '@aglyn/shared-util-tools'\nimport { hoistNonReactStatics, pascalCase } from '@aglyn/shared-util-vendor'\nimport { forwardRef } from 'react'\n\nexport type ComponentRegisterPayload<P extends JSX.AnyProps = any> = {\n  schema: Aglyn.ComponentSchema<P>\n  component: AglynExoticComponent<P>\n}\n\nexport function createAglynComponent<P extends JSX.AnyProps = any, C = any>(\n  schema: Aglyn.ComponentSchema<P>,\n  component: C | any,\n  options?: Partial<ErrorBoundaryProps>,\n): ComponentRegisterPayload<P> {\n  const _schema = cloneDeep(schema)\n  const { $id, pluginId, flags, styledOptions } = _schema\n  const pascalId = `${pluginId ? pascalCase(pluginId) + '-' : ''}${pascalCase(\n    $id,\n  )}`\n\n  const Component =\n    flags?.emotion === FEATURE_FLAG.DISABLED\n      ? component\n      : styled(component, styledOptions)({})\n\n  const AglynComponent = forwardRef<any, P>((props, ref) => {\n    return <Component ref={ref} {...props} />\n  }) as AglynExoticComponent<P>\n\n  AglynComponent.displayName = `AglynComponent(${pascalId})`\n  AglynComponent['$id'] = $id\n  AglynComponent['pluginId'] = pluginId\n  AglynComponent['aglyn'] = true\n  AglynComponent[AGLYN_OF] = COMPONENT_ELEMENT_TYPE\n  hoistNonReactStatics(AglynComponent, component)\n\n  return {\n    component: withErrorBoundary(\n      AglynComponent,\n      options,\n    ) as AglynExoticComponent<P>,\n    schema: cloneDeep(schema),\n  }\n}\n\nexport default createAglynComponent\n"],"names":["FEATURE_FLAG","AGLYN_OF","COMPONENT_ELEMENT_TYPE","withErrorBoundary","styled","cloneDeep","hoistNonReactStatics","pascalCase","forwardRef","createAglynComponent","schema","component","options","_schema","$id","pluginId","flags","styledOptions","pascalId","Component","emotion","DISABLED","AglynComponent","props","ref","displayName"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,wEAAwE;AACxE,8EAA8E;AAC9E,+EAA+E;AAC/E,yDAAyD;;;AAGzD,SAASA,YAAY,QAAQ,2CAA0C;AACvE,SACEC,QAAQ,EACRC,sBAAsB,QACjB,2CAA0C;AACjD,4DAA4D;AAC5D,SAEEC,iBAAiB,QACZ,2DAA0D;AACjE,SAASC,MAAM,QAAQ,yBAAwB;AAC/C,SAASC,SAAS,QAAQ,2BAA0B;AACpD,SAASC,oBAAoB,EAAEC,UAAU,QAAQ,4BAA2B;AAC5E,SAASC,UAAU,QAAQ,QAAO;AAOlC,OAAO,SAASC,qBACdC,MAAgC,EAChCC,SAAkB,EAClBC,OAAqC;IAErC,MAAMC,UAAUR,UAAUK;IAC1B,MAAM,EAAEI,GAAG,EAAEC,QAAQ,EAAEC,KAAK,EAAEC,aAAa,EAAE,GAAGJ;IAChD,MAAMK,WAAW,GAAGH,WAAWR,WAAWQ,YAAY,MAAM,KAAKR,WAC/DO,MACC;IAEH,MAAMK,YACJH,CAAAA,yBAAAA,MAAOI,OAAO,MAAKpB,aAAaqB,QAAQ,GACpCV,YACAP,OAAOO,WAAWM,eAAe,CAAC;IAExC,MAAMK,+BAAiBd,WAAmB,CAACe,OAAOC;QAChD,qBAAO,KAACL;YAAUK,KAAKA;WAASD;IAClC;IAEAD,eAAeG,WAAW,GAAG,CAAC,eAAe,EAAEP,SAAS,CAAC,CAAC;IAC1DI,cAAc,CAAC,MAAM,GAAGR;IACxBQ,cAAc,CAAC,WAAW,GAAGP;IAC7BO,cAAc,CAAC,QAAQ,GAAG;IAC1BA,cAAc,CAACrB,SAAS,GAAGC;IAC3BI,qBAAqBgB,gBAAgBX;IAErC,OAAO;QACLA,WAAWR,kBACTmB,gBACAV;QAEFF,QAAQL,UAAUK;IACpB;AACF;AAEA,eAAeD,qBAAoB"}

package/src/lib/utils/scheme-sx.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Scheme-scoped node sx (AGL-588) — implementation moved to
+ * `@aglyn/aglyn` (`app-utils/scheme-sx`) for AGL-1306: the instance
+ * override layer merges sx inside `composeReusableComponentNodes`, which
+ * lives there and cannot import this renderer back. This path stays as
+ * the renderer's export so its many consumers (the designer's responsive
+ * and style-group utils, the canvas leaf) are untouched.
+ */
+export { SX_SCHEME_DARK_KEY, isResponsiveSxObject, mergeSchemeValue, resolveSchemeSx, resolveSchemeSx as default, type SxScheme, } from '@aglyn/aglyn/app-utils/scheme-sx';
+/**
+ * Palette `var()` substitution (AGL-1331) rides along beside the scheme
+ * pass: both resolve persisted sx against the ACTIVE theme, and the leaf
+ * applies them together.
+ */
+export { resolvePaletteVars, resolvePaletteVarsSx, } from '@aglyn/aglyn/app-utils/palette-sx';

package/src/lib/utils/scheme-sx.js

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Scheme-scoped node sx (AGL-588) — implementation moved to
+ * `@aglyn/aglyn` (`app-utils/scheme-sx`) for AGL-1306: the instance
+ * override layer merges sx inside `composeReusableComponentNodes`, which
+ * lives there and cannot import this renderer back. This path stays as
+ * the renderer's export so its many consumers (the designer's responsive
+ * and style-group utils, the canvas leaf) are untouched.
+ */ export { SX_SCHEME_DARK_KEY, isResponsiveSxObject, mergeSchemeValue, resolveSchemeSx, resolveSchemeSx as default } from "@aglyn/aglyn/app-utils/scheme-sx";
+/**
+ * Palette `var()` substitution (AGL-1331) rides along beside the scheme
+ * pass: both resolve persisted sx against the ACTIVE theme, and the leaf
+ * applies them together.
+ */ export { resolvePaletteVars, resolvePaletteVarsSx } from "@aglyn/aglyn/app-utils/palette-sx";
+
+//# sourceMappingURL=scheme-sx.js.map

package/src/lib/utils/scheme-sx.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn-node-renderer/src/lib/utils/scheme-sx.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Scheme-scoped node sx (AGL-588) — implementation moved to\n * `@aglyn/aglyn` (`app-utils/scheme-sx`) for AGL-1306: the instance\n * override layer merges sx inside `composeReusableComponentNodes`, which\n * lives there and cannot import this renderer back. This path stays as\n * the renderer's export so its many consumers (the designer's responsive\n * and style-group utils, the canvas leaf) are untouched.\n */\nexport {\n  SX_SCHEME_DARK_KEY,\n  isResponsiveSxObject,\n  mergeSchemeValue,\n  resolveSchemeSx,\n  resolveSchemeSx as default,\n  type SxScheme,\n} from '@aglyn/aglyn/app-utils/scheme-sx'\n\n/**\n * Palette `var()` substitution (AGL-1331) rides along beside the scheme\n * pass: both resolve persisted sx against the ACTIVE theme, and the leaf\n * applies them together.\n */\nexport {\n  resolvePaletteVars,\n  resolvePaletteVarsSx,\n} from '@aglyn/aglyn/app-utils/palette-sx'\n"],"names":["SX_SCHEME_DARK_KEY","isResponsiveSxObject","mergeSchemeValue","resolveSchemeSx","default","resolvePaletteVars","resolvePaletteVarsSx"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;CAOC,GACD,SACEA,kBAAkB,EAClBC,oBAAoB,EACpBC,gBAAgB,EAChBC,eAAe,EACfA,mBAAmBC,OAAO,QAErB,mCAAkC;AAEzC;;;;CAIC,GACD,SACEC,kBAAkB,EAClBC,oBAAoB,QACf,oCAAmC"}