@kamod-ch/otok-seo 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kamod
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# @kamod-ch/otok-seo
+
+Typed route metadata, sitemaps, feeds, and SEO helpers for [Otok](https://github.com/kamod-ch/otok).
+
+## Install
+
+```bash
+pnpm add @kamod-ch/otok-seo hono @kamod-ch/otok
+```
+
+## Plugin setup
+
+```ts
+import { defineConfig } from "@kamod-ch/otok";
+import seo from "@kamod-ch/otok-seo";
+
+export default defineConfig({
+  plugins: [
+    seo({
+      origin: "https://example.com",
+      titleTemplate: "%s | Example",
+      siteName: "Example",
+      sitemapPaths: ["/", "/about", "/products"],
+      robots: true,
+      icons: [{ href: "/favicon.ico" }],
+      manifest: { href: "/site.webmanifest" },
+    }),
+  ],
+});
+```
+
+Serves `/robots.txt` and `/sitemap.xml` automatically. With `@kamod-ch/otok-i18n`, sitemaps include hreflang alternates.
+
+## Route metadata
+
+```ts
+import { defineMeta } from "@kamod-ch/otok-seo";
+
+export const head = defineMeta(({ data, locale }) => ({
+  title: data.product.name,
+  description: data.product.description,
+  canonical: `/products/${data.product.slug}`,
+  lang: locale,
+  openGraph: { type: "product" },
+  twitter: { card: "summary_large_image" },
+  jsonLd: {
+    "@context": "https://schema.org",
+    "@type": "Product",
+    name: data.product.name,
+  },
+}));
+```
+
+## i18n integration
+
+```ts
+import { seoI18nHead } from "@kamod-ch/otok-seo";
+
+export async function head({ data, params }) {
+  return seoI18nHead({
+    locale: data.locale,
+    locales: ["de", "en"],
+    defaultLocale: "de",
+    origin: "https://example.com",
+    pathname: `/products/${params.slug}`,
+    meta: {
+      title: data.product.name,
+      description: data.product.description,
+    },
+  });
+}
+```
+
+## Feeds
+
+```ts
+seo({
+  origin: "https://example.com",
+  rss: {
+    path: "/feed.xml",
+    title: "Blog",
+    items: () => loadPosts(),
+  },
+});
+```
+
+## Dynamic OG images
+
+```ts
+seo({
+  origin: "https://example.com",
+  ogImage: ({ route, title }) => `/api/og?route=${encodeURIComponent(route)}&title=${encodeURIComponent(title ?? "")}`,
+});
+```
+
+## Middleware order
+
+Register `seo()` after `i18n()` so locale is available in loaders and OG hooks. Security middleware from `@kamod-ch/otok-security` should run before SEO utility routes.
+
+## API
+
+| Export | Purpose |
+|--------|---------|
+| `defineMeta` / `meta` | Typed route `head` factory |
+| `resolveMetaToHead` | Convert `RouteMeta` → `OtokHead` |
+| `seoI18nHead` | Merge metadata with i18n hreflang |
+| `createSitemapEntries` / `renderSitemapXml` | Sitemap helpers |
+| `renderRobotsTxt` | robots.txt renderer |
+| `renderRssFeed` / `renderAtomFeed` | Feed renderers |
+| `defineLoader` | Loader with `seo.origin` / locale |

package/dist/define-meta.d.ts

@@ -0,0 +1,23 @@
+import type { LoaderResult, OtokHead, OtokPageProps } from "@kamod-ch/otok/server";
+import { type ResolveMetaOptions } from "./resolve.js";
+import type { MetaContext, RouteMeta } from "./types.js";
+export interface DefineMetaOptions extends ResolveMetaOptions {
+    /** Resolve locale from loader data or Hono context. */
+    getLocale?: (ctx: MetaContext) => string | undefined;
+}
+/**
+ * Define typed route metadata that resolves into an Otok `head` export.
+ *
+ * ```ts
+ * export const head = defineMeta(({ data, locale }) => ({
+ *   title: data.product.name,
+ *   description: data.product.description,
+ *   canonical: `/products/${data.product.slug}`,
+ *   openGraph: { type: "product" },
+ * }));
+ * ```
+ */
+export declare function defineMeta<Data extends LoaderResult = LoaderResult>(resolver: (ctx: MetaContext<Data>) => RouteMeta | Promise<RouteMeta>, options?: DefineMetaOptions): (props: OtokPageProps<Data>) => Promise<OtokHead>;
+/** Alias for route modules that export `meta` instead of `head`. */
+export declare const meta: typeof defineMeta;
+//# sourceMappingURL=define-meta.d.ts.map

package/dist/define-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-meta.d.ts","sourceRoot":"","sources":["../src/define-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,uDAAuD;IACvD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,MAAM,GAAG,SAAS,CAAC;CACtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,YAAY,GAAG,YAAY,EACjE,QAAQ,EAAE,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,EACpE,OAAO,GAAE,iBAAsB,GAC9B,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAoBnD;AAED,oEAAoE;AACpE,eAAO,MAAM,IAAI,mBAAa,CAAC"}

package/dist/define-meta.js

@@ -0,0 +1,36 @@
+import { resolveMetaToHead } from "./resolve.js";
+/**
+ * Define typed route metadata that resolves into an Otok `head` export.
+ *
+ * ```ts
+ * export const head = defineMeta(({ data, locale }) => ({
+ *   title: data.product.name,
+ *   description: data.product.description,
+ *   canonical: `/products/${data.product.slug}`,
+ *   openGraph: { type: "product" },
+ * }));
+ * ```
+ */
+export function defineMeta(resolver, options = {}) {
+    return async (props) => {
+        const ctx = {
+            data: props.data,
+            params: props.params,
+            route: props.route,
+            locale: options.getLocale?.({
+                data: props.data,
+                params: props.params,
+                route: props.route,
+                origin: options.origin,
+            }),
+            origin: options.origin,
+        };
+        const meta = await resolver(ctx);
+        if (ctx.locale && !meta.lang)
+            meta.lang = ctx.locale;
+        return resolveMetaToHead(meta, options);
+    };
+}
+/** Alias for route modules that export `meta` instead of `head`. */
+export const meta = defineMeta;
+//# sourceMappingURL=define-meta.js.map

package/dist/define-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-meta.js","sourceRoot":"","sources":["../src/define-meta.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAA2B,MAAM,cAAc,CAAC;AAQ1E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,QAAoE,EACpE,UAA6B,EAAE;IAE/B,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,MAAM,GAAG,GAAsB;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC;YACF,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC;QAErD,OAAO,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAC"}

package/dist/feeds.d.ts

@@ -0,0 +1,13 @@
+import type { FeedConfig } from "./types.js";
+export interface RenderFeedOptions {
+    origin: string;
+    feed: FeedConfig;
+    format: "rss" | "atom";
+}
+/** Render an RSS 2.0 feed. */
+export declare function renderRssFeed(options: RenderFeedOptions): Promise<string>;
+/** Render an Atom 1.0 feed. */
+export declare function renderAtomFeed(options: RenderFeedOptions): Promise<string>;
+/** Render RSS or Atom based on format. */
+export declare function renderFeed(options: RenderFeedOptions): Promise<string>;
+//# sourceMappingURL=feeds.d.ts.map

package/dist/feeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feeds.d.ts","sourceRoot":"","sources":["../src/feeds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAoBD,8BAA8B;AAC9B,wBAAsB,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B/E;AAED,+BAA+B;AAC/B,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BhF;AAED,0CAA0C;AAC1C,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE5E"}

package/dist/feeds.js

@@ -0,0 +1,75 @@
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+function resolveLink(origin, link) {
+    if (/^https?:\/\//i.test(link))
+        return link;
+    return `${origin.replace(/\/$/, "")}${link.startsWith("/") ? link : `/${link}`}`;
+}
+async function resolveItems(feed) {
+    return typeof feed.items === "function" ? await feed.items() : feed.items;
+}
+/** Render an RSS 2.0 feed. */
+export async function renderRssFeed(options) {
+    const { origin, feed } = options;
+    const items = await resolveItems(feed);
+    const channelLink = resolveLink(origin, feed.path);
+    const itemXml = items
+        .map((item) => {
+        const pubDate = item.publishedAt ? `\n      <pubDate>${escapeXml(new Date(item.publishedAt).toUTCString())}</pubDate>` : "";
+        const description = item.description ? `\n      <description>${escapeXml(item.description)}</description>` : "";
+        const author = item.author ? `\n      <author>${escapeXml(item.author)}</author>` : "";
+        return `    <item>
+      <title>${escapeXml(item.title)}</title>
+      <link>${escapeXml(resolveLink(origin, item.link))}</link>
+      <guid isPermaLink="false">${escapeXml(item.id)}</guid>${description}${author}${pubDate}
+    </item>`;
+    })
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0">
+  <channel>
+    <title>${escapeXml(feed.title)}</title>
+    <link>${escapeXml(channelLink)}</link>
+    ${feed.description ? `<description>${escapeXml(feed.description)}</description>` : ""}
+${itemXml}
+  </channel>
+</rss>`;
+}
+/** Render an Atom 1.0 feed. */
+export async function renderAtomFeed(options) {
+    const { origin, feed } = options;
+    const items = await resolveItems(feed);
+    const feedLink = resolveLink(origin, feed.path);
+    const entries = items
+        .map((item) => {
+        const updated = item.updatedAt ?? item.publishedAt;
+        return `  <entry>
+    <title>${escapeXml(item.title)}</title>
+    <link href="${escapeXml(resolveLink(origin, item.link))}" />
+    <id>${escapeXml(item.id)}</id>
+    ${updated ? `<updated>${escapeXml(new Date(updated).toISOString())}</updated>` : ""}
+    ${item.description ? `<summary>${escapeXml(item.description)}</summary>` : ""}
+    ${item.author ? `<author><name>${escapeXml(item.author)}</name></author>` : ""}
+  </entry>`;
+    })
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<feed xmlns="http://www.w3.org/2005/Atom">
+  <title>${escapeXml(feed.title)}</title>
+  <link href="${escapeXml(feedLink)}" rel="self" />
+  <id>${escapeXml(feedLink)}</id>
+  ${feed.description ? `<subtitle>${escapeXml(feed.description)}</subtitle>` : ""}
+${entries}
+</feed>`;
+}
+/** Render RSS or Atom based on format. */
+export async function renderFeed(options) {
+    return options.format === "atom" ? renderAtomFeed(options) : renderRssFeed(options);
+}
+//# sourceMappingURL=feeds.js.map

package/dist/feeds.js.map

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

package/dist/i18n.d.ts

@@ -0,0 +1,16 @@
+import type { I18nHeadOptions } from "@kamod-ch/otok-i18n";
+import type { OtokHead } from "@kamod-ch/otok/server";
+import type { RouteMeta } from "./types.js";
+export interface SeoI18nHeadOptions extends I18nHeadOptions {
+    meta?: RouteMeta;
+    titleTemplate?: string;
+    siteName?: string;
+    defaultOgImage?: string;
+    twitterSite?: string;
+}
+/**
+ * Merge route metadata with i18n head output (lang, hreflang, canonical).
+ * Requires `@kamod-ch/otok-i18n` at runtime.
+ */
+export declare function seoI18nHead(options: SeoI18nHeadOptions): OtokHead;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,QAAQ,CAyBjE"}

package/dist/i18n.js

@@ -0,0 +1,31 @@
+import { i18nHead } from "@kamod-ch/otok-i18n";
+import { resolveMetaToHead } from "./resolve.js";
+/**
+ * Merge route metadata with i18n head output (lang, hreflang, canonical).
+ * Requires `@kamod-ch/otok-i18n` at runtime.
+ */
+export function seoI18nHead(options) {
+    const { meta, titleTemplate, siteName, defaultOgImage, twitterSite, ...i18nOptions } = options;
+    const i18n = i18nHead(i18nOptions);
+    if (!meta)
+        return i18n;
+    const resolved = resolveMetaToHead(meta, {
+        origin: i18nOptions.origin,
+        titleTemplate,
+        siteName,
+        defaultOgImage,
+        twitterSite,
+    });
+    const links = [...(resolved.links ?? [])];
+    for (const link of i18n.links ?? []) {
+        if (!links.some((existing) => existing.rel === link.rel && existing.href === link.href)) {
+            links.push(link);
+        }
+    }
+    return {
+        ...resolved,
+        lang: i18n.lang ?? resolved.lang,
+        links,
+    };
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWjD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IAC/F,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,EAAE;QACvC,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,aAAa;QACb,QAAQ;QACR,cAAc;QACd,WAAW;KACZ,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,QAAQ;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI;QAChC,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { defineMeta, meta, type DefineMetaOptions } from "./define-meta.js";
+export { seoI18nHead, type SeoI18nHeadOptions } from "./i18n.js";
+export { createMetaContext, defineLoader } from "./loader.js";
+export { configureSeoApp } from "./middleware.js";
+export { default } from "./plugin.js";
+export { getSeoRuntime, normalizeSeoOptions, readSeoOrigin, registerSeoRuntime, resetSeoRuntimeForTests, tryGetSeoRuntime, type NormalizedSeoOptions, } from "./registry.js";
+export { resolveMetaToHead, type ResolveMetaOptions } from "./resolve.js";
+export { renderAtomFeed, renderFeed, renderRssFeed, type RenderFeedOptions } from "./feeds.js";
+export { renderRobotsTxt, type RenderRobotsOptions } from "./robots.js";
+export { createSitemapEntries, renderSitemapXml, type CreateSitemapOptions, type SitemapEntry } from "./sitemap.js";
+export type { FeedConfig, FeedItem, HreflangAlternate, MetaContext, OgImageContext, OgImageHook, OpenGraphImage, OpenGraphMeta, OpenGraphType, RobotsConfig, RouteIcon, RouteManifestRef, RouteMeta, SeoPluginOptions, TwitterCardMeta, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACpH,YAAY,EACV,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,WAAW,EACX,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { defineMeta, meta } from "./define-meta.js";
+export { seoI18nHead } from "./i18n.js";
+export { createMetaContext, defineLoader } from "./loader.js";
+export { configureSeoApp } from "./middleware.js";
+export { default } from "./plugin.js";
+export { getSeoRuntime, normalizeSeoOptions, readSeoOrigin, registerSeoRuntime, resetSeoRuntimeForTests, tryGetSeoRuntime, } from "./registry.js";
+export { resolveMetaToHead } from "./resolve.js";
+export { renderAtomFeed, renderFeed, renderRssFeed } from "./feeds.js";
+export { renderRobotsTxt } from "./robots.js";
+export { createSitemapEntries, renderSitemapXml } from "./sitemap.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,IAAI,EAA0B,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAA2B,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,GAEjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,iBAAiB,EAA2B,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAA0B,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAgD,MAAM,cAAc,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "hono";
+import type { LoaderResult, OtokContext, OtokLoader } from "@kamod-ch/otok/server";
+import type { MetaContext } from "./types.js";
+type SeoLoaderContext = {
+    seo: {
+        origin: string;
+        locale?: string;
+    };
+};
+/** Wrap a loader with typed SEO context (origin, locale). */
+export declare function defineLoader<Data extends LoaderResult>(handler: (ctx: OtokContext & SeoLoaderContext) => Data | Promise<Data>): OtokLoader<Data>;
+/** Build meta context from a Hono request — useful in OG image routes. */
+export declare function createMetaContext(c: Context, partial?: Partial<MetaContext>): MetaContext;
+export {};
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AASF,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,IAAI,SAAS,YAAY,EACpD,OAAO,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACrE,UAAU,CAAC,IAAI,CAAC,CAElB;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,CAU7F"}

package/dist/loader.js

@@ -0,0 +1,24 @@
+import { getSeoRuntime, readSeoOrigin } from "./registry.js";
+function resolveSeoContext(hono) {
+    const runtime = getSeoRuntime();
+    const origin = readSeoOrigin(hono) ?? runtime.origin;
+    const i18n = hono.get("i18n");
+    return { origin, locale: i18n?.locale };
+}
+/** Wrap a loader with typed SEO context (origin, locale). */
+export function defineLoader(handler) {
+    return (context) => handler({ ...context, seo: resolveSeoContext(context.hono) });
+}
+/** Build meta context from a Hono request — useful in OG image routes. */
+export function createMetaContext(c, partial = {}) {
+    const runtime = getSeoRuntime();
+    const i18n = c.get("i18n");
+    return {
+        data: partial.data ?? {},
+        params: partial.params ?? {},
+        route: partial.route ?? new URL(c.req.url).pathname,
+        locale: partial.locale ?? i18n?.locale,
+        origin: partial.origin ?? readSeoOrigin(c) ?? runtime.origin,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAU7D,SAAS,iBAAiB,CAAC,IAAyB;IAClD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAe,CAAoC,CAAC;IAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,YAAY,CAC1B,OAAsE;IAEtE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAAC,CAAU,EAAE,UAAgC,EAAE;IAC9E,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,MAAe,CAAoC,CAAC;IACvE,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ;QACnD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE,MAAM;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM;KAC7D,CAAC;AACJ,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,5 @@
+import type { Hono } from "hono";
+import type { NormalizedSeoOptions } from "./registry.js";
+/** Register SEO utility routes on the Hono app. */
+export declare function configureSeoApp(app: Hono, options: NormalizedSeoOptions): void;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAIjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA8C1D,mDAAmD;AACnD,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAoD9E"}

package/dist/middleware.js

@@ -0,0 +1,89 @@
+import { renderFeed } from "./feeds.js";
+import { renderRobotsTxt } from "./robots.js";
+import { createSitemapEntries, renderSitemapXml } from "./sitemap.js";
+async function buildLocalizedSitemap(options) {
+    const i18nRuntime = await tryImportI18n();
+    if (i18nRuntime) {
+        const { createLocalizedSitemapEntries, renderSitemapXml: renderI18nSitemap } = i18nRuntime;
+        const entries = createLocalizedSitemapEntries(options.sitemapPaths ?? [], {
+            origin: options.origin,
+            locales: i18nRuntime.locales,
+            defaultLocale: i18nRuntime.defaultLocale,
+            routing: i18nRuntime.routing,
+        });
+        return renderI18nSitemap(entries);
+    }
+    const entries = createSitemapEntries({
+        origin: options.origin,
+        paths: options.sitemapPaths ?? [],
+    });
+    return renderSitemapXml(entries);
+}
+async function tryImportI18n() {
+    try {
+        const { tryGetI18nRuntime } = await import("@kamod-ch/otok-i18n");
+        const runtime = tryGetI18nRuntime();
+        if (!runtime)
+            return null;
+        const sitemap = await import("@kamod-ch/otok-i18n/sitemap");
+        return {
+            createLocalizedSitemapEntries: sitemap.createLocalizedSitemapEntries,
+            renderSitemapXml: sitemap.renderSitemapXml,
+            locales: runtime.options.locales,
+            defaultLocale: runtime.options.defaultLocale,
+            routing: runtime.options.routing,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Register SEO utility routes on the Hono app. */
+export function configureSeoApp(app, options) {
+    const contextKey = "seoOrigin";
+    app.use("*", async (c, next) => {
+        c.set(contextKey, options.origin);
+        await next();
+    });
+    if (options.robotsEnabled) {
+        app.get("/robots.txt", (c) => {
+            const body = renderRobotsTxt({
+                config: options.robots ?? true,
+                origin: options.origin,
+            });
+            return c.text(body, 200, { "content-type": "text/plain; charset=utf-8" });
+        });
+    }
+    if (options.sitemapEnabled) {
+        app.get("/sitemap.xml", async (c) => {
+            const body = await buildLocalizedSitemap(options);
+            return c.text(body, 200, { "content-type": "application/xml; charset=utf-8" });
+        });
+    }
+    if (options.rss) {
+        app.get(options.rss.path, async (c) => {
+            const body = await renderFeed({ origin: options.origin, feed: options.rss, format: "rss" });
+            return c.text(body, 200, { "content-type": "application/rss+xml; charset=utf-8" });
+        });
+    }
+    if (options.atom) {
+        app.get(options.atom.path, async (c) => {
+            const body = await renderFeed({ origin: options.origin, feed: options.atom, format: "atom" });
+            return c.text(body, 200, { "content-type": "application/atom+xml; charset=utf-8" });
+        });
+    }
+    if (options.ogImage) {
+        app.get("/og-image", async (c) => {
+            const url = new URL(c.req.url);
+            const ctx = {
+                route: url.searchParams.get("route") ?? "/",
+                params: Object.fromEntries(url.searchParams.entries()),
+                locale: url.searchParams.get("locale") ?? undefined,
+                title: url.searchParams.get("title") ?? undefined,
+            };
+            const imageUrl = await options.ogImage(ctx);
+            return c.redirect(imageUrl, 302);
+        });
+    }
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,16 @@
+import { configureSeoApp } from "./middleware.js";
+import type { SeoPluginOptions } from "./types.js";
+/**
+ * Otok SEO plugin factory.
+ *
+ * ```ts
+ * import seo from "@kamod-ch/otok-seo";
+ *
+ * export default defineConfig({
+ *   plugins: [seo({ origin: "https://example.com", titleTemplate: "%s | Example" })],
+ * });
+ * ```
+ */
+export default function seo(options: SeoPluginOptions): import("@kamod-ch/otok-config").OtokPlugin<unknown>;
+export { configureSeoApp };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmBnD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,OAAO,EAAE,gBAAgB,uDASpD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,41 @@
+import { definePlugin } from "@kamod-ch/otok";
+import { configureSeoApp } from "./middleware.js";
+import { normalizeSeoOptions, registerSeoRuntime } from "./registry.js";
+const seoPluginFactory = definePlugin({
+    name: "@kamod-ch/otok-seo",
+    version: "1.0.0",
+    schema: {
+        parse(input) {
+            if (!input || typeof input !== "object") {
+                throw new Error("seo() options must be an object");
+            }
+            const record = input;
+            if (typeof record.origin !== "string" || !record.origin) {
+                throw new Error("seo() requires origin: string");
+            }
+            return normalizeSeoOptions(input);
+        },
+    },
+});
+/**
+ * Otok SEO plugin factory.
+ *
+ * ```ts
+ * import seo from "@kamod-ch/otok-seo";
+ *
+ * export default defineConfig({
+ *   plugins: [seo({ origin: "https://example.com", titleTemplate: "%s | Example" })],
+ * });
+ * ```
+ */
+export default function seo(options) {
+    const normalized = normalizeSeoOptions(options);
+    registerSeoRuntime(normalized);
+    const plugin = seoPluginFactory(normalized);
+    plugin.configureApp = ({ app }) => {
+        configureSeoApp(app, normalized);
+    };
+    return plugin;
+}
+export { configureSeoApp };
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxE,MAAM,gBAAgB,GAAG,YAAY,CAAmB;IACtD,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE;QACN,KAAK,CAAC,KAAK;YACT,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACxD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,mBAAmB,CAAC,KAAyB,CAAC,CAAC;QACxD,CAAC;KACF;CACF,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CAAC,OAAyB;IACnD,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;QAChC,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACnC,CAAC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from "hono";
+import type { SeoPluginOptions } from "./types.js";
+export interface NormalizedSeoOptions extends SeoPluginOptions {
+    origin: string;
+    robotsEnabled: boolean;
+    sitemapEnabled: boolean;
+}
+export declare function normalizeSeoOptions(options: SeoPluginOptions): NormalizedSeoOptions;
+export declare function registerSeoRuntime(options: NormalizedSeoOptions): void;
+export declare function getSeoRuntime(): NormalizedSeoOptions;
+export declare function tryGetSeoRuntime(): NormalizedSeoOptions | null;
+export declare function readSeoOrigin(c: Context, contextKey?: string): string | undefined;
+export declare function resetSeoRuntimeForTests(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,oBAAoB,CAgBnF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAEtE;AAED,wBAAgB,aAAa,IAAI,oBAAoB,CAKpD;AAED,wBAAgB,gBAAgB,IAAI,oBAAoB,GAAG,IAAI,CAE9D;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,SAAc,GAAG,MAAM,GAAG,SAAS,CAEtF;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/registry.js

@@ -0,0 +1,35 @@
+let runtime = null;
+export function normalizeSeoOptions(options) {
+    if (!options.origin || typeof options.origin !== "string") {
+        throw new Error("seo() requires origin: string (absolute site URL)");
+    }
+    const sitemapPaths = options.sitemapPaths ?? [];
+    const sitemapEnabled = options.sitemap !== false && sitemapPaths.length > 0;
+    const robotsEnabled = options.robots !== false;
+    return {
+        ...options,
+        origin: options.origin.replace(/\/$/, ""),
+        sitemapPaths,
+        robotsEnabled,
+        sitemapEnabled,
+    };
+}
+export function registerSeoRuntime(options) {
+    runtime = options;
+}
+export function getSeoRuntime() {
+    if (!runtime) {
+        throw new Error("otok-seo: plugin not registered. Add seo() to otok.config.ts plugins.");
+    }
+    return runtime;
+}
+export function tryGetSeoRuntime() {
+    return runtime;
+}
+export function readSeoOrigin(c, contextKey = "seoOrigin") {
+    return c.get(contextKey);
+}
+export function resetSeoRuntimeForTests() {
+    runtime = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,IAAI,OAAO,GAAgC,IAAI,CAAC;AAQhD,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IAChD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,KAAK,KAAK,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC;IAE/C,OAAO;QACL,GAAG,OAAO;QACV,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACzC,YAAY;QACZ,aAAa;QACb,cAAc;KACf,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC9D,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAU,EAAE,UAAU,GAAG,WAAW;IAChE,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,CAAuB,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,14 @@
+import type { OtokHead } from "@kamod-ch/otok/server";
+import type { RouteMeta, SeoPluginOptions } from "./types.js";
+export interface ResolveMetaOptions {
+    origin?: string;
+    titleTemplate?: string;
+    siteName?: string;
+    defaultOgImage?: string;
+    twitterSite?: string;
+    globalIcons?: SeoPluginOptions["icons"];
+    globalManifest?: SeoPluginOptions["manifest"];
+}
+/** Convert typed route metadata into an OtokHead result. */
+export declare function resolveMetaToHead(meta: RouteMeta, options?: ResolveMetaOptions): OtokHead;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwB9D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CAC/C;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB,GAAG,QAAQ,CAoE7F"}

package/dist/resolve.js

@@ -0,0 +1,95 @@
+function joinOrigin(origin, path) {
+    if (/^https?:\/\//i.test(path))
+        return path;
+    if (!origin)
+        return path;
+    const base = origin.replace(/\/$/, "");
+    const normalized = path.startsWith("/") ? path : `/${path}`;
+    return `${base}${normalized}`;
+}
+function applyTitleTemplate(title, template) {
+    if (!title)
+        return undefined;
+    if (!template)
+        return title;
+    return template.includes("%s") ? template.replace("%s", title) : `${title}${template}`;
+}
+function normalizeOgImages(image, defaultImage) {
+    const raw = Array.isArray(image) ? image : image ? [image] : defaultImage ? [defaultImage] : [];
+    return raw.map((entry) => (typeof entry === "string" ? { url: entry } : entry));
+}
+/** Convert typed route metadata into an OtokHead result. */
+export function resolveMetaToHead(meta, options = {}) {
+    const title = applyTitleTemplate(meta.title, options.titleTemplate);
+    const canonicalHref = meta.canonical ? joinOrigin(options.origin ?? meta.canonical, meta.canonical) : undefined;
+    const propertyMeta = {};
+    const nameMeta = { ...(meta.meta ?? {}) };
+    if (meta.robots)
+        nameMeta.robots = meta.robots;
+    const og = meta.openGraph ?? {};
+    const ogTitle = og.title ?? meta.title;
+    const ogDescription = og.description ?? meta.description;
+    const ogUrl = og.url ?? canonicalHref;
+    if (og.type)
+        propertyMeta["og:type"] = og.type;
+    if (ogTitle)
+        propertyMeta["og:title"] = ogTitle;
+    if (ogDescription)
+        propertyMeta["og:description"] = ogDescription;
+    if (ogUrl)
+        propertyMeta["og:url"] = joinOrigin(options.origin, ogUrl);
+    if (options.siteName ?? og.siteName)
+        propertyMeta["og:site_name"] = options.siteName ?? og.siteName;
+    if (og.locale)
+        propertyMeta["og:locale"] = og.locale;
+    const images = normalizeOgImages(og.images ?? og.image ?? undefined, options.defaultOgImage);
+    if (images[0])
+        propertyMeta["og:image"] = joinOrigin(options.origin, images[0].url);
+    const twitter = meta.twitter ?? {};
+    const twitterCard = twitter.card ?? (images[0] ? "summary_large_image" : "summary");
+    nameMeta["twitter:card"] = twitterCard;
+    if (twitter.site ?? options.twitterSite)
+        nameMeta["twitter:site"] = twitter.site ?? options.twitterSite;
+    if (twitter.creator)
+        nameMeta["twitter:creator"] = twitter.creator;
+    if (twitter.title ?? ogTitle)
+        nameMeta["twitter:title"] = twitter.title ?? ogTitle;
+    if (twitter.description ?? ogDescription)
+        nameMeta["twitter:description"] = twitter.description ?? ogDescription;
+    const twitterImage = twitter.image ?? images[0]?.url;
+    if (twitterImage)
+        nameMeta["twitter:image"] = joinOrigin(options.origin, twitterImage);
+    const links = [
+        ...(canonicalHref ? [{ rel: "canonical", href: canonicalHref }] : []),
+        ...(meta.hreflang ?? []).map((alt) => ({
+            rel: "alternate",
+            href: alt.href,
+            hreflang: alt.hreflang,
+        })),
+        ...(meta.icons ?? options.globalIcons ?? []).map((icon) => ({
+            rel: icon.rel ?? "icon",
+            href: joinOrigin(options.origin, icon.href),
+            type: icon.type,
+        })),
+        ...(meta.manifest ?? options.globalManifest
+            ? [{ rel: "manifest", href: joinOrigin(options.origin, (meta.manifest ?? options.globalManifest).href) }]
+            : []),
+        ...(meta.rss ? [{ rel: "alternate", href: joinOrigin(options.origin, meta.rss), type: "application/rss+xml" }] : []),
+        ...(meta.atom ? [{ rel: "alternate", href: joinOrigin(options.origin, meta.atom), type: "application/atom+xml" }] : []),
+    ];
+    const jsonLd = Array.isArray(meta.jsonLd)
+        ? meta.jsonLd.length === 1
+            ? meta.jsonLd[0]
+            : { "@context": "https://schema.org", "@graph": meta.jsonLd }
+        : meta.jsonLd;
+    return {
+        title,
+        description: meta.description,
+        lang: meta.lang,
+        meta: nameMeta,
+        propertyMeta,
+        links,
+        jsonLd,
+    };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/dist/robots.d.ts

@@ -0,0 +1,9 @@
+import type { RobotsConfig } from "./types.js";
+export interface RenderRobotsOptions {
+    config?: boolean | RobotsConfig;
+    origin?: string;
+    sitemapPath?: string;
+}
+/** Render a robots.txt document from plugin options. */
+export declare function renderRobotsTxt(options?: RenderRobotsOptions): string;
+//# sourceMappingURL=robots.d.ts.map

package/dist/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAmBzE"}

package/dist/robots.js

@@ -0,0 +1,21 @@
+/** Render a robots.txt document from plugin options. */
+export function renderRobotsTxt(options = {}) {
+    const { config = true, origin, sitemapPath = "/sitemap.xml" } = options;
+    if (config === false)
+        return "User-agent: *\nDisallow: /";
+    const rules = typeof config === "object" ? config : {};
+    const lines = ["User-agent: *"];
+    for (const path of rules.allow ?? ["/"]) {
+        lines.push(`Allow: ${path}`);
+    }
+    for (const path of rules.disallow ?? []) {
+        lines.push(`Disallow: ${path}`);
+    }
+    const sitemap = rules.sitemap ?? (origin ? `${origin.replace(/\/$/, "")}${sitemapPath}` : undefined);
+    if (sitemap)
+        lines.push("", `Sitemap: ${sitemap}`);
+    if (rules.host)
+        lines.push(`Host: ${rules.host}`);
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=robots.js.map

package/dist/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAQA,wDAAwD;AACxD,MAAM,UAAU,eAAe,CAAC,UAA+B,EAAE;IAC/D,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IACxE,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,4BAA4B,CAAC;IAE1D,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,MAAM,KAAK,GAAa,CAAC,eAAe,CAAC,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrG,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,OAAO,EAAE,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAElD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/sitemap.d.ts

@@ -0,0 +1,20 @@
+export interface SitemapEntry {
+    loc: string;
+    lastmod?: string;
+    changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+    alternates?: Array<{
+        hreflang: string;
+        href: string;
+    }>;
+}
+export interface CreateSitemapOptions {
+    origin: string;
+    paths: readonly string[];
+    lastmod?: string;
+}
+/** Build basic sitemap entries from pathnames. */
+export declare function createSitemapEntries(options: CreateSitemapOptions): SitemapEntry[];
+/** Render sitemap XML, optionally with xhtml:link alternates. */
+export declare function renderSitemapXml(entries: SitemapEntry[]): string;
+//# sourceMappingURL=sitemap.d.ts.map

package/dist/sitemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.d.ts","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAMlF;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CA2BhE"}

package/dist/sitemap.js

@@ -0,0 +1,40 @@
+/** Build basic sitemap entries from pathnames. */
+export function createSitemapEntries(options) {
+    const base = options.origin.replace(/\/$/, "");
+    return options.paths.map((pathname) => ({
+        loc: `${base}${pathname.startsWith("/") ? pathname : `/${pathname}`}`,
+        lastmod: options.lastmod,
+    }));
+}
+/** Render sitemap XML, optionally with xhtml:link alternates. */
+export function renderSitemapXml(entries) {
+    const xmlns = 'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"';
+    const xhtml = entries.some((e) => e.alternates?.length) ? 'xmlns:xhtml="http://www.w3.org/1999/xhtml"' : "";
+    const urls = entries
+        .map((entry) => {
+        const altLinks = (entry.alternates ?? [])
+            .map((alt) => `    <xhtml:link rel="alternate" hreflang="${escapeXml(alt.hreflang)}" href="${escapeXml(alt.href)}" />`)
+            .join("\n");
+        const lastmod = entry.lastmod ? `\n    <lastmod>${escapeXml(entry.lastmod)}</lastmod>` : "";
+        const changefreq = entry.changefreq ? `\n    <changefreq>${entry.changefreq}</changefreq>` : "";
+        const priority = entry.priority != null ? `\n    <priority>${entry.priority.toFixed(1)}</priority>` : "";
+        return `  <url>
+    <loc>${escapeXml(entry.loc)}</loc>${lastmod}${changefreq}${priority}
+${altLinks}
+  </url>`;
+    })
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset ${xmlns}${xhtml ? ` ${xhtml}` : ""}>
+${urls}
+</urlset>`;
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+//# sourceMappingURL=sitemap.js.map

package/dist/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap.js","sourceRoot":"","sources":["../src/sitemap.ts"],"names":[],"mappings":"AAcA,kDAAkD;AAClD,MAAM,UAAU,oBAAoB,CAAC,OAA6B;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACtC,GAAG,EAAE,GAAG,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE;QACrE,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,MAAM,KAAK,GAAG,qDAAqD,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5G,MAAM,IAAI,GAAG,OAAO;SACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;aACtC,GAAG,CACF,CAAC,GAAG,EAAE,EAAE,CACN,6CAA6C,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAC3G;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,qBAAqB,KAAK,CAAC,UAAU,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAChG,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,mBAAmB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzG,OAAO;WACF,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,OAAO,GAAG,UAAU,GAAG,QAAQ;EACrE,QAAQ;SACD,CAAC;IACN,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;UACC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;EACxC,IAAI;UACI,CAAC;AACX,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,123 @@
+import type { LoaderResult, RouteParams } from "@kamod-ch/otok/server";
+export type JsonLdValue = string | number | boolean | null | JsonLdValue[] | {
+    [key: string]: JsonLdValue;
+};
+export type OpenGraphType = "website" | "article" | "product" | "profile" | "book" | "music.song" | "music.album" | "music.playlist" | "music.radio_station" | "video.movie" | "video.episode" | "video.tv_show" | "video.other";
+export interface OpenGraphMeta {
+    type?: OpenGraphType;
+    title?: string;
+    description?: string;
+    url?: string;
+    siteName?: string;
+    locale?: string;
+    image?: string | OpenGraphImage;
+    images?: Array<string | OpenGraphImage>;
+}
+export interface OpenGraphImage {
+    url: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+    type?: string;
+}
+export interface TwitterCardMeta {
+    card?: "summary" | "summary_large_image" | "app" | "player";
+    site?: string;
+    creator?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+}
+export interface RouteIcon {
+    rel?: "icon" | "apple-touch-icon" | "mask-icon";
+    href: string;
+    sizes?: string;
+    type?: string;
+    color?: string;
+}
+export interface RouteManifestRef {
+    href: string;
+}
+export interface HreflangAlternate {
+    hreflang: string;
+    href: string;
+}
+export interface RouteMeta {
+    title?: string;
+    description?: string;
+    lang?: string;
+    canonical?: string;
+    robots?: string;
+    openGraph?: OpenGraphMeta;
+    twitter?: TwitterCardMeta;
+    jsonLd?: Record<string, JsonLdValue> | Array<Record<string, JsonLdValue>>;
+    icons?: RouteIcon[];
+    manifest?: RouteManifestRef;
+    hreflang?: HreflangAlternate[];
+    rss?: string;
+    atom?: string;
+    meta?: Record<string, string>;
+}
+export interface MetaContext<Data extends LoaderResult = LoaderResult> {
+    data: Data;
+    params: RouteParams;
+    route: string;
+    locale?: string;
+    origin?: string;
+}
+export interface SeoPluginOptions {
+    /** Absolute site origin, e.g. `https://example.com`. Required for canonical URLs and sitemaps. */
+    origin: string;
+    /** Global title template. `%s` is replaced by the page title. */
+    titleTemplate?: string;
+    /** Default site name for Open Graph. */
+    siteName?: string;
+    /** Default Open Graph image URL. */
+    defaultOgImage?: string;
+    /** Default Twitter handle, e.g. `@example`. */
+    twitterSite?: string;
+    /** Paths included in the auto-generated sitemap. */
+    sitemapPaths?: string[];
+    /** Serve `/robots.txt`. Default: true. */
+    robots?: boolean | RobotsConfig;
+    /** Serve `/sitemap.xml`. Default: true when sitemapPaths is set. */
+    sitemap?: boolean;
+    /** RSS feed configuration. */
+    rss?: FeedConfig;
+    /** Atom feed configuration. */
+    atom?: FeedConfig;
+    /** Dynamic OG image hook — receives route context and returns an image URL. */
+    ogImage?: OgImageHook;
+    /** Icons and manifest injected on every page unless overridden. */
+    icons?: RouteIcon[];
+    manifest?: RouteManifestRef;
+}
+export interface RobotsConfig {
+    allow?: string[];
+    disallow?: string[];
+    sitemap?: string;
+    host?: string;
+}
+export interface FeedItem {
+    id: string;
+    title: string;
+    link: string;
+    description?: string;
+    publishedAt?: string;
+    updatedAt?: string;
+    author?: string;
+}
+export interface FeedConfig {
+    path: string;
+    title: string;
+    description?: string;
+    items: FeedItem[] | (() => FeedItem[] | Promise<FeedItem[]>);
+}
+export type OgImageHook = (ctx: OgImageContext) => string | Promise<string>;
+export interface OgImageContext {
+    route: string;
+    params: RouteParams;
+    locale?: string;
+    title?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@kamod-ch/otok-seo",
+  "version": "2.0.0",
+  "description": "Typed route metadata, sitemaps, feeds, and SEO helpers for Otok apps.",
+  "license": "MIT",
+  "homepage": "https://github.com/kamod-ch/otok/tree/main/packages/otok-seo#readme",
+  "bugs": {
+    "url": "https://github.com/kamod-ch/otok/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kamod-ch/otok.git",
+    "directory": "packages/otok-seo"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./sitemap": {
+      "types": "./dist/sitemap.d.ts",
+      "default": "./dist/sitemap.js"
+    },
+    "./feeds": {
+      "types": "./dist/feeds.d.ts",
+      "default": "./dist/feeds.js"
+    },
+    "./robots": {
+      "types": "./dist/robots.d.ts",
+      "default": "./dist/robots.js"
+    },
+    "./loader": {
+      "types": "./dist/loader.d.ts",
+      "default": "./dist/loader.js"
+    }
+  },
+  "peerDependencies": {
+    "@kamod-ch/otok": ">=0.6.1",
+    "hono": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "@kamod-ch/otok-i18n": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.2",
+    "hono": "^4.12.25",
+    "preact": "^10.28.2",
+    "typescript": "~6.0.2",
+    "vitest": "^4.1.2",
+    "@kamod-ch/otok": "0.6.1",
+    "@kamod-ch/otok-i18n": "3.0.0",
+    "@kamod-ch/otok-test": "0.5.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
+}