@ahtmljs/next 0.1.0

package/dist/extractors/data-attrs.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Extract entities and actions from inline `data-ahtml-*` attributes.
+ *
+ * This is the Level-1 adoption path: zero tooling change, just sprinkle
+ * data attributes on your existing markup.
+ *
+ *   <article
+ *     data-ahtml="product"
+ *     data-ahtml-id="product:mbp-14"
+ *     data-ahtml-name="MacBook Pro 14"
+ *     data-ahtml-price="1999 USD"
+ *     data-ahtml-stock="in_stock (42)"
+ *   >
+ *     ...
+ *     <button
+ *       data-ahtml-action="purchase"
+ *       data-ahtml-action-auth="required"
+ *       data-ahtml-action-cost="1999 USD purchase"
+ *       data-ahtml-action-reversible="P30D full_refund"
+ *       data-ahtml-action-target="product:mbp-14"
+ *     >Buy now</button>
+ *   </article>
+ */
+import type { Extraction } from './merge.js';
+export declare function extractFromDataAttrs(html: string): Extraction;
+//# sourceMappingURL=data-attrs.d.ts.map

package/dist/extractors/data-attrs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-attrs.d.ts","sourceRoot":"","sources":["../../src/extractors/data-attrs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAiB7D"}

package/dist/extractors/data-attrs.js

@@ -0,0 +1,163 @@
+/**
+ * Extract entities and actions from inline `data-ahtml-*` attributes.
+ *
+ * This is the Level-1 adoption path: zero tooling change, just sprinkle
+ * data attributes on your existing markup.
+ *
+ *   <article
+ *     data-ahtml="product"
+ *     data-ahtml-id="product:mbp-14"
+ *     data-ahtml-name="MacBook Pro 14"
+ *     data-ahtml-price="1999 USD"
+ *     data-ahtml-stock="in_stock (42)"
+ *   >
+ *     ...
+ *     <button
+ *       data-ahtml-action="purchase"
+ *       data-ahtml-action-auth="required"
+ *       data-ahtml-action-cost="1999 USD purchase"
+ *       data-ahtml-action-reversible="P30D full_refund"
+ *       data-ahtml-action-target="product:mbp-14"
+ *     >Buy now</button>
+ *   </article>
+ */
+export function extractFromDataAttrs(html) {
+    const entities = [];
+    const actions = [];
+    // Naive element scan — sufficient for plugin's compile-time pass.
+    // For runtime DOM, callers should use the agent-side parser.
+    const elementRe = /<(\w+)\b([^>]*?data-ahtml(?:-[\w-]+)?=[^>]*)>/gi;
+    let m;
+    while ((m = elementRe.exec(html)) !== null) {
+        const attrs = parseAttrs(m[2]);
+        const ent = entityFromAttrs(attrs);
+        if (ent)
+            entities.push(ent);
+        const act = actionFromAttrs(attrs);
+        if (act)
+            actions.push(act);
+    }
+    return { source: 'data-attrs', entities, actions };
+}
+function entityFromAttrs(attrs) {
+    const type = attrs['data-ahtml'];
+    if (!type)
+        return null;
+    const id = attrs['data-ahtml-id'] ?? `${type}:${slug(attrs['data-ahtml-name'] ?? type)}`;
+    if (type === 'product') {
+        const p = { id, type: 'product', name: attrs['data-ahtml-name'] ?? '' };
+        if (attrs['data-ahtml-brand'])
+            p.brand = attrs['data-ahtml-brand'];
+        if (attrs['data-ahtml-description'])
+            p.description = attrs['data-ahtml-description'];
+        const price = parseMoney(attrs['data-ahtml-price']);
+        if (price)
+            p.price = price;
+        const stock = parseStock(attrs['data-ahtml-stock']);
+        if (stock)
+            p.stock = stock;
+        if (attrs['data-ahtml-sku'])
+            p.sku = attrs['data-ahtml-sku'];
+        return p;
+    }
+    if (type === 'document' || type === 'article') {
+        const d = {
+            id,
+            type: 'document',
+            title: attrs['data-ahtml-title'] ?? attrs['data-ahtml-name'] ?? '',
+        };
+        if (attrs['data-ahtml-author'])
+            d.author = attrs['data-ahtml-author'];
+        if (attrs['data-ahtml-published'])
+            d.published_at = attrs['data-ahtml-published'];
+        if (attrs['data-ahtml-summary'])
+            d.summary = attrs['data-ahtml-summary'];
+        return d;
+    }
+    if (type === 'task') {
+        const t = {
+            id,
+            type: 'task',
+            title: attrs['data-ahtml-title'] ?? attrs['data-ahtml-name'] ?? '',
+            state: (attrs['data-ahtml-state'] ?? 'open'),
+        };
+        if (attrs['data-ahtml-priority'])
+            t.priority = attrs['data-ahtml-priority'];
+        if (attrs['data-ahtml-assignee'])
+            t.assignee = attrs['data-ahtml-assignee'];
+        return t;
+    }
+    return null;
+}
+function actionFromAttrs(attrs) {
+    const id = attrs['data-ahtml-action'];
+    if (!id)
+        return null;
+    const a = { id };
+    if (attrs['data-ahtml-action-target'])
+        a.target = attrs['data-ahtml-action-target'];
+    const auth = attrs['data-ahtml-action-auth'];
+    if (auth)
+        a.auth = auth;
+    const cost = attrs['data-ahtml-action-cost'];
+    if (cost) {
+        const m = cost.match(/^([\d.]+)\s+(\w+)\s+(\w+)$/);
+        if (m)
+            a.cost = { amount: parseFloat(m[1]), currency: m[2], category: m[3] };
+    }
+    const rev = attrs['data-ahtml-action-reversible'];
+    if (rev) {
+        if (rev === 'no')
+            a.reversible = { reversible: false };
+        else {
+            const [w, ...rest] = rev.split(/\s+/);
+            a.reversible = { reversible: true, window: w, policy: rest.join(' ') || undefined };
+        }
+    }
+    const se = attrs['data-ahtml-action-side-effects'];
+    if (se)
+        a.side_effects = se.split(',').map((s) => s.trim());
+    const conf = attrs['data-ahtml-action-confirmation'];
+    if (conf)
+        a.confirmation = conf;
+    const method = attrs['data-ahtml-action-method'];
+    if (method)
+        a.method = method;
+    const exec = attrs['data-ahtml-action-execute'];
+    if (exec)
+        a.execute_url = exec;
+    return a;
+}
+function parseAttrs(s) {
+    const r = {};
+    const re = /(\w[\w-]*)\s*=\s*("([^"]*)"|'([^']*)'|(\S+))/g;
+    let m;
+    while ((m = re.exec(s)) !== null) {
+        r[m[1].toLowerCase()] = m[3] ?? m[4] ?? m[5] ?? '';
+    }
+    return r;
+}
+function parseMoney(s) {
+    if (!s)
+        return null;
+    const m = s.match(/^([\d.]+)\s+(\w+)$/);
+    return m ? { amount: parseFloat(m[1]), currency: m[2] } : null;
+}
+function parseStock(s) {
+    if (!s)
+        return null;
+    const m = s.match(/^(\w+)\s*(?:\((\d+)\))?$/);
+    if (!m)
+        return null;
+    return m[2]
+        ? { status: m[1], quantity: parseInt(m[2], 10) }
+        : { status: m[1] };
+}
+function slug(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'unknown';
+}
+//# sourceMappingURL=data-attrs.js.map

package/dist/extractors/data-attrs.js.map

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

package/dist/extractors/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Auto-extractors.
+ *
+ * Run a developer's existing HTML through these to produce a Level-0
+ * snapshot with no annotation work. Combined output of multiple
+ * extractors wins by precedence: data-attrs > schema.org > OpenGraph.
+ */
+export { extractFromSchemaOrg } from './schema-org.js';
+export { extractFromOpenGraph } from './opengraph.js';
+export { extractFromDataAttrs } from './data-attrs.js';
+export { mergeExtractions, type Extraction } from './merge.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/extractors/index.js

@@ -0,0 +1,12 @@
+/**
+ * Auto-extractors.
+ *
+ * Run a developer's existing HTML through these to produce a Level-0
+ * snapshot with no annotation work. Combined output of multiple
+ * extractors wins by precedence: data-attrs > schema.org > OpenGraph.
+ */
+export { extractFromSchemaOrg } from './schema-org.js';
+export { extractFromOpenGraph } from './opengraph.js';
+export { extractFromDataAttrs } from './data-attrs.js';
+export { mergeExtractions } from './merge.js';
+//# sourceMappingURL=index.js.map

package/dist/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/extractors/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,YAAY,CAAC"}

package/dist/extractors/merge.d.ts

@@ -0,0 +1,13 @@
+import type { Entity, Action } from '@ahtmljs/schema';
+export interface Extraction {
+    source: 'data-attrs' | 'schema-org' | 'opengraph' | 'route-metadata';
+    page_type?: string;
+    entities: Entity[];
+    actions: Action[];
+}
+/**
+ * Merge extractions in precedence order. Earlier entries override later ones
+ * on conflict (so pass data-attrs FIRST, opengraph LAST).
+ */
+export declare function mergeExtractions(extractions: Extraction[]): Extraction;
+//# sourceMappingURL=merge.d.ts.map

package/dist/extractors/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/extractors/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAkBtE"}

package/dist/extractors/merge.js

@@ -0,0 +1,25 @@
+/**
+ * Merge extractions in precedence order. Earlier entries override later ones
+ * on conflict (so pass data-attrs FIRST, opengraph LAST).
+ */
+export function mergeExtractions(extractions) {
+    const merged = { source: 'data-attrs', entities: [], actions: [] };
+    const entityById = new Map();
+    const actionById = new Map();
+    for (const ex of extractions) {
+        if (!merged.page_type && ex.page_type)
+            merged.page_type = ex.page_type;
+        for (const e of ex.entities) {
+            const prev = entityById.get(e.id);
+            entityById.set(e.id, prev ? { ...e, ...prev } : e);
+        }
+        for (const a of ex.actions) {
+            const prev = actionById.get(a.id);
+            actionById.set(a.id, prev ? { ...a, ...prev } : a);
+        }
+    }
+    merged.entities = [...entityById.values()];
+    merged.actions = [...actionById.values()];
+    return merged;
+}
+//# sourceMappingURL=merge.js.map

package/dist/extractors/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../src/extractors/merge.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAyB;IACxD,MAAM,MAAM,GAAe,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/E,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,CAAC;QACvE,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,EAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAE,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,EAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IACD,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/extractors/opengraph.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Extract a fallback entity from OpenGraph + Twitter card meta tags.
+ * Lower-precedence than schema.org, but covers sites that only ship OG.
+ */
+import type { Extraction } from './merge.js';
+export declare function extractFromOpenGraph(html: string): Extraction;
+//# sourceMappingURL=opengraph.d.ts.map

package/dist/extractors/opengraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opengraph.d.ts","sourceRoot":"","sources":["../../src/extractors/opengraph.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CA4C7D"}

package/dist/extractors/opengraph.js

@@ -0,0 +1,89 @@
+/**
+ * Extract a fallback entity from OpenGraph + Twitter card meta tags.
+ * Lower-precedence than schema.org, but covers sites that only ship OG.
+ */
+export function extractFromOpenGraph(html) {
+    const meta = readMeta(html);
+    if (!meta.size)
+        return { source: 'opengraph', entities: [], actions: [] };
+    const ogType = meta.get('og:type') ?? 'website';
+    const title = meta.get('og:title') ?? meta.get('twitter:title') ?? '';
+    const description = meta.get('og:description') ?? meta.get('twitter:description') ?? '';
+    const url = meta.get('og:url') ?? '';
+    const image = meta.get('og:image') ?? meta.get('twitter:image');
+    const entities = [];
+    if (ogType === 'product') {
+        const price = meta.get('product:price:amount') ?? meta.get('og:price:amount');
+        const currency = meta.get('product:price:currency') ?? meta.get('og:price:currency') ?? 'USD';
+        const id = `product:${slug(title || url)}`;
+        const p = { id, type: 'product', name: title || 'product' };
+        if (description)
+            p.description = description;
+        if (price)
+            p.price = { amount: Number(price), currency };
+        if (image)
+            p.images = [{ url: image }];
+        entities.push(p);
+    }
+    else if (ogType === 'article' || ogType.startsWith('article')) {
+        const d = {
+            id: `document:${slug(title || url)}`,
+            type: 'document',
+            title: title || 'untitled',
+        };
+        if (description)
+            d.summary = description;
+        if (meta.get('article:published_time'))
+            d.published_at = meta.get('article:published_time');
+        if (meta.get('article:modified_time'))
+            d.modified_at = meta.get('article:modified_time');
+        if (meta.get('article:author'))
+            d.author = meta.get('article:author');
+        if (url)
+            d.canonical_url = url;
+        entities.push(d);
+    }
+    else if (title) {
+        const d = {
+            id: `document:${slug(title)}`,
+            type: 'document',
+            title,
+        };
+        if (description)
+            d.summary = description;
+        if (url)
+            d.canonical_url = url;
+        entities.push(d);
+    }
+    return { source: 'opengraph', entities, actions: [] };
+}
+function readMeta(html) {
+    const out = new Map();
+    const re = /<meta\s+([^>]+?)\/?\s*>/gi;
+    let m;
+    while ((m = re.exec(html)) !== null) {
+        const attrs = parseAttrs(m[1]);
+        const key = attrs.property ?? attrs.name;
+        const value = attrs.content;
+        if (key && value !== undefined)
+            out.set(key.toLowerCase(), value);
+    }
+    return out;
+}
+function parseAttrs(s) {
+    const r = {};
+    const re = /(\w[\w:-]*)\s*=\s*("([^"]*)"|'([^']*)'|(\S+))/g;
+    let m;
+    while ((m = re.exec(s)) !== null) {
+        r[m[1].toLowerCase()] = m[3] ?? m[4] ?? m[5] ?? '';
+    }
+    return r;
+}
+function slug(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'unknown';
+}
+//# sourceMappingURL=opengraph.js.map

package/dist/extractors/opengraph.js.map

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

package/dist/extractors/schema-org.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extract entities from inline schema.org JSON-LD blocks.
+ *
+ * If a site already publishes JSON-LD (most e-commerce, news, recipes do),
+ * we get a free Level-0 AHTML snapshot with zero developer work.
+ */
+import type { Extraction } from './merge.js';
+export declare function extractFromSchemaOrg(html: string): Extraction;
+//# sourceMappingURL=schema-org.d.ts.map

package/dist/extractors/schema-org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-org.d.ts","sourceRoot":"","sources":["../../src/extractors/schema-org.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAY7D"}

package/dist/extractors/schema-org.js

@@ -0,0 +1,104 @@
+/**
+ * Extract entities from inline schema.org JSON-LD blocks.
+ *
+ * If a site already publishes JSON-LD (most e-commerce, news, recipes do),
+ * we get a free Level-0 AHTML snapshot with zero developer work.
+ */
+export function extractFromSchemaOrg(html) {
+    const entities = [];
+    const blocks = matchAll(html, /<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi);
+    for (const block of blocks) {
+        try {
+            const data = JSON.parse(block);
+            visit(data, entities);
+        }
+        catch {
+            // skip malformed blocks
+        }
+    }
+    return { source: 'schema-org', entities, actions: [] };
+}
+function visit(node, out) {
+    if (!node || typeof node !== 'object')
+        return;
+    if (Array.isArray(node)) {
+        for (const n of node)
+            visit(n, out);
+        return;
+    }
+    const obj = node;
+    const type = obj['@type'];
+    if (type === 'Product' || type === 'IndividualProduct' || type === 'ProductModel') {
+        const name = String(obj.name ?? '');
+        const id = `product:${slug(name)}`;
+        const p = {
+            id,
+            type: 'product',
+            name,
+            ...(typeof obj.brand === 'object' && obj.brand && { brand: String(obj.brand.name ?? '') }),
+            ...(typeof obj.description === 'string' && { description: obj.description }),
+            ...(typeof obj.sku === 'string' && { sku: obj.sku }),
+        };
+        const offers = obj.offers;
+        if (offers) {
+            const offer = Array.isArray(offers) ? offers[0] : offers;
+            if (offer) {
+                if (offer.price !== undefined && offer.priceCurrency) {
+                    p.price = { amount: Number(offer.price), currency: String(offer.priceCurrency) };
+                }
+                const avail = String(offer.availability ?? '').toLowerCase();
+                if (avail.includes('instock'))
+                    p.stock = { status: 'in_stock' };
+                else if (avail.includes('outofstock'))
+                    p.stock = { status: 'out_of_stock' };
+                else if (avail.includes('preorder'))
+                    p.stock = { status: 'preorder' };
+            }
+        }
+        const rating = obj.aggregateRating;
+        if (rating) {
+            p.rating = {
+                average: Number(rating.ratingValue ?? 0),
+                count: Number(rating.reviewCount ?? rating.ratingCount ?? 0),
+            };
+        }
+        out.push(p);
+    }
+    else if (type === 'Article' || type === 'BlogPosting' || type === 'NewsArticle') {
+        const title = String(obj.headline ?? obj.name ?? '');
+        const d = {
+            id: `document:${slug(title)}`,
+            type: 'document',
+            title,
+            ...(typeof obj.datePublished === 'string' && { published_at: obj.datePublished }),
+            ...(typeof obj.dateModified === 'string' && { modified_at: obj.dateModified }),
+            ...(typeof obj.description === 'string' && { summary: obj.description }),
+            ...(typeof obj.articleBody === 'string' && { content: obj.articleBody }),
+            ...(typeof obj.inLanguage === 'string' && { language: obj.inLanguage }),
+        };
+        const author = obj.author;
+        if (typeof author === 'object' && author)
+            d.author = String(author.name ?? '');
+        else if (typeof author === 'string')
+            d.author = author;
+        out.push(d);
+    }
+    // Recurse into nested arrays/objects so we catch deep entities
+    for (const v of Object.values(obj))
+        visit(v, out);
+}
+function matchAll(s, re) {
+    const r = [];
+    let m;
+    while ((m = re.exec(s)) !== null)
+        r.push(m[1]);
+    return r;
+}
+function slug(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64) || 'unknown';
+}
+//# sourceMappingURL=schema-org.js.map

package/dist/extractors/schema-org.js.map

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

package/dist/handler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Per-route snapshot handler factory.
+ *
+ * Usage in a Next.js App Router project:
+ *
+ *   // app/ahtml/[...path]/route.ts
+ *   import { createAHTMLRoute } from '@ahtmljs/next/handler';
+ *   import { buildSnapshotForPath } from '../../lib/ahtml';
+ *   export const { GET, HEAD } = createAHTMLRoute(buildSnapshotForPath);
+ *
+ * The handler supports:
+ *   - Content negotiation:
+ *       Accept: application/ahtml+json   → canonical JSON
+ *       Accept: application/ahtml+text   → token-optimal compact text  (default)
+ *   - Conditional GET via If-None-Match → 304
+ *   - Diff endpoint via ?since=<etag>   → SnapshotDiff
+ *   - ETag, Cache-Control, Last-Modified headers
+ *   - Optional policy enforcement (rate limit / auth gate)
+ */
+import { type Snapshot } from '@ahtmljs/schema';
+import { type AHTMLConfig } from './index.js';
+export type SnapshotBuilder = (pathSegments: string[], req: Request) => Promise<Snapshot | null> | Snapshot | null;
+export declare function setSnapshotCache(impl: {
+    get(key: string): Snapshot | undefined;
+    set(key: string, s: Snapshot): void;
+}): void;
+export declare function createAHTMLRoute(builder: SnapshotBuilder, configOverride?: AHTMLConfig): {
+    GET: (req: Request, ctx: {
+        params: Promise<{
+            path?: string[];
+        }> | {
+            path?: string[];
+        };
+    }) => Promise<Response>;
+    HEAD: (req: Request, ctx: {
+        params: Promise<{
+            path?: string[];
+        }> | {
+            path?: string[];
+        };
+    }) => Promise<Response>;
+};
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,MAAM,eAAe,GAAG,CAC5B,YAAY,EAAE,MAAM,EAAE,EACtB,GAAG,EAAE,OAAO,KACT,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;AAQhD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAG5H;AAWD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,EAAE,WAAW;eAC7D,OAAO,OAAO;QAAE,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO,CAAC,QAAQ,CAAC;gBAwE/F,OAAO,OAAO;QAAE,MAAM,EAAE,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,GAAG;YAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,KAAG,OAAO,CAAC,QAAQ,CAAC;EAM1H"}