@casualoffice/sheets 0.16.0 → 0.17.0

package/dist/chrome.d.cts

@@ -75,6 +75,38 @@ interface AutoSumPickerProps {
 }
 declare function AutoSumPicker({ api }: AutoSumPickerProps): react.JSX.Element;
 
+/**
+ * Copyright 2026 Casual Office
+ *
+ * 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.
+ */
+/**
+ * MenuBar data model + pure gating engine.
+ *
+ * Split out of `MenuBar.tsx` so the feature-gating contract is unit-testable
+ * under `node --test`: `MenuBar.tsx` statically imports `@univerjs/core` values
+ * (which the vendored typeless-package ESM can't expose as named exports to
+ * node), so it can't be imported in a DOM-less test. This module has only
+ * type-only imports (all erased at build), so `computeVisibleMenus` — the code
+ * that decides which menus/items a host actually sees — can be exercised
+ * directly.
+ *
+ * Feature gates: pass `features` to hide a control or whole menu group when its
+ * feature is disabled. Defaults to all-enabled. A control whose feature is
+ * `false` does not render. An entire top-level menu whose own `feature` is
+ * `false`, or that ends up with no runnable items, is dropped.
+ */
+
 /**
  * Dialog kinds the host can choose to render via `onDialogRequest`. These are
  * the actions the SDK chrome can't fulfil on its own (no built-in modal). The
@@ -82,6 +114,7 @@ declare function AutoSumPicker({ api }: AutoSumPickerProps): react.JSX.Element;
  * carries the pre-resolved A1 selection so the host doesn't have to re-read it.
  */
 type MenuDialogKind = DialogKind;
+
 interface MenuBarProps {
     /** Live API, or `null` until the editor is ready. */
     api: CasualSheetsAPI | null;

package/dist/chrome.d.ts

@@ -75,6 +75,38 @@ interface AutoSumPickerProps {
 }
 declare function AutoSumPicker({ api }: AutoSumPickerProps): react.JSX.Element;
 
+/**
+ * Copyright 2026 Casual Office
+ *
+ * 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.
+ */
+/**
+ * MenuBar data model + pure gating engine.
+ *
+ * Split out of `MenuBar.tsx` so the feature-gating contract is unit-testable
+ * under `node --test`: `MenuBar.tsx` statically imports `@univerjs/core` values
+ * (which the vendored typeless-package ESM can't expose as named exports to
+ * node), so it can't be imported in a DOM-less test. This module has only
+ * type-only imports (all erased at build), so `computeVisibleMenus` — the code
+ * that decides which menus/items a host actually sees — can be exercised
+ * directly.
+ *
+ * Feature gates: pass `features` to hide a control or whole menu group when its
+ * feature is disabled. Defaults to all-enabled. A control whose feature is
+ * `false` does not render. An entire top-level menu whose own `feature` is
+ * `false`, or that ends up with no runnable items, is dropped.
+ */
+
 /**
  * Dialog kinds the host can choose to render via `onDialogRequest`. These are
  * the actions the SDK chrome can't fulfil on its own (no built-in modal). The
@@ -82,6 +114,7 @@ declare function AutoSumPicker({ api }: AutoSumPickerProps): react.JSX.Element;
  * carries the pre-resolved A1 selection so the host doesn't have to re-read it.
  */
 type MenuDialogKind = DialogKind;
+
 interface MenuBarProps {
     /** Live API, or `null` until the editor is ready. */
     api: CasualSheetsAPI | null;

package/dist/chrome.js

@@ -2701,6 +2701,68 @@ function ensurePluginByName(group) {
   return ensurePlugin(currentUniver, group);
 }
 
+// src/chrome/menu-model.ts
+function featureOn(feature, features) {
+  if (!feature) return true;
+  return features[feature] !== false;
+}
+function keepItem(item, features, canOpen) {
+  if (!featureOn(item.feature, features)) return null;
+  if (item.kind === "separator") return item;
+  if (item.kind === "submenu") {
+    const items = filterItems(item.items, features, canOpen);
+    if (items.length === 0) return null;
+    return { ...item, items };
+  }
+  if (item.dialog && !canOpen(item.dialog)) return null;
+  return item;
+}
+function filterItems(items, features, canOpen) {
+  const kept = items.map((i) => keepItem(i, features, canOpen)).filter((i) => i !== null);
+  const out = [];
+  for (const item of kept) {
+    if (item.kind === "separator") {
+      if (out.length === 0) continue;
+      if (out[out.length - 1].kind === "separator") continue;
+    }
+    out.push(item);
+  }
+  while (out.length > 0 && out[out.length - 1].kind === "separator") out.pop();
+  return out;
+}
+function withMenuExtensions(menus, ext) {
+  if (!ext || ext.length === 0) return menus;
+  const byMenu = /* @__PURE__ */ new Map();
+  for (const e of ext) {
+    const list = byMenu.get(e.menu) ?? [];
+    list.push(e);
+    byMenu.set(e.menu, list);
+  }
+  return menus.map((menu) => {
+    const extras = byMenu.get(menu.id);
+    if (!extras || extras.length === 0) return menu;
+    const items = [...menu.items, { kind: "separator", id: `ext-sep-${menu.id}` }];
+    for (const e of extras) {
+      items.push({
+        kind: "item",
+        id: `ext-${e.id}`,
+        label: e.label,
+        icon: e.icon,
+        shortcut: e.shortcut,
+        dialog: e.dialog,
+        run: e.onClick ? (api) => e.onClick?.(api) : void 0
+      });
+    }
+    return { ...menu, items };
+  });
+}
+function computeVisibleMenus(menus, features, canOpen, ext) {
+  return withMenuExtensions(menus, ext).map((menu) => ({
+    ...menu,
+    items: filterItems(menu.items, features, canOpen)
+  })).filter((menu) => featureOn(menu.feature, features) && menu.items.length > 0);
+}
+
 // src/chrome/MenuBar.tsx
 import { jsx as jsx12, jsxs as jsxs11 } from "react/jsx-runtime";
 function fmtShortcut(shortcut) {
@@ -3058,7 +3120,8 @@ var MENUS = [
         id: "about",
         label: "About casual sheets",
         icon: "help_outline",
-        dialog: "about"
+        dialog: "about",
+        feature: "branding"
       }
     ]
   },
@@ -3606,6 +3669,12 @@ var MENUS = [
   {
     id: "help",
     label: "Help",
+    // Whole-menu gate: an embedded host passes `features={{ help: false }}` to
+    // drop the Help menu entirely (no editor-branded surface). Individual
+    // branding links below also carry `feature: 'branding'` so a host that
+    // keeps Help (for keyboard shortcuts) can still hide the About / GitHub
+    // links with `features={{ branding: false }}`.
+    feature: "help",
     items: [
       {
         kind: "item",
@@ -3615,14 +3684,22 @@ var MENUS = [
         shortcut: "Ctrl+/",
         dialog: "keyboard-shortcuts"
       },
-      { kind: "separator", id: "sep-help" },
-      { kind: "item", id: "about", label: "About casual sheets", icon: "info", dialog: "about" },
+      { kind: "separator", id: "sep-help", feature: "branding" },
+      {
+        kind: "item",
+        id: "about",
+        label: "About casual sheets",
+        icon: "info",
+        dialog: "about",
+        feature: "branding"
+      },
       {
         kind: "item",
         id: "github",
         label: "View on GitHub",
         icon: "open_in_new",
-        run: () => openExternal("https://github.com/CasualOffice/sheets")
+        run: () => openExternal("https://github.com/CasualOffice/sheets"),
+        feature: "branding"
       }
     ]
   }
@@ -3709,60 +3786,6 @@ var SUBMENU_PANEL_STYLE = {
   boxShadow: "0 6px 20px rgba(0,0,0,0.16)",
   zIndex: 1001
 };
-function featureOn(feature, features) {
-  if (!feature) return true;
-  return features[feature] !== false;
-}
-function keepItem(item, features, canOpen) {
-  if (!featureOn(item.feature, features)) return null;
-  if (item.kind === "separator") return item;
-  if (item.kind === "submenu") {
-    const items = filterItems(item.items, features, canOpen);
-    if (items.length === 0) return null;
-    return { ...item, items };
-  }
-  if (item.dialog && !canOpen(item.dialog)) return null;
-  return item;
-}
-function filterItems(items, features, canOpen) {
-  const kept = items.map((i) => keepItem(i, features, canOpen)).filter((i) => i !== null);
-  const out = [];
-  for (const item of kept) {
-    if (item.kind === "separator") {
-      if (out.length === 0) continue;
-      if (out[out.length - 1].kind === "separator") continue;
-    }
-    out.push(item);
-  }
-  while (out.length > 0 && out[out.length - 1].kind === "separator") out.pop();
-  return out;
-}
-function withMenuExtensions(menus, ext) {
-  if (!ext || ext.length === 0) return menus;
-  const byMenu = /* @__PURE__ */ new Map();
-  for (const e of ext) {
-    const list = byMenu.get(e.menu) ?? [];
-    list.push(e);
-    byMenu.set(e.menu, list);
-  }
-  return menus.map((menu) => {
-    const extras = byMenu.get(menu.id);
-    if (!extras || extras.length === 0) return menu;
-    const items = [...menu.items, { kind: "separator", id: `ext-sep-${menu.id}` }];
-    for (const e of extras) {
-      items.push({
-        kind: "item",
-        id: `ext-${e.id}`,
-        label: e.label,
-        icon: e.icon,
-        shortcut: e.shortcut,
-        dialog: e.dialog,
-        run: e.onClick ? (api) => e.onClick?.(api) : void 0
-      });
-    }
-    return { ...menu, items };
-  });
-}
 function MenuBar({ api, features = {}, extensions }) {
   const dialogs = useDialogs();
   const [open, setOpen] = useState10(null);
@@ -3806,11 +3829,7 @@ function MenuBar({ api, features = {}, extensions }) {
     }
     item.run?.(api);
   };
-  const baseMenus = withMenuExtensions(MENUS, extensions?.menu);
-  const visibleMenus = baseMenus.map((menu) => ({
-    ...menu,
-    items: filterItems(menu.items, features, dialogs.canOpen)
-  })).filter((menu) => featureOn(menu.feature, features) && menu.items.length > 0);
+  const visibleMenus = computeVisibleMenus(MENUS, features, dialogs.canOpen, extensions?.menu);
   const renderItems = (items) => items.map((item) => {
     if (item.kind === "separator") {
       return /* @__PURE__ */ jsx12("div", { style: SEPARATOR_STYLE, role: "separator", "aria-hidden": true }, item.id);