multisite-cms-mcp 1.0.0

package/dist/tools/get-example.js

@@ -0,0 +1,673 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExample = getExample;
+const EXAMPLES = {
+    manifest_basic: `# Basic manifest.json
+
+A minimal manifest with static pages only:
+
+\`\`\`json
+{
+  "pages": [
+    {
+      "path": "/",
+      "file": "pages/index.html",
+      "title": "Home",
+      "editable": true
+    },
+    {
+      "path": "/about",
+      "file": "pages/about.html",
+      "title": "About Us",
+      "editable": true
+    },
+    {
+      "path": "/contact",
+      "file": "pages/contact.html",
+      "title": "Contact",
+      "editable": true
+    }
+  ],
+  "defaultHeadHtml": "<link href='https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap' rel='stylesheet'>"
+}
+\`\`\`
+
+**Key points:**
+- Each page has a unique \`path\` (the URL)
+- \`file\` points to the HTML file in pages/ folder
+- \`editable: true\` allows inline editing in the CMS
+- \`defaultHeadHtml\` is injected into all pages`,
+    manifest_custom_paths: `# manifest.json with Custom CMS Paths
+
+When your site uses different URLs than the defaults:
+
+\`\`\`json
+{
+  "pages": [
+    {
+      "path": "/",
+      "file": "pages/index.html",
+      "title": "Home",
+      "editable": true
+    },
+    {
+      "path": "/about",
+      "file": "pages/about.html",
+      "title": "About",
+      "editable": true
+    }
+  ],
+  "cmsTemplates": {
+    "blogIndex": "templates/insights_index.html",
+    "blogIndexPath": "/insights",
+    "blogPost": "templates/insights_detail.html",
+    "blogPostPath": "/insights",
+    "team": "templates/leadership.html",
+    "teamPath": "/about/leadership",
+    "downloads": "templates/resources.html",
+    "downloadsPath": "/resources",
+    "authorsIndex": "templates/contributors.html",
+    "authorDetail": "templates/contributor.html",
+    "authorsPath": "/contributors"
+  }
+}
+\`\`\`
+
+**Path Configuration:**
+- \`blogIndexPath: "/insights"\` → Blog listing at /insights
+- \`blogPostPath: "/insights"\` → Posts at /insights/post-slug
+- \`teamPath: "/about/leadership"\` → Team page at /about/leadership
+- Both blogIndexPath and blogPostPath should usually match`,
+    blog_index_template: `# Blog Index Template
+
+Lists all blog posts with filtering options:
+
+\`\`\`html
+<main class="blog-page">
+  <header class="page-header">
+    <h1 data-edit-key="blog-page-title">Our Blog</h1>
+    <p data-edit-key="blog-page-intro">Latest articles and insights</p>
+  </header>
+
+  <!-- Featured Post (first featured article) -->
+  {{#each blogs featured=true limit=1}}
+  <article class="featured-post">
+    {{#if mainImage}}
+      <img src="{{mainImage}}" alt="{{name}}" class="featured-image">
+    {{/if}}
+    <div class="featured-content">
+      <h2><a href="{{url}}">{{name}}</a></h2>
+      <p class="excerpt">{{postSummary}}</p>
+      <div class="meta">
+        {{#if author}}
+          <span class="author">By {{author.name}}</span>
+        {{/if}}
+        <time>{{publishedAt}}</time>
+      </div>
+    </div>
+  </article>
+  {{/each}}
+
+  <!-- All Posts Grid -->
+  <div class="posts-grid">
+    {{#each blogs limit=12}}
+    <article class="post-card">
+      {{#if thumbnailImage}}
+        <img src="{{thumbnailImage}}" alt="{{name}}">
+      {{else}}
+        {{#if mainImage}}
+          <img src="{{mainImage}}" alt="{{name}}">
+        {{/if}}
+      {{/if}}
+      <div class="card-content">
+        <h3><a href="{{url}}">{{name}}</a></h3>
+        <p>{{postSummary}}</p>
+        {{#if author}}
+          <span class="byline">{{author.name}}</span>
+        {{/if}}
+      </div>
+    </article>
+    {{/each}}
+  </div>
+</main>
+\`\`\`
+
+**Key patterns:**
+- \`{{#each blogs featured=true limit=1}}\` for featured post
+- \`{{#each blogs limit=12}}\` for post grid
+- Always wrap images in \`{{#if mainImage}}\`
+- Use \`{{url}}\` for links to post detail page`,
+    blog_post_template: `# Blog Post Detail Template
+
+Single blog post with author information:
+
+\`\`\`html
+<article class="blog-post">
+  {{#if mainImage}}
+    <img src="{{mainImage}}" alt="{{name}}" class="hero-image">
+  {{/if}}
+
+  <header class="post-header">
+    <h1>{{name}}</h1>
+    
+    <div class="post-meta">
+      {{#if author}}
+        <div class="author-info">
+          {{#if author.picture}}
+            <img src="{{author.picture}}" alt="{{author.name}}" class="author-avatar">
+          {{/if}}
+          <a href="{{author.url}}" class="author-name">{{author.name}}</a>
+        </div>
+      {{/if}}
+      <time datetime="{{publishedAt}}">{{publishedAt}}</time>
+    </div>
+  </header>
+
+  {{#if postSummary}}
+    <p class="lead">{{postSummary}}</p>
+  {{/if}}
+
+  <div class="post-content">
+    {{{postBody}}}
+  </div>
+
+  {{#if author}}
+  <aside class="author-box">
+    {{#if author.picture}}
+      <img src="{{author.picture}}" alt="{{author.name}}">
+    {{/if}}
+    <div class="author-details">
+      <h3>About <a href="{{author.url}}">{{author.name}}</a></h3>
+      {{{author.bio}}}
+      <div class="social-links">
+        {{#if author.twitterProfileLink}}
+          <a href="{{author.twitterProfileLink}}">Twitter</a>
+        {{/if}}
+        {{#if author.linkedinProfileLink}}
+          <a href="{{author.linkedinProfileLink}}">LinkedIn</a>
+        {{/if}}
+      </div>
+    </div>
+  </aside>
+  {{/if}}
+</article>
+\`\`\`
+
+**IMPORTANT:**
+- \`{{{postBody}}}\` uses TRIPLE braces (contains HTML)
+- \`{{{author.bio}}}\` uses TRIPLE braces (contains HTML)
+- Everything else uses double braces`,
+    team_template: `# Team Members Template
+
+\`\`\`html
+<section class="team-section">
+  <header class="section-header">
+    <h1 data-edit-key="team-page-title">Our Team</h1>
+    <p data-edit-key="team-page-intro">Meet the people behind our success</p>
+  </header>
+
+  <div class="team-grid">
+    {{#each team sort="order" order="asc"}}
+    <div class="team-member">
+      {{#if photo}}
+        <img src="{{photo}}" alt="{{name}}" class="member-photo">
+      {{/if}}
+      <h3>{{name}}</h3>
+      {{#if role}}
+        <p class="role">{{role}}</p>
+      {{/if}}
+      {{#if bio}}
+        <div class="bio">{{{bio}}}</div>
+      {{/if}}
+      {{#if email}}
+        <a href="mailto:{{email}}" class="email">{{email}}</a>
+      {{/if}}
+    </div>
+    {{/each}}
+  </div>
+</section>
+\`\`\`
+
+**Key points:**
+- \`sort="order" order="asc"\` maintains manual ordering
+- \`{{{bio}}}\` uses triple braces for HTML content
+- \`{{photo}}\` not \`{{picture}}\` (that's for authors)`,
+    downloads_template: `# Downloads Template
+
+\`\`\`html
+<section class="downloads-section">
+  <header class="section-header">
+    <h1 data-edit-key="downloads-title">Resources</h1>
+    <p data-edit-key="downloads-intro">Download our guides and materials</p>
+  </header>
+
+  <div class="downloads-list">
+    {{#each downloads sort="order" order="asc"}}
+    <div class="download-item">
+      <div class="download-info">
+        <h3>{{title}}</h3>
+        {{#if description}}
+          <p>{{description}}</p>
+        {{/if}}
+        {{#if category}}
+          <span class="category">{{category}}</span>
+        {{/if}}
+      </div>
+      <a href="{{fileUrl}}" class="download-btn" download>
+        Download
+      </a>
+    </div>
+    {{/each}}
+  </div>
+</section>
+\`\`\`
+
+**Note:** Downloads uses \`{{title}}\` not \`{{name}}\``,
+    authors_template: `# Authors Index Template
+
+\`\`\`html
+<section class="authors-section">
+  <header class="section-header">
+    <h1 data-edit-key="authors-title">Our Authors</h1>
+  </header>
+
+  <div class="authors-grid">
+    {{#each authors}}
+    <a href="{{url}}" class="author-card">
+      {{#if picture}}
+        <img src="{{picture}}" alt="{{name}}" class="author-photo">
+      {{/if}}
+      <h3>{{name}}</h3>
+      {{#if bio}}
+        <p class="bio-preview">{{{bio}}}</p>
+      {{/if}}
+    </a>
+    {{/each}}
+  </div>
+</section>
+\`\`\``,
+    author_detail_template: `# Author Detail Template
+
+\`\`\`html
+<article class="author-detail">
+  <header class="author-header">
+    {{#if picture}}
+      <img src="{{picture}}" alt="{{name}}" class="author-photo-large">
+    {{/if}}
+    <h1>{{name}}</h1>
+    
+    <div class="social-links">
+      {{#if email}}
+        <a href="mailto:{{email}}">Email</a>
+      {{/if}}
+      {{#if twitterProfileLink}}
+        <a href="{{twitterProfileLink}}">Twitter</a>
+      {{/if}}
+      {{#if linkedinProfileLink}}
+        <a href="{{linkedinProfileLink}}">LinkedIn</a>
+      {{/if}}
+    </div>
+  </header>
+
+  {{#if bio}}
+    <div class="author-bio">{{{bio}}}</div>
+  {{/if}}
+
+  <section class="author-articles">
+    <h2>Articles by {{name}}</h2>
+    <div class="articles-grid">
+      {{#each blogs where="author.slug:{{slug}}" limit=10}}
+      <a href="{{url}}" class="article-card">
+        {{#if thumbnailImage}}
+          <img src="{{thumbnailImage}}" alt="{{name}}">
+        {{/if}}
+        <h3>{{name}}</h3>
+        <p>{{postSummary}}</p>
+      </a>
+      {{/each}}
+    </div>
+  </section>
+</article>
+\`\`\`
+
+**Special:** \`where="author.slug:{{slug}}"\` filters blogs by this author`,
+    custom_collection_template: `# Custom Collection Template
+
+For user-defined collections:
+
+\`\`\`html
+<!-- Index Template: templates/products_index.html -->
+<section class="products-section">
+  <h1 data-edit-key="products-title">Our Products</h1>
+
+  <div class="products-grid">
+    {{#each products sort="order" order="asc"}}
+    <article class="product-card">
+      {{#if image}}
+        <img src="{{image}}" alt="{{name}}">
+      {{/if}}
+      <h3><a href="{{url}}">{{name}}</a></h3>
+      {{#if price}}
+        <span class="price">\${{price}}</span>
+      {{/if}}
+      {{#if description}}
+        <p>{{description}}</p>
+      {{/if}}
+    </article>
+    {{/each}}
+  </div>
+</section>
+\`\`\`
+
+**In manifest.json:**
+\`\`\`json
+{
+  "cmsTemplates": {
+    "collectionPaths": {
+      "products": "/shop"
+    }
+  }
+}
+\`\`\`
+
+This serves the products collection at /shop instead of /products`,
+    form_handling: `# Form Handling
+
+Forms are automatically captured by the CMS:
+
+\`\`\`html
+<form data-form-name="contact" class="contact-form">
+  <div class="form-group">
+    <label for="name">Name</label>
+    <input type="text" name="name" id="name" required>
+  </div>
+  
+  <div class="form-group">
+    <label for="email">Email</label>
+    <input type="email" name="email" id="email" required>
+  </div>
+  
+  <div class="form-group">
+    <label for="message">Message</label>
+    <textarea name="message" id="message" required></textarea>
+  </div>
+  
+  <button type="submit">Send Message</button>
+</form>
+
+<script>
+document.querySelectorAll('form[data-form-name]').forEach(form => {
+  form.addEventListener('submit', async (e) => {
+    e.preventDefault();
+    
+    const formData = new FormData(form);
+    const data = Object.fromEntries(formData);
+    
+    const response = await fetch('/api/forms/submit', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        formName: form.dataset.formName,
+        data: data
+      })
+    });
+    
+    if (response.ok) {
+      form.reset();
+      alert('Thank you! Your message has been sent.');
+    }
+  });
+});
+</script>
+\`\`\`
+
+**Key points:**
+- Add \`data-form-name="xxx"\` to identify the form
+- All \`name\` attributes are captured as fields
+- Tenant context is handled automatically by the system`,
+    asset_paths: `# Asset Path Rules
+
+**ALL asset paths must use /public/ prefix:**
+
+\`\`\`html
+<!-- CSS -->
+<link rel="stylesheet" href="/public/css/style.css">
+<link rel="stylesheet" href="/public/css/components/header.css">
+
+<!-- JavaScript -->
+<script src="/public/js/main.js"></script>
+<script src="/public/js/vendor/swiper.min.js"></script>
+
+<!-- Images -->
+<img src="/public/images/logo.png" alt="Logo">
+<img src="/public/images/team/john.jpg" alt="John">
+
+<!-- Favicon -->
+<link rel="icon" href="/public/images/favicon.ico">
+\`\`\`
+
+**In CSS files:**
+\`\`\`css
+/* Correct */
+background-image: url('/public/images/hero-bg.jpg');
+
+/* Wrong - will break */
+background-image: url('../images/hero-bg.jpg');
+background-image: url('images/hero-bg.jpg');
+\`\`\`
+
+**Common conversions:**
+- \`href="css/style.css"\` → \`href="/public/css/style.css"\`
+- \`src="../images/logo.png"\` → \`src="/public/images/logo.png"\`
+- \`url('../fonts/custom.woff')\` → \`url('/public/fonts/custom.woff')\``,
+    data_edit_keys: `# Inline Editing with data-edit-key
+
+Make text editable in the CMS visual editor:
+
+\`\`\`html
+<!-- Unique, descriptive keys -->
+<h1 data-edit-key="home-hero-title">Welcome to Our Company</h1>
+<p data-edit-key="home-hero-subtitle">We provide excellent services</p>
+
+<!-- Hierarchical naming for sections -->
+<section class="about">
+  <h2 data-edit-key="about-section-title">About Us</h2>
+  <p data-edit-key="about-section-paragraph-1">First paragraph...</p>
+  <p data-edit-key="about-section-paragraph-2">Second paragraph...</p>
+</section>
+
+<!-- For different pages, prefix with page name -->
+<h1 data-edit-key="contact-page-title">Contact Us</h1>
+<p data-edit-key="contact-intro">Get in touch with our team</p>
+\`\`\`
+
+**Naming conventions:**
+- \`{page}-{section}-{element}\`
+- Examples: \`home-hero-title\`, \`about-team-heading\`, \`contact-form-intro\`
+- Must be unique across the entire site
+- Use lowercase with hyphens`,
+    each_loop: `# {{#each}} Loop Syntax
+
+**Basic loop:**
+\`\`\`html
+{{#each blogs}}
+  <article>
+    <h2>{{name}}</h2>
+    <p>{{postSummary}}</p>
+  </article>
+{{/each}}
+\`\`\`
+
+**With limit:**
+\`\`\`html
+{{#each blogs limit=6}}
+  ...
+{{/each}}
+\`\`\`
+
+**Featured only:**
+\`\`\`html
+{{#each blogs featured=true}}
+  ...
+{{/each}}
+\`\`\`
+
+**Combined:**
+\`\`\`html
+{{#each blogs featured=true limit=3}}
+  ...
+{{/each}}
+\`\`\`
+
+**With sorting:**
+\`\`\`html
+{{#each team sort="order" order="asc"}}
+  ...
+{{/each}}
+\`\`\`
+
+**Loop variables:**
+\`\`\`html
+{{#each blogs limit=5}}
+  <article class="{{#if @first}}featured{{/if}} {{#if @last}}last{{/if}}">
+    <span class="position">Item {{@index}}</span>
+    <h2>{{name}}</h2>
+  </article>
+{{/each}}
+\`\`\`
+
+- \`{{@first}}\` - true for first item
+- \`{{@last}}\` - true for last item
+- \`{{@index}}\` - zero-based index (0, 1, 2...)`,
+    conditional_if: `# Conditional Rendering
+
+**{{#if}} - Render if truthy:**
+\`\`\`html
+{{#if mainImage}}
+  <img src="{{mainImage}}" alt="{{name}}">
+{{/if}}
+\`\`\`
+
+**{{#if}} with {{else}}:**
+\`\`\`html
+{{#if thumbnailImage}}
+  <img src="{{thumbnailImage}}" alt="{{name}}">
+{{else}}
+  <div class="placeholder">No image</div>
+{{/if}}
+\`\`\`
+
+**{{#unless}} - Render if falsy:**
+\`\`\`html
+{{#unless featured}}
+  <span class="regular-post">Regular</span>
+{{/unless}}
+\`\`\`
+
+**Nested conditionals:**
+\`\`\`html
+{{#if author}}
+  <div class="author-info">
+    {{#if author.picture}}
+      <img src="{{author.picture}}" alt="{{author.name}}">
+    {{/if}}
+    <span>{{author.name}}</span>
+  </div>
+{{/if}}
+\`\`\`
+
+**Multiple conditions (check both):**
+\`\`\`html
+{{#if mainImage}}
+  {{#if featured}}
+    <img src="{{mainImage}}" class="featured-image">
+  {{/if}}
+{{/if}}
+\`\`\``,
+    nested_fields: `# Nested Field Access
+
+**Author fields in blog templates:**
+\`\`\`html
+{{#each blogs}}
+  <article>
+    <h2>{{name}}</h2>
+    
+    {{#if author}}
+      <div class="author">
+        {{#if author.picture}}
+          <img src="{{author.picture}}" alt="{{author.name}}">
+        {{/if}}
+        <span>By {{author.name}}</span>
+        
+        {{#if author.bio}}
+          <p class="bio">{{{author.bio}}}</p>
+        {{/if}}
+      </div>
+    {{/if}}
+  </article>
+{{/each}}
+\`\`\`
+
+**Available nested author fields:**
+- \`{{author.name}}\`
+- \`{{author.slug}}\`
+- \`{{author.picture}}\`
+- \`{{{author.bio}}}\` (triple braces!)
+- \`{{author.email}}\`
+- \`{{author.twitterProfileLink}}\`
+- \`{{author.linkedinProfileLink}}\`
+- \`{{author.url}}\`
+
+**Always wrap in {{#if author}}** to handle posts without authors`,
+    featured_posts: `# Featured Posts Section
+
+**Homepage featured posts (3 most recent):**
+\`\`\`html
+<section class="featured-posts">
+  <h2 data-edit-key="home-blog-title">Latest News</h2>
+  
+  {{#each blogs featured=true limit=3}}
+  <article class="featured-card {{#if @first}}large{{/if}}">
+    {{#if mainImage}}
+      <img src="{{mainImage}}" alt="{{name}}">
+    {{/if}}
+    <div class="card-content">
+      <h3><a href="{{url}}">{{name}}</a></h3>
+      <p>{{postSummary}}</p>
+      {{#if author}}
+        <span class="byline">By {{author.name}}</span>
+      {{/if}}
+      <time>{{publishedAt}}</time>
+    </div>
+  </article>
+  {{/each}}
+  
+  <a href="/blog" class="view-all">View All Posts →</a>
+</section>
+\`\`\`
+
+**Hero featured post (single):**
+\`\`\`html
+{{#each blogs featured=true limit=1}}
+<section class="hero-post">
+  {{#if mainImage}}
+    <div class="hero-image" style="background-image: url('{{mainImage}}')">
+  {{/if}}
+    <div class="hero-content">
+      <span class="label">Featured</span>
+      <h1><a href="{{url}}">{{name}}</a></h1>
+      <p>{{postSummary}}</p>
+    </div>
+  {{#if mainImage}}
+    </div>
+  {{/if}}
+</section>
+{{/each}}
+\`\`\``,
+};
+/**
+ * Returns example code for a specific pattern
+ */
+async function getExample(exampleType) {
+    return EXAMPLES[exampleType] || `Example not found: ${exampleType}`;
+}

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

@@ -0,0 +1,5 @@
+/**
+ * Returns the complete CMS schema with all built-in and custom collections
+ */
+export declare function getSchema(): Promise<string>;
+//# sourceMappingURL=get-schema.d.ts.map

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

@@ -0,0 +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"}