sheetnext 0.2.9 → 0.2.10

package/docs/skill/sheetnext-dev/GENERATION.md

@@ -1,18 +1,18 @@
-# Generation
-
-Generated on 2026-04-28 by `scripts/doc-scanner.js`.
-
-## Source Inputs
-
-- Public API comments and signatures under `src/core/`.
-- Enum definitions from `src/enum/index.js`.
-- Static protocol references preserved from `docs/static-references/ai-relay.md` and `docs/static-references/json-format.md`.
-- Built-in examples from `scripts/doc-examples.js`.
-
-## Output Contract
-
-- `SKILL.md` is the portable skill entry point.
-- `references/` contains generated or preserved Markdown references for agent lookup.
-- `adapters/` contains optional tool-specific setup notes.
-
-Do not manually edit generated API reference files. Update the documented source or static reference input, then rerun the scanner.
+# Generation
+
+Generated on 2026-04-28 by `scripts/doc-scanner.js`.
+
+## Source Inputs
+
+- Public API comments and signatures under `src/core/`.
+- Enum definitions from `src/enum/index.js`.
+- Static protocol references preserved from `docs/static-references/ai-relay.md` and `docs/static-references/json-format.md`.
+- Built-in examples from `scripts/doc-examples.js`.
+
+## Output Contract
+
+- `SKILL.md` is the portable skill entry point.
+- `references/` contains generated or preserved Markdown references for agent lookup.
+- `adapters/` contains optional tool-specific setup notes.
+
+Do not manually edit generated API reference files. Update the documented source or static reference input, then rerun the scanner.

package/docs/skill/sheetnext-dev/README.md

@@ -1,44 +1,44 @@
-# SheetNext Dev Agent Skill
-
-Generated from SheetNext API docs on 2026-04-28.
-
-This directory is a portable Agent Skill package for SheetNext development. It is designed to work in two modes:
-
-- Skill-aware agents can install or load the whole `sheetnext-dev/` directory.
-- Other AI coding assistants can read `SKILL.md` first, then open the relevant files in `references/`.
-
-## Package Layout
-
-```text
-sheetnext-dev/
-  SKILL.md              # Portable skill entry point and operating rules
-  README.md             # Human-facing usage notes
-  GENERATION.md         # Regeneration notes and source inputs
-  adapters/             # Optional setup notes for specific AI tools
-  references/           # Source-of-truth SheetNext API references
-```
-
-## Recommended Use
-
-1. Read `SKILL.md` before generating or modifying SheetNext code.
-2. Read only the reference files needed for the task.
-3. Verify exact method names and signatures in `references/core-api.md` before coding.
-4. Treat `references/` as generated documentation; update SheetNext source comments or static docs, then rerun the scanner.
-
-## Tool Adapters
-
-- Codex: `adapters/codex.md`
-- Claude: `adapters/claude.md`
-- Cursor: `adapters/cursor.md`
-- GitHub Copilot: `adapters/copilot.md`
-- ChatGPT or generic assistants: `adapters/chatgpt.md`
-
-The adapters are convenience instructions only. The portable contract is `SKILL.md` plus `references/`.
-
-## Regenerate
-
-From the `SNEditor` directory:
-
-```powershell
-node scripts\doc-scanner.js
-```
+# SheetNext Dev Agent Skill
+
+Generated from SheetNext API docs on 2026-04-28.
+
+This directory is a portable Agent Skill package for SheetNext development. It is designed to work in two modes:
+
+- Skill-aware agents can install or load the whole `sheetnext-dev/` directory.
+- Other AI coding assistants can read `SKILL.md` first, then open the relevant files in `references/`.
+
+## Package Layout
+
+```text
+sheetnext-dev/
+  SKILL.md              # Portable skill entry point and operating rules
+  README.md             # Human-facing usage notes
+  GENERATION.md         # Regeneration notes and source inputs
+  adapters/             # Optional setup notes for specific AI tools
+  references/           # Source-of-truth SheetNext API references
+```
+
+## Recommended Use
+
+1. Read `SKILL.md` before generating or modifying SheetNext code.
+2. Read only the reference files needed for the task.
+3. Verify exact method names and signatures in `references/core-api.md` before coding.
+4. Treat `references/` as generated documentation; update SheetNext source comments or static docs, then rerun the scanner.
+
+## Tool Adapters
+
+- Codex: `adapters/codex.md`
+- Claude: `adapters/claude.md`
+- Cursor: `adapters/cursor.md`
+- GitHub Copilot: `adapters/copilot.md`
+- ChatGPT or generic assistants: `adapters/chatgpt.md`
+
+The adapters are convenience instructions only. The portable contract is `SKILL.md` plus `references/`.
+
+## Regenerate
+
+From the `SNEditor` directory:
+
+```powershell
+node scripts\doc-scanner.js
+```

package/docs/skill/sheetnext-dev/SKILL.md

@@ -1,58 +1,58 @@
----
-name: "sheetnext-dev"
-description: "Use for SheetNext spreadsheet apps, templates, events, import/export, JSON workbook data, and AI relay integration."
----
-
-# SheetNext Development
-
-Generated from SheetNext API docs on 2026-04-28.
-
-This is a portable Agent Skill package. `SKILL.md` is the entry point, `references/` contains lazy-loaded API docs, and `adapters/` contains tool-specific setup notes.
-
-Use the bundled references as the source of truth. Do not invent APIs.
-
-## Compatibility
-
-- Skill-aware agents can install or load this directory directly.
-- Any AI coding assistant can use this package by reading this file first, then opening the relevant files in `references/`.
-- Tool-specific setup notes live in `adapters/`; they are optional and do not change the source-of-truth API docs.
-
-## When To Use
-
-- Building SheetNext workbook, sheet, row, column, cell, drawing, table, pivot, slicer, formula, event, import/export, or AI relay features.
-- Debugging SheetNext integrations or generated spreadsheet code.
-- Converting requirements into SheetNext templates, JSON workbook data, or event-driven workflows.
-
-## Read Order
-
-1. For normal spreadsheet development, read `references/core-api.md`.
-2. For events and hooks, read `references/events.md`.
-3. For constants and enum values, read `references/enums.md`.
-4. For JSON import/export data shape, read `references/json-format.md`.
-5. For built-in AI relay integration, read `references/ai-relay.md`.
-6. For common implementation patterns, read `references/recipes.md`.
-
-## API Rules
-
-- Public API is whatever appears in `references/core-api.md`.
-- Deprecated APIs are excluded from the generated references; do not use undocumented old names.
-- Internal SheetNext source members start with `_` or `#`; avoid them unless the user is editing SheetNext internals.
-- Coordinates are zero-based when using numeric objects. A1 strings such as `"A1"` are one-based Excel-style references.
-- Prefer existing SheetNext core APIs over direct DOM access or ad hoc state mutation.
-- For templates, prefer `sheet.insertTemplate(...)`.
-- For import/export, use `SN.IO`.
-- For events, use `SN.Event`.
-
-## Workflow
-
-1. Identify the target object: `SN`, `Sheet`, `Cell`, `IO`, `Event`, etc.
-2. Search the reference docs for the exact method name and signature before coding.
-3. Generate the smallest working implementation first.
-4. State verification steps and any assumptions about the documented API.
-
-## Search Tips
-
-- Method headings in `core-api.md` start with `####` followed by the signature.
-- Class headings use `## ClassName`.
-- Event names are grouped in `events.md` under `## Emitted events`.
-- Enum names are under `## Enum Types` in `enums.md`.
+---
+name: "sheetnext-dev"
+description: "Use for SheetNext spreadsheet apps, templates, events, import/export, JSON workbook data, and AI relay integration."
+---
+
+# SheetNext Development
+
+Generated from SheetNext API docs on 2026-04-28.
+
+This is a portable Agent Skill package. `SKILL.md` is the entry point, `references/` contains lazy-loaded API docs, and `adapters/` contains tool-specific setup notes.
+
+Use the bundled references as the source of truth. Do not invent APIs.
+
+## Compatibility
+
+- Skill-aware agents can install or load this directory directly.
+- Any AI coding assistant can use this package by reading this file first, then opening the relevant files in `references/`.
+- Tool-specific setup notes live in `adapters/`; they are optional and do not change the source-of-truth API docs.
+
+## When To Use
+
+- Building SheetNext workbook, sheet, row, column, cell, drawing, table, pivot, slicer, formula, event, import/export, or AI relay features.
+- Debugging SheetNext integrations or generated spreadsheet code.
+- Converting requirements into SheetNext templates, JSON workbook data, or event-driven workflows.
+
+## Read Order
+
+1. For normal spreadsheet development, read `references/core-api.md`.
+2. For events and hooks, read `references/events.md`.
+3. For constants and enum values, read `references/enums.md`.
+4. For JSON import/export data shape, read `references/json-format.md`.
+5. For built-in AI relay integration, read `references/ai-relay.md`.
+6. For common implementation patterns, read `references/recipes.md`.
+
+## API Rules
+
+- Public API is whatever appears in `references/core-api.md`.
+- Deprecated APIs are excluded from the generated references; do not use undocumented old names.
+- Internal SheetNext source members start with `_` or `#`; avoid them unless the user is editing SheetNext internals.
+- Coordinates are zero-based when using numeric objects. A1 strings such as `"A1"` are one-based Excel-style references.
+- Prefer existing SheetNext core APIs over direct DOM access or ad hoc state mutation.
+- For templates, prefer `sheet.insertTemplate(...)`.
+- For import/export, use `SN.IO`.
+- For events, use `SN.Event`.
+
+## Workflow
+
+1. Identify the target object: `SN`, `Sheet`, `Cell`, `IO`, `Event`, etc.
+2. Search the reference docs for the exact method name and signature before coding.
+3. Generate the smallest working implementation first.
+4. State verification steps and any assumptions about the documented API.
+
+## Search Tips
+
+- Method headings in `core-api.md` start with `####` followed by the signature.
+- Class headings use `## ClassName`.
+- Event names are grouped in `events.md` under `## Emitted events`.
+- Enum names are under `## Enum Types` in `enums.md`.

package/docs/skill/sheetnext-dev/adapters/chatgpt.md

@@ -1,22 +1,22 @@
-# ChatGPT And Generic Assistant Adapter
-
-Use this package by uploading or pasting `SKILL.md` first, then adding the reference files needed for the task.
-
-## Minimal Context
-
-Start with:
-
-- `SKILL.md`
-- `references/core-api.md`
-
-Add these only when needed:
-
-- `references/events.md` for event handling.
-- `references/enums.md` for constants.
-- `references/json-format.md` for import/export data.
-- `references/ai-relay.md` for AI workflow integration.
-- `references/recipes.md` for short examples.
-
-## Prompt
-
-You are using the SheetNext Dev skill. Read `SKILL.md` first. Use the provided reference files as the source of truth, do not invent APIs, and state which reference files you used.
+# ChatGPT And Generic Assistant Adapter
+
+Use this package by uploading or pasting `SKILL.md` first, then adding the reference files needed for the task.
+
+## Minimal Context
+
+Start with:
+
+- `SKILL.md`
+- `references/core-api.md`
+
+Add these only when needed:
+
+- `references/events.md` for event handling.
+- `references/enums.md` for constants.
+- `references/json-format.md` for import/export data.
+- `references/ai-relay.md` for AI workflow integration.
+- `references/recipes.md` for short examples.
+
+## Prompt
+
+You are using the SheetNext Dev skill. Read `SKILL.md` first. Use the provided reference files as the source of truth, do not invent APIs, and state which reference files you used.

package/docs/skill/sheetnext-dev/adapters/claude.md

@@ -1,21 +1,21 @@
-# Claude Adapter
-
-Use this package as a Claude skill when the environment supports custom skills. Otherwise, provide the files as project knowledge or attachments.
-
-## Skill-Aware Setup
-
-Install or copy the whole `sheetnext-dev/` directory into the tool-specific skills location, then start a new session and ask the assistant to use the SheetNext Dev skill.
-
-## Manual Setup
-
-Provide `SKILL.md` first. Add only the reference files needed for the current task:
-
-- `references/core-api.md` for public classes and methods.
-- `references/events.md` for event names and payloads.
-- `references/enums.md` for constants and enum values.
-- `references/json-format.md` for workbook JSON data.
-- `references/ai-relay.md` for built-in AI relay integration.
-
-## Prompt
-
-Use `SKILL.md` as the operating guide. Do not invent SheetNext APIs. Search the relevant reference file for exact method names and signatures before producing code.
+# Claude Adapter
+
+Use this package as a Claude skill when the environment supports custom skills. Otherwise, provide the files as project knowledge or attachments.
+
+## Skill-Aware Setup
+
+Install or copy the whole `sheetnext-dev/` directory into the tool-specific skills location, then start a new session and ask the assistant to use the SheetNext Dev skill.
+
+## Manual Setup
+
+Provide `SKILL.md` first. Add only the reference files needed for the current task:
+
+- `references/core-api.md` for public classes and methods.
+- `references/events.md` for event names and payloads.
+- `references/enums.md` for constants and enum values.
+- `references/json-format.md` for workbook JSON data.
+- `references/ai-relay.md` for built-in AI relay integration.
+
+## Prompt
+
+Use `SKILL.md` as the operating guide. Do not invent SheetNext APIs. Search the relevant reference file for exact method names and signatures before producing code.

package/docs/skill/sheetnext-dev/adapters/codex.md

@@ -1,21 +1,21 @@
-# Codex Adapter
-
-Use this package as a Codex skill by installing the whole `sheetnext-dev/` directory.
-
-## Install From This Repository
-
-From the `SNEditor` directory:
-
-```powershell
-Copy-Item -Recurse -Force .\docs\skill\sheetnext-dev "$env:USERPROFILE\.codex\skills\sheetnext-dev"
-```
-
-Restart Codex after copying the directory.
-
-## Repository-Local Use
-
-If the skill is not installed globally, ask Codex to read `docs/skill/sheetnext-dev/SKILL.md` first and then open the specific reference files required by the task.
-
-## Prompt
-
-Use the SheetNext Dev skill. Read `SKILL.md`, verify exact APIs in `references/core-api.md`, and use `references/events.md`, `references/enums.md`, `references/json-format.md`, or `references/ai-relay.md` only when the task needs them.
+# Codex Adapter
+
+Use this package as a Codex skill by installing the whole `sheetnext-dev/` directory.
+
+## Install From This Repository
+
+From the `SNEditor` directory:
+
+```powershell
+Copy-Item -Recurse -Force .\docs\skill\sheetnext-dev "$env:USERPROFILE\.codex\skills\sheetnext-dev"
+```
+
+Restart Codex after copying the directory.
+
+## Repository-Local Use
+
+If the skill is not installed globally, ask Codex to read `docs/skill/sheetnext-dev/SKILL.md` first and then open the specific reference files required by the task.
+
+## Prompt
+
+Use the SheetNext Dev skill. Read `SKILL.md`, verify exact APIs in `references/core-api.md`, and use `references/events.md`, `references/enums.md`, `references/json-format.md`, or `references/ai-relay.md` only when the task needs them.

package/docs/skill/sheetnext-dev/adapters/copilot.md

@@ -1,15 +1,15 @@
-# GitHub Copilot Adapter
-
-GitHub Copilot can use this package through repository instructions and referenced Markdown files.
-
-## Recommended Setup
-
-Add this summary to `.github/copilot-instructions.md` or your workspace instructions:
-
-```text
-For SheetNext development, use docs/skill/sheetnext-dev/SKILL.md as the guide. The source-of-truth API docs are in docs/skill/sheetnext-dev/references/. Check core-api.md for exact public APIs before writing code. Use events.md, enums.md, json-format.md, and ai-relay.md only when the task needs those areas.
-```
-
-## Usage
-
-Reference specific files in prompts when possible, for example: `Use docs/skill/sheetnext-dev/references/events.md to wire the event handler`.
+# GitHub Copilot Adapter
+
+GitHub Copilot can use this package through repository instructions and referenced Markdown files.
+
+## Recommended Setup
+
+Add this summary to `.github/copilot-instructions.md` or your workspace instructions:
+
+```text
+For SheetNext development, use docs/skill/sheetnext-dev/SKILL.md as the guide. The source-of-truth API docs are in docs/skill/sheetnext-dev/references/. Check core-api.md for exact public APIs before writing code. Use events.md, enums.md, json-format.md, and ai-relay.md only when the task needs those areas.
+```
+
+## Usage
+
+Reference specific files in prompts when possible, for example: `Use docs/skill/sheetnext-dev/references/events.md to wire the event handler`.

package/docs/skill/sheetnext-dev/adapters/cursor.md

@@ -1,17 +1,17 @@
-# Cursor Adapter
-
-Cursor can use this package as repository knowledge even when it does not auto-load Agent Skills.
-
-## Recommended Setup
-
-Keep `docs/skill/sheetnext-dev/` in the repository. Add a short project rule that points Cursor to the skill entry point and references.
-
-Suggested rule text:
-
-```text
-For SheetNext work, read docs/skill/sheetnext-dev/SKILL.md first. Treat docs/skill/sheetnext-dev/references/ as the source of truth. Verify public APIs in references/core-api.md before generating code, and use events.md, enums.md, json-format.md, or ai-relay.md only when relevant.
-```
-
-## Usage
-
-When requesting SheetNext work, mention the relevant area, such as events, JSON import/export, templates, formulas, or AI relay. Ask Cursor to search the matching reference before editing.
+# Cursor Adapter
+
+Cursor can use this package as repository knowledge even when it does not auto-load Agent Skills.
+
+## Recommended Setup
+
+Keep `docs/skill/sheetnext-dev/` in the repository. Add a short project rule that points Cursor to the skill entry point and references.
+
+Suggested rule text:
+
+```text
+For SheetNext work, read docs/skill/sheetnext-dev/SKILL.md first. Treat docs/skill/sheetnext-dev/references/ as the source of truth. Verify public APIs in references/core-api.md before generating code, and use events.md, enums.md, json-format.md, or ai-relay.md only when relevant.
+```
+
+## Usage
+
+When requesting SheetNext work, mention the relevant area, such as events, JSON import/export, templates, formulas, or AI relay. Ask Cursor to search the matching reference before editing.