@sheetpane/tables 0.0.0-stage → 0.4.1

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,41 @@
-# Temporary Holding Version
+# @sheetpane/tables
 
-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.
+**Excel tables in `<sheetpane-excel>`, drawn as their style draws them — header row, banded rows and columns, totals row.**
+
+A table (a ListObject — *Insert › Table* in Excel) is read by `@sheetpane/import` whether or not
+this plugin is on: every sheet carries its `tables` (name, range, header and totals rows, columns,
+style). This plugin only draws them:
+
+```js
+import '@sheetpane/grid';
+import '@sheetpane/tables'; // registers `tables`
+excel.setAttribute('plugins', 'tables styles');
+```
+
+or `createWorkbook({ plugins: [tables()] })`.
+
+| a table's | drawn |
+|---|---|
+| header row | bold; filled in the style's colour with light text (Medium), or a line under it (Light) |
+| banded rows / columns | every other data row or column filled in a light tint of the style's colour |
+| first / last column | bold, when the table turns it on |
+| totals row | bold, under a double line |
+| lines | Light: over and under the table; Medium: under every row |
+
+- **Styles:** `TableStyleLight1`–`7` and `TableStyleMedium1`–`7`, in the workbook's theme colours
+  (style 1 in the dark text colour, 2–7 in accents 1–6) — `TABLE_STYLES`. Any other style (Light
+  8–21, Medium 8–28, Dark, a custom style) draws a bold header row only; a table with no style
+  draws nothing, as Excel's *None*.
+- **Order:** a cell's own format (`@sheetpane/styles`) and a conditional format
+  (`@sheetpane/condfmt`) draw over the table's style, as in Excel, whatever order `plugins` lists
+  them in.
+- **Draw-only:** no control, no change, nothing written — a download keeps the file's table parts
+  as they were.
+- **Headless helpers:** `tableAt(sheet, row, col)`, `findTable(book, name)`, `tableCss(table, row,
+  col, theme)`, `paletteOf(style, theme)`.
+
+**Structured references** — `Units[Name]`, `Units[[#Data],[Name]]` — are resolved by
+`@sheetpane/export`'s `resolveStructuredRef`, which `@sheetpane/validation` uses for list sources:
+a dropdown over a table column reads the table's cells, with or without this plugin.
+
+Spec: [SR-TABLES](../../records/0122_TABLES.md). MIT.

package/dist/index.d.ts

@@ -0,0 +1,66 @@
+import { type CellContext, type Plugin, type StyleSubset } from '@sheetpane/grid';
+export { TABLE_STYLES, DEFAULT_THEME, paletteOf, tint, type TablePalette } from './styles.js';
+/** The plugin's id, and the name `plugins="…"` takes. */
+export declare const PLUGIN_ID = "tables";
+/** A sheet, as a hook sees it. */
+export type Sheet = CellContext['sheet'];
+/** The workbook, as a hook sees it. */
+export type Book = CellContext['book'];
+/** One Excel table: `@sheetpane/import`'s `Table`. */
+export type Table = Sheet['tables'][number];
+/**
+ * The table a cell sits in, if any.
+ *
+ * @param sheet - The sheet.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The table, or `undefined`.
+ */
+export declare function tableAt(sheet: Sheet, row: number, col: number): Table | undefined;
+/**
+ * A table by its name — the name formulas use — case-insensitive, and the sheet it sits on.
+ *
+ * @param book - The workbook.
+ * @param name - The table's name, e.g. `Units`.
+ * @returns The table and its sheet's name, or `undefined`.
+ */
+export declare function findTable(book: Book, name: string): {
+    sheet: string;
+    table: Table;
+} | undefined;
+/**
+ * One cell's look inside a table: the header row bold (filled, for a Medium style), banded rows and columns
+ * filled, the first and last columns bold, the totals row bold under a double line, the style's lines. A
+ * style outside {@link TABLE_STYLES} draws a bold header row only; a table that names no style draws nothing,
+ * as Excel's *None*. A filled cell is given the theme's dark text colour, so it reads in a dark host too.
+ *
+ * @param table - The table.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @param theme - The workbook's theme colours (`RRGGBB` by SpreadsheetML index); Office's when empty.
+ * @returns The CSS, or `undefined` when the cell is outside the table or nothing is drawn there.
+ */
+export declare function tableCss(table: Table, row: number, col: number, theme?: readonly string[]): StyleSubset | undefined;
+/**
+ * The tables plugin: each Excel table in the workbook drawn as its style draws it — header row, banded rows
+ * and columns, first and last column, totals row — through the `decorate` hook. A cell's own format
+ * (`@sheetpane/styles`) and conditional formats (`@sheetpane/condfmt`) draw over it, as in Excel. Importing
+ * this module registers it as `tables`.
+ *
+ * @returns The plugin (`id: 'tables'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0122_TABLES.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { tables } from '@sheetpane/tables';
+ *
+ * excel.workbook = createWorkbook({ plugins: [tables()] });
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/tables'; // registers `tables`
+ * excel.setAttribute('plugins', 'tables styles');
+ * ```
+ */
+export declare function tables(): 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":"AAKA,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAIlG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9F,yDAAyD;AACzD,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,kCAAkC;AAClC,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;AACzC,uCAAuC;AACvC,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AACvC,sDAAsD;AACtD,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAe5C;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,SAAS,CAO/F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,WAAW,GAAG,SAAS,CAmBvH;AAeD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAS/B"}

package/dist/index.js

@@ -0,0 +1,143 @@
+// @sheetpane/tables (W-61) — a workbook's Excel tables, drawn: each table's header row, banded rows and
+// columns, first and last column and totals row, from its built-in table style, through the `decorate`
+// hook. Reading the tables is @sheetpane/import's (`ImportedSheet.tables`); resolving `Units[Name]` is
+// @sheetpane/export's `resolveStructuredRef`. Draw-only: no control, no change, nothing exported.
+// Spec: records/0122_TABLES.md (SR-TABLES).
+import { registerPlugin } from '@sheetpane/grid';
+import { parseRange } from '@sheetpane/export';
+import { paletteOf } from './styles.js';
+export { TABLE_STYLES, DEFAULT_THEME, paletteOf, tint } from './styles.js';
+/** The plugin's id, and the name `plugins="…"` takes. */
+export const PLUGIN_ID = 'tables';
+const placed = new WeakMap();
+function placedOf(sheet) {
+    let list = placed.get(sheet);
+    if (!list) {
+        list = [];
+        for (const table of sheet.tables ?? []) {
+            const box = parseRange(table.ref);
+            if (box)
+                list.push({ table, box });
+        }
+        placed.set(sheet, list);
+    }
+    return list;
+}
+/**
+ * The table a cell sits in, if any.
+ *
+ * @param sheet - The sheet.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @returns The table, or `undefined`.
+ */
+export function tableAt(sheet, row, col) {
+    return placedOf(sheet).find(({ box }) => row >= box.top && row <= box.bottom && col >= box.left && col <= box.right)?.table;
+}
+/**
+ * A table by its name — the name formulas use — case-insensitive, and the sheet it sits on.
+ *
+ * @param book - The workbook.
+ * @param name - The table's name, e.g. `Units`.
+ * @returns The table and its sheet's name, or `undefined`.
+ */
+export function findTable(book, name) {
+    const want = name.toLowerCase();
+    for (const s of book.sheets) {
+        const table = (s.tables ?? []).find((t) => t.name.toLowerCase() === want);
+        if (table)
+            return { sheet: s.name, table };
+    }
+    return undefined;
+}
+/**
+ * One cell's look inside a table: the header row bold (filled, for a Medium style), banded rows and columns
+ * filled, the first and last columns bold, the totals row bold under a double line, the style's lines. A
+ * style outside {@link TABLE_STYLES} draws a bold header row only; a table that names no style draws nothing,
+ * as Excel's *None*. A filled cell is given the theme's dark text colour, so it reads in a dark host too.
+ *
+ * @param table - The table.
+ * @param row - The cell's row, 0-based.
+ * @param col - The cell's column, 0-based.
+ * @param theme - The workbook's theme colours (`RRGGBB` by SpreadsheetML index); Office's when empty.
+ * @returns The CSS, or `undefined` when the cell is outside the table or nothing is drawn there.
+ */
+export function tableCss(table, row, col, theme = []) {
+    const box = parseRange(table.ref);
+    if (!box || row < box.top || row > box.bottom || col < box.left || col > box.right)
+        return undefined;
+    const h = Math.max(0, table.headerRowCount), t = Math.max(0, table.totalsRowCount);
+    const header = row < box.top + h, totals = row > box.bottom - t;
+    const style = table.style;
+    if (!style.name)
+        return undefined;
+    const p = paletteOf(style.name, theme);
+    if (!p)
+        return header ? { 'font-weight': '700' } : undefined;
+    const css = {};
+    const bold = header || totals || (style.showFirstColumn && col === box.left) || (style.showLastColumn && col === box.right);
+    if (bold)
+        css['font-weight'] = '700';
+    draw(css, p, { header, totals, top: row === box.top, bottom: row === box.bottom });
+    if (!header && !totals) {
+        const r = row - box.top - h, c = col - box.left;
+        if ((style.showRowStripes && r % 2 === 0) || (style.showColumnStripes && c % 2 === 0))
+            css['background-color'] = p.stripe;
+    }
+    if (css['background-color'] && !css.color)
+        css.color = p.ink;
+    return Object.keys(css).length ? css : undefined;
+}
+/** The lines and the header fill: Light — a line over and under the table and under the header; Medium — the header filled, a line under every row. */
+function draw(css, p, at) {
+    if (p.kind === 'light') {
+        if (at.top)
+            css['border-top'] = `1px solid ${p.accent}`;
+        if (at.bottom || at.header)
+            css['border-bottom'] = `1px solid ${p.accent}`;
+    }
+    else {
+        if (at.top)
+            css['border-top'] = `1px solid ${p.line}`;
+        css['border-bottom'] = `1px solid ${p.line}`;
+        if (at.header) {
+            css['background-color'] = p.accent;
+            css.color = p.onAccent;
+        }
+    }
+    if (at.totals)
+        css['border-top'] = `3px double ${p.accent}`;
+}
+/**
+ * The tables plugin: each Excel table in the workbook drawn as its style draws it — header row, banded rows
+ * and columns, first and last column, totals row — through the `decorate` hook. A cell's own format
+ * (`@sheetpane/styles`) and conditional formats (`@sheetpane/condfmt`) draw over it, as in Excel. Importing
+ * this module registers it as `tables`.
+ *
+ * @returns The plugin (`id: 'tables'`).
+ * @see https://github.com/arpitarya/sheetpane/blob/main/records/0122_TABLES.md
+ * @example
+ * ```ts
+ * import { createWorkbook } from '@sheetpane/grid';
+ * import { tables } from '@sheetpane/tables';
+ *
+ * excel.workbook = createWorkbook({ plugins: [tables()] });
+ * ```
+ * @example
+ * ```ts
+ * import '@sheetpane/tables'; // registers `tables`
+ * excel.setAttribute('plugins', 'tables styles');
+ * ```
+ */
+export function tables() {
+    return {
+        id: PLUGIN_ID,
+        provides: ['decorate'],
+        decorate(cell) {
+            const table = tableAt(cell.sheet, cell.row, cell.col);
+            return table && tableCss(table, cell.row, cell.col, cell.book.themeColors);
+        },
+    };
+}
+registerPlugin(PLUGIN_ID, () => tables());
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/styles.d.ts

@@ -0,0 +1,37 @@
+/** Office's default theme (lt1, dk1, lt2, dk2, accents 1–6), used when a workbook names none. */
+export declare const DEFAULT_THEME: readonly string[];
+/** Every style name this plugin draws in full; any other draws a bold header row only. */
+export declare const TABLE_STYLES: readonly string[];
+/** What one table style paints: `#RRGGBB` colours, or `undefined` for a style outside the subset. */
+export interface TablePalette {
+    kind: 'light' | 'medium';
+    /** The style's colour: the header fill (Medium), the outer and header lines (Light), the totals row's double line. */
+    accent: string;
+    /** The line between rows (Medium). */
+    line: string;
+    /** The banded rows' and columns' fill. */
+    stripe: string;
+    /** Text on a filled cell: the theme's dark text colour (a filled cell never takes the host's ink). */
+    ink: string;
+    /** Text on the header fill (Medium): the theme's light colour. */
+    onAccent: string;
+}
+/**
+ * Excel's tint (ECMA-376 Part 1, §18.8.19): in HSL, a negative tint darkens (`L·(1+tint)`), a positive one
+ * lightens (`L·(1−tint) + tint`). The same tint as `@sheetpane/styles`' `applyTint`, kept here so this plugin
+ * needs no peer.
+ *
+ * @param rgb - The colour, `RRGGBB` (no `#`).
+ * @param tint - The tint, -1 to 1.
+ * @returns The tinted colour, `RRGGBB` upper case.
+ */
+export declare function tint(rgb: string, tint: number): string;
+/**
+ * The colours a built-in table style paints with, from the workbook's theme.
+ *
+ * @param name - The style's name, e.g. `TableStyleMedium2`.
+ * @param theme - The workbook's theme colours by SpreadsheetML index (`RRGGBB`); Office's when empty.
+ * @returns The palette, or `undefined` when the style is outside the subset ({@link TABLE_STYLES}).
+ */
+export declare function paletteOf(name: string | undefined, theme?: readonly string[]): TablePalette | undefined;
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAIA,iGAAiG;AACjG,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAyG,CAAC;AAErJ,0FAA0F;AAC1F,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA0F,CAAC;AAErI,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IACzB,sHAAsH;IACtH,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtD;AAID;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,YAAY,GAAG,SAAS,CAe3G"}

package/dist/styles.js

@@ -0,0 +1,53 @@
+// The table styles this plugin draws (W-61; SR-TABLES decision 3): Excel's built-in Light 1–7 and
+// Medium 1–7, approximated from the workbook's theme — style 1 is in the theme's dark text colour,
+// styles 2–7 in accents 1–6. Any other style name draws a bold header row only.
+/** Office's default theme (lt1, dk1, lt2, dk2, accents 1–6), used when a workbook names none. */
+export const DEFAULT_THEME = ['FFFFFF', '000000', 'E7E6E6', '44546A', '4472C4', 'ED7D31', 'A5A5A5', 'FFC000', '5B9BD5', '70AD47'];
+/** Every style name this plugin draws in full; any other draws a bold header row only. */
+export const TABLE_STYLES = [1, 2, 3, 4, 5, 6, 7].flatMap((n) => [`TableStyleLight${n}`, `TableStyleMedium${n}`]);
+/**
+ * Excel's tint (ECMA-376 Part 1, §18.8.19): in HSL, a negative tint darkens (`L·(1+tint)`), a positive one
+ * lightens (`L·(1−tint) + tint`). The same tint as `@sheetpane/styles`' `applyTint`, kept here so this plugin
+ * needs no peer.
+ *
+ * @param rgb - The colour, `RRGGBB` (no `#`).
+ * @param tint - The tint, -1 to 1.
+ * @returns The tinted colour, `RRGGBB` upper case.
+ */
+export function tint(rgb, tint) {
+    const [r, g, b] = [0, 2, 4].map((i) => parseInt(rgb.slice(i, i + 2), 16) / 255);
+    const mx = Math.max(r, g, b), mn = Math.min(r, g, b), l0 = (mx + mn) / 2, d = mx - mn;
+    const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l0 - 1));
+    const h = d === 0 ? 0 : mx === r ? ((g - b) / d + 6) % 6 : mx === g ? (b - r) / d + 2 : (r - g) / d + 4;
+    const t = Math.max(-1, Math.min(1, tint));
+    const l = t < 0 ? l0 * (1 + t) : l0 * (1 - t) + t;
+    const c = (1 - Math.abs(2 * l - 1)) * s, x = c * (1 - Math.abs((h % 2) - 1)), m = l - c / 2;
+    const [p, q, w] = h < 1 ? [c, x, 0] : h < 2 ? [x, c, 0] : h < 3 ? [0, c, x] : h < 4 ? [0, x, c] : h < 5 ? [x, 0, c] : [c, 0, x];
+    return [p, q, w].map((v) => Math.round(Math.max(0, Math.min(1, v + m)) * 255).toString(16).padStart(2, '0')).join('').toUpperCase();
+}
+const STYLE = /^TableStyle(Light|Medium)([1-7])$/;
+/**
+ * The colours a built-in table style paints with, from the workbook's theme.
+ *
+ * @param name - The style's name, e.g. `TableStyleMedium2`.
+ * @param theme - The workbook's theme colours by SpreadsheetML index (`RRGGBB`); Office's when empty.
+ * @returns The palette, or `undefined` when the style is outside the subset ({@link TABLE_STYLES}).
+ */
+export function paletteOf(name, theme = []) {
+    const m = name ? STYLE.exec(name) : null;
+    if (!m)
+        return undefined;
+    const th = (i) => (theme[i] ?? DEFAULT_THEME[i]).toUpperCase();
+    const n = Number(m[2]);
+    const base = n === 1 ? th(1) : th(n + 2); // style 1: the dark text colour; 2–7: accents 1–6
+    const dark = n === 1; // a black or grey base takes lighter tints to read as grey
+    return {
+        kind: m[1] === 'Light' ? 'light' : 'medium',
+        accent: `#${base}`,
+        line: `#${tint(base, dark ? 0.5 : 0.4)}`,
+        stripe: `#${tint(base, dark ? 0.85 : 0.8)}`,
+        ink: `#${th(1)}`,
+        onAccent: `#${th(0)}`,
+    };
+}
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

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

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@sheetpane/tables",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.1",
+  "description": "Excel tables for sheetpane — each table's header row, banded rows and columns and totals row drawn from its built-in table style, as a plugin on the `decorate` hook. The tables themselves are read by @sheetpane/import.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arpitarya/sheetpane.git",
+    "directory": "packages/tables"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/index.js",
+    "./src/index.ts"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@sheetpane/grid": "0.4.1"
+  },
+  "dependencies": {
+    "@sheetpane/export": "0.4.1",
+    "@sheetpane/skills": "0.4.1"
+  },
+  "devDependencies": {
+    "@sheetpane/grid": "0.4.1",
+    "@sheetpane/styles": "0.4.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }