chore: promote main to stable

Author: github-actions[bot]

.github/workflows/release-package.yml

@@ -65,7 +65,8 @@ jobs:
               echo "Main is already up to date with stable; skipping PR."
               exit 0
             fi
-            pr_number=$(gh pr create --base main --head stable --title "chore: sync stable release to main" --body "Automated PR to merge the latest stable changes back into main." --json number --jq '.number')
+            pr_url=$(gh pr create --base main --head stable --title "chore: sync stable release to main" --body "Automated PR to merge the latest stable changes back into main.")
+            pr_number=$(echo "$pr_url" | grep -oE '[0-9]+$')
             echo "Created PR #$pr_number to sync stable into main."
           else
             echo "PR #$pr_number already open to sync stable into main."

LICENSE

@@ -18,22 +18,19 @@ function TemplateEditor() {
   return (
     <SuperDocTemplateBuilder
       document={{
-        source: "template.docx",
-        mode: "editing"
+        source: 'template.docx',
+        mode: 'editing',
       }}
-      
       fields={{
         available: [
           { id: '1324567890', label: 'Customer Name', category: 'Contact' },
           { id: '1324567891', label: 'Invoice Date', category: 'Invoice' },
-          { id: '1324567892', label: 'Amount', category: 'Invoice' }
-        ]
+          { id: '1324567892', label: 'Amount', category: 'Invoice' },
+        ],
       }}
-      
       onTrigger={(event) => {
         console.log('User typed trigger at', event.position);
       }}
-      
       onFieldInsert={(field) => {
         console.log('Field inserted:', field.alias);
       }}
@@ -58,7 +55,7 @@ function TemplateEditor() {
 
 - **🎯 Trigger Detection** - Type `{{` (customizable) to insert fields
 - **📝 Field Management** - Insert, update, delete, and navigate fields
-- **🔍 Field Discovery** - Automatically finds existing fields in documents  
+- **🔍 Field Discovery** - Automatically finds existing fields in documents
 - **🎨 UI Agnostic** - Bring your own menus, panels, and components
 - **📄 SDT Based** - Uses structured content tags for Word compatibility
 - **⚡ Simple API** - Clear callbacks for trigger events and field changes
@@ -74,32 +71,32 @@ function TemplateEditor() {
     source: File | Blob | string,
     mode: 'editing' | 'viewing'
   }}
-  
+
   // Field configuration
   fields={{
     available: FieldDefinition[],  // Fields user can insert
     initial: TemplateField[]       // Pre-existing fields
   }}
-  
+
   // UI components (optional)
   menu={{
     trigger: '{{',                  // Trigger pattern
     component: CustomFieldMenu      // Custom menu component
   }}
-  
+
   list={{
     position: 'left' | 'right',    // Sidebar position
     component: CustomFieldList      // Custom list component
   }}
-  
+
   // Toolbar (optional)
   toolbar={true}                   // Render built-in toolbar container
   // toolbar="#my-toolbar"          // Mount into existing element
   // toolbar={{                     // Configure built-in toolbar
   //   toolbarGroups: ['center'],
   //   excludeItems: ['italic', 'bold'],
   // }}
-  
+
   // Event handlers
   onReady={() => {}}
   onTrigger={(event) => {}}
@@ -126,8 +123,8 @@ ref.current.deleteField(fieldId);
 
 // Navigation
 ref.current.selectField(fieldId);
-ref.current.nextField();      // Tab behavior
-ref.current.previousField();  // Shift+Tab behavior
+ref.current.nextField(); // Tab behavior
+ref.current.previousField(); // Shift+Tab behavior
 
 // Get data
 const fields = ref.current.getFields();
@@ -141,10 +138,10 @@ const template = await ref.current.exportTemplate();
 ```jsx
 const CustomFieldMenu = ({ isVisible, position, availableFields, onSelect, onClose }) => {
   if (!isVisible) return null;
-  
+
   return (
     <div style={{ position: 'fixed', left: position?.left, top: position?.top }}>
-      {availableFields.map(field => (
+      {availableFields.map((field) => (
         <button key={field.id} onClick={() => onSelect(field)}>
           {field.label}
         </button>
@@ -162,8 +159,8 @@ const CustomFieldList = ({ fields, onSelect, onDelete, selectedFieldId }) => {
   return (
     <div>
       <h3>Fields ({fields.length})</h3>
-      {fields.map(field => (
-        <div 
+      {fields.map((field) => (
+        <div
           key={field.id}
           onClick={() => onSelect(field)}
           style={{ background: selectedFieldId === field.id ? '#blue' : '#gray' }}
@@ -184,7 +181,7 @@ Enable Tab/Shift+Tab navigation:
 ```jsx
 function TemplateEditor() {
   const ref = useRef();
-  
+
   const handleKeyDown = (e) => {
     if (e.key === 'Tab') {
       e.preventDefault();
@@ -195,7 +192,7 @@ function TemplateEditor() {
       }
     }
   };
-  
+
   return (
     <div onKeyDown={handleKeyDown}>
       <SuperDocTemplateBuilder ref={ref} {...props} />
@@ -219,7 +216,7 @@ const handleDownload = async () => {
 
   // Or with custom filename
   await ref.current?.exportTemplate({
-    fileName: 'invoice-template.docx'
+    fileName: 'invoice-template.docx',
   });
 };
 ```
@@ -233,7 +230,7 @@ const handleSave = async () => {
   // Get the blob without triggering download
   const blob = await ref.current?.exportTemplate({
     fileName: 'invoice-template.docx',
-    triggerDownload: false
+    triggerDownload: false,
   });
 
   if (blob) {
@@ -243,7 +240,7 @@ const handleSave = async () => {
 
     await fetch('/api/templates', {
       method: 'POST',
-      body: formData
+      body: formData,
     });
   }
 };
@@ -262,6 +259,7 @@ exportTemplate(config?: ExportConfig): Promise<void | Blob>
 ```
 
 **Return value:**
+
 - `Promise<void>` when `triggerDownload: true` (download happens automatically)
 - `Promise<Blob>` when `triggerDownload: false` (returns the docx data)
 
@@ -276,12 +274,12 @@ import type {
   FieldDefinition,
   TriggerEvent,
   ExportConfig,
-  SuperDocTemplateBuilderHandle
+  SuperDocTemplateBuilderHandle,
 } from '@superdoc-dev/template-builder';
 
 const ref = useRef<SuperDocTemplateBuilderHandle>(null);
 ```
 
 ## License
 
-MIT
+AGPLv3

README.md

@@ -16,7 +16,7 @@ const availableFields: FieldDefinition[] = [
   { id: '1242142773', label: 'Service Type' },
   { id: '1242142774', label: 'Agreement Jurisdiction' },
   { id: '1242142775', label: 'Company Address' },
-  { id: '1242142776', label: 'Signature' },
+  { id: '1242142776', label: 'Signature', mode: 'block' },
 ];
 
 export function App() {

demo/src/App.tsx

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true
+  },
+  "include": ["src"]
+}

demo/tsconfig.json

@@ -4,4 +4,7 @@ import react from '@vitejs/plugin-react';
 export default defineConfig({
   plugins: [react()],
   base: '/',
+  resolve: {
+    dedupe: ['react', 'react-dom'],
+  },
 });

demo/vite.config.ts

@@ -46,7 +46,7 @@
     "react"
   ],
   "author": "SuperDoc Team",
-  "license": "MIT",
+  "license": "AGPLv3",
   "bugs": {
     "url": "https://github.com/superdoc-dev/template-builder/issues"
   },

package.json

@@ -61,7 +61,7 @@ export const FieldMenu: React.FC<FieldMenuProps> = ({
     const newField: FieldDefinition = {
       id: `custom_${Date.now()}`,
       label: trimmedName,
-      metadata: { mode: fieldMode },
+      mode: fieldMode,
     };
 
     try {
@@ -416,7 +416,7 @@ export const FieldMenu: React.FC<FieldMenuProps> = ({
                       flexShrink: 0,
                     }}
                   >
-                    {field.metadata?.mode || 'inline'}
+                    {field.mode || 'inline'}
                   </span>
                 </div>
               ))}

src/defaults/FieldMenu.tsx

@@ -491,13 +491,13 @@ const SuperDocTemplateBuilder = forwardRef<
       menuTriggerFromRef.current = null;
       resetMenuFilter();
 
-      const mode = (field.metadata?.mode as 'inline' | 'block') || 'inline';
+      const mode = field.mode || 'inline';
 
       if (field.id.startsWith('custom_') && onFieldCreate) {
         const createdField = await onFieldCreate(field);
 
         if (createdField) {
-          const createdMode = (createdField.metadata?.mode as 'inline' | 'block') || mode;
+          const createdMode = createdField.mode || mode;
           insertFieldInternal(createdMode, {
             alias: createdField.label,
             metadata: createdField.metadata,

src/index.tsx

@@ -5,6 +5,7 @@ export interface FieldDefinition {
   label: string;
   defaultValue?: string;
   metadata?: Record<string, any>;
+  mode?: 'inline' | 'block';
   group?: string;
 }