sheetnext 0.2.10 → 0.2.12

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

@@ -1,58 +1,46 @@
----
-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: "Develop SheetNext spreadsheet apps and integrations. Use when building or debugging SheetNext workbook, sheet, cell, formula, event, import/export, JSON workbook data, template, AI relay, drawing, table, pivot, or slicer features."
+---
+
+# SheetNext Development
+
+Generated from SheetNext API docs on 2026-06-14.
+
+Use the bundled references as the source of truth. Do not invent undocumented APIs.
+
+Tool-specific setup notes live in `adapters/`; they are optional and do not change the API contract.
+
+## 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.

package/docs/skill/sheetnext-dev/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "SheetNext Dev"
+  short_description: "Build SheetNext spreadsheet features with API references."
+  default_prompt: "Use $sheetnext-dev to build SheetNext spreadsheet features with the documented API references."
+
+policy:
+  allow_implicit_invocation: true