Merge branch 'main' into nick/sd-2054-history-namespace-undoredo-document-api-commands

Author: harbournick

.github/workflows/ci-examples.yml

@@ -12,15 +12,31 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        example: [react, vue, vanilla, cdn, angular]
+        example: [react, vue, vanilla, cdn, angular, nuxt, laravel]
     steps:
       - uses: actions/checkout@v6
 
+      - name: Setup PHP
+        if: matrix.example == 'laravel'
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.2'
+
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
           node-version: '20'
 
+      - name: Install Composer dependencies
+        if: matrix.example == 'laravel'
+        working-directory: examples/getting-started/laravel
+        run: composer install --no-interaction --prefer-dist
+
+      - name: Prepare Laravel environment
+        if: matrix.example == 'laravel'
+        working-directory: examples/getting-started/laravel
+        run: cp .env.example .env && php artisan key:generate
+
       - name: Install example dependencies
         if: matrix.example != 'cdn'
         working-directory: examples/getting-started/${{ matrix.example }}

.github/workflows/risk-label.yml .github/workflows/pr-labels.yml.github/workflows/risk-label.yml renamed to .github/workflows/pr-labels.yml

@@ -1,4 +1,4 @@
-name: PR Risk Label
+name: PR Labels
 
 on:
   pull_request:
@@ -85,3 +85,30 @@ jobs:
                 labels: [LABELS[level].name],
               });
             }
+
+      - name: Add community label
+        if: >-
+          github.event.action == 'opened' &&
+          github.event.pull_request.author_association != 'MEMBER' &&
+          github.event.pull_request.author_association != 'OWNER' &&
+          github.event.pull_request.author_association != 'COLLABORATOR' &&
+          github.event.pull_request.user.type != 'Bot'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const label = { name: 'community', color: '7057ff' };
+
+            try {
+              await github.rest.issues.getLabel({ owner, repo, name: label.name });
+            } catch {
+              await github.rest.issues.createLabel({ owner, repo, ...label });
+            }
+
+            await github.rest.issues.addLabels({
+              owner,
+              repo,
+              issue_number: context.issue.number,
+              labels: [label.name],
+            });

.github/workflows/risk-assess.yml

@@ -2,6 +2,7 @@ name: AI Risk Assessment
 
 # Runs AFTER risk-label.yml applies the file-path label.
 # Only triggers for critical/sensitive PRs — low-risk PRs skip AI entirely.
+# Fork PRs skip AI (no access to ANTHROPIC_API_KEY) — file-path label still applies.
 #
 # - Updates the risk label if AI disagrees with file-path classification
 # - Logs full details to workflow output (visible in Actions tab)
@@ -45,27 +46,36 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      # Skip AI for low-risk PRs
-      - name: Skip AI for low-risk
-        if: steps.filepath.outputs.level == 'low'
-        run: echo "Low risk — skipping AI assessment"
-
-      # Install Agent SDK (only for non-low PRs)
+      # Skip AI when low-risk or API key unavailable (e.g. fork PRs)
+      - name: Check AI eligibility
+        id: ai
+        run: |
+          if [ "${{ steps.filepath.outputs.level }}" = "low" ]; then
+            echo "skip=true" >> $GITHUB_OUTPUT
+            echo "Skipping AI — low risk"
+          elif [ -z "${{ secrets.ANTHROPIC_API_KEY }}" ]; then
+            echo "skip=true" >> $GITHUB_OUTPUT
+            echo "Skipping AI — no API key (fork PR)"
+          else
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+
+      # Install Agent SDK (only when AI will run)
       - name: Setup Node and Agent SDK
-        if: steps.filepath.outputs.level != 'low'
+        if: steps.ai.outputs.skip != 'true'
         uses: actions/setup-node@v4
         with:
           node-version: 20
 
       - name: Install Agent SDK
-        if: steps.filepath.outputs.level != 'low'
+        if: steps.ai.outputs.skip != 'true'
         run: npm install --prefix .github/scripts @anthropic-ai/claude-agent-sdk
         env:
           NODE_ENV: production
 
       # Layer 2+3: AI assessment
       - name: Run tiered AI assessment
-        if: steps.filepath.outputs.level != 'low'
+        if: steps.ai.outputs.skip != 'true'
         id: assess
         run: node .github/scripts/risk-assess.mjs ${{ env.PR_NUMBER }}
         env:
@@ -77,7 +87,7 @@ jobs:
 
       # Update risk label if AI disagrees with file-path classification
       - name: Update risk label from AI
-        if: steps.filepath.outputs.level != 'low'
+        if: steps.ai.outputs.skip != 'true'
         uses: actions/github-script@v7
         with:
           script: |

README.md

@@ -144,6 +144,8 @@ Special thanks to these community members who have contributed code to SuperDoc:
 <a href="https://github.com/asumaran"><img src="https://github.com/asumaran.png" width="50" height="50" alt="asumaran" title="Alfredo Sumaran" /></a>
 <a href="https://github.com/J-Michalek"><img src="https://github.com/J-Michalek.png" width="50" height="50" alt="J-Michalek" title="Jakub Michálek" /></a>
 <a href="https://github.com/gm1357"><img src="https://github.com/gm1357.png" width="50" height="50" alt="gm1357" title="Gabriel Machado" /></a>
+<a href="https://github.com/roncallyt"><img src="https://github.com/roncallyt.png" width="50" height="50" alt="roncallyt" title="Thomerson Roncally" /></a>
+<a href="https://github.com/gpardhivvarma"><img src="https://github.com/gpardhivvarma.png" width="50" height="50" alt="gpardhivvarma" title="G Pardhiv Varma" /></a>
 
 Want to see your avatar here? Check the [Contributing Guide](CONTRIBUTING.md) to get started.
 

apps/cli/scripts/export-sdk-contract.ts

@@ -16,7 +16,7 @@ import { resolve, dirname } from 'node:path';
 import { createHash } from 'node:crypto';
 import { tmpdir } from 'node:os';
 
-import { COMMAND_CATALOG } from '@superdoc/document-api';
+import { COMMAND_CATALOG, INLINE_PROPERTY_REGISTRY } from '@superdoc/document-api';
 
 import { CLI_OPERATION_METADATA } from '../src/cli/operation-params';
 import {
@@ -60,9 +60,12 @@ const INTENT_NAMES = {
   'doc.delete': 'delete_content',
   'doc.blocks.delete': 'delete_block',
   'doc.format.apply': 'format_apply',
-  'doc.format.fontSize': 'format_font_size',
-  'doc.format.fontFamily': 'format_font_family',
-  'doc.format.color': 'format_color',
+  ...Object.fromEntries(
+    INLINE_PROPERTY_REGISTRY.map((entry) => [
+      `doc.format.${entry.key}`,
+      `format_${entry.key.replace(/[A-Z]/g, (char) => `_${char.toLowerCase()}`)}`,
+    ]),
+  ),
   'doc.format.align': 'format_align',
   'doc.styles.apply': 'styles_apply',
   'doc.create.paragraph': 'create_paragraph',
@@ -86,6 +89,7 @@ const INTENT_NAMES = {
   'doc.sections.setLinkToPrevious': 'set_section_link_to_previous',
   'doc.sections.setPageBorders': 'set_section_page_borders',
   'doc.sections.clearPageBorders': 'clear_section_page_borders',
+  'doc.create.tableOfContents': 'create_table_of_contents',
   'doc.lists.list': 'list_lists',
   'doc.lists.get': 'get_list',
   'doc.lists.insert': 'insert_list',
@@ -102,6 +106,11 @@ const INTENT_NAMES = {
   'doc.trackChanges.list': 'list_tracked_changes',
   'doc.trackChanges.get': 'get_tracked_change',
   'doc.trackChanges.decide': 'decide_tracked_change',
+  'doc.toc.list': 'list_table_of_contents',
+  'doc.toc.get': 'get_table_of_contents',
+  'doc.toc.configure': 'configure_table_of_contents',
+  'doc.toc.update': 'update_table_of_contents',
+  'doc.toc.remove': 'remove_table_of_contents',
   'doc.query.match': 'query_match',
   'doc.mutations.preview': 'preview_mutations',
   'doc.mutations.apply': 'apply_mutations',

apps/cli/src/__tests__/conformance/harness.ts

@@ -2,7 +2,7 @@ import { copyFile, mkdtemp, mkdir, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
 import { run } from '../../index';
-import { resolveListDocFixture, resolveSourceDocFixture } from '../fixtures';
+import { resolveListDocFixture, resolveSourceDocFixture, resolveTocDocFixture } from '../fixtures';
 
 type RunResult = {
   code: number;
@@ -48,6 +48,12 @@ export type ListItemAddress = {
   nodeId: string;
 };
 
+export type TocAddress = {
+  kind: 'block';
+  nodeType: 'tableOfContents';
+  nodeId: string;
+};
+
 function parseEnvelope(raw: RunResult): CommandEnvelope {
   const source = raw.stdout.trim() || raw.stderr.trim();
   if (!source) {
@@ -119,6 +125,36 @@ export class ConformanceHarness {
     return filePath;
   }
 
+  async copyTocFixtureDoc(label: string, stateDir: string): Promise<string> {
+    const filePath = path.join(this.docsDir, `${this.nextId()}-${label}.docx`);
+
+    try {
+      await copyFile(await resolveTocDocFixture(), filePath);
+      const probe = await this.runCli(['toc', 'list', filePath, '--limit', '1'], stateDir);
+      if (probe.result.code === 0) {
+        return filePath;
+      }
+    } catch {
+      // Fall back to creating a TOC fixture from the generic source doc.
+    }
+
+    const sourceDoc = await this.copyFixtureDoc(`${label}-seed`);
+    const seededPath = path.join(this.docsDir, `${this.nextId()}-${label}-seeded.docx`);
+    const { result, envelope } = await this.runCli(
+      ['create', 'table-of-contents', sourceDoc, '--out', seededPath],
+      stateDir,
+    );
+
+    if (result.code !== 0 || envelope.ok !== true) {
+      const details = envelope.ok
+        ? 'unexpected non-success envelope'
+        : `${envelope.error.code}: ${envelope.error.message}`;
+      throw new Error(`Unable to seed TOC fixture for ${label}: ${details}`);
+    }
+
+    return seededPath;
+  }
+
   createOutputPath(label: string): string {
     return path.join(this.docsDir, `${this.nextId()}-${label}.docx`);
   }
@@ -236,6 +272,27 @@ export class ConformanceHarness {
     return address;
   }
 
+  async firstTocAddress(docPath: string, stateDir: string): Promise<TocAddress> {
+    const { result, envelope } = await this.runCli(['toc', 'list', docPath, '--limit', '1'], stateDir);
+    if (result.code !== 0) {
+      throw new Error(`Unable to resolve first table of contents for ${docPath}`);
+    }
+
+    assertSuccessEnvelope(envelope);
+    const data = envelope.data as {
+      result?: {
+        items?: Array<{
+          address?: TocAddress;
+        }>;
+      };
+    };
+    const address = data.result?.items?.[0]?.address;
+    if (!address) {
+      throw new Error(`No table of contents address found in ${docPath}`);
+    }
+    return address;
+  }
+
   async addCommentFixture(
     stateDir: string,
     label: string,