@spwig/theme-cli 1.0.0

package/dist/schemas/theme_manifest_schema.json

@@ -0,0 +1,267 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Theme Package Manifest Schema",
+  "description": "Schema for Spwig theme package manifests with bundled components",
+  "type": "object",
+  "required": [
+    "name",
+    "version",
+    "display_name",
+    "description",
+    "author"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "minLength": 2,
+      "maxLength": 50,
+      "description": "Theme identifier (lowercase, alphanumeric with hyphens)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
+      "description": "Semantic version (e.g., 1.0.0)"
+    },
+    "display_name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Human-readable theme name"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 10,
+      "maxLength": 1000,
+      "description": "Theme description for marketplace listing"
+    },
+    "author": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Theme author/vendor name"
+    },
+    "license": {
+      "type": "string",
+      "enum": ["MIT", "Apache-2.0", "GPL-3.0", "Proprietary"],
+      "default": "Proprietary",
+      "description": "Theme license type"
+    },
+    "bundled_components": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "name", "path"],
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": ["header", "footer", "section", "utility"],
+            "description": "Component type"
+          },
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9_-]*$",
+            "description": "Component name"
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^components/",
+            "description": "Relative path to component directory"
+          }
+        }
+      },
+      "description": "List of components bundled with this theme"
+    },
+    "page_schemas": {
+      "type": "object",
+      "properties": {
+        "home": {
+          "type": "string",
+          "description": "Path to home page schema"
+        },
+        "product": {
+          "type": "string",
+          "description": "Path to product page schema"
+        },
+        "collection": {
+          "type": "string",
+          "description": "Path to collection page schema"
+        },
+        "cart": {
+          "type": "string",
+          "description": "Path to cart page schema"
+        },
+        "checkout": {
+          "type": "string",
+          "description": "Path to checkout page schema"
+        },
+        "landing": {
+          "type": "string",
+          "description": "Path to landing page schema"
+        }
+      },
+      "additionalProperties": {
+        "type": "string"
+      },
+      "description": "Page schema file paths"
+    },
+    "design_tokens": {
+      "type": "string",
+      "description": "Path to design tokens file (colors, fonts, spacing)"
+    },
+    "preview_image": {
+      "type": "string",
+      "pattern": "^.+\\.(png|jpg|jpeg|webp)$",
+      "description": "Theme preview image filename (recommended: 600x800px, max 5MB)"
+    },
+    "screenshots": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "pattern": "^.+\\.(png|jpg|jpeg|webp)$"
+      },
+      "maxItems": 10,
+      "description": "Screenshot filenames for theme showcase (recommended: 1200x800px, max 5MB each)"
+    },
+    "demo_url": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to live demo of theme"
+    },
+    "documentation_url": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to theme documentation"
+    },
+    "support_url": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL for theme support"
+    },
+    "tags": {
+      "type": "array",
+      "maxItems": 10,
+      "items": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]*$",
+        "maxLength": 30
+      },
+      "description": "Searchable tags for theme marketplace"
+    },
+    "categories": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "enum": [
+          "fashion",
+          "electronics",
+          "home-garden",
+          "sports",
+          "beauty",
+          "food-beverage",
+          "books",
+          "toys",
+          "jewelry",
+          "automotive",
+          "general"
+        ]
+      },
+      "description": "Theme categories for marketplace organization"
+    },
+    "color_schemes": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "colors"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Color scheme name (e.g., 'Light', 'Dark')"
+          },
+          "colors": {
+            "type": "object",
+            "properties": {
+              "primary": {
+                "type": "string",
+                "pattern": "^#[0-9A-Fa-f]{6}$"
+              },
+              "secondary": {
+                "type": "string",
+                "pattern": "^#[0-9A-Fa-f]{6}$"
+              },
+              "accent": {
+                "type": "string",
+                "pattern": "^#[0-9A-Fa-f]{6}$"
+              },
+              "background": {
+                "type": "string",
+                "pattern": "^#[0-9A-Fa-f]{6}$"
+              },
+              "text": {
+                "type": "string",
+                "pattern": "^#[0-9A-Fa-f]{6}$"
+              }
+            }
+          }
+        }
+      },
+      "description": "Pre-defined color schemes for theme"
+    },
+    "features": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "List of theme features for marketing"
+    },
+    "min_platform_version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
+      "description": "Minimum platform version required"
+    },
+    "max_platform_version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$",
+      "description": "Maximum platform version supported"
+    },
+    "changelog": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["version", "date", "changes"],
+        "properties": {
+          "version": {
+            "type": "string",
+            "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$"
+          },
+          "date": {
+            "type": "string",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+          },
+          "changes": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "description": "Version history and changes"
+    },
+    "total_size_bytes": {
+      "type": "integer",
+      "description": "Total package size in bytes (added during packaging)"
+    },
+    "file_count": {
+      "type": "integer",
+      "description": "Total number of files (added during packaging)"
+    },
+    "checksum": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "SHA256 checksum of package contents (added during packaging)"
+    }
+  },
+  "additionalProperties": false
+}

package/dist/templates/components/blank.template.html.template

@@ -0,0 +1,4 @@
+<!-- {{displayName}} -->
+<div class="{{componentName}}">
+  <!-- Add your HTML here -->
+</div>

package/dist/templates/components/footer.manifest.json.template

@@ -0,0 +1,11 @@
+{
+  "name": "{{componentName}}",
+  "version": "1.0.0",
+  "display_name": "{{displayName}}",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "tier_compatibility": ["A", "B", "C"],
+  "regions": ["footer"],
+  "category": "footer",
+  "tags": ["footer", "navigation"]
+}

package/dist/templates/components/footer.template.html.template

@@ -0,0 +1,36 @@
+<footer class="site-footer">
+  <div class="container">
+    <div class="footer-content">
+      <!-- Footer Links -->
+      <div class="footer-section">
+        <h3>Quick Links</h3>
+        <nav class="footer-nav">
+          {% for item in navigation.footer_menu %}
+            <a href="{{ item.url }}">{{ item.title }}</a>
+          {% endfor %}
+        </nav>
+      </div>
+
+      <!-- Contact Info -->
+      <div class="footer-section">
+        <h3>Contact</h3>
+        <div class="contact-info">
+          {% if store.email %}
+            <p>Email: {{ store.email }}</p>
+          {% endif %}
+          {% if store.phone %}
+            <p>Phone: {{ store.phone }}</p>
+          {% endif %}
+        </div>
+      </div>
+
+      <!-- Copyright -->
+      <div class="footer-bottom">
+        <p>&copy; {{ "now" | date: "%Y" }} {{ store.name }}. All rights reserved.</p>
+        {% if settings.show_powered_by %}
+          <p>Powered by Spwig</p>
+        {% endif %}
+      </div>
+    </div>
+  </div>
+</footer>

package/dist/templates/components/header.manifest.json.template

@@ -0,0 +1,11 @@
+{
+  "name": "{{componentName}}",
+  "version": "1.0.0",
+  "display_name": "{{displayName}}",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "tier_compatibility": ["A", "B", "C"],
+  "regions": ["header"],
+  "category": "header",
+  "tags": ["navigation", "header"]
+}

package/dist/templates/components/header.schema.json.template

@@ -0,0 +1,23 @@
+{
+  "settings": [
+    {
+      "id": "background_color",
+      "type": "color",
+      "label": "Background Color",
+      "default": "#ffffff"
+    },
+    {
+      "id": "show_logo",
+      "type": "checkbox",
+      "label": "Show Logo",
+      "default": true
+    },
+    {
+      "id": "sticky",
+      "type": "checkbox",
+      "label": "Sticky Header",
+      "info": "Header stays at top when scrolling",
+      "default": false
+    }
+  ]
+}

package/dist/templates/components/header.template.html.template

@@ -0,0 +1,39 @@
+<header class="site-header" style="background-color: {{ settings.background_color }};">
+  <div class="container">
+    <div class="header-content">
+      <!-- Logo -->
+      <div class="header-logo">
+        {% if settings.show_logo and store.logo %}
+          <a href="/">
+            <img src="{{ store.logo }}" alt="{{ store.name }}" class="logo-image">
+          </a>
+        {% else %}
+          <a href="/" class="logo-text">
+            {{ store.name }}
+          </a>
+        {% endif %}
+      </div>
+
+      <!-- Navigation -->
+      <nav class="main-navigation">
+        {% for item in navigation.main_menu %}
+          <a href="{{ item.url }}" class="nav-link">
+            {{ item.title }}
+          </a>
+        {% endfor %}
+      </nav>
+
+      <!-- Cart Icon -->
+      <div class="header-actions">
+        <a href="/cart" class="cart-link">
+          <svg class="cart-icon" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor">
+            <path d="M9 2L9 4M15 2L15 4M3 8h18M5 8h14a2 2 0 012 2v10a2 2 0 01-2 2H5a2 2 0 01-2-2V10a2 2 0 012-2z" stroke-width="2" stroke-linecap="round"/>
+          </svg>
+          {% if cart.item_count > 0 %}
+            <span class="cart-count">{{ cart.item_count }}</span>
+          {% endif %}
+        </a>
+      </div>
+    </div>
+  </div>
+</header>

package/dist/templates/components/schema.json.template

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "title": "Component Settings",
+  "description": "Configuration options for this component",
+  "properties": {
+    "example_setting": {
+      "type": "string",
+      "title": "Example Setting",
+      "description": "This is an example setting - replace with your own",
+      "default": "default value"
+    }
+  },
+  "required": []
+}

package/dist/templates/components/section.manifest.json.template

@@ -0,0 +1,11 @@
+{
+  "name": "{{componentName}}",
+  "version": "1.0.0",
+  "display_name": "{{displayName}}",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "tier_compatibility": ["A", "B", "C"],
+  "regions": ["main", "sidebar"],
+  "category": "section",
+  "tags": ["section", "content"]
+}

package/dist/templates/components/section.template.html.template

@@ -0,0 +1,13 @@
+<section class="hero-section" style="background-color: {{ settings.background_color }};">
+  <div class="container">
+    <div class="hero-content">
+      <h1 class="hero-title">{{ settings.title }}</h1>
+      <p class="hero-description">{{ settings.description }}</p>
+      {% if settings.show_button %}
+        <a href="{{ settings.button_url }}" class="hero-button">
+          {{ settings.button_text }}
+        </a>
+      {% endif %}
+    </div>
+  </div>
+</section>

package/dist/templates/components/utility.manifest.json.template

@@ -0,0 +1,11 @@
+{
+  "name": "{{componentName}}",
+  "version": "1.0.0",
+  "display_name": "{{displayName}}",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "tier_compatibility": ["A", "B", "C"],
+  "regions": ["header", "footer", "sidebar"],
+  "category": "utility",
+  "tags": ["utility"]
+}

package/dist/templates/theme/README.md.template

@@ -0,0 +1,64 @@
+# {{displayName}}
+
+{{description}}
+
+## Theme Information
+
+- **Author**: {{author}}
+- **Version**: 1.0.0
+- **License**: {{license}}
+
+## Features
+
+- Responsive design optimized for all devices
+- Modern and clean aesthetics
+- Customizable color schemes via design tokens
+- Performance optimized
+- Accessible and SEO-friendly
+
+## Development
+
+```bash
+# Start development server
+spwig dev
+
+# Validate theme
+spwig validate
+
+# Package for distribution
+spwig package
+```
+
+## Bundled Components
+
+This theme includes the following components:
+
+- **Default Header** - Site header with navigation
+- **Default Footer** - Site footer with links
+- **Hero Section** - Eye-catching hero banner
+
+## Customization
+
+### Design Tokens
+
+Edit `design_tokens.json` to customize colors, typography, spacing, and more.
+
+### Components
+
+Components are located in the `components/` directory. Each component has:
+- `manifest.json` - Component configuration
+- `template.html` - Component template
+- `schema.json` - Component settings schema
+- `styles.css` - Component styles (optional)
+
+### Pages
+
+Page schemas are in the `pages/` directory. Configure which components appear on each page type.
+
+## Support
+
+For questions or support, please contact {{author}}.
+
+## License
+
+This theme is licensed under the {{license}} license.

package/dist/templates/theme/design_tokens.json.template

@@ -0,0 +1,66 @@
+{
+  "colors": {
+    "primary": "#2563eb",
+    "secondary": "#64748b",
+    "accent": "#f59e0b",
+    "background": "#ffffff",
+    "text": "#1e293b",
+    "success": "#10b981",
+    "warning": "#f59e0b",
+    "error": "#ef4444",
+    "border": "#e2e8f0"
+  },
+  "typography": {
+    "heading_font": "Inter, system-ui, sans-serif",
+    "body_font": "Inter, system-ui, sans-serif",
+    "mono_font": "Consolas, Monaco, monospace",
+    "base_size": "16px",
+    "scale": 1.25,
+    "weights": {
+      "light": 300,
+      "normal": 400,
+      "medium": 500,
+      "semibold": 600,
+      "bold": 700
+    }
+  },
+  "spacing": {
+    "unit": "0.25rem",
+    "scale": [0, 1, 2, 4, 8, 12, 16, 24, 32, 48, 64, 96, 128]
+  },
+  "breakpoints": {
+    "mobile": "640px",
+    "tablet": "768px",
+    "desktop": "1024px",
+    "wide": "1280px"
+  },
+  "borders": {
+    "radius": {
+      "none": "0",
+      "sm": "0.125rem",
+      "default": "0.25rem",
+      "md": "0.375rem",
+      "lg": "0.5rem",
+      "xl": "0.75rem",
+      "full": "9999px"
+    },
+    "width": {
+      "default": "1px",
+      "thick": "2px",
+      "thicker": "4px"
+    }
+  },
+  "shadows": {
+    "sm": "0 1px 2px 0 rgba(0, 0, 0, 0.05)",
+    "default": "0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06)",
+    "md": "0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06)",
+    "lg": "0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05)",
+    "xl": "0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04)"
+  },
+  "transitions": {
+    "fast": "150ms",
+    "default": "300ms",
+    "slow": "500ms",
+    "easing": "cubic-bezier(0.4, 0, 0.2, 1)"
+  }
+}

package/dist/templates/theme/manifest.json.template

@@ -0,0 +1,40 @@
+{
+  "name": "{{themeName}}",
+  "version": "1.0.0",
+  "display_name": "{{displayName}}",
+  "description": "{{description}}",
+  "author": "{{author}}",
+  "license": "{{license}}",
+  "bundled_components": [
+    {
+      "type": "header",
+      "name": "default_header",
+      "path": "components/headers/default_header"
+    },
+    {
+      "type": "footer",
+      "name": "default_footer",
+      "path": "components/footers/default_footer"
+    },
+    {
+      "type": "section",
+      "name": "hero_section",
+      "path": "components/sections/hero_section"
+    }
+  ],
+  "page_schemas": {
+    "home": "pages/home.json",
+    "product": "pages/product.json",
+    "collection": "pages/collection.json",
+    "cart": "pages/cart.json"
+  },
+  "design_tokens": "design_tokens.json",
+  "tags": ["ecommerce", "modern"],
+  "categories": ["general"],
+  "features": [
+    "Responsive design",
+    "Modern aesthetics",
+    "Customizable color schemes",
+    "Performance optimized"
+  ]
+}

package/dist/utils/file-system.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Check if a directory exists
+ */
+export declare function directoryExists(dirPath: string): Promise<boolean>;
+/**
+ * Check if a file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Ensure directory exists, create if it doesn't
+ */
+export declare function ensureDirectory(dirPath: string): Promise<void>;
+/**
+ * Read JSON file
+ */
+export declare function readJSON<T = any>(filePath: string): Promise<T>;
+/**
+ * Write JSON file with formatting
+ */
+export declare function writeJSON(filePath: string, data: any): Promise<void>;
+/**
+ * Copy file
+ */
+export declare function copyFile(source: string, destination: string): Promise<void>;
+/**
+ * Copy directory recursively
+ */
+export declare function copyDirectory(source: string, destination: string): Promise<void>;
+/**
+ * Read template file and replace placeholders
+ */
+export declare function readTemplate(templatePath: string, variables: Record<string, string>): Promise<string>;
+/**
+ * Write file from template
+ */
+export declare function writeFromTemplate(templatePath: string, outputPath: string, variables: Record<string, string>): Promise<void>;
+/**
+ * Get all files in directory recursively
+ */
+export declare function getFilesRecursively(dirPath: string): Promise<string[]>;
+/**
+ * Calculate file size
+ */
+export declare function getFileSize(filePath: string): Promise<number>;
+/**
+ * Calculate directory size
+ */
+export declare function getDirectorySize(dirPath: string): Promise<number>;
+//# sourceMappingURL=file-system.d.ts.map

package/dist/utils/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/utils/file-system.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGpE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmB5E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASvE"}