@nuxtjp/localized-site 0.0.0-stage → 0.1.1

package/dist/runtime/app/components/LocalizedLanguageSwitcher.vue

@@ -0,0 +1,21 @@
+<script setup>
+import { useLocalizedSite } from "../composables/useLocalizedSite";
+const site = useLocalizedSite();
+</script>
+
+<template>
+  <nav
+    class="nls-language-switcher"
+    :aria-label="site.locale.value === 'ja' ? '\u8A00\u8A9E' : 'Language'"
+  >
+    <NuxtLink
+      v-for="locale in site.supportedLocales"
+      :key="locale"
+      :to="site.localePath(locale)"
+      :lang="locale"
+      :aria-current="locale === site.locale.value ? 'page' : void 0"
+    >
+      {{ locale === "ja" ? "\u65E5\u672C\u8A9E" : "English" }}
+    </NuxtLink>
+  </nav>
+</template>

package/dist/runtime/app/components/LocalizedLanguageSwitcher.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/components/PublicMaintenanceNotice.d.vue.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/components/PublicMaintenanceNotice.vue

@@ -0,0 +1,29 @@
+<script setup>
+import { onMounted, ref } from "vue";
+import { maintenanceForService } from "../../core/maintenance";
+import { useLocalizedSite } from "../composables/useLocalizedSite";
+const site = useLocalizedSite();
+const notice = ref(null);
+onMounted(async () => {
+  try {
+    const response = await fetch("/maintenance.json", {
+      credentials: "same-origin",
+      signal: AbortSignal.timeout(2e3)
+    });
+    if (!response.ok) throw new Error("Maintenance state is unavailable");
+    const source = await response.text();
+    if (source.length > 65536) throw new Error("Maintenance state is too large");
+    const document = JSON.parse(source);
+    notice.value = maintenanceForService(document, site.config.serviceId);
+  } catch {
+    notice.value = null;
+  }
+});
+</script>
+
+<template>
+  <aside v-if="notice" class="nls-maintenance" role="status">
+    <strong>{{ site.locale.value === "ja" ? "\u30E1\u30F3\u30C6\u30CA\u30F3\u30B9\u4E2D" : "Maintenance" }}</strong>
+    <span>{{ notice[site.locale.value] }}</span>
+  </aside>
+</template>

package/dist/runtime/app/components/PublicMaintenanceNotice.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/composables/useLocalizedMessages.d.ts

@@ -0,0 +1,10 @@
+import type { LocalizedMessages } from '../../core/messages.js';
+export declare function useLocalizedMessages<Key extends string>(messages: LocalizedMessages<Key>): {
+    t: (key: Key) => string;
+    config: any;
+    content: import("vue").ComputedRef<any>;
+    locale: import("vue").ComputedRef<"ja" | "en">;
+    localePath: (localeValue: import("../../core/index.js").SupportedLocale, path?: any) => string;
+    pageId: import("vue").ComputedRef<import("../../../contracts/types.js").ContentPageId | undefined>;
+    supportedLocales: any;
+};

package/dist/runtime/app/composables/useLocalizedMessages.js

@@ -0,0 +1,14 @@
+import { translatedMessage } from "../../core/messages.js";
+import { useLocalizedSite } from "./useLocalizedSite.js";
+export function useLocalizedMessages(messages) {
+  const site = useLocalizedSite();
+  function t(key) {
+    return translatedMessage(
+      messages,
+      key,
+      site.locale.value,
+      site.config
+    );
+  }
+  return { ...site, t };
+}

package/dist/runtime/app/composables/useLocalizedSite.d.ts

@@ -0,0 +1,9 @@
+import type { SupportedLocale } from '../../../contracts/types.js';
+export declare function useLocalizedSite(): {
+    config: any;
+    content: import("vue").ComputedRef<any>;
+    locale: import("vue").ComputedRef<"ja" | "en">;
+    localePath: (localeValue: SupportedLocale, path?: any) => string;
+    pageId: import("vue").ComputedRef<import("../../../contracts/types.js").ContentPageId | undefined>;
+    supportedLocales: any;
+};

package/dist/runtime/app/composables/useLocalizedSite.js

@@ -0,0 +1,25 @@
+import { computed } from "vue";
+import { useRoute, useRuntimeConfig } from "#imports";
+import {
+  localeFromPath,
+  localePath as buildLocalePath,
+  pageIdFromPath
+} from "../../core/path.js";
+export function useLocalizedSite() {
+  const route = useRoute();
+  const config = useRuntimeConfig().public.nuxtJpLocalizedSite;
+  const locale = computed(() => localeFromPath(route.path, config.defaultLocale));
+  const content = computed(() => config.content[locale.value]);
+  const pageId = computed(() => pageIdFromPath(route.path));
+  function localePath(localeValue, path = route.fullPath) {
+    return buildLocalePath(path, localeValue, config);
+  }
+  return {
+    config,
+    content,
+    locale,
+    localePath,
+    pageId,
+    supportedLocales: config.locales
+  };
+}

package/dist/runtime/app/layouts/localized-site.d.vue.ts

@@ -0,0 +1,13 @@
+declare var __VLS_29: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_29) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/layouts/localized-site.vue

@@ -0,0 +1,37 @@
+<script setup>
+import { useLocalizedSite } from "#imports";
+const site = useLocalizedSite();
+</script>
+
+<template>
+  <div class="nls-shell">
+    <header class="nls-header">
+      <NuxtLink :to="site.localePath(site.locale.value, '/')">
+        {{ site.content.value.brand }}
+      </NuxtLink>
+      <nav :aria-label="site.locale.value === 'ja' ? '\u4E3B\u8981' : 'Primary'">
+        <NuxtLink :to="site.localePath(site.locale.value, '/')">
+          {{ site.locale.value === "ja" ? "\u30DB\u30FC\u30E0" : "Home" }}
+        </NuxtLink>
+        <NuxtLink :to="site.localePath(site.locale.value, '/docs')">
+          {{ site.content.value.docs.overview.title }}
+        </NuxtLink>
+      </nav>
+      <NuxtJpLocalizedLanguageSwitcher />
+    </header>
+    <NuxtJpPublicMaintenanceNotice />
+    <main id="main-content" class="nls-main">
+      <slot />
+    </main>
+    <footer class="nls-footer">
+      <section>
+        <strong>{{ site.content.value.privacy.label }}</strong>
+        <p>{{ site.content.value.privacy.summary }}</p>
+      </section>
+      <section>
+        <strong>{{ site.content.value.contact.label }}</strong>
+        <p>{{ site.content.value.contact.summary }}</p>
+      </section>
+    </footer>
+  </div>
+</template>

package/dist/runtime/app/layouts/localized-site.vue.d.ts

@@ -0,0 +1,13 @@
+declare var __VLS_29: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_29) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/app/pages/LocalizedContentPage.d.vue.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/pages/LocalizedContentPage.vue

@@ -0,0 +1,13 @@
+<script setup>
+import { computed } from "vue";
+import LocalizedDocument from "../components/LocalizedDocument.vue";
+import LocalizedLanding from "../components/LocalizedLanding.vue";
+import { useLocalizedSite } from "../composables/useLocalizedSite";
+const site = useLocalizedSite();
+const documentId = computed(() => site.pageId.value && site.pageId.value !== "landing" ? site.pageId.value : void 0);
+</script>
+
+<template>
+  <LocalizedLanding v-if="!documentId" />
+  <LocalizedDocument v-else :document-id="documentId" />
+</template>

package/dist/runtime/app/pages/LocalizedContentPage.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/app/plugins/localized-head.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/dist/runtime/app/plugins/localized-head.js

@@ -0,0 +1,7 @@
+import { defineNuxtPlugin, useHead, useRoute, useRuntimeConfig } from "#imports";
+import { localizedHead } from "../../core/seo.js";
+export default defineNuxtPlugin(() => {
+  const route = useRoute();
+  const config = useRuntimeConfig().public.nuxtJpLocalizedSite;
+  useHead(() => localizedHead(route.path, config));
+});

package/dist/runtime/core/index.d.ts

@@ -0,0 +1,8 @@
+export { defineLocalizedMessages, translatedMessage } from './messages.js';
+export type { LocalizedMessages, MessageDictionary } from './messages.js';
+export { localeFromPath, localePath, pageIdFromPath, siteRoutes, unlocalizedPath } from './path.js';
+export { localizedHead } from './seo.js';
+export type { HeadLink, HeadMeta, LocalizedHead } from './seo.js';
+export { MAINTENANCE_SCHEMA, maintenanceForService, parseMaintenanceDocument } from './maintenance.js';
+export type { MaintenanceMessage, MaintenanceState, MaintenanceTarget, PublicMaintenanceDocument } from './maintenance.js';
+export type { ResolvedSiteConfig, SiteConfig, SupportedLocale } from '../../contracts/types.js';

package/dist/runtime/core/index.js

@@ -0,0 +1,14 @@
+export { defineLocalizedMessages, translatedMessage } from "./messages.js";
+export {
+  localeFromPath,
+  localePath,
+  pageIdFromPath,
+  siteRoutes,
+  unlocalizedPath
+} from "./path.js";
+export { localizedHead } from "./seo.js";
+export {
+  MAINTENANCE_SCHEMA,
+  maintenanceForService,
+  parseMaintenanceDocument
+} from "./maintenance.js";

package/dist/runtime/core/maintenance.d.ts

@@ -0,0 +1,25 @@
+export declare const MAINTENANCE_SCHEMA = "nuxtjp://public/maintenance-state/v1";
+export type MaintenanceState = 'operational' | 'maintenance';
+export interface MaintenanceMessage {
+    ja: string;
+    en: string;
+}
+export interface MaintenanceTarget {
+    serviceId: string;
+    state: MaintenanceState;
+    message: MaintenanceMessage;
+    expiresAt: string;
+}
+export interface PublicMaintenanceDocument {
+    schema: typeof MAINTENANCE_SCHEMA;
+    generatedAt: string;
+    expiresAt: string;
+    global: {
+        state: MaintenanceState;
+        message: MaintenanceMessage;
+        expiresAt: string;
+    };
+    services: MaintenanceTarget[];
+}
+export declare function parseMaintenanceDocument(value: unknown): PublicMaintenanceDocument | null;
+export declare function maintenanceForService(value: unknown, serviceId: string, now?: number): MaintenanceMessage | null;

package/dist/runtime/core/maintenance.js

@@ -0,0 +1,51 @@
+export const MAINTENANCE_SCHEMA = "nuxtjp://public/maintenance-state/v1";
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function message(value) {
+  if (!record(value) || Object.keys(value).sort().join(",") !== "en,ja") return false;
+  return ["ja", "en"].every((key) => {
+    const text = value[key];
+    return typeof text === "string" && text.trim().length > 0 && text.length <= 240 && !/[\u0000-\u001f\u007f]/u.test(text);
+  });
+}
+function state(value) {
+  return value === "operational" || value === "maintenance";
+}
+function target(value) {
+  if (!record(value)) return false;
+  if (Object.keys(value).sort().join(",") !== "expiresAt,message,serviceId,state") return false;
+  return typeof value.serviceId === "string" && /^[a-z][a-z0-9-]{0,63}$/u.test(value.serviceId) && state(value.state) && message(value.message) && validTimestamp(value.expiresAt);
+}
+export function parseMaintenanceDocument(value) {
+  if (!record(value)) return null;
+  const keys = Object.keys(value).sort().join(",");
+  if (keys !== "expiresAt,generatedAt,global,schema,services") return null;
+  if (value.schema !== MAINTENANCE_SCHEMA || !record(value.global)) return null;
+  const globalKeys = Object.keys(value.global).sort().join(",");
+  if (globalKeys !== "expiresAt,message,state") return null;
+  if (!state(value.global.state) || !message(value.global.message) || !validTimestamp(value.global.expiresAt)) return null;
+  if (!Array.isArray(value.services) || value.services.length > 128) return null;
+  if (!value.services.every(target)) return null;
+  const ids = new Set(value.services.map((item) => item.serviceId));
+  if (ids.size !== value.services.length) return null;
+  if (!validTimestamp(value.generatedAt) || !validTimestamp(value.expiresAt)) return null;
+  const generated = Date.parse(value.generatedAt);
+  const expires = Date.parse(value.expiresAt);
+  const targetExpiries = [
+    Date.parse(value.global.expiresAt),
+    ...value.services.map((item) => Date.parse(item.expiresAt))
+  ];
+  if (generated >= expires || targetExpiries.some((time) => time < generated || time > expires)) return null;
+  return value;
+}
+export function maintenanceForService(value, serviceId, now = Date.now()) {
+  const document = parseMaintenanceDocument(value);
+  if (!document || Date.parse(document.expiresAt) <= now) return null;
+  if (document.global.state === "maintenance" && Date.parse(document.global.expiresAt) > now) return document.global.message;
+  const service = document.services.find((item) => item.serviceId === serviceId);
+  return service?.state === "maintenance" && Date.parse(service.expiresAt) > now ? service.message : null;
+}
+function validTimestamp(value) {
+  return typeof value === "string" && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{3})?Z$/u.test(value) && Number.isFinite(Date.parse(value));
+}

package/dist/runtime/core/messages.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedSiteConfig, SupportedLocale } from '../../contracts/types.js';
+export type MessageDictionary = Record<string, string>;
+export type LocalizedMessages<Key extends string> = {
+    readonly ja: Readonly<Record<Key, string>>;
+    readonly en: Readonly<Record<Key, string>>;
+};
+type NoExtraKeys<Expected, Actual> = Actual & Record<Exclude<keyof Actual, keyof Expected>, never>;
+export declare function defineLocalizedMessages<const Ja extends MessageDictionary, const En extends Record<keyof Ja, string>>(messages: {
+    ja: Ja;
+    en: NoExtraKeys<Ja, En>;
+}): LocalizedMessages<Extract<keyof Ja, string>>;
+export declare function translatedMessage<Key extends string>(messages: LocalizedMessages<Key>, key: Key, locale: SupportedLocale, config: Pick<ResolvedSiteConfig, 'defaultLocale' | 'fallbackLocale'>): string;
+export {};

package/dist/runtime/core/messages.js

@@ -0,0 +1,11 @@
+export function defineLocalizedMessages(messages) {
+  return messages;
+}
+export function translatedMessage(messages, key, locale, config) {
+  const order = [locale, config.fallbackLocale, config.defaultLocale].filter((entry, index, values) => values.indexOf(entry) === index);
+  for (const candidate of order) {
+    const value = messages[candidate][key];
+    if (typeof value === "string" && value.trim() !== "") return value;
+  }
+  throw new Error(`localized message is empty in every fallback locale: ${key}`);
+}

package/dist/runtime/core/path.d.ts

@@ -0,0 +1,6 @@
+import type { ContentPageId, ResolvedSiteConfig, SupportedLocale } from '../../contracts/types.js';
+export declare function localeFromPath(path: string, defaultLocale: SupportedLocale): SupportedLocale;
+export declare function unlocalizedPath(path: string): string;
+export declare function localePath(path: string, locale: SupportedLocale, config: Pick<ResolvedSiteConfig, 'defaultLocale' | 'prefixDefaultLocale'>): string;
+export declare function pageIdFromPath(path: string): ContentPageId | undefined;
+export declare function siteRoutes(config: ResolvedSiteConfig): string[];

package/dist/runtime/core/path.js

@@ -0,0 +1,43 @@
+function routeParts(input) {
+  if (!input.startsWith("/") || input.startsWith("//") || input.includes("\\")) {
+    throw new Error("localized routes must be absolute site paths");
+  }
+  const suffixIndex = [...["?", "#"]].map((marker) => input.indexOf(marker)).filter((index) => index >= 0).sort((left, right) => left - right)[0];
+  const pathname = suffixIndex === void 0 ? input : input.slice(0, suffixIndex);
+  const suffix = suffixIndex === void 0 ? "" : input.slice(suffixIndex);
+  const segments = pathname.split("/").filter(Boolean);
+  if (segments.some((segment) => segment === "." || segment === "..")) {
+    throw new Error("localized routes cannot traverse directories");
+  }
+  const normalized = segments.length === 0 ? "/" : `/${segments.join("/")}`;
+  return { pathname: normalized, suffix };
+}
+export function localeFromPath(path, defaultLocale) {
+  const first = routeParts(path).pathname.split("/")[1];
+  return first === "ja" || first === "en" ? first : defaultLocale;
+}
+export function unlocalizedPath(path) {
+  const { pathname } = routeParts(path);
+  const segments = pathname.split("/").filter(Boolean);
+  if (segments[0] === "ja" || segments[0] === "en") segments.shift();
+  return segments.length === 0 ? "/" : `/${segments.join("/")}`;
+}
+export function localePath(path, locale, config) {
+  const { suffix } = routeParts(path);
+  const base = unlocalizedPath(path);
+  const needsPrefix = config.prefixDefaultLocale || locale !== config.defaultLocale;
+  const localized = needsPrefix ? `/${locale}${base === "/" ? "" : base}` : base;
+  return `${localized}${suffix}`;
+}
+export function pageIdFromPath(path) {
+  const pagePath = unlocalizedPath(path);
+  if (pagePath === "/") return "landing";
+  if (pagePath === "/docs") return "overview";
+  if (pagePath === "/docs/getting-started") return "gettingStarted";
+  if (pagePath === "/docs/security") return "security";
+  return void 0;
+}
+export function siteRoutes(config) {
+  const paths = ["/", "/docs", "/docs/getting-started", "/docs/security"];
+  return config.locales.flatMap((locale) => paths.map((path) => localePath(path, locale, config)));
+}

package/dist/runtime/core/seo.d.ts

@@ -0,0 +1,20 @@
+import type { ResolvedSiteConfig, SupportedLocale } from '../../contracts/types.js';
+export interface HeadLink {
+    rel: 'canonical' | 'alternate';
+    href: string;
+    hreflang?: string;
+}
+export interface HeadMeta {
+    name?: string;
+    property?: string;
+    content: string;
+}
+export interface LocalizedHead {
+    title: string;
+    htmlAttrs: {
+        lang: SupportedLocale;
+    };
+    link: HeadLink[];
+    meta: HeadMeta[];
+}
+export declare function localizedHead(path: string, config: ResolvedSiteConfig): LocalizedHead;

package/dist/runtime/core/seo.js

@@ -0,0 +1,52 @@
+import { localeFromPath, localePath, pageIdFromPath } from "./path.js";
+function absoluteUrl(path, locale, config) {
+  const site = new URL(config.origin);
+  const base = site.pathname === "/" ? "" : site.pathname.replace(/\/+$/, "");
+  const localized = localePath(path.split(/[?#]/, 1)[0] ?? "/", locale, config);
+  site.pathname = `${base}${localized === "/" ? "/" : localized}`;
+  site.search = "";
+  site.hash = "";
+  return site.toString();
+}
+function pageText(path, locale, config) {
+  const content = config.content[locale];
+  const pageId = pageIdFromPath(path);
+  if (!pageId || pageId === "landing") {
+    return { title: content.brand, description: content.summary };
+  }
+  const document = content.docs[pageId];
+  return {
+    title: `${document.title} | ${content.brand}`,
+    description: document.summary
+  };
+}
+export function localizedHead(path, config) {
+  const locale = localeFromPath(path, config.defaultLocale);
+  const page = pageText(path, locale, config);
+  const canonical = absoluteUrl(path, locale, config);
+  const alternates = config.locales.map((alternate) => ({
+    rel: "alternate",
+    hreflang: alternate,
+    href: absoluteUrl(path, alternate, config)
+  }));
+  return {
+    title: page.title,
+    htmlAttrs: { lang: locale },
+    link: [
+      { rel: "canonical", href: canonical },
+      ...alternates,
+      {
+        rel: "alternate",
+        hreflang: "x-default",
+        href: absoluteUrl(path, config.defaultLocale, config)
+      }
+    ],
+    meta: [
+      { name: "description", content: page.description },
+      { property: "og:locale", content: locale === "ja" ? "ja_JP" : "en_US" },
+      { property: "og:url", content: canonical },
+      { property: "og:title", content: page.title },
+      { property: "og:description", content: page.description }
+    ]
+  };
+}

package/dist/runtime/shared/nuxt-imports.d.ts

@@ -0,0 +1,18 @@
+declare module '#imports' {
+  export function defineNuxtPlugin(plugin: () => void): unknown
+  export const useLocalizedSite: typeof import(
+    '../app/composables/useLocalizedSite'
+  ).useLocalizedSite
+  export function useHead(
+    input: () => import('../core/seo').LocalizedHead
+  ): void
+  export function useRoute(): {
+    path: string
+    fullPath: string
+  }
+  export function useRuntimeConfig(): {
+    public: {
+      nuxtJpLocalizedSite: import('../../contracts/types').ResolvedSiteConfig
+    }
+  }
+}

package/dist/types.d.mts

@@ -0,0 +1,3 @@
+export { default } from './module.mjs'
+
+export { type ModuleOptions, type ResolvedSiteConfig, type SiteConfig, type SupportedLocale } from './module.mjs'

package/examples/content/site.config.json

@@ -0,0 +1,90 @@
+{
+  "schema": "nuxtjp://localized-site/site-config/v1",
+  "siteId": "sample-service-site",
+  "serviceId": "sample-service",
+  "origin": "https://example.test",
+  "audienceScope": "japan",
+  "defaultLocale": "ja",
+  "fallbackLocale": "en",
+  "prefixDefaultLocale": false,
+  "locales": ["ja", "en"],
+  "externalActions": false,
+  "content": {
+    "ja": {
+      "brand": "サンプルサービス",
+      "tagline": "ローカル契約から構築する公開サイト",
+      "summary": "日本語と英語の内容を同じ構造で管理する例です。",
+      "features": [
+        {"id": "local-first", "title": "ローカル完結", "summary": "ビルド時に明示したコンテンツだけを読み取ります。"},
+        {"id": "typed-contract", "title": "型付き契約", "summary": "同じ識別子と文書構造を二言語で検証します。"},
+        {"id": "seo-ready", "title": "SEO対応", "summary": "lang、canonical、hreflangをURL戦略から生成します。"}
+      ],
+      "docs": {
+        "overview": {
+          "slug": "/docs",
+          "title": "概要",
+          "summary": "サービスの構成と責務を説明します。",
+          "sections": [
+            {"id": "purpose", "title": "目的", "body": ["公開情報を小さな契約として安全に提供します。"]}
+          ]
+        },
+        "gettingStarted": {
+          "slug": "/docs/getting-started",
+          "title": "はじめに",
+          "summary": "最小構成でサイトをビルドする手順です。",
+          "sections": [
+            {"id": "install", "title": "導入", "body": ["公開確認済みのパッケージを導入し、設定ファイルを配置します。"]}
+          ]
+        },
+        "security": {
+          "slug": "/docs/security",
+          "title": "セキュリティ",
+          "summary": "情報境界と外部操作の方針です。",
+          "sections": [
+            {"id": "boundary", "title": "境界", "body": ["任意のメンテナンス案内は同一originから読み取ります。外部操作は実装しません。"]}
+          ]
+        }
+      },
+      "privacy": {"label": "プライバシー", "summary": "公開承認済みの情報のみを表示します。"},
+      "contact": {"label": "お問い合わせ", "summary": "連絡方法はサービス運営者が別途定めます。"}
+    },
+    "en": {
+      "brand": "Sample Service",
+      "tagline": "A public site built from a local contract",
+      "summary": "This example maintains Japanese and English in one structure.",
+      "features": [
+        {"id": "local-first", "title": "Local first", "summary": "Only explicitly selected content is read during the build."},
+        {"id": "typed-contract", "title": "Typed contract", "summary": "Both locales share validated identifiers and document structure."},
+        {"id": "seo-ready", "title": "SEO ready", "summary": "URL policy generates lang, canonical, and hreflang metadata."}
+      ],
+      "docs": {
+        "overview": {
+          "slug": "/docs",
+          "title": "Overview",
+          "summary": "Understand the service structure and responsibility.",
+          "sections": [
+            {"id": "purpose", "title": "Purpose", "body": ["Publish approved information through a small contract."]}
+          ]
+        },
+        "gettingStarted": {
+          "slug": "/docs/getting-started",
+          "title": "Getting started",
+          "summary": "Build the site from the minimum consumer files.",
+          "sections": [
+            {"id": "install", "title": "Install", "body": ["Install the verified published package and provide the site configuration."]}
+          ]
+        },
+        "security": {
+          "slug": "/docs/security",
+          "title": "Security",
+          "summary": "Review information boundaries and external-action policy.",
+          "sections": [
+            {"id": "boundary", "title": "Boundary", "body": ["The optional maintenance notice reads same-origin data. The module implements no external actions."]}
+          ]
+        }
+      },
+      "privacy": {"label": "Privacy", "summary": "Only information approved for publication is rendered."},
+      "contact": {"label": "Contact", "summary": "The service operator defines the contact channel separately."}
+    }
+  }
+}