@modyo/mcp 0.1.0

package/build/shared/helpers/logger.js

@@ -0,0 +1,64 @@
+import pino from "pino";
+/**
+ * Determines log level from environment variables
+ * Supports both LOG_LEVEL and legacy DEBUG env vars
+ */
+const getLogLevel = () => {
+    if (process.env.LOG_LEVEL) {
+        return process.env.LOG_LEVEL;
+    }
+    // Legacy support: DEBUG=true means debug level
+    if (process.env.DEBUG === "true" || process.env.DEBUG === "1") {
+        return "debug";
+    }
+    return "info";
+};
+const level = getLogLevel();
+const isDev = level === "debug" || process.env.NODE_ENV === "development";
+/**
+ * Build Pino options based on environment
+ */
+const buildPinoOptions = () => {
+    if (isDev) {
+        return {
+            level,
+            transport: {
+                target: "pino-pretty",
+                options: {
+                    colorize: true,
+                },
+            },
+        };
+    }
+    return {
+        level,
+    };
+};
+/**
+ * Pino logger instance
+ * - Uses pino-pretty in development/debug mode for readable output
+ * - Uses JSON format in production for structured logging
+ */
+export const pinoLogger = pino(buildPinoOptions());
+/**
+ * Default logger implementation for shared package
+ * Logs using Pino with level-based formatting
+ *
+ * Environment Variables:
+ * - LOG_LEVEL: debug|info|warn|error (granular control)
+ * - DEBUG: true|1 (legacy, equivalent to LOG_LEVEL=debug)
+ * - NODE_ENV: development (enables pretty output)
+ */
+export const logger = (message, context, level = "info") => {
+    // Map "warning" to Pino's "warn" level
+    const pinoLevel = level === "warning" ? "warn" : level;
+    if (context !== undefined) {
+        pinoLogger[pinoLevel]({
+            context,
+        }, message);
+    }
+    else {
+        pinoLogger[pinoLevel](message);
+    }
+};
+//# sourceMappingURL=logger.js.map

package/build/shared/helpers/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/shared/helpers/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAA4B,MAAM,MAAM,CAAC;AAGhD;;;GAGG;AACH,MAAM,WAAW,GAAG,GAAW,EAAE;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAC/B,CAAC;IACD,+CAA+C;IAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;QAC9D,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;AAC5B,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,CAAC;AAE1E;;GAEG;AACH,MAAM,gBAAgB,GAAG,GAAkB,EAAE;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,KAAK;YACL,SAAS,EAAE;gBACT,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI;iBACf;aACF;SACF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK;KACN,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,EAAE,EAAE;IACjE,uCAAuC;IACvC,MAAM,SAAS,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;IAEvD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,UAAU,CAAC,SAAS,CAAC,CACnB;YACE,OAAO;SACR,EACD,OAAO,CACR,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC"}

package/build/shared/helpers/retryWithBackoff.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Retry utility with exponential backoff and jitter.
+ *
+ * Features:
+ * - Exponential backoff with random jitter
+ * - Configurable max retries
+ * - Retry on specific status codes and network errors
+ * - Respect Retry-After header from 429 responses
+ * - Progress callback for logging
+ */
+export interface RetryOptions {
+    /**
+     * Maximum number of retry attempts (default: 3)
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay in milliseconds before first retry (default: 1000)
+     */
+    initialDelayMs?: number;
+    /**
+     * Maximum delay in milliseconds (default: 30000)
+     */
+    maxDelayMs?: number;
+    /**
+     * HTTP status codes that should trigger a retry (default: [429, 503, 504])
+     */
+    retryableStatusCodes?: number[];
+    /**
+     * Callback invoked before each retry attempt
+     * @param attempt - Current attempt number (1-indexed)
+     * @param error - The error that triggered the retry
+     * @param delayMs - Calculated delay before retry in milliseconds
+     */
+    onRetry?: (attempt: number, error: Error, delayMs: number) => void;
+}
+/**
+ * Retry an async operation with exponential backoff.
+ *
+ * @param operation - Async function to retry
+ * @param options - Retry configuration options
+ * @returns Promise resolving to operation result
+ * @throws Last error if all retries exhausted
+ *
+ * @example
+ * ```typescript
+ * const result = await retryWithBackoff(
+ *   () => fetchClient.get('/api/resource'),
+ *   {
+ *     maxRetries: 3,
+ *     onRetry: (attempt, error, delay) => {
+ *       console.log(`Retry ${attempt} after ${delay}ms: ${error.message}`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export declare function retryWithBackoff<T>(operation: () => Promise<T>, options?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retryWithBackoff.d.ts.map

package/build/shared/helpers/retryWithBackoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryWithBackoff.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/retryWithBackoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA+DZ"}

package/build/shared/helpers/retryWithBackoff.js

@@ -0,0 +1,78 @@
+/**
+ * Retry utility with exponential backoff and jitter.
+ *
+ * Features:
+ * - Exponential backoff with random jitter
+ * - Configurable max retries
+ * - Retry on specific status codes and network errors
+ * - Respect Retry-After header from 429 responses
+ * - Progress callback for logging
+ */
+/**
+ * Retry an async operation with exponential backoff.
+ *
+ * @param operation - Async function to retry
+ * @param options - Retry configuration options
+ * @returns Promise resolving to operation result
+ * @throws Last error if all retries exhausted
+ *
+ * @example
+ * ```typescript
+ * const result = await retryWithBackoff(
+ *   () => fetchClient.get('/api/resource'),
+ *   {
+ *     maxRetries: 3,
+ *     onRetry: (attempt, error, delay) => {
+ *       console.log(`Retry ${attempt} after ${delay}ms: ${error.message}`);
+ *     }
+ *   }
+ * );
+ * ```
+ */
+export async function retryWithBackoff(operation, options = {}) {
+    const { maxRetries = 3, initialDelayMs = 1000, maxDelayMs = 30000, retryableStatusCodes = [
+        429,
+        503,
+        504,
+    ], onRetry, } = options;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            // Check if error is retryable
+            const errorWithStatus = error;
+            const statusCode = errorWithStatus.statusCode;
+            const errorCode = errorWithStatus.code;
+            const isRetryableStatus = statusCode && retryableStatusCodes.includes(statusCode);
+            const isNetworkError = errorCode === "ETIMEDOUT" || errorCode === "ECONNRESET";
+            const isRetryable = isRetryableStatus || isNetworkError;
+            // Don't retry if not retryable or out of attempts
+            if (!isRetryable || attempt === maxRetries) {
+                throw error;
+            }
+            // Calculate delay with exponential backoff
+            const baseDelay = Math.min(initialDelayMs * 2 ** attempt, maxDelayMs);
+            // Add jitter (±10% random variation)
+            const jitter = Math.random() * baseDelay * 0.2 - baseDelay * 0.1;
+            let delayMs = baseDelay + jitter;
+            // Check for Retry-After header (RFC 7231)
+            const retryAfterSeconds = errorWithStatus.retryAfter;
+            if (retryAfterSeconds && statusCode === 429) {
+                // Respect Retry-After but cap at maxDelayMs
+                delayMs = Math.min(retryAfterSeconds * 1000, maxDelayMs);
+            }
+            // Invoke retry callback if provided
+            if (onRetry) {
+                onRetry(attempt + 1, error, delayMs);
+            }
+            // Wait before retrying
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+    // This should never be reached due to throw in loop, but TypeScript needs it
+    throw lastError;
+}
+//# sourceMappingURL=retryWithBackoff.js.map

package/build/shared/helpers/retryWithBackoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryWithBackoff.js","sourceRoot":"","sources":["../../../src/shared/helpers/retryWithBackoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgCH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAA2B,EAC3B,UAAwB,EAAE;IAE1B,MAAM,EACJ,UAAU,GAAG,CAAC,EACd,cAAc,GAAG,IAAI,EACrB,UAAU,GAAG,KAAK,EAClB,oBAAoB,GAAG;QACrB,GAAG;QACH,GAAG;QACH,GAAG;KACJ,EACD,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,IAAI,SAAgB,CAAC;IAErB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAc,CAAC;YAE3B,8BAA8B;YAC9B,MAAM,eAAe,GAAG,KAAY,CAAC;YACrC,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC;YAC9C,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC;YAEvC,MAAM,iBAAiB,GACrB,UAAU,IAAI,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,cAAc,GAClB,SAAS,KAAK,WAAW,IAAI,SAAS,KAAK,YAAY,CAAC;YAC1D,MAAM,WAAW,GAAG,iBAAiB,IAAI,cAAc,CAAC;YAExD,kDAAkD;YAClD,IAAI,CAAC,WAAW,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;gBAC3C,MAAM,KAAK,CAAC;YACd,CAAC;YAED,2CAA2C;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,IAAI,OAAO,EAAE,UAAU,CAAC,CAAC;YAEtE,qCAAqC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,GAAG,GAAG,CAAC;YACjE,IAAI,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;YAEjC,0CAA0C;YAC1C,MAAM,iBAAiB,GAAG,eAAe,CAAC,UAAU,CAAC;YACrD,IAAI,iBAAiB,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC5C,4CAA4C;gBAC5C,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC;YAC3D,CAAC;YAED,oCAAoC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,KAAc,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;YAED,uBAAuB;YACvB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,MAAM,SAAU,CAAC;AACnB,CAAC"}

package/build/shared/helpers/slugSchema.d.ts

@@ -0,0 +1,2 @@
+export declare const slugRegex: RegExp;
+//# sourceMappingURL=slugSchema.d.ts.map

package/build/shared/helpers/slugSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugSchema.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/slugSchema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,QAAgD,CAAC"}

package/build/shared/helpers/slugSchema.js

@@ -0,0 +1,2 @@
+export const slugRegex = /^[a-zA-Z0-9](?:[a-zA-Z0-9_-]*[a-zA-Z0-9])?$/;
+//# sourceMappingURL=slugSchema.js.map

package/build/shared/helpers/slugSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugSchema.js","sourceRoot":"","sources":["../../../src/shared/helpers/slugSchema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,6CAA6C,CAAC"}

package/build/shared/helpers/slugify.d.ts

@@ -0,0 +1,2 @@
+export declare function slugify(name: string): string;
+//# sourceMappingURL=slugify.d.ts.map

package/build/shared/helpers/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/slugify.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,UAOnC"}

package/build/shared/helpers/slugify.js

@@ -0,0 +1,9 @@
+export function slugify(name) {
+    return name
+        .toLowerCase()
+        .trim()
+        .replace(/\s+/g, "-")
+        .replace(/[^\w-]+/g, "")
+        .replace(/--+/g, "-");
+}
+//# sourceMappingURL=slugify.js.map

package/build/shared/helpers/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../../src/shared/helpers/slugify.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC"}

package/build/shared/helpers/templateContentValidator.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Template Content Validator
+ *
+ * Provides content type detection and naming convention validation for templates.
+ * Returns soft warnings (not errors) to guide users toward best practices.
+ */
+export type DetectedContentType = "css" | "js" | "html" | "liquid" | "mixed" | "unknown";
+export interface TemplateContentValidation {
+    warnings: string[];
+    detectedContentType: DetectedContentType;
+    hasCssSuffix: boolean;
+    hasJsSuffix: boolean;
+}
+export interface HardcodedColorMatch {
+    line: number;
+    found: string;
+    suggestion: string;
+}
+/**
+ * Detects hardcoded CSS colors that should use --bs-* design tokens instead.
+ *
+ * Scans CSS line-by-line, skipping comments and url() contents.
+ * Returns matches with line numbers for actionable warnings.
+ */
+export declare function detectHardcodedColors(css: string): HardcodedColorMatch[];
+/**
+ * Detects the primary content type of template body
+ */
+export declare function detectContentType(body: string): DetectedContentType;
+/**
+ * Validates template content against naming conventions
+ *
+ * @param name - Template name
+ * @param body - Template body content
+ * @param category - Template category (custom_snippet, system_snippet, etc.)
+ * @returns Validation result with warnings
+ */
+export declare function validateTemplateContent(name: string, body: string, category?: string): TemplateContentValidation;
+/**
+ * Checks if content contains unnecessary wrapper tags for the given suffix
+ */
+export declare function hasUnnecessaryWrapperTags(body: string, suffix: "_css" | "_js"): boolean;
+/**
+ * Checks if content has inline style/script tags missing CSP nonce attributes
+ */
+export declare function hasMissingCspNonce(body: string): {
+    styleMissing: boolean;
+    scriptMissing: boolean;
+};
+//# sourceMappingURL=templateContentValidator.d.ts.map

package/build/shared/helpers/templateContentValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateContentValidator.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/templateContentValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,KAAK,GACL,IAAI,GACJ,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AA4CD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmFxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA0DnE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,yBAAyB,CAsJ3B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,KAAK,GACrB,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG;IAChD,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB,CAcA"}

package/build/shared/helpers/templateContentValidator.js

@@ -0,0 +1,301 @@
+/**
+ * Template Content Validator
+ *
+ * Provides content type detection and naming convention validation for templates.
+ * Returns soft warnings (not errors) to guide users toward best practices.
+ */
+/**
+ * Regex patterns for content detection
+ */
+const PATTERNS = {
+    // CSS detection patterns - more specific to avoid matching JS imports
+    CSS_SELECTOR: /^[\s\n]*([.#]?[a-zA-Z_-][a-zA-Z0-9_-]*\s*\{|@(media|keyframes|import|charset|font-face|supports|layer)\b)/m,
+    // CSS property pattern: property-name: value (not just any braces)
+    CSS_PROPERTY: /[a-z-]+\s*:\s*[^;{}]+[;}]/i,
+    CSS_AT_RULE: /^[\s\n]*@(media|keyframes|import|charset|font-face|supports|layer|page|namespace)/m,
+    // JS detection patterns
+    JS_FUNCTION: /^\s*(function\s+\w+|const\s+\w+\s*=|let\s+\w+\s*=|var\s+\w+\s*=|export\s+(default\s+)?(function|const|class)|import\s+)/m,
+    JS_STATEMENTS: /(console\.(log|warn|error)|document\.|window\.|addEventListener|querySelector)/,
+    JS_MODULE: /^[\s\n]*(import\s+|export\s+)/m,
+    // Tag detection patterns
+    STYLE_TAG: /<style[\s>]/i,
+    SCRIPT_TAG: /<script[\s>]/i,
+    // CSP nonce patterns - detect <style> or <script> tags without nonce attribute
+    STYLE_WITHOUT_NONCE: /<style(?![^>]*nonce=)[^>]*>/gi,
+    SCRIPT_WITHOUT_NONCE: /<script(?![^>]*nonce=)[^>]*>/gi,
+    // Suffix patterns
+    CSS_SUFFIX: /_css$/,
+    JS_SUFFIX: /_js$/,
+};
+/**
+ * Allowlisted color values that are common legitimate uses (box-shadow, resets)
+ */
+const ALLOWED_HEX = new Set([
+    "#000",
+    "#fff",
+    "#000000",
+    "#ffffff",
+]);
+/**
+ * Detects hardcoded CSS colors that should use --bs-* design tokens instead.
+ *
+ * Scans CSS line-by-line, skipping comments and url() contents.
+ * Returns matches with line numbers for actionable warnings.
+ */
+export function detectHardcodedColors(css) {
+    if (!css || css.trim().length === 0)
+        return [];
+    const matches = [];
+    const suggestion = "Use a --bs-* CSS token instead";
+    // Strip block comments (/* ... */) preserving line structure
+    const withoutComments = css.replace(/\/\*[\s\S]*?\*\//g, (match) => match.replace(/[^\n]/g, " "));
+    const lines = withoutComments.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        let line = lines[i] ?? "";
+        // Strip url(...) contents to avoid false positives on data URIs and SVG refs
+        line = line.replace(/url\(\s*(?:"[^"]*"|'[^']*'|[^)])*\)/gi, "url()");
+        // Detect hex colors: #xxx, #xxxxxx, #xxxxxxxx
+        const hexRegex = /#[0-9a-fA-F]{3,8}\b/g;
+        for (let hexMatch = hexRegex.exec(line); hexMatch !== null; hexMatch = hexRegex.exec(line)) {
+            const found = hexMatch[0];
+            if (!ALLOWED_HEX.has(found) && !ALLOWED_HEX.has(found.toLowerCase())) {
+                matches.push({
+                    line: i + 1,
+                    found,
+                    suggestion,
+                });
+            }
+        }
+        // Detect rgb/rgba with literal numbers — rgb(var(--token)) is safe
+        // because \d{1,3} never matches var(...)
+        const rgbRegex = /rgba?\(\s*\d{1,3}\s*,\s*\d{1,3}\s*,\s*\d{1,3}/g;
+        for (let rgbMatch = rgbRegex.exec(line); rgbMatch !== null; rgbMatch = rgbRegex.exec(line)) {
+            // Extract the full rgb(a)(...) including optional alpha
+            const startIdx = rgbMatch.index;
+            const closeParen = line.indexOf(")", startIdx);
+            const found = closeParen !== -1 ? line.slice(startIdx, closeParen + 1) : rgbMatch[0];
+            // Allow rgba(0,0,0,alpha) - common transparent black for shadows
+            // Only skip rgba() with alpha, not solid rgb(0,0,0)
+            if (/rgba\(\s*0\s*,\s*0\s*,\s*0\s*,/.test(found))
+                continue;
+            // Allow rgba(255,255,255,alpha) - common transparent white
+            if (/rgba\(\s*255\s*,\s*255\s*,\s*255\s*,/.test(found))
+                continue;
+            matches.push({
+                line: i + 1,
+                found,
+                suggestion,
+            });
+        }
+        // Detect hsl/hsla with literal numbers — hsl(var(--token)) is safe
+        // because \d+ never matches var(...)
+        const hslRegex = /hsla?\(\s*\d+/g;
+        for (let hslMatch = hslRegex.exec(line); hslMatch !== null; hslMatch = hslRegex.exec(line)) {
+            // Extract the full hsl(...) for the warning
+            const startIdx = hslMatch.index;
+            const closeParen = line.indexOf(")", startIdx);
+            const found = closeParen !== -1 ? line.slice(startIdx, closeParen + 1) : hslMatch[0];
+            matches.push({
+                line: i + 1,
+                found,
+                suggestion,
+            });
+        }
+    }
+    return matches;
+}
+/**
+ * Detects the primary content type of template body
+ */
+export function detectContentType(body) {
+    if (!body || body.trim().length === 0) {
+        return "unknown";
+    }
+    const trimmedBody = body.trim();
+    // Check for JS patterns first (to exclude from CSS detection)
+    const isJsModule = PATTERNS.JS_MODULE.test(trimmedBody);
+    // Check for CSS patterns (exclude JS imports that look like CSS selectors)
+    const hasCssPatterns = !isJsModule &&
+        (PATTERNS.CSS_SELECTOR.test(trimmedBody) ||
+            PATTERNS.CSS_AT_RULE.test(trimmedBody) ||
+            (PATTERNS.CSS_PROPERTY.test(trimmedBody) &&
+                !PATTERNS.SCRIPT_TAG.test(trimmedBody)));
+    // Check for JS patterns
+    const hasJsPatterns = PATTERNS.JS_FUNCTION.test(trimmedBody) ||
+        PATTERNS.JS_MODULE.test(trimmedBody) ||
+        PATTERNS.JS_STATEMENTS.test(trimmedBody);
+    // Check for HTML tags
+    const hasStyleTag = PATTERNS.STYLE_TAG.test(trimmedBody);
+    const hasScriptTag = PATTERNS.SCRIPT_TAG.test(trimmedBody);
+    const hasHtmlTags = /<[a-z][\s\S]*>/i.test(trimmedBody);
+    // Check for Liquid syntax
+    const hasLiquid = /{%|{{/.test(trimmedBody);
+    // Priority-based detection
+    if (hasCssPatterns && !hasHtmlTags && !hasJsPatterns) {
+        return "css";
+    }
+    if (hasJsPatterns && !hasHtmlTags && !hasCssPatterns) {
+        return "js";
+    }
+    if (hasLiquid && (hasHtmlTags || hasStyleTag || hasScriptTag)) {
+        return "liquid";
+    }
+    if (hasHtmlTags || hasStyleTag || hasScriptTag) {
+        return "html";
+    }
+    if (hasLiquid) {
+        return "liquid";
+    }
+    if (hasCssPatterns && hasJsPatterns) {
+        return "mixed";
+    }
+    return "unknown";
+}
+/**
+ * Validates template content against naming conventions
+ *
+ * @param name - Template name
+ * @param body - Template body content
+ * @param category - Template category (custom_snippet, system_snippet, etc.)
+ * @returns Validation result with warnings
+ */
+export function validateTemplateContent(name, body, category) {
+    const warnings = [];
+    const hasCssSuffix = PATTERNS.CSS_SUFFIX.test(name);
+    const hasJsSuffix = PATTERNS.JS_SUFFIX.test(name);
+    const detectedContentType = detectContentType(body);
+    // Determine template type for category-specific validations
+    const isSnippet = !category || category === "custom_snippet" || category === "system_snippet";
+    // CDN-delivered templates (stylesheet, javascript) don't need inline tag validations
+    const isCdnTemplate = category === "stylesheet" || category === "javascript";
+    // Track if wrapper tag warnings were added (to avoid double warnings)
+    let warnedAboutStyleTag = false;
+    let warnedAboutScriptTag = false;
+    // Snippet-specific validations (only for custom_snippet and system_snippet)
+    if (isSnippet) {
+        // Validation 1: _css suffix but contains <style> tags
+        if (hasCssSuffix && PATTERNS.STYLE_TAG.test(body)) {
+            warnings.push(`Template "${name}" has _css suffix but contains <style> tags. ` +
+                `_css snippets should contain pure CSS without HTML wrapper tags.`);
+            warnedAboutStyleTag = true;
+        }
+        // Validation 2: _js suffix but contains <script> tags
+        if (hasJsSuffix && PATTERNS.SCRIPT_TAG.test(body)) {
+            warnings.push(`Template "${name}" has _js suffix but contains <script> tags. ` +
+                `_js snippets should contain pure JavaScript without HTML wrapper tags.`);
+            warnedAboutScriptTag = true;
+        }
+        // Validation 3: CSS content without _css suffix
+        if (!hasCssSuffix && !hasJsSuffix && detectedContentType === "css") {
+            warnings.push(`Template "${name}" appears to contain CSS but lacks _css suffix. ` +
+                `Consider renaming to "${name}_css" for proper linting support in Modyo editor.`);
+        }
+        // Validation 4: JS content without _js suffix
+        if (!hasCssSuffix && !hasJsSuffix && detectedContentType === "js") {
+            warnings.push(`Template "${name}" appears to contain JavaScript but lacks _js suffix. ` +
+                `Consider renaming to "${name}_js" for proper linting support in Modyo editor.`);
+        }
+        // Validation 5: _css suffix but content is not CSS
+        // Skip if we already warned about <style> tags (more specific warning)
+        if (hasCssSuffix &&
+            !warnedAboutStyleTag &&
+            detectedContentType !== "css" &&
+            detectedContentType !== "unknown" &&
+            body.trim().length > 0) {
+            warnings.push(`Template "${name}" has _css suffix but content appears to be ${detectedContentType}. ` +
+                `Consider removing the _css suffix if this is not CSS content.`);
+        }
+        // Validation 6: _js suffix but content is not JS
+        // Skip if we already warned about <script> tags (more specific warning)
+        if (hasJsSuffix &&
+            !warnedAboutScriptTag &&
+            detectedContentType !== "js" &&
+            detectedContentType !== "unknown" &&
+            body.trim().length > 0) {
+            warnings.push(`Template "${name}" has _js suffix but content appears to be ${detectedContentType}. ` +
+                `Consider removing the _js suffix if this is not JavaScript content.`);
+        }
+    }
+    // Validation: snippet contains layout markers (should be a layout instead)
+    if (isSnippet && body.trim().length > 0) {
+        const hasHtml5Tag = /\{%\s*html5\s*%\}/.test(body);
+        const hasHtml5OpenTag = /\{\{\s*html5\.open_tag\s*\}\}/.test(body);
+        const hasContentForLayout = /\{\{\s*content_for_layout\s*\}\}/.test(body);
+        const hasLayoutMarker = hasHtml5Tag || hasHtml5OpenTag;
+        if (hasLayoutMarker || hasContentForLayout) {
+            const markers = [];
+            if (hasHtml5Tag)
+                markers.push("{% html5 %}");
+            if (hasHtml5OpenTag)
+                markers.push("{{ html5.open_tag }}");
+            if (hasContentForLayout)
+                markers.push("{{ content_for_layout }}");
+            warnings.push(`Template "${name}" contains layout markers (${markers.join(" and ")}) but is categorized as ${category || "snippet"}. ` +
+                `Templates that wrap entire pages should use category "layout", not "${category || "custom_snippet"}".`);
+        }
+    }
+    // CSP nonce validations - apply to snippets and layouts, NOT CDN templates
+    // CDN templates (stylesheet, javascript) are delivered via CDN, not inline in HTML
+    if (!isCdnTemplate) {
+        // Validation 7: CSP nonce compliance for inline <style> tags
+        // Skip for _css snippets (should contain pure CSS, no HTML tags)
+        if (!hasCssSuffix) {
+            const stylesWithoutNonce = body.match(PATTERNS.STYLE_WITHOUT_NONCE);
+            if (stylesWithoutNonce && stylesWithoutNonce.length > 0) {
+                warnings.push(`Template "${name}" contains <style> tag(s) without CSP nonce attribute. ` +
+                    `For CSP compliance, add nonce="{{csp_nonce}}" to inline <style> tags.`);
+            }
+        }
+        // Validation 8: CSP nonce compliance for inline <script> tags
+        // Skip for _js snippets (should contain pure JS, no HTML tags)
+        if (!hasJsSuffix) {
+            const scriptsWithoutNonce = body.match(PATTERNS.SCRIPT_WITHOUT_NONCE);
+            if (scriptsWithoutNonce && scriptsWithoutNonce.length > 0) {
+                warnings.push(`Template "${name}" contains <script> tag(s) without CSP nonce attribute. ` +
+                    `For CSP compliance, add nonce="{{csp_nonce}}" to inline <script> tags.`);
+            }
+        }
+    }
+    // Validation 9: Hardcoded CSS colors (token-first enforcement)
+    if (detectedContentType === "css" ||
+        hasCssSuffix ||
+        category === "stylesheet") {
+        const colorMatches = detectHardcodedColors(body);
+        for (const match of colorMatches) {
+            warnings.push(`Line ${match.line}: hardcoded color "${match.found}" — use a --bs-* CSS token instead`);
+        }
+    }
+    return {
+        warnings,
+        detectedContentType,
+        hasCssSuffix,
+        hasJsSuffix,
+    };
+}
+/**
+ * Checks if content contains unnecessary wrapper tags for the given suffix
+ */
+export function hasUnnecessaryWrapperTags(body, suffix) {
+    if (suffix === "_css") {
+        return PATTERNS.STYLE_TAG.test(body);
+    }
+    if (suffix === "_js") {
+        return PATTERNS.SCRIPT_TAG.test(body);
+    }
+    return false;
+}
+/**
+ * Checks if content has inline style/script tags missing CSP nonce attributes
+ */
+export function hasMissingCspNonce(body) {
+    // Use match() instead of test() to avoid regex global flag state issues
+    const hasStyleTag = PATTERNS.STYLE_TAG.test(body);
+    const hasScriptTag = PATTERNS.SCRIPT_TAG.test(body);
+    const styleMissing = hasStyleTag && body.match(PATTERNS.STYLE_WITHOUT_NONCE) !== null;
+    const scriptMissing = hasScriptTag && body.match(PATTERNS.SCRIPT_WITHOUT_NONCE) !== null;
+    return {
+        styleMissing,
+        scriptMissing,
+    };
+}
+//# sourceMappingURL=templateContentValidator.js.map

package/build/shared/helpers/templateContentValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateContentValidator.js","sourceRoot":"","sources":["../../../src/shared/helpers/templateContentValidator.ts"],"names":[],"mappings":"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"}

package/build/shared/helpers/truncateContent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Truncates content if it exceeds the maximum size and appends a message
+ * indicating how many total characters exist.
+ */
+export declare function truncateContent(content: string, maxSize?: number): string;
+//# sourceMappingURL=truncateContent.d.ts.map

package/build/shared/helpers/truncateContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncateContent.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/truncateContent.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,OAAO,SAAmB,GACzB,MAAM,CAMR"}

package/build/shared/helpers/truncateContent.js

@@ -0,0 +1,12 @@
+const MAX_CONTENT_SIZE = 100 * 1024; // 100KB
+/**
+ * Truncates content if it exceeds the maximum size and appends a message
+ * indicating how many total characters exist.
+ */
+export function truncateContent(content, maxSize = MAX_CONTENT_SIZE) {
+    if (content.length <= maxSize)
+        return content;
+    return (content.slice(0, maxSize) +
+        `\n...[truncated, ${content.length} chars total]`);
+}
+//# sourceMappingURL=truncateContent.js.map

package/build/shared/helpers/truncateContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncateContent.js","sourceRoot":"","sources":["../../../src/shared/helpers/truncateContent.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ;AAE7C;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,OAAO,GAAG,gBAAgB;IAE1B,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC9C,OAAO,CACL,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;QACzB,oBAAoB,OAAO,CAAC,MAAM,eAAe,CAClD,CAAC;AACJ,CAAC"}