@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/seo/generator.js

@@ -0,0 +1,236 @@
+/**
+ * SEO Capability Implementation
+ *
+ * Meta tag generation, JSON-LD structured data, and Open Graph tags
+ *
+ * All outputs are plain serializable objects suitable for SSR.
+ *
+ * @module @pwfabric/runtime/seo/generator
+ */
+// ============================================================
+// DEFAULT SEO CAPABILITY
+// ============================================================
+/**
+ * Default SEO capability implementation
+ */
+export class DefaultSeoCapability {
+    defaults;
+    constructor(defaults) {
+        this.defaults = {
+            siteName: defaults?.siteName ?? '',
+            titleSeparator: defaults?.titleSeparator ?? ' | ',
+            defaultViewport: defaults?.defaultViewport ?? 'width=device-width, initial-scale=1',
+            defaultCharset: defaults?.defaultCharset ?? 'utf-8',
+            defaultRobots: defaults?.defaultRobots ?? 'index, follow',
+        };
+    }
+    generateMetaTags(input) {
+        const meta = [];
+        const link = [];
+        // Title (may include site name suffix)
+        let title = input.title;
+        if (this.defaults.siteName && !title.includes(this.defaults.siteName)) {
+            title = `${input.title}${this.defaults.titleSeparator}${this.defaults.siteName}`;
+        }
+        // Charset
+        const charset = input.charset ?? this.defaults.defaultCharset;
+        meta.push({ httpEquiv: 'Content-Type', content: `text/html; charset=${charset}` });
+        // Viewport
+        const viewport = input.viewport ?? this.defaults.defaultViewport;
+        meta.push({ name: 'viewport', content: viewport });
+        // Description
+        if (input.description) {
+            meta.push({ name: 'description', content: input.description });
+        }
+        // Keywords
+        if (input.keywords && input.keywords.length > 0) {
+            meta.push({ name: 'keywords', content: input.keywords.join(', ') });
+        }
+        // Author
+        if (input.author) {
+            meta.push({ name: 'author', content: input.author });
+        }
+        // Robots
+        const robots = input.robots ?? this.defaults.defaultRobots;
+        meta.push({ name: 'robots', content: robots });
+        // Canonical
+        if (input.canonical) {
+            link.push({ rel: 'canonical', href: input.canonical });
+        }
+        // Custom tags
+        if (input.custom) {
+            for (const customTag of input.custom) {
+                meta.push(customTag);
+            }
+        }
+        return { title, meta, link };
+    }
+    generateStructuredData(input) {
+        const data = {
+            '@context': 'https://schema.org',
+            '@type': input.type,
+            name: input.name,
+        };
+        if (input.description) {
+            data.description = input.description;
+        }
+        if (input.url) {
+            data.url = input.url;
+        }
+        if (input.image) {
+            data.image = input.image;
+        }
+        if (input.datePublished) {
+            data.datePublished = input.datePublished;
+        }
+        if (input.dateModified) {
+            data.dateModified = input.dateModified;
+        }
+        // Author
+        if (input.author) {
+            data.author = {
+                '@type': input.author.type,
+                name: input.author.name,
+                ...(input.author.url ? { url: input.author.url } : {}),
+            };
+        }
+        // Publisher
+        if (input.publisher) {
+            const publisher = {
+                '@type': 'Organization',
+                name: input.publisher.name,
+            };
+            if (input.publisher.url) {
+                publisher.url = input.publisher.url;
+            }
+            if (input.publisher.logo) {
+                publisher.logo = {
+                    '@type': 'ImageObject',
+                    url: input.publisher.logo,
+                };
+            }
+            data.publisher = publisher;
+        }
+        // Breadcrumbs
+        if (input.breadcrumbs && input.breadcrumbs.length > 0) {
+            data['@type'] = 'BreadcrumbList';
+            data.itemListElement = input.breadcrumbs.map((crumb, index) => ({
+                '@type': 'ListItem',
+                position: index + 1,
+                name: crumb.name,
+                item: crumb.url,
+            }));
+        }
+        // FAQ
+        if (input.faq && input.faq.length > 0) {
+            data['@type'] = 'FAQPage';
+            data.mainEntity = input.faq.map((item) => ({
+                '@type': 'Question',
+                name: item.question,
+                acceptedAnswer: {
+                    '@type': 'Answer',
+                    text: item.answer,
+                },
+            }));
+        }
+        // Custom properties
+        if (input.custom) {
+            for (const [key, value] of Object.entries(input.custom)) {
+                if (key !== '@context' && key !== '@type') {
+                    data[key] = value;
+                }
+            }
+        }
+        const script = JSON.stringify(data);
+        return { script, data };
+    }
+    generateOpenGraph(input) {
+        const meta = [];
+        // Required OG tags
+        meta.push({ property: 'og:title', content: input.title });
+        meta.push({ property: 'og:type', content: input.type ?? 'website' });
+        // Optional OG tags
+        if (input.description) {
+            meta.push({ property: 'og:description', content: input.description });
+        }
+        if (input.url) {
+            meta.push({ property: 'og:url', content: input.url });
+        }
+        if (input.image) {
+            meta.push({ property: 'og:image', content: input.image });
+            if (input.imageWidth) {
+                meta.push({ property: 'og:image:width', content: String(input.imageWidth) });
+            }
+            if (input.imageHeight) {
+                meta.push({ property: 'og:image:height', content: String(input.imageHeight) });
+            }
+            if (input.imageAlt) {
+                meta.push({ property: 'og:image:alt', content: input.imageAlt });
+            }
+        }
+        if (input.siteName) {
+            meta.push({ property: 'og:site_name', content: input.siteName });
+        }
+        if (input.locale) {
+            meta.push({ property: 'og:locale', content: input.locale });
+        }
+        if (input.localeAlternates) {
+            for (const alt of input.localeAlternates) {
+                meta.push({ property: 'og:locale:alternate', content: alt });
+            }
+        }
+        // Article-specific tags
+        if (input.article) {
+            if (input.article.publishedTime) {
+                meta.push({ property: 'article:published_time', content: input.article.publishedTime });
+            }
+            if (input.article.modifiedTime) {
+                meta.push({ property: 'article:modified_time', content: input.article.modifiedTime });
+            }
+            if (input.article.author) {
+                meta.push({ property: 'article:author', content: input.article.author });
+            }
+            if (input.article.section) {
+                meta.push({ property: 'article:section', content: input.article.section });
+            }
+            if (input.article.tags) {
+                for (const tag of input.article.tags) {
+                    meta.push({ property: 'article:tag', content: tag });
+                }
+            }
+        }
+        // Twitter card
+        if (input.twitter) {
+            meta.push({ name: 'twitter:card', content: input.twitter.card ?? 'summary' });
+            if (input.twitter.site) {
+                meta.push({ name: 'twitter:site', content: input.twitter.site });
+            }
+            if (input.twitter.creator) {
+                meta.push({ name: 'twitter:creator', content: input.twitter.creator });
+            }
+        }
+        return { meta };
+    }
+    generateAll(config) {
+        const output = {
+            metaTags: this.generateMetaTags(config.meta),
+        };
+        if (config.structuredData) {
+            output.structuredData = this.generateStructuredData(config.structuredData);
+        }
+        if (config.openGraph) {
+            output.openGraph = this.generateOpenGraph(config.openGraph);
+        }
+        return output;
+    }
+}
+// ============================================================
+// FACTORY FUNCTION
+// ============================================================
+/**
+ * Create an SEO capability instance
+ */
+export function createSeoCapability(defaults) {
+    return new DefaultSeoCapability(defaults);
+}
+//# sourceMappingURL=generator.js.map

package/dist/seo/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/seo/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,+DAA+D;AAC/D,yBAAyB;AACzB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACd,QAAQ,CAAa;IAEtC,YAAY,QAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG;YACd,QAAQ,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE;YAClC,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,KAAK;YACjD,eAAe,EAAE,QAAQ,EAAE,eAAe,IAAI,qCAAqC;YACnF,cAAc,EAAE,QAAQ,EAAE,cAAc,IAAI,OAAO;YACnD,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,eAAe;SAC1D,CAAA;IACH,CAAC;IAED,gBAAgB,CAAC,KAAmB;QAClC,MAAM,IAAI,GAAc,EAAE,CAAA;QAC1B,MAAM,IAAI,GAAc,EAAE,CAAA;QAE1B,uCAAuC;QACvC,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QACvB,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtE,KAAK,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAA;QAClF,CAAC;QAED,UAAU;QACV,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAA;QAC7D,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,sBAAsB,OAAO,EAAE,EAAE,CAAC,CAAA;QAElF,WAAW;QACX,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAA;QAChE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAElD,cAAc;QACd,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,WAAW;QACX,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACrE,CAAC;QAED,SAAS;QACT,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QACtD,CAAC;QAED,SAAS;QACT,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAA;QAC1D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAE9C,YAAY;QACZ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAA;QACxD,CAAC;QAED,cAAc;QACd,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC9B,CAAC;IAED,sBAAsB,CAAC,KAA0B;QAC/C,MAAM,IAAI,GAA4B;YACpC,UAAU,EAAE,oBAAoB;YAChC,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAA;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAA;QACtC,CAAC;QAED,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAA;QACtB,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;QAC1B,CAAC;QAED,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YACxB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAA;QAC1C,CAAC;QAED,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAA;QACxC,CAAC;QAED,SAAS;QACT,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG;gBACZ,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;gBAC1B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;gBACvB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAA;QACH,CAAC;QAED,YAAY;QACZ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,SAAS,GAA4B;gBACzC,OAAO,EAAE,cAAc;gBACvB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI;aAC3B,CAAA;YACD,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;gBACxB,SAAS,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAA;YACrC,CAAC;YACD,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACzB,SAAS,CAAC,IAAI,GAAG;oBACf,OAAO,EAAE,aAAa;oBACtB,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI;iBAC1B,CAAA;YACH,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC5B,CAAC;QAED,cAAc;QACd,IAAI,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,GAAG,gBAAgB,CAAA;YAChC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC9D,OAAO,EAAE,UAAU;gBACnB,QAAQ,EAAE,KAAK,GAAG,CAAC;gBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,GAAG;aAChB,CAAC,CAAC,CAAA;QACL,CAAC;QAED,MAAM;QACN,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,GAAG,SAAS,CAAA;YACzB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACzC,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,IAAI,CAAC,QAAQ;gBACnB,cAAc,EAAE;oBACd,OAAO,EAAE,QAAQ;oBACjB,IAAI,EAAE,IAAI,CAAC,MAAM;iBAClB;aACF,CAAC,CAAC,CAAA;QACL,CAAC;QAED,oBAAoB;QACpB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxD,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;oBAC1C,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QAEnC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IACzB,CAAC;IAED,iBAAiB,CAAC,KAAqB;QACrC,MAAM,IAAI,GAAc,EAAE,CAAA;QAE1B,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QACzD,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAA;QAEpE,mBAAmB;QACnB,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;QACvE,CAAC;QAED,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;QACvD,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;YACzD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;YAC9E,CAAC;YACD,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YAChF,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;YAClE,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;QAC7D,CAAC;QAED,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;gBACzC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;YAC9D,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBAChC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,wBAAwB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;YACzF,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,uBAAuB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;YACvF,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;YAC1E,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;YAC5E,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACvB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrC,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;QAED,eAAe;QACf,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAA;YAC7E,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;YAClE,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;YACxE,CAAC;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,CAAA;IACjB,CAAC;IAED,WAAW,CAAC,MAAiB;QAC3B,MAAM,MAAM,GAIR;YACF,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,CAAC;SAC7C,CAAA;QAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;QAC5E,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF;AAcD,+DAA+D;AAC/D,mBAAmB;AACnB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAMnC;IACC,OAAO,IAAI,oBAAoB,CAAC,QAAQ,CAAC,CAAA;AAC3C,CAAC","sourcesContent":["/**\n * SEO Capability Implementation\n *\n * Meta tag generation, JSON-LD structured data, and Open Graph tags\n *\n * All outputs are plain serializable objects suitable for SSR.\n *\n * @module @pwfabric/runtime/seo/generator\n */\n\nimport type {\n  SeoCapability,\n  MetaTagInput,\n  MetaTagOutput,\n  MetaTag,\n  LinkTag,\n  StructuredDataInput,\n  StructuredDataOutput,\n  OpenGraphInput,\n  OpenGraphOutput,\n  SeoConfig,\n  SeoOutput,\n} from './types.js'\n\n// ============================================================\n// DEFAULT SEO CAPABILITY\n// ============================================================\n\n/**\n * Default SEO capability implementation\n */\nexport class DefaultSeoCapability implements SeoCapability {\n  private readonly defaults: SeoDefaults\n\n  constructor(defaults?: Partial<SeoDefaults>) {\n    this.defaults = {\n      siteName: defaults?.siteName ?? '',\n      titleSeparator: defaults?.titleSeparator ?? ' | ',\n      defaultViewport: defaults?.defaultViewport ?? 'width=device-width, initial-scale=1',\n      defaultCharset: defaults?.defaultCharset ?? 'utf-8',\n      defaultRobots: defaults?.defaultRobots ?? 'index, follow',\n    }\n  }\n\n  generateMetaTags(input: MetaTagInput): MetaTagOutput {\n    const meta: MetaTag[] = []\n    const link: LinkTag[] = []\n\n    // Title (may include site name suffix)\n    let title = input.title\n    if (this.defaults.siteName && !title.includes(this.defaults.siteName)) {\n      title = `${input.title}${this.defaults.titleSeparator}${this.defaults.siteName}`\n    }\n\n    // Charset\n    const charset = input.charset ?? this.defaults.defaultCharset\n    meta.push({ httpEquiv: 'Content-Type', content: `text/html; charset=${charset}` })\n\n    // Viewport\n    const viewport = input.viewport ?? this.defaults.defaultViewport\n    meta.push({ name: 'viewport', content: viewport })\n\n    // Description\n    if (input.description) {\n      meta.push({ name: 'description', content: input.description })\n    }\n\n    // Keywords\n    if (input.keywords && input.keywords.length > 0) {\n      meta.push({ name: 'keywords', content: input.keywords.join(', ') })\n    }\n\n    // Author\n    if (input.author) {\n      meta.push({ name: 'author', content: input.author })\n    }\n\n    // Robots\n    const robots = input.robots ?? this.defaults.defaultRobots\n    meta.push({ name: 'robots', content: robots })\n\n    // Canonical\n    if (input.canonical) {\n      link.push({ rel: 'canonical', href: input.canonical })\n    }\n\n    // Custom tags\n    if (input.custom) {\n      for (const customTag of input.custom) {\n        meta.push(customTag)\n      }\n    }\n\n    return { title, meta, link }\n  }\n\n  generateStructuredData(input: StructuredDataInput): StructuredDataOutput {\n    const data: Record<string, unknown> = {\n      '@context': 'https://schema.org',\n      '@type': input.type,\n      name: input.name,\n    }\n\n    if (input.description) {\n      data.description = input.description\n    }\n\n    if (input.url) {\n      data.url = input.url\n    }\n\n    if (input.image) {\n      data.image = input.image\n    }\n\n    if (input.datePublished) {\n      data.datePublished = input.datePublished\n    }\n\n    if (input.dateModified) {\n      data.dateModified = input.dateModified\n    }\n\n    // Author\n    if (input.author) {\n      data.author = {\n        '@type': input.author.type,\n        name: input.author.name,\n        ...(input.author.url ? { url: input.author.url } : {}),\n      }\n    }\n\n    // Publisher\n    if (input.publisher) {\n      const publisher: Record<string, unknown> = {\n        '@type': 'Organization',\n        name: input.publisher.name,\n      }\n      if (input.publisher.url) {\n        publisher.url = input.publisher.url\n      }\n      if (input.publisher.logo) {\n        publisher.logo = {\n          '@type': 'ImageObject',\n          url: input.publisher.logo,\n        }\n      }\n      data.publisher = publisher\n    }\n\n    // Breadcrumbs\n    if (input.breadcrumbs && input.breadcrumbs.length > 0) {\n      data['@type'] = 'BreadcrumbList'\n      data.itemListElement = input.breadcrumbs.map((crumb, index) => ({\n        '@type': 'ListItem',\n        position: index + 1,\n        name: crumb.name,\n        item: crumb.url,\n      }))\n    }\n\n    // FAQ\n    if (input.faq && input.faq.length > 0) {\n      data['@type'] = 'FAQPage'\n      data.mainEntity = input.faq.map((item) => ({\n        '@type': 'Question',\n        name: item.question,\n        acceptedAnswer: {\n          '@type': 'Answer',\n          text: item.answer,\n        },\n      }))\n    }\n\n    // Custom properties\n    if (input.custom) {\n      for (const [key, value] of Object.entries(input.custom)) {\n        if (key !== '@context' && key !== '@type') {\n          data[key] = value\n        }\n      }\n    }\n\n    const script = JSON.stringify(data)\n\n    return { script, data }\n  }\n\n  generateOpenGraph(input: OpenGraphInput): OpenGraphOutput {\n    const meta: MetaTag[] = []\n\n    // Required OG tags\n    meta.push({ property: 'og:title', content: input.title })\n    meta.push({ property: 'og:type', content: input.type ?? 'website' })\n\n    // Optional OG tags\n    if (input.description) {\n      meta.push({ property: 'og:description', content: input.description })\n    }\n\n    if (input.url) {\n      meta.push({ property: 'og:url', content: input.url })\n    }\n\n    if (input.image) {\n      meta.push({ property: 'og:image', content: input.image })\n      if (input.imageWidth) {\n        meta.push({ property: 'og:image:width', content: String(input.imageWidth) })\n      }\n      if (input.imageHeight) {\n        meta.push({ property: 'og:image:height', content: String(input.imageHeight) })\n      }\n      if (input.imageAlt) {\n        meta.push({ property: 'og:image:alt', content: input.imageAlt })\n      }\n    }\n\n    if (input.siteName) {\n      meta.push({ property: 'og:site_name', content: input.siteName })\n    }\n\n    if (input.locale) {\n      meta.push({ property: 'og:locale', content: input.locale })\n    }\n\n    if (input.localeAlternates) {\n      for (const alt of input.localeAlternates) {\n        meta.push({ property: 'og:locale:alternate', content: alt })\n      }\n    }\n\n    // Article-specific tags\n    if (input.article) {\n      if (input.article.publishedTime) {\n        meta.push({ property: 'article:published_time', content: input.article.publishedTime })\n      }\n      if (input.article.modifiedTime) {\n        meta.push({ property: 'article:modified_time', content: input.article.modifiedTime })\n      }\n      if (input.article.author) {\n        meta.push({ property: 'article:author', content: input.article.author })\n      }\n      if (input.article.section) {\n        meta.push({ property: 'article:section', content: input.article.section })\n      }\n      if (input.article.tags) {\n        for (const tag of input.article.tags) {\n          meta.push({ property: 'article:tag', content: tag })\n        }\n      }\n    }\n\n    // Twitter card\n    if (input.twitter) {\n      meta.push({ name: 'twitter:card', content: input.twitter.card ?? 'summary' })\n      if (input.twitter.site) {\n        meta.push({ name: 'twitter:site', content: input.twitter.site })\n      }\n      if (input.twitter.creator) {\n        meta.push({ name: 'twitter:creator', content: input.twitter.creator })\n      }\n    }\n\n    return { meta }\n  }\n\n  generateAll(config: SeoConfig): SeoOutput {\n    const output: {\n      metaTags: MetaTagOutput\n      structuredData?: StructuredDataOutput\n      openGraph?: OpenGraphOutput\n    } = {\n      metaTags: this.generateMetaTags(config.meta),\n    }\n\n    if (config.structuredData) {\n      output.structuredData = this.generateStructuredData(config.structuredData)\n    }\n\n    if (config.openGraph) {\n      output.openGraph = this.generateOpenGraph(config.openGraph)\n    }\n\n    return output\n  }\n}\n\n// ============================================================\n// DEFAULTS\n// ============================================================\n\ninterface SeoDefaults {\n  siteName: string\n  titleSeparator: string\n  defaultViewport: string\n  defaultCharset: string\n  defaultRobots: string\n}\n\n// ============================================================\n// FACTORY FUNCTION\n// ============================================================\n\n/**\n * Create an SEO capability instance\n */\nexport function createSeoCapability(defaults?: {\n  siteName?: string\n  titleSeparator?: string\n  defaultViewport?: string\n  defaultCharset?: string\n  defaultRobots?: string\n}): SeoCapability {\n  return new DefaultSeoCapability(defaults)\n}\n"]}

package/dist/seo/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SEO Capability Module
+ *
+ * Meta tag generation, structured data, and Open Graph tags
+ *
+ * Exports:
+ * - Types: MetaTagInput, StructuredDataInput, OpenGraphInput, SeoCapability, etc.
+ * - Implementations: DefaultSeoCapability
+ * - Factory functions: createSeoCapability
+ *
+ * @module @pwfabric/runtime/seo
+ */
+export type { MetaTag, MetaTagInput, MetaTagOutput, LinkTag, StructuredDataType, StructuredDataInput, PersonInput, OrganizationInput, BreadcrumbInput, FaqInput, StructuredDataOutput, OpenGraphType, OpenGraphInput, OpenGraphArticle, TwitterCardInput, OpenGraphOutput, SeoCapability, SeoConfig, SeoOutput, } from './types.js';
+export { DefaultSeoCapability, createSeoCapability } from './generator.js';

package/dist/seo/index.js

@@ -0,0 +1,15 @@
+/**
+ * SEO Capability Module
+ *
+ * Meta tag generation, structured data, and Open Graph tags
+ *
+ * Exports:
+ * - Types: MetaTagInput, StructuredDataInput, OpenGraphInput, SeoCapability, etc.
+ * - Implementations: DefaultSeoCapability
+ * - Factory functions: createSeoCapability
+ *
+ * @module @pwfabric/runtime/seo
+ */
+// Implementations
+export { DefaultSeoCapability, createSeoCapability } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/seo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/seo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAyBH,kBAAkB;AAClB,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA","sourcesContent":["/**\n * SEO Capability Module\n *\n * Meta tag generation, structured data, and Open Graph tags\n *\n * Exports:\n * - Types: MetaTagInput, StructuredDataInput, OpenGraphInput, SeoCapability, etc.\n * - Implementations: DefaultSeoCapability\n * - Factory functions: createSeoCapability\n *\n * @module @pwfabric/runtime/seo\n */\n\n// Types\nexport type {\n  MetaTag,\n  MetaTagInput,\n  MetaTagOutput,\n  LinkTag,\n  StructuredDataType,\n  StructuredDataInput,\n  PersonInput,\n  OrganizationInput,\n  BreadcrumbInput,\n  FaqInput,\n  StructuredDataOutput,\n  OpenGraphType,\n  OpenGraphInput,\n  OpenGraphArticle,\n  TwitterCardInput,\n  OpenGraphOutput,\n  SeoCapability,\n  SeoConfig,\n  SeoOutput,\n} from './types.js'\n\n// Implementations\nexport { DefaultSeoCapability, createSeoCapability } from './generator.js'\n"]}

package/dist/seo/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * SEO Capability Types
+ *
+ * Meta tag generation, structured data, and Open Graph tags
+ *
+ * @module @pwfabric/runtime/seo/types
+ */
+/**
+ * Meta tag definition
+ */
+export interface MetaTag {
+    readonly name?: string;
+    readonly property?: string;
+    readonly httpEquiv?: string;
+    readonly content: string;
+}
+/**
+ * Input for generating meta tags
+ */
+export interface MetaTagInput {
+    readonly title: string;
+    readonly description?: string;
+    readonly keywords?: readonly string[];
+    readonly author?: string;
+    readonly robots?: string;
+    readonly canonical?: string;
+    readonly viewport?: string;
+    readonly charset?: string;
+    readonly custom?: readonly MetaTag[];
+}
+/**
+ * Generated meta tag output (serializable for SSR)
+ */
+export interface MetaTagOutput {
+    readonly title: string;
+    readonly meta: readonly MetaTag[];
+    readonly link: readonly LinkTag[];
+}
+/**
+ * Link tag definition
+ */
+export interface LinkTag {
+    readonly rel: string;
+    readonly href: string;
+    readonly type?: string;
+    readonly hreflang?: string;
+}
+/**
+ * JSON-LD structured data type
+ */
+export type StructuredDataType = 'WebSite' | 'WebPage' | 'Article' | 'Organization' | 'Person' | 'BreadcrumbList' | 'FAQPage' | 'Product' | 'LocalBusiness' | string;
+/**
+ * Input for generating structured data
+ */
+export interface StructuredDataInput {
+    readonly type: StructuredDataType;
+    readonly name: string;
+    readonly description?: string;
+    readonly url?: string;
+    readonly image?: string | readonly string[];
+    readonly datePublished?: string;
+    readonly dateModified?: string;
+    readonly author?: PersonInput | OrganizationInput;
+    readonly publisher?: OrganizationInput;
+    readonly breadcrumbs?: readonly BreadcrumbInput[];
+    readonly faq?: readonly FaqInput[];
+    readonly custom?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Person input for structured data
+ */
+export interface PersonInput {
+    readonly type: 'Person';
+    readonly name: string;
+    readonly url?: string;
+}
+/**
+ * Organization input for structured data
+ */
+export interface OrganizationInput {
+    readonly type: 'Organization';
+    readonly name: string;
+    readonly url?: string;
+    readonly logo?: string;
+}
+/**
+ * Breadcrumb input
+ */
+export interface BreadcrumbInput {
+    readonly name: string;
+    readonly url: string;
+}
+/**
+ * FAQ input
+ */
+export interface FaqInput {
+    readonly question: string;
+    readonly answer: string;
+}
+/**
+ * Generated JSON-LD output (serializable)
+ */
+export interface StructuredDataOutput {
+    readonly script: string;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+/**
+ * Open Graph type
+ */
+export type OpenGraphType = 'website' | 'article' | 'profile' | 'video' | 'music' | string;
+/**
+ * Input for generating Open Graph tags
+ */
+export interface OpenGraphInput {
+    readonly title: string;
+    readonly description?: string;
+    readonly url?: string;
+    readonly image?: string;
+    readonly imageWidth?: number;
+    readonly imageHeight?: number;
+    readonly imageAlt?: string;
+    readonly type?: OpenGraphType;
+    readonly siteName?: string;
+    readonly locale?: string;
+    readonly localeAlternates?: readonly string[];
+    readonly article?: OpenGraphArticle;
+    readonly twitter?: TwitterCardInput;
+}
+/**
+ * Article-specific Open Graph data
+ */
+export interface OpenGraphArticle {
+    readonly publishedTime?: string;
+    readonly modifiedTime?: string;
+    readonly author?: string;
+    readonly section?: string;
+    readonly tags?: readonly string[];
+}
+/**
+ * Twitter card input
+ */
+export interface TwitterCardInput {
+    readonly card?: 'summary' | 'summary_large_image' | 'app' | 'player';
+    readonly site?: string;
+    readonly creator?: string;
+}
+/**
+ * Generated Open Graph output (serializable)
+ */
+export interface OpenGraphOutput {
+    readonly meta: readonly MetaTag[];
+}
+/**
+ * SEO capability interface for generating SEO-related markup
+ */
+export interface SeoCapability {
+    /** Generate meta tags from input */
+    generateMetaTags(input: MetaTagInput): MetaTagOutput;
+    /** Generate JSON-LD structured data */
+    generateStructuredData(input: StructuredDataInput): StructuredDataOutput;
+    /** Generate Open Graph (and Twitter card) tags */
+    generateOpenGraph(input: OpenGraphInput): OpenGraphOutput;
+    /** Combine all SEO outputs into a single serializable object */
+    generateAll(config: SeoConfig): SeoOutput;
+}
+/**
+ * Combined SEO configuration
+ */
+export interface SeoConfig {
+    readonly meta: MetaTagInput;
+    readonly structuredData?: StructuredDataInput;
+    readonly openGraph?: OpenGraphInput;
+}
+/**
+ * Combined SEO output (serializable for SSR)
+ */
+export interface SeoOutput {
+    readonly metaTags: MetaTagOutput;
+    readonly structuredData?: StructuredDataOutput;
+    readonly openGraph?: OpenGraphOutput;
+}

package/dist/seo/types.js

@@ -0,0 +1,9 @@
+/**
+ * SEO Capability Types
+ *
+ * Meta tag generation, structured data, and Open Graph tags
+ *
+ * @module @pwfabric/runtime/seo/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/seo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/seo/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG","sourcesContent":["/**\n * SEO Capability Types\n *\n * Meta tag generation, structured data, and Open Graph tags\n *\n * @module @pwfabric/runtime/seo/types\n */\n\n// ============================================================\n// META TAGS\n// ============================================================\n\n/**\n * Meta tag definition\n */\nexport interface MetaTag {\n  readonly name?: string\n  readonly property?: string\n  readonly httpEquiv?: string\n  readonly content: string\n}\n\n/**\n * Input for generating meta tags\n */\nexport interface MetaTagInput {\n  readonly title: string\n  readonly description?: string\n  readonly keywords?: readonly string[]\n  readonly author?: string\n  readonly robots?: string\n  readonly canonical?: string\n  readonly viewport?: string\n  readonly charset?: string\n  readonly custom?: readonly MetaTag[]\n}\n\n/**\n * Generated meta tag output (serializable for SSR)\n */\nexport interface MetaTagOutput {\n  readonly title: string\n  readonly meta: readonly MetaTag[]\n  readonly link: readonly LinkTag[]\n}\n\n/**\n * Link tag definition\n */\nexport interface LinkTag {\n  readonly rel: string\n  readonly href: string\n  readonly type?: string\n  readonly hreflang?: string\n}\n\n// ============================================================\n// STRUCTURED DATA (JSON-LD)\n// ============================================================\n\n/**\n * JSON-LD structured data type\n */\nexport type StructuredDataType =\n  | 'WebSite'\n  | 'WebPage'\n  | 'Article'\n  | 'Organization'\n  | 'Person'\n  | 'BreadcrumbList'\n  | 'FAQPage'\n  | 'Product'\n  | 'LocalBusiness'\n  | string\n\n/**\n * Input for generating structured data\n */\nexport interface StructuredDataInput {\n  readonly type: StructuredDataType\n  readonly name: string\n  readonly description?: string\n  readonly url?: string\n  readonly image?: string | readonly string[]\n  readonly datePublished?: string\n  readonly dateModified?: string\n  readonly author?: PersonInput | OrganizationInput\n  readonly publisher?: OrganizationInput\n  readonly breadcrumbs?: readonly BreadcrumbInput[]\n  readonly faq?: readonly FaqInput[]\n  readonly custom?: Readonly<Record<string, unknown>>\n}\n\n/**\n * Person input for structured data\n */\nexport interface PersonInput {\n  readonly type: 'Person'\n  readonly name: string\n  readonly url?: string\n}\n\n/**\n * Organization input for structured data\n */\nexport interface OrganizationInput {\n  readonly type: 'Organization'\n  readonly name: string\n  readonly url?: string\n  readonly logo?: string\n}\n\n/**\n * Breadcrumb input\n */\nexport interface BreadcrumbInput {\n  readonly name: string\n  readonly url: string\n}\n\n/**\n * FAQ input\n */\nexport interface FaqInput {\n  readonly question: string\n  readonly answer: string\n}\n\n/**\n * Generated JSON-LD output (serializable)\n */\nexport interface StructuredDataOutput {\n  readonly script: string\n  readonly data: Readonly<Record<string, unknown>>\n}\n\n// ============================================================\n// OPEN GRAPH\n// ============================================================\n\n/**\n * Open Graph type\n */\nexport type OpenGraphType = 'website' | 'article' | 'profile' | 'video' | 'music' | string\n\n/**\n * Input for generating Open Graph tags\n */\nexport interface OpenGraphInput {\n  readonly title: string\n  readonly description?: string\n  readonly url?: string\n  readonly image?: string\n  readonly imageWidth?: number\n  readonly imageHeight?: number\n  readonly imageAlt?: string\n  readonly type?: OpenGraphType\n  readonly siteName?: string\n  readonly locale?: string\n  readonly localeAlternates?: readonly string[]\n  readonly article?: OpenGraphArticle\n  readonly twitter?: TwitterCardInput\n}\n\n/**\n * Article-specific Open Graph data\n */\nexport interface OpenGraphArticle {\n  readonly publishedTime?: string\n  readonly modifiedTime?: string\n  readonly author?: string\n  readonly section?: string\n  readonly tags?: readonly string[]\n}\n\n/**\n * Twitter card input\n */\nexport interface TwitterCardInput {\n  readonly card?: 'summary' | 'summary_large_image' | 'app' | 'player'\n  readonly site?: string\n  readonly creator?: string\n}\n\n/**\n * Generated Open Graph output (serializable)\n */\nexport interface OpenGraphOutput {\n  readonly meta: readonly MetaTag[]\n}\n\n// ============================================================\n// SEO CAPABILITY INTERFACE\n// ============================================================\n\n/**\n * SEO capability interface for generating SEO-related markup\n */\nexport interface SeoCapability {\n  /** Generate meta tags from input */\n  generateMetaTags(input: MetaTagInput): MetaTagOutput\n\n  /** Generate JSON-LD structured data */\n  generateStructuredData(input: StructuredDataInput): StructuredDataOutput\n\n  /** Generate Open Graph (and Twitter card) tags */\n  generateOpenGraph(input: OpenGraphInput): OpenGraphOutput\n\n  /** Combine all SEO outputs into a single serializable object */\n  generateAll(config: SeoConfig): SeoOutput\n}\n\n/**\n * Combined SEO configuration\n */\nexport interface SeoConfig {\n  readonly meta: MetaTagInput\n  readonly structuredData?: StructuredDataInput\n  readonly openGraph?: OpenGraphInput\n}\n\n/**\n * Combined SEO output (serializable for SSR)\n */\nexport interface SeoOutput {\n  readonly metaTags: MetaTagOutput\n  readonly structuredData?: StructuredDataOutput\n  readonly openGraph?: OpenGraphOutput\n}\n"]}

package/dist/state/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * State Management Module
+ *
+ * State management capability for surfaces
+ *
+ * Exports:
+ * - Types: StateStore, SurfaceStateManager, StateChangeEvent, etc.
+ * - Implementations: InMemoryStateStore, DefaultSurfaceStateManager
+ * - Factory functions: createStateStore, createSurfaceStateManager
+ *
+ * @module @pwfabric/runtime/state
+ */
+export type { StateStore, SurfaceStateManager, StateChangeEvent, StateChangeListener, StateStoreConfig, StateHistoryEntry, } from './types.js';
+export { InMemoryStateStore, createStateStore } from './store.js';
+export { DefaultSurfaceStateManager, createSurfaceStateManager } from './manager.js';

package/dist/state/index.js

@@ -0,0 +1,16 @@
+/**
+ * State Management Module
+ *
+ * State management capability for surfaces
+ *
+ * Exports:
+ * - Types: StateStore, SurfaceStateManager, StateChangeEvent, etc.
+ * - Implementations: InMemoryStateStore, DefaultSurfaceStateManager
+ * - Factory functions: createStateStore, createSurfaceStateManager
+ *
+ * @module @pwfabric/runtime/state
+ */
+// Implementations
+export { InMemoryStateStore, createStateStore } from './store.js';
+export { DefaultSurfaceStateManager, createSurfaceStateManager } from './manager.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA","sourcesContent":["/**\n * State Management Module\n *\n * State management capability for surfaces\n *\n * Exports:\n * - Types: StateStore, SurfaceStateManager, StateChangeEvent, etc.\n * - Implementations: InMemoryStateStore, DefaultSurfaceStateManager\n * - Factory functions: createStateStore, createSurfaceStateManager\n *\n * @module @pwfabric/runtime/state\n */\n\n// Types\nexport type {\n  StateStore,\n  SurfaceStateManager,\n  StateChangeEvent,\n  StateChangeListener,\n  StateStoreConfig,\n  StateHistoryEntry,\n} from './types.js'\n\n// Implementations\nexport { InMemoryStateStore, createStateStore } from './store.js'\nexport { DefaultSurfaceStateManager, createSurfaceStateManager } from './manager.js'\n"]}

package/dist/state/manager.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Surface State Manager
+ *
+ * Manager for surface-scoped state stores
+ *
+ * @module @pwfabric/runtime/state/manager
+ */
+import type { SurfaceStateManager, StateStore, StateStoreConfig } from './types.js';
+/**
+ * Default implementation of SurfaceStateManager
+ * Manages multiple state stores, one per surface
+ */
+export declare class DefaultSurfaceStateManager implements SurfaceStateManager {
+    private readonly stores;
+    private readonly defaultConfig;
+    constructor(defaultConfig?: StateStoreConfig);
+    createStore<T>(surfaceId: string, initialState: T): StateStore<T>;
+    getStore<T>(surfaceId: string): StateStore<T> | undefined;
+    hasStore(surfaceId: string): boolean;
+    destroyStore(surfaceId: string): void;
+    destroyAll(): void;
+    getSurfaceIds(): string[];
+    /**
+     * Get or create a store for a surface
+     * Creates a new store with empty initial state if it doesn't exist
+     */
+    getOrCreateStore<T>(surfaceId: string, initialState?: T): StateStore<T>;
+    private normalizeInitialState;
+}
+/**
+ * Create a surface state manager
+ */
+export declare function createSurfaceStateManager(config?: StateStoreConfig): SurfaceStateManager;

package/dist/state/manager.js

@@ -0,0 +1,81 @@
+/**
+ * Surface State Manager
+ *
+ * Manager for surface-scoped state stores
+ *
+ * @module @pwfabric/runtime/state/manager
+ */
+import { InMemoryStateStore } from './store.js';
+// ============================================================
+// DEFAULT SURFACE STATE MANAGER
+// ============================================================
+/**
+ * Default implementation of SurfaceStateManager
+ * Manages multiple state stores, one per surface
+ */
+export class DefaultSurfaceStateManager {
+    stores = new Map();
+    defaultConfig;
+    constructor(defaultConfig = {}) {
+        this.defaultConfig = defaultConfig;
+    }
+    createStore(surfaceId, initialState) {
+        // If store already exists, throw error to prevent accidental overwrites
+        if (this.stores.has(surfaceId)) {
+            throw new Error(`State store already exists for surface: ${surfaceId}`);
+        }
+        // Convert single value initialState to object format if needed
+        const stateObject = this.normalizeInitialState(initialState);
+        const store = new InMemoryStateStore(stateObject, this.defaultConfig);
+        this.stores.set(surfaceId, store);
+        return store;
+    }
+    getStore(surfaceId) {
+        return this.stores.get(surfaceId);
+    }
+    hasStore(surfaceId) {
+        return this.stores.has(surfaceId);
+    }
+    destroyStore(surfaceId) {
+        const store = this.stores.get(surfaceId);
+        if (store) {
+            store.clear();
+            this.stores.delete(surfaceId);
+        }
+    }
+    destroyAll() {
+        for (const store of this.stores.values()) {
+            store.clear();
+        }
+        this.stores.clear();
+    }
+    getSurfaceIds() {
+        return Array.from(this.stores.keys());
+    }
+    /**
+     * Get or create a store for a surface
+     * Creates a new store with empty initial state if it doesn't exist
+     */
+    getOrCreateStore(surfaceId, initialState) {
+        const existing = this.getStore(surfaceId);
+        if (existing) {
+            return existing;
+        }
+        return this.createStore(surfaceId, initialState ?? {});
+    }
+    normalizeInitialState(initialState) {
+        // If already an object (but not null/array), use it directly
+        if (initialState !== null && typeof initialState === 'object' && !Array.isArray(initialState)) {
+            return initialState;
+        }
+        // Otherwise, wrap in a 'value' key
+        return { value: initialState };
+    }
+}
+/**
+ * Create a surface state manager
+ */
+export function createSurfaceStateManager(config) {
+    return new DefaultSurfaceStateManager(config);
+}
+//# sourceMappingURL=manager.js.map