@casualoffice/sheets 0.16.0 → 0.18.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;