@omerdlw/base-framework 1.0.5 → 2.0.0

package/dist/chunk-4GMQKD6F.js

@@ -0,0 +1,353 @@
+import { defineThemeSpec, useTheme } from './chunk-7TAVYJ3A.js';
+import { defineModule, useRegistryEntries, useModuleRegistration } from './chunk-GF7TUX5I.js';
+import { isPlainObject, trimToNull, toFiniteNumber, clamp } from './chunk-TV3WEF5G.js';
+import { useMemo, isValidElement, useSyncExternalStore, Fragment as Fragment$1, useState, useEffect, createElement } from 'react';
+import { usePathname } from 'next/navigation';
+import { createPortal } from 'react-dom';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
+
+// src/modules/controls/constants.ts
+var CONTROLS_EDGE_INSET = 4;
+var CONTROLS_DOCK_GAP = 8;
+var CONTROLS_DOCK_ELEMENT_ID = "dock-card-stack";
+var CONTROL_SIDE_NAMES = Object.freeze(["left", "right"]);
+var controlsTheme = defineThemeSpec("controls");
+function isControlSide(value) {
+  return CONTROL_SIDE_NAMES.includes(value);
+}
+function hasContent(content) {
+  return content !== void 0 && content !== null && content !== false;
+}
+function isRenderable(value) {
+  if (value === null || value === void 0 || ["boolean", "number", "string"].includes(typeof value) || isValidElement(value)) {
+    return true;
+  }
+  return Array.isArray(value) && value.every(isRenderable);
+}
+function validateControlEntry(entry) {
+  if (!isPlainObject(entry)) {
+    return { issues: ["control must be a plain object"], valid: false };
+  }
+  const issues = [];
+  if (!trimToNull(entry.id)) {
+    issues.push("control id must be a non-empty string");
+  }
+  if (!isControlSide(entry.side)) {
+    issues.push("control side must be left or right");
+  }
+  if (!hasContent(entry.content) || !isRenderable(entry.content)) {
+    issues.push("control content must be renderable");
+  }
+  if (!Number.isFinite(Number(entry.order))) {
+    issues.push("control order must be a finite number");
+  }
+  return { issues, valid: issues.length === 0 };
+}
+function resolveSlot(slot, props) {
+  if (slot == null || slot === false) return null;
+  if (isValidElement(slot)) return slot;
+  if (typeof slot === "function") return createElement(slot, props);
+  return slot;
+}
+function normalizePageControls(controls) {
+  if (!controls) return null;
+  if (Array.isArray(controls)) return controls;
+  if ("side" in controls) return [controls];
+  const { id = "controls", order = 0, path, registry } = controls;
+  return CONTROL_SIDE_NAMES.flatMap((side) => {
+    const content = controls[side];
+    if (!hasContent(content)) return [];
+    return [
+      {
+        ...registry ? { registry } : {},
+        content,
+        id: `${id}-${side}`,
+        order,
+        ...path ? { path } : {},
+        side
+      }
+    ];
+  });
+}
+function resolveControlsPairs(entries, pathname) {
+  const rows = /* @__PURE__ */ new Map();
+  for (const entry of Array.isArray(entries) ? entries : Object.values(entries || {})) {
+    if (entry?.path !== pathname || !isControlSide(entry.side) || !hasContent(entry.content)) {
+      continue;
+    }
+    const order = toFiniteNumber(entry.order);
+    const row = rows.get(order) ?? {};
+    rows.set(order, row);
+    const current = row[entry.side];
+    if (!current || String(entry.id).localeCompare(String(current.id)) < 0) {
+      row[entry.side] = { content: entry.content, id: entry.id };
+    }
+  }
+  const pairs = [...rows].sort(([a], [b]) => a - b).map(([, row]) => row).filter(
+    (row) => Boolean(row.left && row.right)
+  );
+  return {
+    left: pairs.map((row) => row.left),
+    right: pairs.map((row) => row.right)
+  };
+}
+
+// src/modules/controls/layout.ts
+function getControlsLayout(dockRect, viewport) {
+  const { height, width } = viewport;
+  if (!dockRect || width <= 0 || height <= 0) return null;
+  const inset = CONTROLS_EDGE_INSET;
+  const gap = CONTROLS_DOCK_GAP;
+  const dockLeft = clamp(dockRect.left, 0, width);
+  const dockRight = clamp(dockRect.right, dockLeft, width);
+  const dockBottom = clamp(dockRect.bottom, 0, height);
+  return {
+    bottom: Math.max(0, height - dockBottom),
+    height: Math.max(0, dockRect.height) / 2,
+    left: {
+      maxWidth: Math.max(0, dockLeft - inset * 2 - gap),
+      right: Math.max(inset, width - dockLeft + gap)
+    },
+    right: {
+      left: Math.min(width - inset, dockRight + gap),
+      maxWidth: Math.max(0, width - dockRight - inset * 2 - gap)
+    }
+  };
+}
+function areLayoutsEqual(a, b) {
+  if (a === b) return true;
+  if (!a || !b) return false;
+  return a.bottom === b.bottom && a.height === b.height && a.isHidden === b.isHidden && a.left.maxWidth === b.left.maxWidth && a.left.right === b.left.right && a.right.left === b.right.left && a.right.maxWidth === b.right.maxWidth;
+}
+function getDockStackElement() {
+  return document.getElementById(CONTROLS_DOCK_ELEMENT_ID);
+}
+function getDockElement() {
+  return document.querySelector('[data-controls-anchor="true"]') ?? getDockStackElement();
+}
+function measureLayout() {
+  const dockElement = getDockElement();
+  if (!dockElement) return null;
+  const layout = getControlsLayout(dockElement.getBoundingClientRect(), {
+    height: window.innerHeight,
+    width: window.innerWidth
+  });
+  return layout && {
+    ...layout,
+    isHidden: getDockStackElement()?.dataset.controlsHidden === "true"
+  };
+}
+function useControlsLayout() {
+  const [layout, setLayout] = useState(null);
+  useEffect(() => {
+    let observed;
+    let resizeObserver;
+    const update = () => {
+      const next = measureLayout();
+      setLayout((prev) => areLayoutsEqual(prev, next) ? prev : next);
+    };
+    const observe = () => {
+      const dockElement = getDockElement();
+      if (dockElement !== observed) {
+        observed = dockElement;
+        resizeObserver?.disconnect();
+        mutationObserver.disconnect();
+        if (dockElement) {
+          if (typeof ResizeObserver !== "undefined") {
+            resizeObserver = new ResizeObserver(update);
+            resizeObserver.observe(dockElement);
+          }
+          mutationObserver.observe(dockElement, {
+            attributes: true,
+            attributeFilter: ["data-controls-anchor", "data-controls-hidden"]
+          });
+          if (dockElement.parentElement) {
+            mutationObserver.observe(dockElement.parentElement, {
+              childList: true
+            });
+          }
+        } else {
+          mutationObserver.observe(document.body, {
+            childList: true,
+            subtree: true
+          });
+        }
+      }
+      update();
+    };
+    const mutationObserver = new MutationObserver(observe);
+    observe();
+    window.addEventListener("resize", update);
+    return () => {
+      mutationObserver.disconnect();
+      resizeObserver?.disconnect();
+      window.removeEventListener("resize", update);
+    };
+  }, []);
+  return layout;
+}
+function useControlsRegistration(config, options) {
+  useModuleRegistration("controls", config, options);
+}
+function useControls(config, options) {
+  const pathname = usePathname();
+  const definitionPath = config && "path" in config ? config.path : void 0;
+  const path = options?.path || definitionPath || pathname;
+  const entries = useMemo(() => {
+    if (!config) return null;
+    if (Array.isArray(config) || "side" in config) return config;
+    const { defaultProps = {}, left, right, ...page } = config;
+    const resolved = normalizePageControls({
+      ...page,
+      left: resolveSlot(left, defaultProps),
+      path,
+      right: resolveSlot(right, defaultProps)
+    });
+    return resolved?.length ? resolved : null;
+  }, [config, path]);
+  useControlsRegistration(entries, options);
+  return useControlsLayout();
+}
+var emptySubscribe = () => () => {
+};
+function useControlsModel() {
+  const portalTarget = useSyncExternalStore(
+    emptySubscribe,
+    () => typeof document !== "undefined" ? document.body : null,
+    () => null
+  );
+  const layout = useControlsLayout();
+  const pathname = usePathname();
+  const entries = useRegistryEntries("controls");
+  const { left, right } = useMemo(
+    () => resolveControlsPairs(entries, pathname),
+    [entries, pathname]
+  );
+  const theme = useTheme(controlsTheme);
+  return { portalTarget, layout, left, right, theme };
+}
+function ControlsSide({
+  controls,
+  geometry,
+  side,
+  theme
+}) {
+  if (controls.length === 0 || !geometry.height || !geometry.maxWidth) {
+    return null;
+  }
+  const positionStyle = side === "left" ? {
+    bottom: geometry.bottom,
+    maxWidth: geometry.maxWidth,
+    right: geometry.right
+  } : {
+    bottom: geometry.bottom,
+    left: geometry.left,
+    maxWidth: geometry.maxWidth
+  };
+  return /* @__PURE__ */ jsx(
+    "aside",
+    {
+      "aria-label": `${side === "left" ? "Left" : "Right"} page controls`,
+      className: theme.slots.rail,
+      style: { ...theme.styles.rail, ...positionStyle },
+      children: /* @__PURE__ */ jsx(
+        "div",
+        {
+          "data-side": side,
+          className: theme.slots.stack,
+          style: {
+            ...theme.styles.stack,
+            "--controls-height": `${geometry.height}px`
+          },
+          children: controls.map(({ content, id }, index) => /* @__PURE__ */ jsx(Fragment$1, { children: content }, id || index))
+        }
+      )
+    }
+  );
+}
+function Controls() {
+  const { portalTarget, layout, left, right, theme } = useControlsModel();
+  if (!portalTarget || !layout || layout.isHidden || left.length === 0) {
+    return null;
+  }
+  return createPortal(
+    /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        ControlsSide,
+        {
+          controls: left,
+          geometry: {
+            ...layout.left,
+            bottom: layout.bottom,
+            height: layout.height
+          },
+          side: "left",
+          theme
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        ControlsSide,
+        {
+          controls: right,
+          geometry: {
+            ...layout.right,
+            bottom: layout.bottom,
+            height: layout.height
+          },
+          side: "right",
+          theme
+        }
+      )
+    ] }),
+    portalTarget
+  );
+}
+function selectPageControls(config) {
+  return normalizePageControls(config.controls);
+}
+function useControlsPage(_slice, page) {
+  return useMemo(
+    () => ({
+      set: (controls) => page.set({ controls })
+    }),
+    [page]
+  );
+}
+function defineControls(definition = {}) {
+  const { id = "controls", order = 0 } = definition;
+  return Object.freeze({
+    config: definition,
+    id,
+    order,
+    use: function useDefinedControls(props = {}, options = {}) {
+      return useControls(
+        {
+          ...definition,
+          defaultProps: { ...definition.defaultProps, ...props }
+        },
+        options
+      );
+    }
+  });
+}
+var controlsModule = defineModule({
+  id: "controls",
+  Overlay: Controls,
+  registry: {
+    keyPolicy: "named",
+    lifecycle: "immediate",
+    validate: validateControlEntry
+  },
+  page: {
+    select: selectPageControls,
+    entries: (entry, { pathname }) => {
+      const path = pathname || "/";
+      return [{ key: `${path}::${entry.id}`, value: { ...entry, path } }];
+    },
+    use: useControlsPage
+  }
+});
+
+export { CONTROLS_DOCK_ELEMENT_ID, CONTROLS_DOCK_GAP, CONTROLS_EDGE_INSET, CONTROL_SIDE_NAMES, Controls, ControlsSide, areLayoutsEqual, controlsModule, controlsTheme, defineControls, getControlsLayout, getDockElement, getDockStackElement, hasContent, isControlSide, measureLayout, normalizePageControls, resolveControlsPairs, resolveSlot, useControls, useControlsLayout, useControlsRegistration, validateControlEntry };
+//# sourceMappingURL=chunk-4GMQKD6F.js.map
+//# sourceMappingURL=chunk-4GMQKD6F.js.map

package/dist/chunk-4GMQKD6F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/modules/controls/constants.ts","../src/modules/controls/entries.ts","../src/modules/controls/layout.ts","../src/modules/controls/hooks.ts","../src/modules/controls/overlay.tsx","../src/modules/controls/module.tsx"],"names":["usePathname","useMemo","Fragment"],"mappings":"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","file":"chunk-4GMQKD6F.js","sourcesContent":["import { defineThemeSpec } from \"@/theme\";\nimport { type ControlsThemeSlot } from \"./types\";\n\nexport const CONTROLS_EDGE_INSET = 4;\nexport const CONTROLS_DOCK_GAP = 8;\nexport const CONTROLS_DOCK_ELEMENT_ID = \"dock-card-stack\";\nexport const CONTROL_SIDE_NAMES = Object.freeze([\"left\", \"right\"] as const);\n\nexport const controlsTheme = defineThemeSpec<ControlsThemeSlot>(\"controls\");\n","import { createElement, isValidElement, type ReactNode } from \"react\";\nimport { type ValidationResult } from \"@/kernel\";\nimport { isPlainObject, toFiniteNumber, trimToNull } from \"@/utils\";\nimport { CONTROL_SIDE_NAMES } from \"./constants\";\nimport {\n  type ControlEntry,\n  type ControlSide,\n  type ControlSlot,\n  type ControlsPageConfig,\n  type ControlsPairItem,\n  type PageControlEntry,\n  type ResolvedControlsPairs,\n} from \"./types\";\n\nexport function isControlSide(value: unknown): value is ControlSide {\n  return CONTROL_SIDE_NAMES.includes(value as ControlSide);\n}\n\nexport function hasContent(content: unknown): boolean {\n  return content !== undefined && content !== null && content !== false;\n}\n\nfunction isRenderable(value: unknown): boolean {\n  if (\n    value === null ||\n    value === undefined ||\n    [\"boolean\", \"number\", \"string\"].includes(typeof value) ||\n    isValidElement(value)\n  ) {\n    return true;\n  }\n  return Array.isArray(value) && value.every(isRenderable);\n}\n\nexport function validateControlEntry(entry: unknown): ValidationResult {\n  if (!isPlainObject(entry)) {\n    return { issues: [\"control must be a plain object\"], valid: false };\n  }\n  const issues: string[] = [];\n  if (!trimToNull(entry.id)) {\n    issues.push(\"control id must be a non-empty string\");\n  }\n  if (!isControlSide(entry.side)) {\n    issues.push(\"control side must be left or right\");\n  }\n  if (!hasContent(entry.content) || !isRenderable(entry.content)) {\n    issues.push(\"control content must be renderable\");\n  }\n  if (!Number.isFinite(Number(entry.order))) {\n    issues.push(\"control order must be a finite number\");\n  }\n  return { issues, valid: issues.length === 0 };\n}\n\nexport function resolveSlot(\n  slot: ControlSlot | undefined,\n  props: Record<string, unknown>,\n): ReactNode {\n  if (slot == null || slot === false) return null;\n  if (isValidElement(slot)) return slot;\n  if (typeof slot === \"function\") return createElement(slot, props);\n  return slot;\n}\n\nexport function normalizePageControls(\n  controls: ControlsPageConfig | null | undefined,\n): PageControlEntry[] | null {\n  if (!controls) return null;\n  if (Array.isArray(controls)) return controls;\n  if (\"side\" in controls) return [controls];\n\n  const { id = \"controls\", order = 0, path, registry } = controls;\n  return CONTROL_SIDE_NAMES.flatMap((side) => {\n    const content = controls[side];\n    if (!hasContent(content)) return [];\n    return [\n      {\n        ...(registry ? { registry } : {}),\n        content,\n        id: `${id}-${side}`,\n        order,\n        ...(path ? { path } : {}),\n        side,\n      },\n    ];\n  });\n}\n\nexport function resolveControlsPairs(\n  entries: Record<string, ControlEntry> | ControlEntry[] | null | undefined,\n  pathname: string,\n): ResolvedControlsPairs {\n  const rows = new Map<\n    number,\n    { left?: ControlsPairItem; right?: ControlsPairItem }\n  >();\n\n  for (const entry of Array.isArray(entries)\n    ? entries\n    : Object.values(entries || {})) {\n    if (\n      entry?.path !== pathname ||\n      !isControlSide(entry.side) ||\n      !hasContent(entry.content)\n    ) {\n      continue;\n    }\n    const order = toFiniteNumber(entry.order);\n    const row = rows.get(order) ?? {};\n    rows.set(order, row);\n    const current = row[entry.side];\n    if (!current || String(entry.id).localeCompare(String(current.id)) < 0) {\n      row[entry.side] = { content: entry.content, id: entry.id };\n    }\n  }\n\n  const pairs = [...rows]\n    .sort(([a], [b]) => a - b)\n    .map(([, row]) => row)\n    .filter((row): row is Required<typeof row> =>\n      Boolean(row.left && row.right),\n    );\n\n  return {\n    left: pairs.map((row) => row.left),\n    right: pairs.map((row) => row.right),\n  };\n}\n","import { clamp } from \"@/utils\";\nimport {\n  CONTROLS_DOCK_ELEMENT_ID,\n  CONTROLS_DOCK_GAP,\n  CONTROLS_EDGE_INSET,\n} from \"./constants\";\nimport { type ControlsLayout, type ViewportDimensions } from \"./types\";\n\nexport function getControlsLayout(\n  dockRect: Pick<DOMRect, \"bottom\" | \"height\" | \"left\" | \"right\"> | null,\n  viewport: ViewportDimensions,\n): ControlsLayout | null {\n  const { height, width } = viewport;\n  if (!dockRect || width <= 0 || height <= 0) return null;\n\n  const inset = CONTROLS_EDGE_INSET;\n  const gap = CONTROLS_DOCK_GAP;\n  const dockLeft = clamp(dockRect.left, 0, width);\n  const dockRight = clamp(dockRect.right, dockLeft, width);\n  const dockBottom = clamp(dockRect.bottom, 0, height);\n\n  return {\n    bottom: Math.max(0, height - dockBottom),\n    height: Math.max(0, dockRect.height) / 2,\n    left: {\n      maxWidth: Math.max(0, dockLeft - inset * 2 - gap),\n      right: Math.max(inset, width - dockLeft + gap),\n    },\n    right: {\n      left: Math.min(width - inset, dockRight + gap),\n      maxWidth: Math.max(0, width - dockRight - inset * 2 - gap),\n    },\n  };\n}\n\nexport function areLayoutsEqual(\n  a: ControlsLayout | null,\n  b: ControlsLayout | null,\n): boolean {\n  if (a === b) return true;\n  if (!a || !b) return false;\n  return (\n    a.bottom === b.bottom &&\n    a.height === b.height &&\n    a.isHidden === b.isHidden &&\n    a.left.maxWidth === b.left.maxWidth &&\n    a.left.right === b.left.right &&\n    a.right.left === b.right.left &&\n    a.right.maxWidth === b.right.maxWidth\n  );\n}\n\nexport function getDockStackElement(): HTMLElement | null {\n  return document.getElementById(CONTROLS_DOCK_ELEMENT_ID);\n}\n\nexport function getDockElement(): Element | null {\n  return (\n    document.querySelector('[data-controls-anchor=\"true\"]') ??\n    getDockStackElement()\n  );\n}\n\nexport function measureLayout(): ControlsLayout | null {\n  const dockElement = getDockElement();\n  if (!dockElement) return null;\n  const layout = getControlsLayout(dockElement.getBoundingClientRect(), {\n    height: window.innerHeight,\n    width: window.innerWidth,\n  });\n  return (\n    layout && {\n      ...layout,\n      isHidden: getDockStackElement()?.dataset.controlsHidden === \"true\",\n    }\n  );\n}\n","\"use client\";\n\nimport { useEffect, useMemo, useState } from \"react\";\nimport { usePathname } from \"next/navigation\";\nimport { useModuleRegistration, type RegistryMetadata } from \"@/kernel\";\nimport {\n  type ControlEntry,\n  type ControlsLayout,\n  type ControlsPageConfig,\n  type ControlsUseOptions,\n  type DefineControlsOptions,\n} from \"./types\";\nimport { normalizePageControls, resolveSlot } from \"./entries\";\nimport {\n  areLayoutsEqual,\n  getDockElement,\n  measureLayout,\n} from \"./layout\";\n\nexport function useControlsLayout(): ControlsLayout | null {\n  const [layout, setLayout] = useState<ControlsLayout | null>(null);\n\n  useEffect(() => {\n    let observed: Element | null | undefined;\n    let resizeObserver: ResizeObserver | undefined;\n\n    const update = () => {\n      const next = measureLayout();\n      setLayout((prev) => (areLayoutsEqual(prev, next) ? prev : next));\n    };\n\n    const observe = () => {\n      const dockElement = getDockElement();\n      if (dockElement !== observed) {\n        observed = dockElement;\n        resizeObserver?.disconnect();\n        mutationObserver.disconnect();\n        if (dockElement) {\n          if (typeof ResizeObserver !== \"undefined\") {\n            resizeObserver = new ResizeObserver(update);\n            resizeObserver.observe(dockElement);\n          }\n          mutationObserver.observe(dockElement, {\n            attributes: true,\n            attributeFilter: [\"data-controls-anchor\", \"data-controls-hidden\"],\n          });\n          if (dockElement.parentElement) {\n            mutationObserver.observe(dockElement.parentElement, {\n              childList: true,\n            });\n          }\n        } else {\n          mutationObserver.observe(document.body, {\n            childList: true,\n            subtree: true,\n          });\n        }\n      }\n      update();\n    };\n\n    const mutationObserver = new MutationObserver(observe);\n\n    observe();\n    window.addEventListener(\"resize\", update);\n    return () => {\n      mutationObserver.disconnect();\n      resizeObserver?.disconnect();\n      window.removeEventListener(\"resize\", update);\n    };\n  }, []);\n\n  return layout;\n}\n\nexport function useControlsRegistration(\n  config: ControlsPageConfig | null | undefined,\n  options?: RegistryMetadata & { enabled?: boolean },\n): void {\n  useModuleRegistration(\"controls\", config, options);\n}\n\nexport function useControls(\n  config?: DefineControlsOptions | ControlEntry | ControlEntry[] | null,\n  options?: ControlsUseOptions,\n): ControlsLayout | null {\n  const pathname = usePathname();\n  const definitionPath = config && \"path\" in config ? config.path : undefined;\n  const path = options?.path || definitionPath || pathname;\n\n  const entries = useMemo(() => {\n    if (!config) return null;\n    if (Array.isArray(config) || \"side\" in config) return config;\n    const { defaultProps = {}, left, right, ...page } = config;\n    const resolved = normalizePageControls({\n      ...page,\n      left: resolveSlot(left, defaultProps),\n      path,\n      right: resolveSlot(right, defaultProps),\n    });\n    return resolved?.length ? resolved : null;\n  }, [config, path]);\n\n  useControlsRegistration(entries, options);\n  return useControlsLayout();\n}\n","\"use client\";\n\nimport {\n  Fragment,\n  useMemo,\n  useSyncExternalStore,\n  type CSSProperties,\n} from \"react\";\nimport { createPortal } from \"react-dom\";\nimport { usePathname } from \"next/navigation\";\nimport { useRegistryEntries } from \"@/kernel\";\nimport { useModuleTheme } from \"@/theme\";\nimport { controlsTheme } from \"./constants\";\nimport { resolveControlsPairs } from \"./entries\";\nimport { useControlsLayout } from \"./hooks\";\nimport { type ControlEntry, type ControlsSideProps } from \"./types\";\n\nconst emptySubscribe = () => () => {};\n\nexport function useControlsModel() {\n  const portalTarget = useSyncExternalStore(\n    emptySubscribe,\n    () => (typeof document !== \"undefined\" ? document.body : null),\n    () => null,\n  );\n  const layout = useControlsLayout();\n  const pathname = usePathname();\n  const entries = useRegistryEntries<\"controls\", ControlEntry>(\"controls\");\n  const { left, right } = useMemo(\n    () => resolveControlsPairs(entries, pathname),\n    [entries, pathname],\n  );\n\n  const theme = useModuleTheme(controlsTheme);\n\n  return { portalTarget, layout, left, right, theme };\n}\n\nexport function ControlsSide({\n  controls,\n  geometry,\n  side,\n  theme,\n}: ControlsSideProps) {\n  if (controls.length === 0 || !geometry.height || !geometry.maxWidth) {\n    return null;\n  }\n  const positionStyle: CSSProperties =\n    side === \"left\"\n      ? {\n          bottom: geometry.bottom,\n          maxWidth: geometry.maxWidth,\n          right: geometry.right,\n        }\n      : {\n          bottom: geometry.bottom,\n          left: geometry.left,\n          maxWidth: geometry.maxWidth,\n        };\n  return (\n    <aside\n      aria-label={`${side === \"left\" ? \"Left\" : \"Right\"} page controls`}\n      className={theme.slots.rail}\n      style={{ ...theme.styles.rail, ...positionStyle }}\n    >\n      <div\n        data-side={side}\n        className={theme.slots.stack}\n        style={\n          {\n            ...theme.styles.stack,\n            \"--controls-height\": `${geometry.height}px`,\n          } as CSSProperties\n        }\n      >\n        {controls.map(({ content, id }, index) => (\n          <Fragment key={id || index}>{content}</Fragment>\n        ))}\n      </div>\n    </aside>\n  );\n}\n\nexport function Controls() {\n  const { portalTarget, layout, left, right, theme } = useControlsModel();\n  if (!portalTarget || !layout || layout.isHidden || left.length === 0) {\n    return null;\n  }\n  return createPortal(\n    <>\n      <ControlsSide\n        controls={left}\n        geometry={{\n          ...layout.left,\n          bottom: layout.bottom,\n          height: layout.height,\n        }}\n        side=\"left\"\n        theme={theme}\n      />\n      <ControlsSide\n        controls={right}\n        geometry={{\n          ...layout.right,\n          bottom: layout.bottom,\n          height: layout.height,\n        }}\n        side=\"right\"\n        theme={theme}\n      />\n    </>,\n    portalTarget,\n  );\n}\n","\"use client\";\n\nimport { useMemo } from \"react\";\nimport {\n  defineModule,\n  type PageConfig,\n  type PageModuleApi,\n} from \"@/kernel\";\nimport { useControls } from \"./hooks\";\nimport { normalizePageControls, validateControlEntry } from \"./entries\";\nimport { Controls } from \"./overlay\";\nimport {\n  type ControlsPageApi,\n  type DefinedControls,\n  type DefineControlsOptions,\n  type ControlsPageConfig,\n  type PageControlEntry,\n} from \"./types\";\n\nfunction selectPageControls(config: PageConfig) {\n  return normalizePageControls(config.controls);\n}\n\nfunction useControlsPage(\n  _slice: PageControlEntry[] | null,\n  page: PageModuleApi,\n): ControlsPageApi {\n  return useMemo(\n    () => ({\n      set: (controls: ControlsPageConfig | null) => page.set({ controls }),\n    }),\n    [page],\n  );\n}\n\nexport function defineControls(\n  definition: DefineControlsOptions = {},\n): DefinedControls {\n  const { id = \"controls\", order = 0 } = definition;\n\n  return Object.freeze({\n    config: definition,\n    id,\n    order,\n    use: function useDefinedControls(props = {}, options = {}) {\n      return useControls(\n        {\n          ...definition,\n          defaultProps: { ...definition.defaultProps, ...props },\n        },\n        options,\n      );\n    },\n  });\n}\n\nexport const controlsModule = defineModule({\n  id: \"controls\",\n  Overlay: Controls,\n  registry: {\n    keyPolicy: \"named\",\n    lifecycle: \"immediate\",\n    validate: validateControlEntry,\n  },\n  page: {\n    select: selectPageControls,\n    entries: (entry: PageControlEntry, { pathname }) => {\n      const path = pathname || \"/\";\n      return [{ key: `${path}::${entry.id}`, value: { ...entry, path } }];\n    },\n    use: useControlsPage,\n  },\n});\n\ndeclare module \"@omerdlw/base-framework/kernel\" {\n  interface CoreModules {\n    controls: typeof controlsModule;\n  }\n  interface PageConfig {\n    controls?: ControlsPageConfig | null;\n  }\n}\n"]}