@sheetwrite/vue 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sheetwrite contributors
+
+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

@@ -0,0 +1,54 @@
+# @sheetwrite/vue
+
+Vue 3 components for Sheetwrite.
+
+## Install
+
+```sh
+bun add @sheetwrite/vue
+```
+
+Vue 3.4 or newer is a peer dependency. Core and WASM arrive transitively.
+
+## Data-first component
+
+```vue
+<script setup lang="ts">
+import { Sheetwrite } from "@sheetwrite/vue";
+import "@sheetwrite/vue/styles.css";
+</script>
+
+<template>
+  <Sheetwrite
+    :columns="columns"
+    :default-rows="products"
+    height="500px"
+    @grid-change="(event) => console.log(event.source, event.transaction.patches)"
+  />
+</template>
+```
+
+`defaultRows` seeds an uncontrolled grid and is never mutated. A new array identity deliberately creates a new generation. Use `height` or `fill`; `fill` requires an already-sized ancestor.
+
+`grid-change` observes the complete transaction. Do not persist only
+`event.changes`; use `event.transaction.patches` or attach `SyncCoordinator` to
+the exposed `Grid` for mutation IDs, acknowledgements, retry, and remote ordering.
+
+WASM initializes on client mount. Supply a `#fallback` slot while loading, observe `@initialization-error`, and use `wasm-source` only for explicit asset control.
+
+## Advanced component
+
+```vue
+<SheetwriteGrid ref="gridComponent" :workbook="workbook" :data="data" fill />
+```
+
+The exposed `grid` handle is published before `@ready="({ grid, generation, reason }) => …"` and clears during replacement/unmount. Reset-bound inputs are `workbook`, `data`, `datasource`, `datasourceStorage`, `renderer`, `workerUrl`, and `renderers`; `theme`, `readOnly`, `config`, `overscan`, and `minColumns` update live.
+
+Events are `grid-change`, `viewport-change`, `selection-change`, `edit-begin`, `edit-commit`, `search`, `active-sheet-change`, `ready`, and `initialization-error`. Native DOM change/scroll listeners remain available on the host.
+
+For vanilla/preload control, use `initSheetwrite()` and `createGrid()` from `@sheetwrite/core`. See [installation](https://sheetwrite.vercel.app/docs/start/installation/), [Vue integration](https://sheetwrite.vercel.app/docs/frameworks/vue/), and [collaboration](https://sheetwrite.vercel.app/docs/guides/collaboration/).
+
+XLSX is not installed by this adapter. If the toolbar configuration enables
+XLSX export, install `@sheetwrite/xlsx` and import
+`@sheetwrite/xlsx/register` before the action (or lazily inside its handler).
+CSV/TSV require no optional package.

package/dist/index.d.ts

@@ -0,0 +1,304 @@
+import { type CellRenderer, type CellScalar, type ChangeEvent, type ColumnarData, type DataSource, type DataSourceStorageOptions, type Grid, type GridEvents, type GridOptions, type Selection, type Theme, type Workbook } from "@sheetwrite/core";
+import { type GridReadyEvent, type SheetwriteInitializationProps } from "@sheetwrite/core/adapter";
+import { type PropType } from "vue";
+/** Imperative Grid handle exposed by the Vue advanced component. */
+export interface SheetwriteGridExpose {
+    /** Live Grid after readiness, or `null` before initialization and during teardown. */
+    grid: Grid | null;
+}
+declare const SheetwriteGridComponent: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** Live workbook schema adopted by the Grid. */
+    workbook: {
+        type: PropType<Workbook>;
+        required: true;
+    };
+    /** Eager column-major values for the active sheet. */
+    data: {
+        type: PropType<ColumnarData>;
+        default: undefined;
+    };
+    /** Lazy row provider requested for visible windows. */
+    datasource: {
+        type: PropType<DataSource>;
+        default: undefined;
+    };
+    /** Allocation and cache policy for datasource storage. */
+    datasourceStorage: {
+        type: PropType<DataSourceStorageOptions>;
+        default: undefined;
+    };
+    /** Paint backend; defaults to main-thread canvas. */
+    renderer: {
+        type: PropType<GridOptions["renderer"]>;
+        default: undefined;
+    };
+    /** Browser-fetchable worker module URL. */
+    workerUrl: {
+        type: PropType<GridOptions["workerUrl"]>;
+        default: undefined;
+    };
+    /** Live overrides merged into the resolved Grid theme. */
+    theme: {
+        type: PropType<Partial<Theme>>;
+        default: undefined;
+    };
+    /** Disables mutation while preserving navigation and selection. */
+    readOnly: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** Host-owned client permission check for protected ranges. */
+    protectionResolver: {
+        type: PropType<GridOptions["protectionResolver"]>;
+        default: undefined;
+    };
+    /** Atomic or partial handling for denied local operations. */
+    mutationPolicy: {
+        type: PropType<GridOptions["mutationPolicy"]>;
+        default: undefined;
+    };
+    /** Named custom renderers registered when the Grid is created. */
+    renderers: {
+        type: PropType<Record<string, CellRenderer>>;
+        default: undefined;
+    };
+    /** Extra rows painted above and below the viewport. */
+    overscan: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /** Minimum rendered column count, including empty padding columns. */
+    minColumns: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /** Built-in toolbar, menu, keyboard, find, and tab controls. */
+    config: {
+        type: PropType<GridOptions["config"]>;
+        default: undefined;
+    };
+    /** Explicit source passed to process-wide WASM initialization. */
+    wasmSource: {
+        type: PropType<SheetwriteInitializationProps["wasmSource"]>;
+        default: undefined;
+    };
+    /** Host height in CSS pixels for numbers or any CSS length string. */
+    height: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /** Fills the parent's available width and height. */
+    fill: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "grid-change": (_event: ChangeEvent) => boolean;
+    "selection-change": (_selection: Selection | null) => boolean;
+    "viewport-change": (_event: GridEvents["scroll"]) => boolean;
+    "edit-begin": (_event: GridEvents["edit-begin"]) => boolean;
+    "edit-commit": (_event: GridEvents["edit-commit"]) => boolean;
+    search: (_result: GridEvents["search"]) => boolean;
+    "active-sheet-change": (_event: GridEvents["active-sheet"]) => boolean;
+    ready: (_event: GridReadyEvent) => boolean;
+    "initialization-error": (_error: unknown) => boolean;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** Live workbook schema adopted by the Grid. */
+    workbook: {
+        type: PropType<Workbook>;
+        required: true;
+    };
+    /** Eager column-major values for the active sheet. */
+    data: {
+        type: PropType<ColumnarData>;
+        default: undefined;
+    };
+    /** Lazy row provider requested for visible windows. */
+    datasource: {
+        type: PropType<DataSource>;
+        default: undefined;
+    };
+    /** Allocation and cache policy for datasource storage. */
+    datasourceStorage: {
+        type: PropType<DataSourceStorageOptions>;
+        default: undefined;
+    };
+    /** Paint backend; defaults to main-thread canvas. */
+    renderer: {
+        type: PropType<GridOptions["renderer"]>;
+        default: undefined;
+    };
+    /** Browser-fetchable worker module URL. */
+    workerUrl: {
+        type: PropType<GridOptions["workerUrl"]>;
+        default: undefined;
+    };
+    /** Live overrides merged into the resolved Grid theme. */
+    theme: {
+        type: PropType<Partial<Theme>>;
+        default: undefined;
+    };
+    /** Disables mutation while preserving navigation and selection. */
+    readOnly: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+    /** Host-owned client permission check for protected ranges. */
+    protectionResolver: {
+        type: PropType<GridOptions["protectionResolver"]>;
+        default: undefined;
+    };
+    /** Atomic or partial handling for denied local operations. */
+    mutationPolicy: {
+        type: PropType<GridOptions["mutationPolicy"]>;
+        default: undefined;
+    };
+    /** Named custom renderers registered when the Grid is created. */
+    renderers: {
+        type: PropType<Record<string, CellRenderer>>;
+        default: undefined;
+    };
+    /** Extra rows painted above and below the viewport. */
+    overscan: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /** Minimum rendered column count, including empty padding columns. */
+    minColumns: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    /** Built-in toolbar, menu, keyboard, find, and tab controls. */
+    config: {
+        type: PropType<GridOptions["config"]>;
+        default: undefined;
+    };
+    /** Explicit source passed to process-wide WASM initialization. */
+    wasmSource: {
+        type: PropType<SheetwriteInitializationProps["wasmSource"]>;
+        default: undefined;
+    };
+    /** Host height in CSS pixels for numbers or any CSS length string. */
+    height: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /** Fills the parent's available width and height. */
+    fill: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+}>> & Readonly<{
+    "onActive-sheet-change"?: ((_event: {
+        sheet: import("@sheetwrite/core").SheetId;
+    }) => any) | undefined;
+    "onEdit-begin"?: ((_event: {
+        addr: import("@sheetwrite/core").CellAddress;
+    }) => any) | undefined;
+    "onEdit-commit"?: ((_event: {
+        addr: import("@sheetwrite/core").CellAddress;
+        value: import("@sheetwrite/core").CellValue;
+    }) => any) | undefined;
+    "onGrid-change"?: ((_event: ChangeEvent) => any) | undefined;
+    "onInitialization-error"?: ((_error: unknown) => any) | undefined;
+    onReady?: ((_event: GridReadyEvent) => any) | undefined;
+    onSearch?: ((_result: import("@sheetwrite/core").SearchResult) => any) | undefined;
+    "onSelection-change"?: ((_selection: Selection | null) => any) | undefined;
+    "onViewport-change"?: ((_event: {
+        scrollTop: number;
+        firstRow: number;
+        lastRow: number;
+    }) => any) | undefined;
+}>, {
+    data: ColumnarData;
+    datasource: DataSource;
+    datasourceStorage: DataSourceStorageOptions;
+    renderer: "canvas" | "worker" | undefined;
+    workerUrl: string | URL | undefined;
+    theme: Partial<Theme>;
+    readOnly: boolean;
+    protectionResolver: import("@sheetwrite/core").ProtectionResolver | undefined;
+    mutationPolicy: import("@sheetwrite/core").MutationPolicyMode | undefined;
+    renderers: Record<string, CellRenderer>;
+    overscan: number;
+    minColumns: number;
+    config: import("@sheetwrite/core").GridConfig | undefined;
+    wasmSource: string | WebAssembly.Module | Request | URL | BufferSource | undefined;
+    height: string | number;
+    fill: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** Advanced framework component for workbook data or datasource input. */
+export declare const SheetwriteGrid: typeof SheetwriteGridComponent & {
+    new (): InstanceType<typeof SheetwriteGridComponent> & SheetwriteGridExpose;
+};
+/** Convenience component for local object rows with live option updates. */
+export declare const Sheetwrite: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** Ordered schema used to derive the component-owned sheet. */
+    columns: {
+        type: PropType<readonly {
+            key: string;
+            title: string;
+        }[]>;
+        required: true;
+    };
+    /** Rows converted to initial columnar data; missing keys become `null`. */
+    defaultRows: {
+        type: PropType<readonly Record<string, CellScalar>[]>;
+        required: true;
+    };
+    /** Generated sheet name; defaults to `Sheet 1`. */
+    sheetName: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** Host height in CSS pixels for numbers or any CSS length string. */
+    height: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /** Fills the parent; exactly one of `fill` or `height` is required. */
+    fill: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** Ordered schema used to derive the component-owned sheet. */
+    columns: {
+        type: PropType<readonly {
+            key: string;
+            title: string;
+        }[]>;
+        required: true;
+    };
+    /** Rows converted to initial columnar data; missing keys become `null`. */
+    defaultRows: {
+        type: PropType<readonly Record<string, CellScalar>[]>;
+        required: true;
+    };
+    /** Generated sheet name; defaults to `Sheet 1`. */
+    sheetName: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** Host height in CSS pixels for numbers or any CSS length string. */
+    height: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: undefined;
+    };
+    /** Fills the parent; exactly one of `fill` or `height` is required. */
+    fill: {
+        type: BooleanConstructor;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    sheetName: string;
+    height: string | number;
+    fill: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export type { CellScalar, Grid } from "@sheetwrite/core";
+export type { GridReadyEvent, SimpleColumn } from "@sheetwrite/core/adapter";
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,208 @@
+import { initSheetwrite, isSheetwriteReady, } from "@sheetwrite/core";
+import { createGridController, createSimpleGridInput, getGridResetReason, gridSizeStyle, } from "@sheetwrite/core/adapter";
+import { defineComponent, h, nextTick, onBeforeUnmount, onMounted, ref, shallowRef, watch, } from "vue";
+const gridProps = {
+    workbook: { type: Object, required: true },
+    data: { type: Object, default: undefined },
+    datasource: { type: Object, default: undefined },
+    datasourceStorage: {
+        type: Object,
+        default: undefined,
+    },
+    renderer: { type: String, default: undefined },
+    workerUrl: {
+        type: [String, URL],
+        default: undefined,
+    },
+    theme: { type: Object, default: undefined },
+    readOnly: { type: Boolean, default: undefined },
+    protectionResolver: {
+        type: Function,
+        default: undefined,
+    },
+    mutationPolicy: {
+        type: String,
+        default: undefined,
+    },
+    renderers: { type: Object, default: undefined },
+    overscan: { type: Number, default: undefined },
+    minColumns: { type: Number, default: undefined },
+    config: { type: Object, default: undefined },
+    wasmSource: {
+        type: [Object, String],
+        default: undefined,
+    },
+    height: { type: [Number, String], default: undefined },
+    fill: { type: Boolean, default: undefined },
+};
+const gridEmits = {
+    "grid-change": (_event) => true,
+    "selection-change": (_selection) => true,
+    "viewport-change": (_event) => true,
+    "edit-begin": (_event) => true,
+    "edit-commit": (_event) => true,
+    search: (_result) => true,
+    "active-sheet-change": (_event) => true,
+    ready: (_event) => true,
+    "initialization-error": (_error) => true,
+};
+const SheetwriteGridComponent = defineComponent({
+    name: "SheetwriteGrid",
+    inheritAttrs: false,
+    props: gridProps,
+    emits: gridEmits,
+    setup(props, { attrs, emit, expose, slots }) {
+        const host = ref(null);
+        const exposedGrid = shallowRef(null);
+        let controller = null;
+        let generation = 0;
+        let previousOptions = null;
+        let mounted = false;
+        let initializationToken = 0;
+        const handlers = {
+            onGridChange: (event) => emit("grid-change", event),
+            onSelectionChange: (selection) => emit("selection-change", selection),
+            onViewportChange: (event) => emit("viewport-change", event),
+            onEditBegin: (event) => emit("edit-begin", event),
+            onEditCommit: (event) => emit("edit-commit", event),
+            onSearch: (result) => emit("search", result),
+            onActiveSheetChange: (event) => emit("active-sheet-change", event),
+        };
+        function currentOptions() {
+            return {
+                workbook: props.workbook,
+                data: props.data,
+                datasource: props.datasource,
+                datasourceStorage: props.datasourceStorage,
+                renderer: props.renderer,
+                workerUrl: props.workerUrl,
+                theme: props.theme,
+                readOnly: props.readOnly,
+                protectionResolver: props.protectionResolver,
+                mutationPolicy: props.mutationPolicy,
+                renderers: props.renderers,
+                overscan: props.overscan,
+                minColumns: props.minColumns,
+                config: props.config,
+            };
+        }
+        function teardownGrid() {
+            exposedGrid.value = null;
+            controller?.destroy();
+            controller = null;
+        }
+        async function createCurrentGrid() {
+            if (!mounted || !host.value)
+                return;
+            const options = currentOptions();
+            const reason = generation === 0
+                ? "initial"
+                : ((previousOptions && getGridResetReason(previousOptions, options)) ?? "input-reset");
+            teardownGrid();
+            const created = createGridController(host.value, options, handlers);
+            controller = created;
+            generation += 1;
+            previousOptions = options;
+            exposedGrid.value = created.grid;
+            await nextTick();
+            if (controller !== created)
+                return;
+            emit("ready", { grid: created.grid, generation, reason });
+        }
+        async function initialize() {
+            const token = ++initializationToken;
+            const alreadyReady = isSheetwriteReady();
+            try {
+                const initialization = initSheetwrite(props.wasmSource);
+                if (alreadyReady && mounted && !controller)
+                    await createCurrentGrid();
+                await initialization;
+                if (!alreadyReady && mounted && isSheetwriteReady() && !controller) {
+                    await createCurrentGrid();
+                }
+            }
+            catch (error) {
+                if (mounted && token === initializationToken)
+                    emit("initialization-error", error);
+            }
+        }
+        onMounted(() => {
+            mounted = true;
+            void initialize();
+        });
+        onBeforeUnmount(() => {
+            mounted = false;
+            initializationToken += 1;
+            teardownGrid();
+        });
+        watch(() => props.wasmSource, () => {
+            void initialize();
+        });
+        watch(() => [
+            props.workbook,
+            props.data,
+            props.datasource,
+            props.datasourceStorage,
+            props.renderer,
+            props.workerUrl,
+            props.protectionResolver,
+            props.mutationPolicy,
+            props.renderers,
+        ], () => {
+            if (isSheetwriteReady())
+                void createCurrentGrid();
+        });
+        watch(() => props.readOnly, (value) => controller?.setReadOnly(value ?? false));
+        watch(() => props.config, (value) => controller?.setConfig(value));
+        watch(() => props.theme, (value) => controller?.setTheme(value));
+        watch(() => props.overscan, (value) => controller?.setOverscan(value));
+        watch(() => props.minColumns, (value) => controller?.setMinColumns(value));
+        expose({ grid: exposedGrid });
+        return () => {
+            const style = [
+                attrs.style,
+                gridSizeStyle({ height: props.height, fill: props.fill || undefined }),
+            ];
+            return h("div", { ...attrs, ref: host, class: ["sheetwrite", attrs.class], style }, exposedGrid.value ? undefined : slots.fallback?.());
+        };
+    },
+});
+export const SheetwriteGrid = SheetwriteGridComponent;
+export const Sheetwrite = defineComponent({
+    name: "SheetwriteComponent",
+    inheritAttrs: false,
+    props: {
+        columns: { type: Array, required: true },
+        defaultRows: { type: Array, required: true },
+        sheetName: { type: String, default: undefined },
+        height: { type: [Number, String], default: undefined },
+        fill: { type: Boolean, default: undefined },
+    },
+    setup(props, { attrs, slots }) {
+        let input = null;
+        let inputColumns = null;
+        let inputRows = null;
+        let inputSheetName;
+        return () => {
+            if ((props.height === undefined && !props.fill) ||
+                (props.height !== undefined && props.fill)) {
+                throw new Error("Sheetwrite: provide exactly one of height or fill");
+            }
+            if (input === null ||
+                inputColumns !== props.columns ||
+                inputRows !== props.defaultRows ||
+                inputSheetName !== props.sheetName) {
+                input = createSimpleGridInput({
+                    columns: props.columns,
+                    defaultRows: props.defaultRows,
+                    sheetName: props.sheetName,
+                });
+                inputColumns = props.columns;
+                inputRows = props.defaultRows;
+                inputSheetName = props.sheetName;
+            }
+            return h(SheetwriteGrid, { ...attrs, ...props, ...input }, slots);
+        };
+    },
+});
+//# 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/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@sheetwrite/vue",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Vue adapter for Sheetwrite.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chh-ay/Sheetwrite.git",
+    "directory": "packages/vue"
+  },
+  "homepage": "https://chh-ay.github.io/Sheetwrite/",
+  "bugs": {
+    "url": "https://github.com/chh-ay/Sheetwrite/issues"
+  },
+  "keywords": [
+    "spreadsheet",
+    "data-grid",
+    "vue",
+    "canvas"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./styles.css": "./styles.css"
+  },
+  "files": [
+    "dist",
+    "styles.css"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && tsc -p tsconfig.declarations.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "peerDependencies": {
+    "vue": ">=3.4"
+  },
+  "dependencies": {
+    "@sheetwrite/core": "0.1.0"
+  }
+}

package/styles.css

@@ -0,0 +1 @@
+@import "@sheetwrite/core/styles.css";