@micropress/theme-sdk 0.0.1

package/dist/index.js

@@ -0,0 +1,166 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  css: () => css,
+  defineTheme: () => defineTheme,
+  escapeHtml: () => escapeHtml,
+  html: () => html,
+  isNewsArticle: () => isNewsArticle,
+  isNewsList: () => isNewsList,
+  isPageContent: () => isPageContent,
+  join: () => join,
+  raw: () => raw,
+  render: () => render,
+  renderer: () => renderer,
+  when: () => when,
+  withAssets: () => withAssets,
+  withScripts: () => withScripts,
+  withStyles: () => withStyles
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/html.ts
+function escapeHtml(unsafe) {
+  return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function html(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i < values.length) {
+      const value = values[i];
+      if (value === null || value === void 0) {
+        continue;
+      }
+      if (typeof value === "object" && "html" in value) {
+        result += value.html;
+      } else if (Array.isArray(value)) {
+        result += value.map((v) => {
+          if (v && typeof v === "object" && "html" in v) {
+            return v.html;
+          }
+          return escapeHtml(String(v));
+        }).join("");
+      } else {
+        result += escapeHtml(String(value));
+      }
+    }
+  }
+  return {
+    html: result,
+    toString() {
+      return this.html;
+    }
+  };
+}
+function raw(htmlString) {
+  return {
+    html: htmlString,
+    toString() {
+      return this.html;
+    }
+  };
+}
+function join(items, separator = "") {
+  return raw(items.map((i) => i.html).join(separator));
+}
+function when(condition, content) {
+  if (!condition) {
+    return raw("");
+  }
+  return typeof content === "string" ? raw(content) : content;
+}
+function css(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i < values.length) {
+      result += String(values[i]);
+    }
+  }
+  return result;
+}
+
+// src/define-theme.ts
+function defineTheme(definition) {
+  return definition;
+}
+function render(fn) {
+  return { render: fn };
+}
+function withStyles(fn, styles) {
+  return {
+    render: fn,
+    styles: () => styles
+  };
+}
+function withScripts(fn, scripts) {
+  return {
+    render: fn,
+    scripts: () => scripts
+  };
+}
+function withAssets(fn, options) {
+  return {
+    render: fn,
+    styles: options.styles ? () => options.styles : void 0,
+    scripts: options.scripts ? () => options.scripts : void 0
+  };
+}
+
+// src/types.ts
+function renderer(fnOrOptions) {
+  if (typeof fnOrOptions === "function") {
+    return { render: fnOrOptions };
+  }
+  return fnOrOptions;
+}
+
+// src/dto/content.ts
+function isPageContent(content) {
+  return content.contentType === "page";
+}
+function isNewsArticle(content) {
+  return content.contentType === "news-article";
+}
+function isNewsList(content) {
+  return content.contentType === "news-list";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  css,
+  defineTheme,
+  escapeHtml,
+  html,
+  isNewsArticle,
+  isNewsList,
+  isPageContent,
+  join,
+  raw,
+  render,
+  renderer,
+  when,
+  withAssets,
+  withScripts,
+  withStyles
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/html.ts","../src/define-theme.ts","../src/types.ts","../src/dto/content.ts"],"sourcesContent":["// MicroPress Theme SDK\n// Everything you need to build themes\n\n// HTML helpers\nexport { html, css, raw, join, when, escapeHtml } from './html';\nexport type { HtmlResult } from './html';\n\n// Theme definition\nexport { defineTheme, render, withStyles, withScripts, withAssets } from './define-theme';\nexport type { ThemeDefinition, ThemeConfig, ThemeRenderers } from './define-theme';\n\n// Types\nexport { renderer } from './types';\nexport type { RenderContext, RenderFn, Renderer, BlockRenderer } from './types';\n\n// DTOs - All block and document types\nexport * from './dto';\n","// HTML Tagged Template - Safe, easy HTML generation\n\n/**\n * Result of html`` tagged template.\n */\nexport interface HtmlResult {\n  html: string;\n  toString(): string;\n}\n\n/**\n * Escape HTML entities for safe insertion.\n */\nexport function escapeHtml(unsafe: string): string {\n  return unsafe\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#039;');\n}\n\n/**\n * Tagged template for HTML.\n * Automatically escapes interpolated values unless they're HtmlResult.\n *\n * @example\n * ```ts\n * const name = '<script>alert(\"xss\")</script>';\n * html`<div>${name}</div>` // Safe: <div>&lt;script&gt;...</div>\n *\n * const inner = html`<span>safe</span>`;\n * html`<div>${inner}</div>` // Nested HTML preserved\n * ```\n */\nexport function html(strings: TemplateStringsArray, ...values: unknown[]): HtmlResult {\n  let result = '';\n\n  for (let i = 0; i < strings.length; i++) {\n    result += strings[i];\n\n    if (i < values.length) {\n      const value = values[i];\n\n      if (value === null || value === undefined) {\n        // Skip null/undefined\n        continue;\n      }\n\n      if (typeof value === 'object' && 'html' in value) {\n        // HtmlResult - already safe\n        result += (value as HtmlResult).html;\n      } else if (Array.isArray(value)) {\n        // Array of values - join them\n        result += value\n          .map(v => {\n            if (v && typeof v === 'object' && 'html' in v) {\n              return (v as HtmlResult).html;\n            }\n            return escapeHtml(String(v));\n          })\n          .join('');\n      } else {\n        // Escape everything else\n        result += escapeHtml(String(value));\n      }\n    }\n  }\n\n  return {\n    html: result,\n    toString() {\n      return this.html;\n    },\n  };\n}\n\n/**\n * Mark raw HTML as safe (use carefully!).\n *\n * @example\n * ```ts\n * const trusted = raw('<b>trusted content</b>');\n * html`<div>${trusted}</div>`\n * ```\n */\nexport function raw(htmlString: string): HtmlResult {\n  return {\n    html: htmlString,\n    toString() {\n      return this.html;\n    },\n  };\n}\n\n/**\n * Join multiple HTML results.\n */\nexport function join(items: HtmlResult[], separator = ''): HtmlResult {\n  return raw(items.map(i => i.html).join(separator));\n}\n\n/**\n * Conditional HTML - returns empty if condition is false.\n */\nexport function when(condition: boolean, content: HtmlResult | string): HtmlResult {\n  if (!condition) {\n    return raw('');\n  }\n  return typeof content === 'string' ? raw(content) : content;\n}\n\n/**\n * CSS tagged template - just returns the string.\n * Useful for syntax highlighting in editors.\n */\nexport function css(strings: TemplateStringsArray, ...values: unknown[]): string {\n  let result = '';\n  for (let i = 0; i < strings.length; i++) {\n    result += strings[i];\n    if (i < values.length) {\n      result += String(values[i]);\n    }\n  }\n  return result;\n}\n","// Theme Definition - The simplest way to create a theme\n\nimport type { Renderer, RenderFn } from './types';\nimport type {\n  DocumentDTO,\n  HeaderDTO,\n  NavigationDTO,\n  FooterDTO,\n  PageContentDTO,\n  NewsArticleDTO,\n  NewsListDTO,\n  NewsCardDTO,\n  ContentBlock,\n} from './dto';\n\n/**\n * All the components a theme can customize.\n * Every component is optional - defaults are used for missing ones.\n */\nexport interface ThemeRenderers {\n  // Document-level\n  document?: Renderer<DocumentDTO>;\n  header?: Renderer<HeaderDTO>;\n  navigation?: Renderer<NavigationDTO>;\n  footer?: Renderer<FooterDTO>;\n\n  // Content-level\n  article?: Renderer<PageContentDTO>;\n  newsArticle?: Renderer<NewsArticleDTO>;\n  newsList?: Renderer<NewsListDTO>;\n  newsCard?: Renderer<NewsCardDTO>;\n\n  // Block-level (key is block type)\n  blocks?: Partial<Record<ContentBlock['type'], Renderer<ContentBlock>>>;\n}\n\n/**\n * Theme configuration.\n */\nexport interface ThemeConfig {\n  /** Theme ID (must match manifest) */\n  id: string;\n  /** Theme display name */\n  name: string;\n  /** Theme version */\n  version: string;\n  /** CSS variables for customization */\n  variables?: Record<string, string>;\n}\n\n/**\n * Complete theme definition.\n */\nexport interface ThemeDefinition {\n  config: ThemeConfig;\n  renderers: ThemeRenderers;\n  /** Global styles for the theme */\n  styles?: string;\n  /** Global scripts for the theme */\n  scripts?: string;\n}\n\n/**\n * Define a theme with custom renderers.\n *\n * @example\n * ```ts\n * import { defineTheme, html } from '@micropress/theme-sdk';\n *\n * export default defineTheme({\n *   config: {\n *     id: 'my-theme',\n *     name: 'My Theme',\n *     version: '1.0.0',\n *   },\n *   renderers: {\n *     header: {\n *       render: (data, ctx) => html`\n *         <header class=\"my-header\">\n *           <h1>${data.siteName}</h1>\n *         </header>\n *       `.html,\n *     },\n *   },\n * });\n * ```\n */\nexport function defineTheme(definition: ThemeDefinition): ThemeDefinition {\n  return definition;\n}\n\n/**\n * Quick helper to define just a render function.\n *\n * @example\n * ```ts\n * const header = render<HeaderDTO>((data, ctx) => html`\n *   <header>${data.siteName}</header>\n * `.html);\n * ```\n */\nexport function render<T>(fn: RenderFn<T>): Renderer<T> {\n  return { render: fn };\n}\n\n/**\n * Quick helper to define a renderer with styles.\n *\n * @example\n * ```ts\n * const card = withStyles<CardDTO>(\n *   (data, ctx) => html`<div class=\"card\">${ctx.renderAll(data.children)}</div>`.html,\n *   css`.card { padding: 1rem; }`\n * );\n * ```\n */\nexport function withStyles<T>(fn: RenderFn<T>, styles: string): Renderer<T> {\n  return {\n    render: fn,\n    styles: () => styles,\n  };\n}\n\n/**\n * Quick helper to define a renderer with scripts.\n */\nexport function withScripts<T>(fn: RenderFn<T>, scripts: string): Renderer<T> {\n  return {\n    render: fn,\n    scripts: () => scripts,\n  };\n}\n\n/**\n * Define a renderer with both styles and scripts.\n */\nexport function withAssets<T>(\n  fn: RenderFn<T>,\n  options: { styles?: string; scripts?: string }\n): Renderer<T> {\n  return {\n    render: fn,\n    styles: options.styles ? () => options.styles! : undefined,\n    scripts: options.scripts ? () => options.scripts! : undefined,\n  };\n}\n","// Theme SDK Types - Keep it simple\n\nimport type { ContentBlock, BuildingBlock } from './dto';\n\n/**\n * Context passed to every render function.\n * Contains everything you need to render content.\n */\nexport interface RenderContext {\n  /** Render a child block */\n  render: (block: ContentBlock | BuildingBlock) => string;\n  /** Render multiple blocks */\n  renderAll: (blocks: (ContentBlock | BuildingBlock)[]) => string;\n  /** Site configuration */\n  site: {\n    name: string;\n    baseUrl: string;\n    currentPath?: string;\n  };\n}\n\n/**\n * A render function takes data and context, returns HTML.\n */\nexport type RenderFn<T> = (data: T, ctx: RenderContext) => string;\n\n/**\n * A renderer object with optional styles and scripts.\n */\nexport interface Renderer<T = unknown> {\n  render: RenderFn<T>;\n  styles?: () => string;\n  scripts?: () => string;\n}\n\n/**\n * Shorthand type for block renderers.\n */\nexport type BlockRenderer<T extends ContentBlock = ContentBlock> = Renderer<T>;\n\n/**\n * Helper to create a typed renderer.\n */\nexport function renderer<T>(fn: RenderFn<T>): Renderer<T>;\nexport function renderer<T>(options: Renderer<T>): Renderer<T>;\nexport function renderer<T>(fnOrOptions: RenderFn<T> | Renderer<T>): Renderer<T> {\n  if (typeof fnOrOptions === 'function') {\n    return { render: fnOrOptions };\n  }\n  return fnOrOptions;\n}\n","// Content DTOs\n// These define the content area of pages, news articles, and lists\n\nimport type { BuildingBlock } from './blocks';\n\n// ============================================================================\n// Content Types\n// ============================================================================\n\n/** The type of content being rendered */\nexport type ContentType = 'page' | 'news-article' | 'news-list';\n\n// ============================================================================\n// Base Content\n// ============================================================================\n\n/** Base content interface with common fields */\nexport interface BaseContentDTO {\n  /** Page/article title */\n  title: string;\n  /** Content type discriminator */\n  contentType: ContentType;\n}\n\n// ============================================================================\n// Page Content\n// ============================================================================\n\n/** A regular page's content */\nexport interface PageContentDTO extends BaseContentDTO {\n  contentType: 'page';\n  /** Content blocks to render */\n  blocks: BuildingBlock[];\n}\n\n// ============================================================================\n// News Article\n// ============================================================================\n\n/** A back navigation link */\nexport interface BackLinkDTO {\n  label: string;\n  href: string;\n}\n\n/** A news article's content */\nexport interface NewsArticleDTO extends BaseContentDTO {\n  contentType: 'news-article';\n  /** Content blocks to render */\n  blocks: BuildingBlock[];\n  /** Publication date (ISO string for formatting) */\n  publishedAt: string;\n  /** Author name */\n  author?: string;\n  /** Link back to news list */\n  backLink: BackLinkDTO;\n}\n\n// ============================================================================\n// News List\n// ============================================================================\n\n/** A news card in the news list */\nexport interface NewsCardDTO {\n  /** Article title */\n  title: string;\n  /** Article excerpt/preview */\n  excerpt?: string;\n  /** Publication date (ISO string) */\n  publishedAt: string;\n  /** Link to full article */\n  href: string;\n  /** Whether this is a featured article */\n  featured?: boolean;\n  /** Cover image URL */\n  image?: string;\n  /** Category label (e.g., \"News\", \"Events\") */\n  category?: string;\n  /** Estimated reading time in minutes */\n  readingTime?: number;\n}\n\n/** A news list page's content */\nexport interface NewsListDTO extends BaseContentDTO {\n  contentType: 'news-list';\n  /** The news cards to display */\n  items: NewsCardDTO[];\n}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/** All content types that can be rendered in the main content area */\nexport type ContentDTO = PageContentDTO | NewsArticleDTO | NewsListDTO;\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/** Check if content is a regular page */\nexport function isPageContent(content: ContentDTO): content is PageContentDTO {\n  return content.contentType === 'page';\n}\n\n/** Check if content is a news article */\nexport function isNewsArticle(content: ContentDTO): content is NewsArticleDTO {\n  return content.contentType === 'news-article';\n}\n\n/** Check if content is a news list */\nexport function isNewsList(content: ContentDTO): content is NewsListDTO {\n  return content.contentType === 'news-list';\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,125 @@
+// src/html.ts
+function escapeHtml(unsafe) {
+  return unsafe.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#039;");
+}
+function html(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i < values.length) {
+      const value = values[i];
+      if (value === null || value === void 0) {
+        continue;
+      }
+      if (typeof value === "object" && "html" in value) {
+        result += value.html;
+      } else if (Array.isArray(value)) {
+        result += value.map((v) => {
+          if (v && typeof v === "object" && "html" in v) {
+            return v.html;
+          }
+          return escapeHtml(String(v));
+        }).join("");
+      } else {
+        result += escapeHtml(String(value));
+      }
+    }
+  }
+  return {
+    html: result,
+    toString() {
+      return this.html;
+    }
+  };
+}
+function raw(htmlString) {
+  return {
+    html: htmlString,
+    toString() {
+      return this.html;
+    }
+  };
+}
+function join(items, separator = "") {
+  return raw(items.map((i) => i.html).join(separator));
+}
+function when(condition, content) {
+  if (!condition) {
+    return raw("");
+  }
+  return typeof content === "string" ? raw(content) : content;
+}
+function css(strings, ...values) {
+  let result = "";
+  for (let i = 0; i < strings.length; i++) {
+    result += strings[i];
+    if (i < values.length) {
+      result += String(values[i]);
+    }
+  }
+  return result;
+}
+
+// src/define-theme.ts
+function defineTheme(definition) {
+  return definition;
+}
+function render(fn) {
+  return { render: fn };
+}
+function withStyles(fn, styles) {
+  return {
+    render: fn,
+    styles: () => styles
+  };
+}
+function withScripts(fn, scripts) {
+  return {
+    render: fn,
+    scripts: () => scripts
+  };
+}
+function withAssets(fn, options) {
+  return {
+    render: fn,
+    styles: options.styles ? () => options.styles : void 0,
+    scripts: options.scripts ? () => options.scripts : void 0
+  };
+}
+
+// src/types.ts
+function renderer(fnOrOptions) {
+  if (typeof fnOrOptions === "function") {
+    return { render: fnOrOptions };
+  }
+  return fnOrOptions;
+}
+
+// src/dto/content.ts
+function isPageContent(content) {
+  return content.contentType === "page";
+}
+function isNewsArticle(content) {
+  return content.contentType === "news-article";
+}
+function isNewsList(content) {
+  return content.contentType === "news-list";
+}
+export {
+  css,
+  defineTheme,
+  escapeHtml,
+  html,
+  isNewsArticle,
+  isNewsList,
+  isPageContent,
+  join,
+  raw,
+  render,
+  renderer,
+  when,
+  withAssets,
+  withScripts,
+  withStyles
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/html.ts","../src/define-theme.ts","../src/types.ts","../src/dto/content.ts"],"sourcesContent":["// HTML Tagged Template - Safe, easy HTML generation\n\n/**\n * Result of html`` tagged template.\n */\nexport interface HtmlResult {\n  html: string;\n  toString(): string;\n}\n\n/**\n * Escape HTML entities for safe insertion.\n */\nexport function escapeHtml(unsafe: string): string {\n  return unsafe\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#039;');\n}\n\n/**\n * Tagged template for HTML.\n * Automatically escapes interpolated values unless they're HtmlResult.\n *\n * @example\n * ```ts\n * const name = '<script>alert(\"xss\")</script>';\n * html`<div>${name}</div>` // Safe: <div>&lt;script&gt;...</div>\n *\n * const inner = html`<span>safe</span>`;\n * html`<div>${inner}</div>` // Nested HTML preserved\n * ```\n */\nexport function html(strings: TemplateStringsArray, ...values: unknown[]): HtmlResult {\n  let result = '';\n\n  for (let i = 0; i < strings.length; i++) {\n    result += strings[i];\n\n    if (i < values.length) {\n      const value = values[i];\n\n      if (value === null || value === undefined) {\n        // Skip null/undefined\n        continue;\n      }\n\n      if (typeof value === 'object' && 'html' in value) {\n        // HtmlResult - already safe\n        result += (value as HtmlResult).html;\n      } else if (Array.isArray(value)) {\n        // Array of values - join them\n        result += value\n          .map(v => {\n            if (v && typeof v === 'object' && 'html' in v) {\n              return (v as HtmlResult).html;\n            }\n            return escapeHtml(String(v));\n          })\n          .join('');\n      } else {\n        // Escape everything else\n        result += escapeHtml(String(value));\n      }\n    }\n  }\n\n  return {\n    html: result,\n    toString() {\n      return this.html;\n    },\n  };\n}\n\n/**\n * Mark raw HTML as safe (use carefully!).\n *\n * @example\n * ```ts\n * const trusted = raw('<b>trusted content</b>');\n * html`<div>${trusted}</div>`\n * ```\n */\nexport function raw(htmlString: string): HtmlResult {\n  return {\n    html: htmlString,\n    toString() {\n      return this.html;\n    },\n  };\n}\n\n/**\n * Join multiple HTML results.\n */\nexport function join(items: HtmlResult[], separator = ''): HtmlResult {\n  return raw(items.map(i => i.html).join(separator));\n}\n\n/**\n * Conditional HTML - returns empty if condition is false.\n */\nexport function when(condition: boolean, content: HtmlResult | string): HtmlResult {\n  if (!condition) {\n    return raw('');\n  }\n  return typeof content === 'string' ? raw(content) : content;\n}\n\n/**\n * CSS tagged template - just returns the string.\n * Useful for syntax highlighting in editors.\n */\nexport function css(strings: TemplateStringsArray, ...values: unknown[]): string {\n  let result = '';\n  for (let i = 0; i < strings.length; i++) {\n    result += strings[i];\n    if (i < values.length) {\n      result += String(values[i]);\n    }\n  }\n  return result;\n}\n","// Theme Definition - The simplest way to create a theme\n\nimport type { Renderer, RenderFn } from './types';\nimport type {\n  DocumentDTO,\n  HeaderDTO,\n  NavigationDTO,\n  FooterDTO,\n  PageContentDTO,\n  NewsArticleDTO,\n  NewsListDTO,\n  NewsCardDTO,\n  ContentBlock,\n} from './dto';\n\n/**\n * All the components a theme can customize.\n * Every component is optional - defaults are used for missing ones.\n */\nexport interface ThemeRenderers {\n  // Document-level\n  document?: Renderer<DocumentDTO>;\n  header?: Renderer<HeaderDTO>;\n  navigation?: Renderer<NavigationDTO>;\n  footer?: Renderer<FooterDTO>;\n\n  // Content-level\n  article?: Renderer<PageContentDTO>;\n  newsArticle?: Renderer<NewsArticleDTO>;\n  newsList?: Renderer<NewsListDTO>;\n  newsCard?: Renderer<NewsCardDTO>;\n\n  // Block-level (key is block type)\n  blocks?: Partial<Record<ContentBlock['type'], Renderer<ContentBlock>>>;\n}\n\n/**\n * Theme configuration.\n */\nexport interface ThemeConfig {\n  /** Theme ID (must match manifest) */\n  id: string;\n  /** Theme display name */\n  name: string;\n  /** Theme version */\n  version: string;\n  /** CSS variables for customization */\n  variables?: Record<string, string>;\n}\n\n/**\n * Complete theme definition.\n */\nexport interface ThemeDefinition {\n  config: ThemeConfig;\n  renderers: ThemeRenderers;\n  /** Global styles for the theme */\n  styles?: string;\n  /** Global scripts for the theme */\n  scripts?: string;\n}\n\n/**\n * Define a theme with custom renderers.\n *\n * @example\n * ```ts\n * import { defineTheme, html } from '@micropress/theme-sdk';\n *\n * export default defineTheme({\n *   config: {\n *     id: 'my-theme',\n *     name: 'My Theme',\n *     version: '1.0.0',\n *   },\n *   renderers: {\n *     header: {\n *       render: (data, ctx) => html`\n *         <header class=\"my-header\">\n *           <h1>${data.siteName}</h1>\n *         </header>\n *       `.html,\n *     },\n *   },\n * });\n * ```\n */\nexport function defineTheme(definition: ThemeDefinition): ThemeDefinition {\n  return definition;\n}\n\n/**\n * Quick helper to define just a render function.\n *\n * @example\n * ```ts\n * const header = render<HeaderDTO>((data, ctx) => html`\n *   <header>${data.siteName}</header>\n * `.html);\n * ```\n */\nexport function render<T>(fn: RenderFn<T>): Renderer<T> {\n  return { render: fn };\n}\n\n/**\n * Quick helper to define a renderer with styles.\n *\n * @example\n * ```ts\n * const card = withStyles<CardDTO>(\n *   (data, ctx) => html`<div class=\"card\">${ctx.renderAll(data.children)}</div>`.html,\n *   css`.card { padding: 1rem; }`\n * );\n * ```\n */\nexport function withStyles<T>(fn: RenderFn<T>, styles: string): Renderer<T> {\n  return {\n    render: fn,\n    styles: () => styles,\n  };\n}\n\n/**\n * Quick helper to define a renderer with scripts.\n */\nexport function withScripts<T>(fn: RenderFn<T>, scripts: string): Renderer<T> {\n  return {\n    render: fn,\n    scripts: () => scripts,\n  };\n}\n\n/**\n * Define a renderer with both styles and scripts.\n */\nexport function withAssets<T>(\n  fn: RenderFn<T>,\n  options: { styles?: string; scripts?: string }\n): Renderer<T> {\n  return {\n    render: fn,\n    styles: options.styles ? () => options.styles! : undefined,\n    scripts: options.scripts ? () => options.scripts! : undefined,\n  };\n}\n","// Theme SDK Types - Keep it simple\n\nimport type { ContentBlock, BuildingBlock } from './dto';\n\n/**\n * Context passed to every render function.\n * Contains everything you need to render content.\n */\nexport interface RenderContext {\n  /** Render a child block */\n  render: (block: ContentBlock | BuildingBlock) => string;\n  /** Render multiple blocks */\n  renderAll: (blocks: (ContentBlock | BuildingBlock)[]) => string;\n  /** Site configuration */\n  site: {\n    name: string;\n    baseUrl: string;\n    currentPath?: string;\n  };\n}\n\n/**\n * A render function takes data and context, returns HTML.\n */\nexport type RenderFn<T> = (data: T, ctx: RenderContext) => string;\n\n/**\n * A renderer object with optional styles and scripts.\n */\nexport interface Renderer<T = unknown> {\n  render: RenderFn<T>;\n  styles?: () => string;\n  scripts?: () => string;\n}\n\n/**\n * Shorthand type for block renderers.\n */\nexport type BlockRenderer<T extends ContentBlock = ContentBlock> = Renderer<T>;\n\n/**\n * Helper to create a typed renderer.\n */\nexport function renderer<T>(fn: RenderFn<T>): Renderer<T>;\nexport function renderer<T>(options: Renderer<T>): Renderer<T>;\nexport function renderer<T>(fnOrOptions: RenderFn<T> | Renderer<T>): Renderer<T> {\n  if (typeof fnOrOptions === 'function') {\n    return { render: fnOrOptions };\n  }\n  return fnOrOptions;\n}\n","// Content DTOs\n// These define the content area of pages, news articles, and lists\n\nimport type { BuildingBlock } from './blocks';\n\n// ============================================================================\n// Content Types\n// ============================================================================\n\n/** The type of content being rendered */\nexport type ContentType = 'page' | 'news-article' | 'news-list';\n\n// ============================================================================\n// Base Content\n// ============================================================================\n\n/** Base content interface with common fields */\nexport interface BaseContentDTO {\n  /** Page/article title */\n  title: string;\n  /** Content type discriminator */\n  contentType: ContentType;\n}\n\n// ============================================================================\n// Page Content\n// ============================================================================\n\n/** A regular page's content */\nexport interface PageContentDTO extends BaseContentDTO {\n  contentType: 'page';\n  /** Content blocks to render */\n  blocks: BuildingBlock[];\n}\n\n// ============================================================================\n// News Article\n// ============================================================================\n\n/** A back navigation link */\nexport interface BackLinkDTO {\n  label: string;\n  href: string;\n}\n\n/** A news article's content */\nexport interface NewsArticleDTO extends BaseContentDTO {\n  contentType: 'news-article';\n  /** Content blocks to render */\n  blocks: BuildingBlock[];\n  /** Publication date (ISO string for formatting) */\n  publishedAt: string;\n  /** Author name */\n  author?: string;\n  /** Link back to news list */\n  backLink: BackLinkDTO;\n}\n\n// ============================================================================\n// News List\n// ============================================================================\n\n/** A news card in the news list */\nexport interface NewsCardDTO {\n  /** Article title */\n  title: string;\n  /** Article excerpt/preview */\n  excerpt?: string;\n  /** Publication date (ISO string) */\n  publishedAt: string;\n  /** Link to full article */\n  href: string;\n  /** Whether this is a featured article */\n  featured?: boolean;\n  /** Cover image URL */\n  image?: string;\n  /** Category label (e.g., \"News\", \"Events\") */\n  category?: string;\n  /** Estimated reading time in minutes */\n  readingTime?: number;\n}\n\n/** A news list page's content */\nexport interface NewsListDTO extends BaseContentDTO {\n  contentType: 'news-list';\n  /** The news cards to display */\n  items: NewsCardDTO[];\n}\n\n// ============================================================================\n// Union Type\n// ============================================================================\n\n/** All content types that can be rendered in the main content area */\nexport type ContentDTO = PageContentDTO | NewsArticleDTO | NewsListDTO;\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\n/** Check if content is a regular page */\nexport function isPageContent(content: ContentDTO): content is PageContentDTO {\n  return content.contentType === 'page';\n}\n\n/** Check if content is a news article */\nexport function isNewsArticle(content: ContentDTO): content is NewsArticleDTO {\n  return content.contentType === 'news-article';\n}\n\n/** Check if content is a news list */\nexport function isNewsList(content: ContentDTO): content is NewsListDTO {\n  return content.contentType === 'news-list';\n}\n"],"mappings":";AAaO,SAAS,WAAW,QAAwB;AACjD,SAAO,OACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,QAAQ;AAC3B;AAeO,SAAS,KAAK,YAAkC,QAA+B;AACpF,MAAI,SAAS;AAEb,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,cAAU,QAAQ,CAAC;AAEnB,QAAI,IAAI,OAAO,QAAQ;AACrB,YAAM,QAAQ,OAAO,CAAC;AAEtB,UAAI,UAAU,QAAQ,UAAU,QAAW;AAEzC;AAAA,MACF;AAEA,UAAI,OAAO,UAAU,YAAY,UAAU,OAAO;AAEhD,kBAAW,MAAqB;AAAA,MAClC,WAAW,MAAM,QAAQ,KAAK,GAAG;AAE/B,kBAAU,MACP,IAAI,OAAK;AACR,cAAI,KAAK,OAAO,MAAM,YAAY,UAAU,GAAG;AAC7C,mBAAQ,EAAiB;AAAA,UAC3B;AACA,iBAAO,WAAW,OAAO,CAAC,CAAC;AAAA,QAC7B,CAAC,EACA,KAAK,EAAE;AAAA,MACZ,OAAO;AAEL,kBAAU,WAAW,OAAO,KAAK,CAAC;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,WAAW;AACT,aAAO,KAAK;AAAA,IACd;AAAA,EACF;AACF;AAWO,SAAS,IAAI,YAAgC;AAClD,SAAO;AAAA,IACL,MAAM;AAAA,IACN,WAAW;AACT,aAAO,KAAK;AAAA,IACd;AAAA,EACF;AACF;AAKO,SAAS,KAAK,OAAqB,YAAY,IAAgB;AACpE,SAAO,IAAI,MAAM,IAAI,OAAK,EAAE,IAAI,EAAE,KAAK,SAAS,CAAC;AACnD;AAKO,SAAS,KAAK,WAAoB,SAA0C;AACjF,MAAI,CAAC,WAAW;AACd,WAAO,IAAI,EAAE;AAAA,EACf;AACA,SAAO,OAAO,YAAY,WAAW,IAAI,OAAO,IAAI;AACtD;AAMO,SAAS,IAAI,YAAkC,QAA2B;AAC/E,MAAI,SAAS;AACb,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,cAAU,QAAQ,CAAC;AACnB,QAAI,IAAI,OAAO,QAAQ;AACrB,gBAAU,OAAO,OAAO,CAAC,CAAC;AAAA,IAC5B;AAAA,EACF;AACA,SAAO;AACT;;;ACtCO,SAAS,YAAY,YAA8C;AACxE,SAAO;AACT;AAYO,SAAS,OAAU,IAA8B;AACtD,SAAO,EAAE,QAAQ,GAAG;AACtB;AAaO,SAAS,WAAc,IAAiB,QAA6B;AAC1E,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,QAAQ,MAAM;AAAA,EAChB;AACF;AAKO,SAAS,YAAe,IAAiB,SAA8B;AAC5E,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,SAAS,MAAM;AAAA,EACjB;AACF;AAKO,SAAS,WACd,IACA,SACa;AACb,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,QAAQ,QAAQ,SAAS,MAAM,QAAQ,SAAU;AAAA,IACjD,SAAS,QAAQ,UAAU,MAAM,QAAQ,UAAW;AAAA,EACtD;AACF;;;ACpGO,SAAS,SAAY,aAAqD;AAC/E,MAAI,OAAO,gBAAgB,YAAY;AACrC,WAAO,EAAE,QAAQ,YAAY;AAAA,EAC/B;AACA,SAAO;AACT;;;ACmDO,SAAS,cAAc,SAAgD;AAC5E,SAAO,QAAQ,gBAAgB;AACjC;AAGO,SAAS,cAAc,SAAgD;AAC5E,SAAO,QAAQ,gBAAgB;AACjC;AAGO,SAAS,WAAW,SAA6C;AACtE,SAAO,QAAQ,gBAAgB;AACjC;","names":[]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@micropress/theme-sdk",
+  "version": "0.0.1",
+  "description": "SDK for building MicroPress themes",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "micropress-theme": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "lint": "eslint src cli --ext .ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.9",
+    "eslint": "^9.39.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.17"
+  },
+  "keywords": [
+    "micropress",
+    "theme",
+    "sdk",
+    "cms",
+    "static-site"
+  ],
+  "author": "MicroPress Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/JWThewes/micropress-theme-sdk.git"
+  },
+  "homepage": "https://github.com/JWThewes/micropress-theme-sdk#readme",
+  "bugs": {
+    "url": "https://github.com/JWThewes/micropress-theme-sdk/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}