@sheetpane/visibility 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arpit Arya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,32 @@
-# Temporary Holding Version
+# @sheetpane/visibility
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Hide and unhide rows, columns and sheets in `<sheetpane-excel>` — as changes, written into the download.**
+
+The grid already honours what a file hides, marks it (◂▸ / ▴▾ on the headers, a double line, a
+*⊘ n hidden* button for sheets) and lets anyone show it for viewing. This plugin adds editing, in
+Edit:
+
+```js
+import '@sheetpane/visibility/ui';
+excel.setAttribute('plugins', 'visibility');
+```
+
+| action | where | Windows / Linux | Mac |
+|---|---|---|---|
+| Hide rows / columns | the selection bar, the cell and header menus | Ctrl+Alt+9 / Ctrl+Alt+0 | ⌘⌥9 / ⌘⌥0 |
+| Unhide rows / columns (select across the gap) | the same, and a click on a marker | Ctrl+Shift+9 / Ctrl+Shift+0 | ⌘⇧9 / ⌘⇧0 |
+| Group / Ungroup (outline) | the selection bar, the header menu | Alt+Shift+→ / Alt+Shift+← | ⌥⇧→ / ⌥⇧← |
+| Hide sheet | right-click a tab (or Shift+F10 on it) | — | — |
+| Unhide sheet | the banner on a hidden sheet opened from *⊘ n hidden* | — | — |
+
+Excel's own Ctrl+9 / Ctrl+0 belong to the browser, so the keys are Google Sheets'. On Windows,
+Ctrl+Shift+0 is often taken by the input-language hotkey — the header menu always works.
+
+- **Changes:** hiding is counted once per sheet and axis, undoable, and the download carries it
+  (`patchXlsx`'s `hidden` option). Revealing for viewing never is.
+- **Rules:** the last visible sheet cannot be hidden ("A workbook needs one visible sheet"); a CSV
+  stores no hidden state, so the controls are disabled there.
+- **Headless:** `visibility()` from `@sheetpane/visibility`, and the actions `setSpanHidden`,
+  `setSheetHidden`, `hiddenIn`, `canHideSheet`, `spanOf`.
+
+Spec: [SR-VISIBILITY](../../records/0121_VISIBILITY.md). MIT.

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import { type Plugin, type Selection, type Snapshot, type WorkbookStore } from '@sheetpane/grid';
+/**
+ * The rows and columns a selection spans, 0-based.
+ * @param sel - The selection.
+ * @returns Its rows and columns.
+ */
+export declare function spanOf(sel: Selection): {
+    rows: number[];
+    cols: number[];
+};
+/**
+ * Why hiding cannot be changed here, or undefined when it can: a CSV stores no hidden state.
+ * @param snap - The pane's snapshot.
+ * @returns The reason, or undefined.
+ */
+export declare function blockedReason(snap: Snapshot): string | undefined;
+/**
+ * Hides the selection's rows or columns — one undoable change, written into the download.
+ * @param store - The pane's workbook.
+ * @param sel - The selection.
+ * @param axis - `rows` or `cols`.
+ * @param hide - True hides; false unhides (a range across a hidden span shows it, as in Excel).
+ */
+export declare function setSpanHidden(store: WorkbookStore, sel: Selection, axis: 'rows' | 'cols', hide: boolean): void;
+/**
+ * Hides a sheet (`hidden`, never `veryHidden`) or unhides it; the last visible sheet stays.
+ * @param store - The pane's workbook.
+ * @param sheet - The sheet's name.
+ * @param hide - True hides; false unhides.
+ * @returns False when refused (the last visible sheet, or a CSV).
+ */
+export declare function setSheetHidden(store: WorkbookStore, sheet: string, hide: boolean): boolean;
+/**
+ * What a sheet hides, read from a snapshot (the file's, with the hiding changes applied) — what
+ * `store.hidden()` gives, for controls that see only the snapshot.
+ * @param snap - The pane's snapshot.
+ * @param sheet - The sheet's name.
+ * @returns Hidden rows and columns (0-based) and the sheet's state.
+ */
+export declare function hiddenIn(snap: Snapshot, sheet: string): {
+    rows: number[];
+    cols: number[];
+    state: string;
+};
+/**
+ * Whether another sheet would stay visible if this one were hidden.
+ * @param snap - The pane's snapshot.
+ * @param sheet - The sheet's name.
+ * @returns True when the sheet may be hidden.
+ */
+export declare function canHideSheet(snap: Snapshot, sheet: string): boolean;
+/**
+ * The headless plugin: its presence in a pane lets a hidden-span marker unhide (Edit).
+ * @returns The plugin (`id: 'visibility'`).
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { visibility } from '@sheetpane/visibility';
+ * const book = createWorkbook({ plugins: [visibility()] });
+ * ```
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0121_VISIBILITY.md
+ */
+export declare function visibility(): Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,MAAM,EAAE,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAG1H;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAIzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAG9G;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAS1F;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQzG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/index.js

@@ -0,0 +1,96 @@
+// @sheetpane/visibility (W-49) — hiding and unhiding as changes. Core honours, marks and reveals what
+// a file hides (SR-GRID decision 21c); this plugin is what lets an editor change it: with it in the
+// pane, a marker click in Edit unhides, and `./ui` adds the controls. Headless: the actions below.
+// No runtime dependency; `@sheetpane/grid` is a peer.
+import { cellKey, registerPlugin } from '@sheetpane/grid';
+import { parseRange, parseRef } from '@sheetpane/export';
+/**
+ * The rows and columns a selection spans, 0-based.
+ * @param sel - The selection.
+ * @returns Its rows and columns.
+ */
+export function spanOf(sel) {
+    const r = sel.range ? parseRange(sel.range) : undefined, p = parseRef(sel.ref);
+    const top = r ? r.top : p.row, bottom = r ? r.bottom : p.row, left = r ? r.left : p.col, right = r ? r.right : p.col;
+    return { rows: Array.from({ length: bottom - top + 1 }, (_, i) => top + i), cols: Array.from({ length: right - left + 1 }, (_, i) => left + i) };
+}
+/**
+ * Why hiding cannot be changed here, or undefined when it can: a CSV stores no hidden state.
+ * @param snap - The pane's snapshot.
+ * @returns The reason, or undefined.
+ */
+export function blockedReason(snap) {
+    return snap.source?.kind === 'csv' ? 'CSV can’t store hidden rows' : undefined;
+}
+/**
+ * Hides the selection's rows or columns — one undoable change, written into the download.
+ * @param store - The pane's workbook.
+ * @param sel - The selection.
+ * @param axis - `rows` or `cols`.
+ * @param hide - True hides; false unhides (a range across a hidden span shows it, as in Excel).
+ */
+export function setSpanHidden(store, sel, axis, hide) {
+    if (blockedReason(store.getSnapshot()))
+        return;
+    store.setHidden(sel.sheet, axis, spanOf(sel)[axis], hide);
+}
+/**
+ * Hides a sheet (`hidden`, never `veryHidden`) or unhides it; the last visible sheet stays.
+ * @param store - The pane's workbook.
+ * @param sheet - The sheet's name.
+ * @param hide - True hides; false unhides.
+ * @returns False when refused (the last visible sheet, or a CSV).
+ */
+export function setSheetHidden(store, sheet, hide) {
+    if (blockedReason(store.getSnapshot()))
+        return false;
+    const ok = store.setSheetState(sheet, hide ? 'hidden' : 'visible');
+    // hiding the sheet in view moves to the next visible one
+    if (ok && hide && store.getSnapshot().selection.sheet === sheet) {
+        const next = store.getSnapshot().book.sheets.find((x) => x.name !== sheet && store.hidden(x.name).state === 'visible');
+        if (next)
+            store.select({ sheet: next.name, ref: 'A1' });
+    }
+    return ok;
+}
+/**
+ * What a sheet hides, read from a snapshot (the file's, with the hiding changes applied) — what
+ * `store.hidden()` gives, for controls that see only the snapshot.
+ * @param snap - The pane's snapshot.
+ * @param sheet - The sheet's name.
+ * @returns Hidden rows and columns (0-based) and the sheet's state.
+ */
+export function hiddenIn(snap, sheet) {
+    const sh = snap.book?.sheets.find((x) => x.name === sheet);
+    const ch = (k) => snap.changes.get(cellKey(sheet, k))?.now;
+    return {
+        rows: ch('#hiddenRows') ?? sh?.hiddenRows ?? [],
+        cols: ch('#hiddenCols') ?? sh?.hiddenCols ?? [],
+        state: ch('#sheetState') ?? sh?.state ?? (sh?.hidden ? 'hidden' : 'visible'),
+    };
+}
+/**
+ * Whether another sheet would stay visible if this one were hidden.
+ * @param snap - The pane's snapshot.
+ * @param sheet - The sheet's name.
+ * @returns True when the sheet may be hidden.
+ */
+export function canHideSheet(snap, sheet) {
+    return !!snap.book && snap.book.sheets.some((x) => x.name !== sheet && hiddenIn(snap, x.name).state === 'visible');
+}
+/**
+ * The headless plugin: its presence in a pane lets a hidden-span marker unhide (Edit).
+ * @returns The plugin (`id: 'visibility'`).
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { visibility } from '@sheetpane/visibility';
+ * const book = createWorkbook({ plugins: [visibility()] });
+ * ```
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0121_VISIBILITY.md
+ */
+export function visibility() {
+    return { id: 'visibility', provides: [] };
+}
+registerPlugin('visibility', () => visibility());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,oGAAoG;AACpG,mGAAmG;AACnG,sDAAsD;AACtD,OAAO,EAAE,OAAO,EAAE,cAAc,EAAkE,MAAM,iBAAiB,CAAC;AAC1H,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,GAAc;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAChF,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrH,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC;AACnJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,OAAO,IAAI,CAAC,MAAM,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAoB,EAAE,GAAc,EAAE,IAAqB,EAAE,IAAa;IACtG,IAAI,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO;IAC/C,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAoB,EAAE,KAAa,EAAE,IAAa;IAC/E,IAAI,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnE,yDAAyD;IACzD,IAAI,EAAE,IAAI,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;QACxH,IAAI,IAAI;YAAE,KAAK,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAc,EAAE,KAAa;IACpD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAqG,CAAC;IAC/J,MAAM,EAAE,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IACnE,OAAO;QACL,IAAI,EAAG,EAAE,CAAC,aAAa,CAA0B,IAAI,EAAE,EAAE,UAAU,IAAI,EAAE;QACzE,IAAI,EAAG,EAAE,CAAC,aAAa,CAA0B,IAAI,EAAE,EAAE,UAAU,IAAI,EAAE;QACzE,KAAK,EAAG,EAAE,CAAC,aAAa,CAAwB,IAAI,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;KACrG,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc,EAAE,KAAa;IACxD,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AACrH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,cAAc,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC"}

package/dist/ui.d.ts

@@ -0,0 +1,14 @@
+import { type Plugin } from '@sheetpane/grid';
+/**
+ * The controls: Hide and Unhide rows and columns (selection bar, cell and header menus), Group and
+ * Ungroup (Alt+Shift+→ / ←), and Hide sheet (tab menu).
+ * @returns The controls plugin (`id: 'visibility-ui'`).
+ * @example
+ * ```ts
+ * import '@sheetpane/visibility/ui';
+ * excel.setAttribute('plugins', 'visibility'); // a <sheetpane-excel>
+ * ```
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0121_VISIBILITY.md
+ */
+export declare function ui(): Plugin;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAIA,OAAO,EAA0C,KAAK,MAAM,EAAqD,MAAM,iBAAiB,CAAC;AA4CzI;;;;;;;;;;GAUG;AACH,wBAAgB,EAAE,IAAI,MAAM,CAgB3B"}

package/dist/ui.js

@@ -0,0 +1,77 @@
+// @sheetpane/visibility/ui (W-49): Hide / Unhide rows, columns and sheets in the docked selection bar,
+// the cell menu, the header menu and the tab menu, with Google Sheets' keys (Excel's Ctrl+9 / Ctrl+0
+// are the browser's). Labels follow the selection; a CSV and the last visible sheet say why not.
+import { colName, parseRange } from '@sheetpane/export';
+import { registerPlugin } from '@sheetpane/grid';
+import { blockedReason, canHideSheet, hiddenIn, setSheetHidden, setSpanHidden, spanOf, visibility } from './index.js';
+const span = (axis, sel) => {
+    const list = spanOf(sel)[axis], a = list[0], b = list[list.length - 1];
+    const n = (i) => (axis === 'rows' ? String(i + 1) : colName(i));
+    return a === b ? `${axis === 'rows' ? 'row' : 'column'} ${n(a)}` : `${axis === 'rows' ? 'rows' : 'columns'} ${n(a)}–${n(b)}`;
+};
+const hiddenInside = (snap, sel, axis) => {
+    const h = new Set(hiddenIn(snap, sel.sheet)[axis]);
+    return spanOf(sel)[axis].some((i) => h.has(i));
+};
+function spanControl(axis, hide, shortcut) {
+    const verb = hide ? 'Hide' : 'Unhide';
+    return {
+        id: `visibility-${hide ? 'hide' : 'unhide'}-${axis}`, slot: 'selbar', group: 'visibility', mode: 'edit', shortcut,
+        label: `${verb} ${axis === 'rows' ? 'rows' : 'columns'}`,
+        labelFor: (_s, sel) => `${verb} ${span(axis, sel)}`,
+        menus: ['cell', 'header'],
+        // Unhide needs a selection across the hidden span; Hide needs something to hide
+        disabled: (snap, sel) => !!blockedReason(snap) || (!hide && !hiddenInside(snap, sel, axis)),
+        disabledReason: (snap, sel) => blockedReason(snap) ?? (!hide && !hiddenInside(snap, sel, axis) ? `Select across the hidden ${axis === 'rows' ? 'rows' : 'columns'} to unhide them` : undefined),
+        run: (store, sel) => setSpanHidden(store, sel, axis, hide),
+    };
+}
+/** Group (+1 level) or ungroup (−1): whole columns selected → columns, else rows. */
+function groupControl(delta) {
+    const axisOf = (snap, sel) => {
+        const sheet = snap.book?.sheets.find((x) => x.name === sel.sheet), r = sel.range ? parseRange(sel.range) : undefined;
+        return r && sheet && r.top === 0 && r.bottom >= sheet.rows.length - 1 && sheet.rows.length > 1 ? 'cols' : 'rows';
+    };
+    const verb = delta > 0 ? 'Group' : 'Ungroup';
+    return {
+        id: `visibility-${delta > 0 ? 'group' : 'ungroup'}`, slot: 'selbar', group: 'visibility-outline', mode: 'edit', label: verb,
+        shortcut: delta > 0 ? 'Alt+Shift+ArrowRight' : 'Alt+Shift+ArrowLeft', menus: ['header'],
+        labelFor: (snap, sel) => `${verb} ${span(axisOf(snap, sel), sel)}`,
+        disabled: (snap) => !!blockedReason(snap),
+        disabledReason: (snap) => blockedReason(snap),
+        run: (store, sel) => { if (!blockedReason(store.getSnapshot())) {
+            const axis = axisOf(store.getSnapshot(), sel);
+            store.setOutline(sel.sheet, axis, spanOf(sel)[axis], delta);
+        } },
+    };
+}
+/**
+ * The controls: Hide and Unhide rows and columns (selection bar, cell and header menus), Group and
+ * Ungroup (Alt+Shift+→ / ←), and Hide sheet (tab menu).
+ * @returns The controls plugin (`id: 'visibility-ui'`).
+ * @example
+ * ```ts
+ * import '@sheetpane/visibility/ui';
+ * excel.setAttribute('plugins', 'visibility'); // a <sheetpane-excel>
+ * ```
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0121_VISIBILITY.md
+ */
+export function ui() {
+    const controls = [
+        spanControl('rows', true, 'Mod+Alt+9'),
+        spanControl('cols', true, 'Mod+Alt+0'),
+        spanControl('rows', false, 'Mod+Shift+9'),
+        spanControl('cols', false, 'Mod+Shift+0'),
+        groupControl(1), groupControl(-1),
+        {
+            id: 'visibility-hide-sheet', slot: 'selbar', group: 'visibility', mode: 'edit', label: 'Hide sheet', menus: ['tab'],
+            labelFor: (_s, sel) => `Hide sheet ${sel.sheet}`,
+            disabled: (snap, sel) => !!blockedReason(snap) || !canHideSheet(snap, sel.sheet),
+            disabledReason: (snap, sel) => blockedReason(snap) ?? (!canHideSheet(snap, sel.sheet) ? 'A workbook needs one visible sheet' : undefined),
+            run: (store, sel) => { setSheetHidden(store, sel.sheet, true); },
+        },
+    ];
+    return { id: 'visibility-ui', provides: [], controls };
+}
+registerPlugin('visibility', () => [visibility(), ui()]);
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@sheetpane/visibility",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Hide and unhide rows, columns and sheets for sheetpane — menus, Google Sheets' shortcuts, a click on the grid's hidden-span markers — written into the download. Core already honours and marks what a file hides.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arpitarya/sheetpane.git",
+    "directory": "packages/visibility"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/index.js",
+    "./dist/ui.js",
+    "./src/index.ts",
+    "./src/ui.ts"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@sheetpane/grid": "0.1.0"
+  },
+  "dependencies": {
+    "@sheetpane/export": "0.1.0",
+    "@sheetpane/skills": "0.1.0"
+  },
+  "devDependencies": {
+    "@sheetpane/grid": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }