create-zudo-doc 0.1.0

package/templates/features/tauriDev/files/src-tauri-dev/tauri.conf.json

@@ -0,0 +1,22 @@
+{
+  "productName": "zudo-doc dev",
+  "version": "0.1.0",
+  "identifier": "com.takazudo.zudo-doc-dev",
+  "build": {
+    "frontendDist": "./frontend",
+    "beforeDevCommand": "cd .. && pnpm dev",
+    "devUrl": "http://localhost:4321/"
+  },
+  "app": {
+    "windows": [],
+    "withGlobalTauri": true,
+    "security": { "csp": null }
+  },
+  "bundle": {
+    "active": true,
+    "targets": "all",
+    "icon": ["icons/icon.png"],
+    "category": "DeveloperTool",
+    "macOS": { "minimumSystemVersion": "10.15" }
+  }
+}

package/templates/features/tauriDev/files/src-tauri-dev/test-launch.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# Test script: launch app via open (Finder simulation), verify dev server loads.
+# Usage: bash test-launch.sh [count]
+#   count  — number of launch iterations (default 3)
+# Exits 0 on success, 1 on failure.
+#
+# The script reads the port from devServerUrl in a known test config.json, or
+# accepts it via the DEV_PORT env var. Readiness is checked by curling
+# <devServerUrl>/ (root), not /___ready — zfb dev server has no /___ready endpoint.
+#
+# The app must already be built: src-tauri-dev/target/release/bundle/macos/zudo-doc\ dev.app
+
+COUNT=${1:-3}
+PASS=0
+FAIL=0
+
+# Port to check: parse from test config, or fall back to env var / default 4321
+TEST_CONFIG="${HOME}/Library/Application Support/com.takazudo.zudo-doc-dev/config.json"
+if [ -f "$TEST_CONFIG" ]; then
+  DEV_SERVER_URL=$(python3 -c "import json,sys; d=json.load(open(sys.argv[1])); print(d.get('devServerUrl',''))" "$TEST_CONFIG" 2>/dev/null)
+  DEV_PORT=$(echo "$DEV_SERVER_URL" | sed 's/.*:\([0-9]*\).*/\1/')
+fi
+DEV_PORT="${DEV_PORT:-${DEV_PORT_OVERRIDE:-4321}}"
+READY_URL="http://localhost:${DEV_PORT}/"
+
+echo "Using port: ${DEV_PORT} (ready URL: ${READY_URL})"
+
+for RUN in $(seq 1 "$COUNT"); do
+  echo "=== Run $RUN/$COUNT ==="
+
+  # Kill everything
+  ps aux | grep "zudo-doc-dev" | grep -v grep | awk '{print $2}' | xargs kill 2>/dev/null
+  lsof -ti :"$DEV_PORT" | xargs kill 2>/dev/null
+  sleep 3
+
+  # Launch via open (use build output or override)
+  APP_PATH="${APP_OVERRIDE:-$(dirname "$0")/target/release/bundle/macos/zudo-doc dev.app}"
+  open "$APP_PATH"
+
+  # Wait up to 60s for dev server to be available
+  OK=0
+  for i in $(seq 1 20); do
+    sleep 3
+    READY=$(curl -s -o /dev/null -w "%{http_code}" "$READY_URL" 2>/dev/null)
+    if [ "$READY" = "200" ]; then
+      echo "  Run $RUN: PASS (ready at $((i*3))s, HTTP 200 at ${READY_URL})"
+      OK=1
+      PASS=$((PASS + 1))
+      break
+    fi
+  done
+
+  if [ "$OK" = "0" ]; then
+    echo "  Run $RUN: FAIL (server not ready after 60s)"
+    FAIL=$((FAIL + 1))
+  fi
+done
+
+# Cleanup
+ps aux | grep "zudo-doc-dev" | grep -v grep | awk '{print $2}' | xargs kill 2>/dev/null
+lsof -ti :"$DEV_PORT" | xargs kill 2>/dev/null
+
+echo ""
+echo "=== Results: $PASS/$COUNT passed, $FAIL failed ==="
+[ "$FAIL" -gt 0 ] && exit 1 || exit 0

package/templates/features/versioning/files/pages/[locale]/docs/versions.tsx

@@ -0,0 +1,100 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Port of src/pages/[locale]/docs/versions.astro → zfb page module.
+//
+// Non-default-locale versions page. paths() emits one route per locale in
+// settings.locales. Locale string is passed as a prop to drive label
+// translation in the component.
+//
+// paths() contract (zfb ADR-004 — synchronous):
+//   params: { locale: string }
+//   props:  { locale }
+
+import { settings } from "@/config/settings";
+import { t } from "@/config/i18n";
+import { withBase } from "@/utils/base";
+import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+import { VersionsPageContent } from "@takazudo/zudo-doc/nav-indexing";
+import type { VersionPageEntry, VersionsPageLabels } from "@takazudo/zudo-doc/nav-indexing";
+import type { JSX } from "preact";
+import { FooterWithDefaults } from "../../lib/_footer-with-defaults";
+import { HeaderWithDefaults } from "../../lib/_header-with-defaults";
+import { HeadWithDefaults } from "../../lib/_head-with-defaults";
+import { composeMetaTitle } from "../../lib/_compose-meta-title";
+import { BodyEndIslands } from "../../lib/_body-end-islands";
+
+export const frontmatter = { title: "Versions" };
+
+// ---------------------------------------------------------------------------
+// paths() — synchronous (ADR-004)
+// ---------------------------------------------------------------------------
+
+/** One route per non-default locale. */
+export function paths(): Array<{
+  params: { locale: string };
+  props: { locale: string };
+}> {
+  return Object.keys(settings.locales).map((locale) => ({
+    params: { locale },
+    props: { locale },
+  }));
+}
+
+// ---------------------------------------------------------------------------
+// Page component
+// ---------------------------------------------------------------------------
+
+interface PageArgs {
+  params: { locale: string };
+  props: { locale: string };
+}
+
+export default function LocaleVersionsPage({ params }: PageArgs): JSX.Element {
+  const locale = params.locale;
+  const pageTitle = t("version.page.title", locale);
+
+  const labels: VersionsPageLabels = {
+    pageTitle,
+    latestTitle: t("version.page.latest.title", locale),
+    latestDescription: t("version.page.latest.description", locale),
+    latestLink: t("version.page.latest.link", locale),
+    pastTitle: t("version.page.past.title", locale),
+    pastDescription: t("version.page.past.description", locale),
+    unmaintained: t("version.page.unmaintained", locale),
+    unreleased: t("version.page.unreleased", locale),
+    versionCol: t("version.switcher.label", locale),
+    statusCol: t("version.page.status", locale),
+    docsCol: t("version.page.docs", locale),
+  };
+
+  const latestHref = withBase(`/${locale}/docs/getting-started`);
+
+  const versions: VersionPageEntry[] = settings.versions
+    ? settings.versions.map((v) => ({
+        slug: v.slug,
+        label: v.label ?? v.slug,
+        docsHref: withBase(`/${locale}/v/${v.slug}/docs/getting-started/`),
+        banner: v.banner as "unmaintained" | "unreleased" | undefined,
+      }))
+    : [];
+
+  return (
+    <DocLayoutWithDefaults
+      title={composeMetaTitle(pageTitle)}
+      head={<HeadWithDefaults title={pageTitle} />}
+      lang={locale}
+      noindex={settings.noindex}
+      hideSidebar={true}
+      hideToc={true}
+      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase(`/${locale}/docs/versions`)} />}
+      footerOverride={<FooterWithDefaults lang={locale} />}
+      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+    >
+      <VersionsPageContent
+        latestHref={latestHref}
+        versions={versions}
+        labels={labels}
+      />
+    </DocLayoutWithDefaults>
+  );
+}

package/templates/features/versioning/files/pages/docs/versions.tsx

@@ -0,0 +1,78 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+// Port of src/pages/docs/versions.astro → zfb page module.
+//
+// Default-locale (EN) documentation versions page. Static route — no
+// paths() export needed. Lists the latest version and any past versions
+// configured in settings.versions.
+//
+// Data flow:
+//   settings.versions          → build version entry list
+//   t() for locale strings     → labels bag passed to VersionsPageContent
+
+import { settings } from "@/config/settings";
+import { defaultLocale, t } from "@/config/i18n";
+import { withBase } from "@/utils/base";
+import { DocLayoutWithDefaults } from "@takazudo/zudo-doc/doclayout";
+import { VersionsPageContent } from "@takazudo/zudo-doc/nav-indexing";
+import type { VersionPageEntry, VersionsPageLabels } from "@takazudo/zudo-doc/nav-indexing";
+import type { JSX } from "preact";
+import { FooterWithDefaults } from "../lib/_footer-with-defaults";
+import { HeaderWithDefaults } from "../lib/_header-with-defaults";
+import { HeadWithDefaults } from "../lib/_head-with-defaults";
+import { composeMetaTitle } from "../lib/_compose-meta-title";
+import { BodyEndIslands } from "../lib/_body-end-islands";
+
+export const frontmatter = { title: "Versions" };
+
+export default function VersionsPage(): JSX.Element {
+  const locale = defaultLocale;
+  const pageTitle = t("version.page.title", locale);
+
+  const labels: VersionsPageLabels = {
+    pageTitle,
+    latestTitle: t("version.page.latest.title", locale),
+    latestDescription: t("version.page.latest.description", locale),
+    latestLink: t("version.page.latest.link", locale),
+    pastTitle: t("version.page.past.title", locale),
+    pastDescription: t("version.page.past.description", locale),
+    unmaintained: t("version.page.unmaintained", locale),
+    unreleased: t("version.page.unreleased", locale),
+    versionCol: t("version.switcher.label", locale),
+    statusCol: t("version.page.status", locale),
+    docsCol: t("version.page.docs", locale),
+  };
+
+  // Latest docs href — points to the default docs entry point
+  const latestHref = withBase("/docs/getting-started");
+
+  // Past version entries from settings
+  const versions: VersionPageEntry[] = settings.versions
+    ? settings.versions.map((v) => ({
+        slug: v.slug,
+        label: v.label ?? v.slug,
+        docsHref: withBase(`/v/${v.slug}/docs/getting-started/`),
+        banner: v.banner as "unmaintained" | "unreleased" | undefined,
+      }))
+    : [];
+
+  return (
+    <DocLayoutWithDefaults
+      title={composeMetaTitle(pageTitle)}
+      head={<HeadWithDefaults title={pageTitle} />}
+      lang={locale}
+      noindex={settings.noindex}
+      hideSidebar={true}
+      hideToc={true}
+      headerOverride={<HeaderWithDefaults lang={locale} currentPath={withBase("/docs/versions")} />}
+      footerOverride={<FooterWithDefaults lang={locale} />}
+      bodyEndComponents={<BodyEndIslands basePath={settings.base ?? "/"} />}
+    >
+      <VersionsPageContent
+        latestHref={latestHref}
+        versions={versions}
+        labels={labels}
+      />
+    </DocLayoutWithDefaults>
+  );
+}