multisite-cms-mcp 1.0.5 → 1.0.7

package/dist/tools/get-conversion-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAoe1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}
+{"version":3,"file":"get-conversion-guide.d.ts","sourceRoot":"","sources":["../../src/tools/get-conversion-guide.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAC;AAugB1H;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1E"}

package/dist/tools/get-conversion-guide.js

@@ -287,6 +287,38 @@ Inside {{#each}}:
 - \`{{@last}}\` - true for last item  
 - \`{{@index}}\` - zero-based index
 
+## Parent Context (\`../\`)
+Inside loops, access the parent scope:
+\`\`\`html
+{{#each blogs}}
+  {{#if (eq author.name ../name)}}
+    <!-- Only show posts by current author -->
+    <h3>{{name}}</h3>
+  {{/if}}
+{{/each}}
+\`\`\`
+
+- \`../name\` - Parent item's name field
+- \`../slug\` - Parent item's slug
+- \`../fieldName\` - Any field from parent scope
+
+**Use cases:**
+- Author pages: filter posts by current author
+- Category pages: filter items by current category
+- Related items: match based on current page
+
+## Equality Comparisons
+Compare two values:
+\`\`\`html
+{{#if (eq author.name ../name)}}
+  <!-- True when fields match -->
+{{/if}}
+
+{{#eq status "published"}}
+  <!-- Compare to literal string -->
+{{/eq}}
+\`\`\`
+
 ## Collection Fields
 
 **Blog Posts:**
@@ -331,33 +363,34 @@ Forms are automatically captured by the CMS.
 
 ## Form Handler Script
 
-Add to your JavaScript:
+Add to your JavaScript (typically /public/js/main.js):
 
 \`\`\`javascript
 document.querySelectorAll('form[data-form-name]').forEach(form => {
   form.addEventListener('submit', async (e) => {
     e.preventDefault();
     
+    const formName = form.dataset.formName || 'general';
     const formData = new FormData(form);
     const data = Object.fromEntries(formData);
     
-    const response = await fetch('/api/forms/submit', {
+    // IMPORTANT: Endpoint is /_forms/{formName}
+    const response = await fetch('/_forms/' + formName, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        formName: form.dataset.formName,
-        data: data
-      })
+      body: JSON.stringify(data)
     });
     
     if (response.ok) {
       form.reset();
-      alert('Thank you!');
+      alert(form.dataset.successMessage || 'Thank you!');
     }
   });
 });
 \`\`\`
 
+**CRITICAL:** The form endpoint is \`/_forms/{formName}\` - NOT \`/api/forms/submit\`
+
 ## Naming Conventions
 
 - Contact form → \`contact\`
@@ -444,7 +477,9 @@ Keep external URLs unchanged:
 - [ ] Templates include header/footer
 - [ ] {{#each}} loops have {{/each}}
 - [ ] {{#if}} conditions have {{/if}}
+- [ ] {{#eq}} comparisons have {{/eq}}
 - [ ] Rich text uses {{{triple braces}}}
+- [ ] Parent refs (../) only inside loops
 - [ ] Correct field names used
 
 ## ✓ Field Names

package/dist/tools/get-example.d.ts

@@ -1,4 +1,4 @@
-type ExampleType = 'manifest_basic' | 'manifest_custom_paths' | 'blog_index_template' | 'blog_post_template' | 'team_template' | 'downloads_template' | 'authors_template' | 'author_detail_template' | 'custom_collection_template' | 'form_handling' | 'asset_paths' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts';
+type ExampleType = 'manifest_basic' | 'manifest_custom_paths' | 'blog_index_template' | 'blog_post_template' | 'team_template' | 'downloads_template' | 'authors_template' | 'author_detail_template' | 'custom_collection_template' | 'form_handling' | 'asset_paths' | 'data_edit_keys' | 'each_loop' | 'conditional_if' | 'nested_fields' | 'featured_posts' | 'parent_context' | 'equality_comparison';
 /**
  * Returns example code for a specific pattern
  */

package/dist/tools/get-example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,4BAA4B,GAC5B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,CAAC;AA0qBrB;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}
+{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,qBAAqB,GACrB,oBAAoB,GACpB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,4BAA4B,GAC5B,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,qBAAqB,CAAC;AAqxB1B;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1E"}

package/dist/tools/get-example.js

@@ -664,6 +664,111 @@ Make text editable in the CMS visual editor:
 </section>
 {{/each}}
 \`\`\``,
+    parent_context: `# Parent Context References (\`../\`)
+
+Inside loops, access the **parent scope** (the page's current item) using \`../\`:
+
+**Use Case: Author Detail Page - Show Only This Author's Posts**
+\`\`\`html
+<article class="author-detail">
+  <h1>{{name}}</h1>
+  <p class="bio">{{{bio}}}</p>
+  
+  <section class="author-articles">
+    <h2>Posts by {{name}}</h2>
+    
+    {{#each blogs}}
+      {{#if (eq author.name ../name)}}
+        <article class="post-card">
+          <h3><a href="{{url}}">{{name}}</a></h3>
+          <p>{{postSummary}}</p>
+          <time>{{publishedAt}}</time>
+        </article>
+      {{/if}}
+    {{/each}}
+  </section>
+</article>
+\`\`\`
+
+**How It Works:**
+- Inside \`{{#each blogs}}\`, the context is each blog post
+- \`author.name\` = the blog post's author
+- \`../name\` = the parent context (the author being displayed on the page)
+- Only posts where author.name matches ../name are shown
+
+**Use Case: Category Page - Highlight Current Category**
+\`\`\`html
+<nav class="category-nav">
+  {{#each categories}}
+    <a href="{{url}}" class="{{#if (eq slug ../slug)}}active{{/if}}">
+      {{name}}
+    </a>
+  {{/each}}
+</nav>
+
+<div class="category-content">
+  <h1>{{name}}</h1>
+  
+  {{#each items}}
+    {{#if (eq category ../slug)}}
+      <div class="item">{{name}}</div>
+    {{/if}}
+  {{/each}}
+</div>
+\`\`\`
+
+**Available Parent Fields:**
+- \`../name\` - Parent item's name
+- \`../slug\` - Parent item's slug
+- \`../fieldName\` - Any field from the parent item
+- \`../nested.field\` - Nested field access in parent`,
+    equality_comparison: `# Equality Comparisons
+
+Compare two values using \`(eq field1 field2)\` helper:
+
+**Compare Two Fields:**
+\`\`\`html
+{{#if (eq author.slug ../slug)}}
+  <span class="current-author-badge">✓ Your Post</span>
+{{/if}}
+
+{{#if (eq category selectedCategory)}}
+  <div class="active">{{name}}</div>
+{{/if}}
+\`\`\`
+
+**Compare Field to Literal String (use {{#eq}}):**
+\`\`\`html
+{{#eq status "published"}}
+  <span class="badge badge-success">Published</span>
+{{/eq}}
+
+{{#eq type "featured"}}
+  <div class="featured-highlight">⭐ {{name}}</div>
+{{/eq}}
+
+{{#eq category "news"}}
+  <span class="news-icon">📰</span>
+{{/eq}}
+\`\`\`
+
+**Inside Loops with Parent Context:**
+\`\`\`html
+{{#each blogs}}
+  <article class="{{#if (eq author.name ../name)}}highlight{{/if}}">
+    <h3>{{name}}</h3>
+    {{#if (eq author.name ../name)}}
+      <span class="yours">You wrote this!</span>
+    {{/if}}
+  </article>
+{{/each}}
+\`\`\`
+
+**Common Use Cases:**
+- Filter items by current category/author/tag
+- Highlight active menu items
+- Show badges for specific statuses
+- Conditional styling based on relationships`,
 };
 /**
  * Returns example code for a specific pattern

package/dist/tools/get-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CA6IjD"}
+{"version":3,"file":"get-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAmOjD"}

package/dist/tools/get-schema.js

@@ -128,6 +128,40 @@ Inside \`{{#each}}\` blocks:
 {{/each}}
 \`\`\`
 
+### Parent Context References (\`../\`)
+Inside loops, access the parent scope (page's current item) using \`../\`:
+
+\`\`\`html
+<!-- On author detail page, show only posts by THIS author -->
+{{#each blogs}}
+  {{#if (eq author.name ../name)}}
+    <h3>{{name}}</h3>
+  {{/if}}
+{{/each}}
+\`\`\`
+
+- \`../name\` - Parent item's name field
+- \`../slug\` - Parent item's slug
+- \`../fieldName\` - Any field from the parent scope
+
+**Use cases:**
+- Author pages: filter posts by current author
+- Category pages: filter items by current category
+- Related items: match based on current detail page
+
+### Equality Comparisons
+Compare two values in conditionals:
+
+\`\`\`html
+{{#if (eq author.name ../name)}}
+  <!-- True when fields match -->
+{{/if}}
+
+{{#eq status "published"}}
+  <!-- Compare field to literal string -->
+{{/eq}}
+\`\`\`
+
 ### Rich Text (Triple Braces)
 For HTML content that should NOT be escaped:
 \`\`\`html
@@ -144,5 +178,57 @@ For HTML content that should NOT be escaped:
 3. **Always wrap optional fields in {{#if}}** - Check before rendering
 4. **Use {{url}} for links** - Generates correct path based on manifest
 5. **Match field names exactly** - \`{{name}}\` not \`{{title}}\`
+
+---
+
+## Form Handling
+
+Forms are automatically captured and stored in the CMS.
+
+### Form Setup
+1. Add \`data-form-name="xxx"\` attribute to the form
+2. Include the form handler script in your JavaScript
+
+\`\`\`html
+<form data-form-name="contact">
+  <input type="text" name="firstName" required>
+  <input type="email" name="email" required>
+  <textarea name="message"></textarea>
+  <button type="submit">Send</button>
+</form>
+\`\`\`
+
+### Form Handler Script (add to /public/js/main.js)
+\`\`\`javascript
+document.querySelectorAll('form[data-form-name]').forEach(form => {
+  form.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    const formName = form.dataset.formName || 'general';
+    const formData = new FormData(form);
+    const data = Object.fromEntries(formData);
+    
+    const response = await fetch('/_forms/' + formName, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data)
+    });
+    
+    if (response.ok) {
+      form.reset();
+      alert(form.dataset.successMessage || 'Thank you!');
+    }
+  });
+});
+\`\`\`
+
+**CRITICAL:** Endpoint is \`/_forms/{formName}\` - NOT \`/api/forms/submit\`
+
+### Common Form Names
+- \`contact\` - Contact/inquiry forms
+- \`newsletter\` - Email signups
+- \`quote-request\` - Quote/consultation requests
+- \`appointment\` - Scheduling forms
+
+Tenant context is handled automatically by the system.
 `;
 }

package/dist/tools/validate-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AA0E7J;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAgNjB"}
+{"version":3,"file":"validate-template.d.ts","sourceRoot":"","sources":["../../src/tools/validate-template.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,CAAC;AA0E7J;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,EAC1B,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CA+OjB"}

package/dist/tools/validate-template.js

@@ -208,6 +208,34 @@ async function validateTemplate(html, templateType, collectionSlug) {
     if (siteTokens.length > 0) {
         suggestions.push(`- Found ${siteTokens.length} site token(s) like {{site.site_name}} - these come from manifest.json`);
     }
+    // Validate parent context references (../)
+    const parentRefs = html.match(/\{\{\.\.\/([\w.]+)\}\}/g) || [];
+    if (parentRefs.length > 0) {
+        // Check if they're used inside a loop
+        if (eachLoops.length === 0) {
+            warnings.push(`- Found ${parentRefs.length} parent reference(s) like {{../name}} but no {{#each}} loop - these only work inside loops`);
+        }
+        else {
+            suggestions.push(`- Found ${parentRefs.length} parent context reference(s) ({{../fieldName}}) - accesses parent scope in loops`);
+        }
+    }
+    // Validate equality helper syntax
+    const eqHelpers = html.match(/\{\{#if\s+\(eq\s+[^)]+\)\s*\}\}/g) || [];
+    if (eqHelpers.length > 0) {
+        suggestions.push(`- Found ${eqHelpers.length} equality comparison(s) like {{#if (eq field1 field2)}} - compares two values`);
+        // Check if closing {{/if}} exists for each
+        for (const helper of eqHelpers) {
+            if (!html.includes('{{/if}}')) {
+                errors.push(`- Missing {{/if}} to close: ${helper}`);
+            }
+        }
+    }
+    // Validate {{#eq}} blocks  
+    const eqBlocks = html.match(/\{\{#eq\s+[\w.]+\s+"[^"]+"\s*\}\}/g) || [];
+    const eqCloses = (html.match(/\{\{\/eq\}\}/g) || []).length;
+    if (eqBlocks.length !== eqCloses) {
+        errors.push(`- Unbalanced {{#eq}}: ${eqBlocks.length} opens, ${eqCloses} closes`);
+    }
     // Build result
     let output = '';
     if (errors.length === 0 && warnings.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "multisite-cms-mcp",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "MCP server for AI-assisted website conversion to CMS format. Provides validation, examples, and schema tools.",
   "main": "dist/index.js",
   "bin": {