create-zudo-doc 0.2.21 → 1.0.0

package/templates/features/bodyFootUtil/files/src/utils/github.ts

@@ -1,19 +1,22 @@
-import { settings } from "@/config/settings";
+// Host thin-stub — see @takazudo/zudo-doc/github-helpers (epic #2344, S7).
+//
+// `buildGitHubRepoUrl` and `buildGitHubSourceUrl` are now parameterized pure
+// functions in the package; this module wraps them with the host's
+// `settings.githubUrl` singleton.
 
-function trimTrailingSlash(url: string): string {
-  return url.replace(/\/+$/, "");
-}
+import { settings } from "@/config/settings";
+import {
+  buildGitHubRepoUrl as _buildGitHubRepoUrl,
+  buildGitHubSourceUrl as _buildGitHubSourceUrl,
+} from "@takazudo/zudo-doc/github-helpers";
 
 export function buildGitHubRepoUrl(): string | null {
-  if (!settings.githubUrl) return null;
-  return trimTrailingSlash(settings.githubUrl as string);
+  return _buildGitHubRepoUrl(settings.githubUrl);
 }
 
 export function buildGitHubSourceUrl(
   contentDir: string,
   entryId: string,
 ): string | null {
-  const repoUrl = buildGitHubRepoUrl();
-  if (!repoUrl) return null;
-  return `${repoUrl}/blob/HEAD/${contentDir}/${entryId}`;
+  return _buildGitHubSourceUrl(settings.githubUrl, contentDir, entryId);
 }

package/templates/features/designTokenPanel/files/src/lib/design-token-panel-bootstrap.ts

@@ -3,47 +3,21 @@
  *
  * Imported as a side-effect from the body-end islands helper when
  * settings.designTokenPanel is truthy. The dynamic import is gated there so
- * this module is only bundled
- * when the feature is enabled.
+ * this module is only bundled when the feature is enabled.
  *
- * Lifecycle adapter: wires zdtp's navigation hooks to zfb's own navigation
- * events via setLifecycleAdapter(). onBeforeSwap maps to zfb:before-preparation
- * and onPageLoad maps to zfb:after-swap so zdtp re-applies persisted token
- * overrides on every soft navigation without depending on Astro events.
+ * The wiring MECHANISM (configurePanel + setLifecycleAdapter) now lives in the
+ * package at `@takazudo/zudo-doc/design-token-panel-bootstrap`. This file
+ * passes the project's PanelConfig DATA to that mechanism.
+ *
+ * S9a package-first migration — zudolab/zudo-doc#2333.
+ *
+ * CSS is pulled via `@import "@takazudo/zdtp/styles.css"` in
+ * src/styles/global.css so the panel chrome lands in the main page CSS bundle
+ * (not a deferred chunk). Vite library mode strips the source CSS import from
+ * the emitted JS, so the explicit CSS-side import is the required pull point.
  */
 
-import { configurePanel, setLifecycleAdapter, type LifecycleAdapter } from "@takazudo/zdtp";
-// CSS is pulled via `@import "@takazudo/zdtp/styles.css"` in
-// src/styles/global.css so the panel chrome lands in the main page CSS bundle
-// (not a deferred chunk). Vite library mode strips the source CSS import from
-// the emitted JS, so the explicit CSS-side import is the required pull point.
+import { bootstrapDesignTokenPanel } from "@takazudo/zudo-doc/design-token-panel-bootstrap";
 import { designTokenPanelConfig } from "@/config/design-token-panel-config";
 
-configurePanel(designTokenPanelConfig);
-
-// Drain the pre-hydration click queue. If the user clicked the palette button
-// before this module evaluated, a pre-hydration shim captured the event as a
-// single boolean flag. Calling __zdtpReadyClicks() here removes the shim
-// listener and re-dispatches once (at most) so the now-registered zdtp
-// listener picks it up and mounts the panel.
-if (typeof window !== "undefined") {
-  (window as { __zdtpReadyClicks?: () => void }).__zdtpReadyClicks?.();
-}
-
-// zfb fires "zfb:before-preparation" (before nav) and "zfb:after-swap" (after nav).
-// Adjust these event names if your zfb version uses different names.
-if (typeof document !== "undefined") {
-  const adapter: LifecycleAdapter = {
-    onBeforeSwap(cb) {
-      const handler = () => cb();
-      document.addEventListener("zfb:before-preparation", handler);
-      return () => document.removeEventListener("zfb:before-preparation", handler);
-    },
-    onPageLoad(cb) {
-      const handler = () => cb();
-      document.addEventListener("zfb:after-swap", handler);
-      return () => document.removeEventListener("zfb:after-swap", handler);
-    },
-  };
-  setLifecycleAdapter(adapter);
-}
+bootstrapDesignTokenPanel(designTokenPanelConfig);