@orbytes/astrolab 0.3.0

package/src/core/LICENSE-astrobook

@@ -0,0 +1,166 @@
+Everything under src/core/, src/ui/ and src/types/ is vendored from Astrobook.
+
+  Upstream:  https://github.com/ocavue/astrobook
+  Version:   0.13.3
+  Commit:    a79f03cdfd32eb08330b33fa7d5830ac506f9272
+
+This notice lives under src/core/ for historical reasons — that was the only vendored directory
+when it was written, on 2026-09-21 — and it governs all three. What each one is:
+
+  src/core/    the upstream package `@astrobook/core` (packages/core/src/ → src/core/) plus the
+               hand-written Astro components of the `astrobook` package (packages/astrobook/lib/
+               → src/core/lib/).
+  src/ui/      the upstream package `@astrobook/ui` (packages/ui/src/ → src/ui/), vendored
+               2026-09-22.
+  src/types/   the upstream package `@astrobook/types` (packages/types/lib/ → src/types/),
+               vendored 2026-09-22.
+
+So this package depends on no astrobook npm package at all, and on nothing outside Astro itself.
+The upstream layout is mirrored in each case so a future `diff -r` against an upstream tag stays
+possible.
+
+THE CONVENTION, UNCHANGED: a file here is byte-identical to upstream unless it opens with a
+`// Vendored from astrobook 0.13.3 (…)` header, and that header names what changed in it. So
+`diff -r` against a future upstream checkout shows real upstream changes, and the headers are the
+list of what to re-apply. Four files carry no header and no change: core/utils/get-exports.ts,
+core/utils/invariant.ts, core/utils/path.ts, core/virtual-module/virtual-module-ids.ts. Under
+core/lib/, four of the six .astro files are unchanged (components/head.astro,
+components/empty.astro, components/with-decorators.astro, and — apart from one import — nothing
+else); every file under src/ui/ and src/types/ carries a header, because every one of them
+changed.
+
+THE VIRTUAL MODULE IDS ARE UPSTREAM'S AND MUST STAY THAT WAY. The vendored core emits
+`virtual:astrobook/story-modules.mjs` and its siblings (core/virtual-module/virtual-module-ids.ts)
+and the vendored UI imports them by name. Both sides are ours now, so renaming them to
+`virtual:orbytes-lab/*` is possible — it is pure churn with silent-breakage risk, so it is later
+cleanup and deliberately not part of the 2026-09-22 pass.
+
+--------------------------------------------------------------------------------
+Every deliberate divergence in src/core/
+--------------------------------------------------------------------------------
+
+1. Relative imports carry the `.ts` extension. Upstream is bundled by tsdown before it ships;
+   this package ships source, and node cannot resolve an extensionless specifier. Astro loads
+   astro.config.mjs with a plain node import() first, so this graph has to load under node.
+2. `src/core/lib-paths.ts` is new. It resolves the vendored `.astro` files and client.ts to
+   absolute posix paths from `import.meta.url`, replacing the bare `astrobook/pages/story.astro`,
+   `astrobook/components/with-decorators.astro`, `astrobook/client`,
+   `astrobook/components/{head,home,empty}.astro` and `astrobook/pages/app.astro` specifiers that
+   upstream emits into generated routes, injects as a route entrypoint, and uses as option
+   defaults. A bare specifier resolves to the wrong checkout's copy in an agent git worktree
+   (measured on a real consuming site); an absolute path cannot.
+3. `src/core/utils/kebab-case.ts` is new: `just-kebab-case@4.2.0`, inlined. Upstream imports it
+   but declares it only as a devDependency, because tsdown bundles it into the published artifact.
+   Nothing bundles here, so it is inlined from that artifact instead.
+4. `options.ts` is rewritten in plain TypeScript. Upstream expresses it as a valibot schema;
+   valibot is 1.8 MB for one caller. Same option names, same defaults, same `home: false`
+   transform, same resolved shape, same thrown-message layout. The upstream version string used
+   for the home page's version-badge label is inlined as `0.13.3`.
+5. `picomatch` is declared by upstream `@astrobook/core` and imported nowhere in it, so it is not
+   carried over.
+6. The `*.spec.ts` / `*.test.ts` files are not vendored — this package has no test runner.
+7. Type imports point at `src/types/` by relative path rather than at the `@astrobook/types`
+   package (2026-09-22).
+8. `src/core/lib/pages/preview.astro` is new, and `virtual-routes.ts` picks between it and
+   `story.astro` per route (2026-09-22). Upstream routes the dashboard and the bare story through
+   one page, so a bare story also received the lab's chrome. Splitting them is what lets the
+   lab's own styling stop at the preview's edge — see src/ui/lab.css.
+
+--------------------------------------------------------------------------------
+Every deliberate divergence in src/ui/ (all of it added 2026-09-22)
+--------------------------------------------------------------------------------
+
+9.  NO UNOCSS. Upstream's UI is written in UnoCSS atomic classes (`:uno: flex shrink-0 …`) and
+    three shortcuts, compiled by `unocss --rewrite` at publish time into a 24 KB `style.css` of
+    hashed `astrobook-7fpo4s` class names. This package ships source and has no build step, so
+    every utility string is replaced by a semantic class — `.lab-sidebar__nav`, `.lab-tree-row`,
+    `.lab-search__input` — and every rule lives in one hand-written stylesheet, `src/ui/lab.css`.
+    Upstream's `src/style.css` (a placeholder for the generated file) and `uno.config.ts` are not
+    vendored. Neither are the icon classes: `presetIcons` turned `i-fluent-search-16-regular` and
+    friends into background images at build time, so each is now an inline `<svg>`.
+10. THE CHROME NO LONGER RECEIVES THE CONSUMER'S CSS OR HEAD (decided 2026-09-22: the lab's own
+    furniture looks the same in every repo it is installed in, and only the rendered story takes
+    the site's styling). Upstream's `layout.astro` imported `virtual:astrobook/user-css.mjs` last, "so it
+    can override built-in styles". Here the consumer's stylesheets and head component reach the
+    PREVIEW only. Three layouts where upstream had one:
+      layout.astro            the chrome shell. No consumer CSS, no consumer head. `/lab`.
+      dashboard-layout.astro  NEW. The chrome plus the story inside it — the one document that
+                              carries both stylesheets, because it is both things at once.
+      preview-layout.astro    NEW. The bare story: consumer CSS and head, none of the lab's own.
+    `layout.astro` also gained a `<slot name="head" />` so a wrapping layout can add to the head
+    without this file importing anything. Full reasoning: src/ui/lab.css.
+11. `astro-theme-toggle` is vendored, not depended on: `theme-script.astro`, `theme-toggle.astro`
+    and `theme.ts` are written for this package. Same `theme-toggle` localStorage key, same
+    `.dark` class, `data-theme` and `color-scheme` on <html>, same `astro:after-swap` re-apply, so
+    an existing reader's stored preference carries over. Dropped: the ripple
+    `startViewTransition` animation. Why the dependency went, at length: theme-script.astro.
+12. `customElements.define` calls are guarded with `customElements.get`, so a second definition on
+    a view-transition swap cannot throw.
+13. `build-path.ts` imports `createPathBuilder` from the vendored core by relative path rather
+    than from `@astrobook/core/client`, and the `import '@astrobook/types'` side-effect lines are
+    gone — the ambient declarations they pulled in live in src/types/virtual.d.ts.
+
+--------------------------------------------------------------------------------
+Every deliberate divergence in src/types/ (all of it added 2026-09-22)
+--------------------------------------------------------------------------------
+
+14. `lib/types.d.ts` → `types.ts` and `lib/index.d.ts` + `lib/index.js` → one `index.ts`. The
+    bodies are interfaces and one `declare global`, so they emit nothing at runtime and every
+    importer uses `import type`; a plain `.ts` is what the vendored core can import by relative
+    path without `allowImportingTsExtensions`. `virtual.d.ts` keeps its extension and its module
+    ids, and its one internal import is spelled `./types.js` as node16 resolution requires.
+15. The option doc comments for `css` and `head` gained a line saying they now reach the preview
+    only. Nothing else in the text changed.
+
+--------------------------------------------------------------------------------
+
+MIT License
+
+Copyright (c) 2024 ocavue
+
+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.
+
+--------------------------------------------------------------------------------
+
+astro-theme-toggle (vendored in part — see divergence 11 above)
+
+  Upstream:  https://github.com/ocavue/astro-theme-toggle
+  Version:   0.8.2
+
+MIT License
+
+Copyright (c) 2025 ocavue
+
+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/src/core/astro-integration.ts

@@ -0,0 +1,166 @@
+// Vendored from astrobook 0.13.3 (astro-integration.ts) — see ./LICENSE-astrobook.
+// Divergence: relative imports carry the .ts extension so node can load this graph directly
+// (upstream is bundled before it ships; this package is not).
+// Divergence: the specifiers this file injects as a route entrypoint are absolute paths into ./lib-paths.ts rather
+// than bare `astrobook/...` ids — see that file for why.
+import fs from 'node:fs/promises'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import type { IntegrationOptions } from '../types/types.ts'
+import type { AstroIntegration } from 'astro'
+import colors from 'yoctocolors'
+
+import { APP_PAGE } from './lib-paths.ts'
+import { resolveOptions } from './options.ts'
+import { createPathBuilder } from './utils/path-builder.ts'
+import {
+  createVirtualRouteComponent,
+  getVirtualRoutes,
+} from './virtual-module/virtual-routes.ts'
+import { createVirtualFilesPlugin } from './virtual-module/vite-plugin.ts'
+
+export type { IntegrationOptions }
+
+export function createAstrobookIntegration(
+  userOptions?: IntegrationOptions,
+): AstroIntegration {
+  let astrobookBaseForLogging: string | undefined
+
+  const resolvedOptions = resolveOptions(userOptions)
+
+  return {
+    name: 'astrobook',
+    hooks: {
+      'astro:config:setup': async ({
+        updateConfig,
+        injectRoute,
+        createCodegenDir,
+        config,
+        logger,
+        command,
+      }) => {
+        const rootDir = path.resolve(
+          fileURLToPath(config.root),
+          resolvedOptions.directory,
+        )
+
+        const astroBase = config.base || ''
+
+        // The subpaths are relative to the Astro base path.
+        const astrobookSubpath = resolvedOptions.subpath
+
+        const buildPath = createPathBuilder({
+          trailingSlash: config.trailingSlash,
+        })
+
+        const dashboardSubpath = buildPath(
+          astrobookSubpath,
+          resolvedOptions.dashboardSubpath,
+        )
+        const previewSubpath = buildPath(
+          astrobookSubpath,
+          resolvedOptions.previewSubpath,
+        )
+
+        if (dashboardSubpath === previewSubpath) {
+          throw new Error(
+            '[Astrobook] The dashboard and preview subpaths cannot be the same. Please set different values for `dashboardSubpath` and `previewSubpath` options.',
+          )
+        }
+
+        const astrobookBase = buildPath(astroBase, astrobookSubpath)
+        const dashboardBase = buildPath(astroBase, dashboardSubpath)
+        const storyBase = buildPath(astroBase, previewSubpath)
+
+        // If subpath is set, Astrobook is only part of the current Astro
+        // project. In this case, we want to print the URL of the Astrobook
+        // entrypoint for easy access.
+        if (astrobookSubpath && command === 'dev') {
+          astrobookBaseForLogging = astrobookBase
+        } else {
+          astrobookBaseForLogging = undefined
+        }
+
+        logger.debug(`Creating dedicated folder`)
+        const codegenDir: string = fileURLToPath(createCodegenDir())
+
+        logger.debug(`Created dedicated folder at ${codegenDir}`)
+
+        logger.debug(`Scanning for stories in ${rootDir}`)
+
+        const routes = await getVirtualRoutes(
+          rootDir,
+          codegenDir,
+          logger,
+          dashboardSubpath,
+          previewSubpath,
+          buildPath,
+        )
+
+        logger.debug(`Writing files to ${codegenDir}`)
+        await Promise.all(
+          Array.from(routes.values(), async (route) => {
+            const filePath = route.entrypoint
+            const fileContent = createVirtualRouteComponent(route)
+            await fs.mkdir(path.dirname(filePath), { recursive: true })
+            await fs.writeFile(filePath, fileContent, { encoding: 'utf-8' })
+          }),
+        )
+
+        updateConfig({
+          vite: {
+            plugins: [
+              createVirtualFilesPlugin(
+                rootDir,
+                {
+                  astrobookBase,
+                  dashboardBase,
+                  storyBase,
+                  head: resolvedOptions.head,
+                  home: resolvedOptions.home,
+                  homeContent: resolvedOptions.homeContent,
+                  css: resolvedOptions.css,
+                  title: resolvedOptions.title,
+                  trailingSlash: config.trailingSlash,
+                },
+                config,
+                logger,
+              ),
+            ],
+          },
+        })
+
+        logger.debug(`Injecting routes`)
+        for (const route of routes.values()) {
+          injectRoute({
+            pattern: route.pattern,
+            entrypoint: route.entrypoint,
+            prerender: true,
+          })
+        }
+        injectRoute({
+          pattern: astrobookSubpath,
+          entrypoint: APP_PAGE,
+          prerender: true,
+        })
+      },
+      'astro:server:start': ({ logger, address }) => {
+        if (astrobookBaseForLogging) {
+          const url = new URL(
+            astrobookBaseForLogging,
+            `http://localhost:${address.port}`,
+          )
+          const message =
+            colors.bgGreen(colors.white(colors.bold(' astrobook '))) +
+            ' is available at ' +
+            colors.cyan(url.href)
+          // Get a logger that don't print the label and the current time
+          // https://github.com/withastro/astro/blob/ff72ebe/packages/astro/src/core/logger/core.ts#L38
+          const plainLogger = logger.fork('SKIP_FORMAT')
+          plainLogger.info(message)
+        }
+      },
+    },
+  }
+}

package/src/core/client.ts

@@ -0,0 +1,89 @@
+// Vendored from astrobook 0.13.3 (client.ts) — see LICENSE-astrobook.
+// Divergence: relative imports carry the .ts extension so node can load this graph directly
+// (upstream is bundled before it ships; this package is not).
+import type { StoryNamedExport } from '../types/types.ts'
+import type { AstroComponentFactory } from 'astro/runtime/server/index.js'
+
+export { createPathBuilder, type PathBuilder } from './utils/path-builder.ts'
+
+// Copy from https://github.com/withastro/astro/blob/astro@5.0.0/packages/astro/src/runtime/server/render/astro/factory.ts#L15
+function isAstroComponentFactory(obj: unknown): obj is AstroComponentFactory {
+  return obj == null
+    ? false
+    : (obj as Record<string, unknown>).isAstroComponentFactory === true
+}
+
+/**
+ * @internal
+ */
+export function parseStoryDefaultExport(
+  module: Record<string, unknown>,
+  importPath: string,
+): {
+  isAstroComponent: boolean
+} {
+  const defaultExport = 'default' in module ? module['default'] : undefined
+  if (!defaultExport) {
+    throw new TypeError(
+      `[astrobook] '${importPath}' should have a default export`,
+    )
+  }
+  if (typeof defaultExport !== 'object') {
+    throw new TypeError(
+      `[astrobook] '${importPath}' default export should be an object, but got ${typeof defaultExport}`,
+    )
+  }
+
+  const component =
+    'component' in defaultExport ? defaultExport.component : undefined
+  if (!component) {
+    throw new TypeError(
+      `[astrobook] '${importPath}' default export should have a component property`,
+    )
+  }
+
+  // Whether the component is an Astro component or not (e.g. React, Vue, etc.)
+  const isAstroComponent: boolean = isAstroComponentFactory(component)
+
+  return { isAstroComponent }
+}
+
+/**
+ * @internal
+ */
+export function parseStoryNamedExport(
+  module: Record<string, unknown>,
+  importPath: string,
+  storyName: string,
+): StoryNamedExport {
+  const storyObject: unknown =
+    module && typeof module === 'object' ? module[storyName] : undefined
+  if (!storyObject) {
+    throw new Error(
+      `[astrobook] Unable to find named export '${storyName}' from '${importPath}'`,
+    )
+  }
+  if (typeof storyObject !== 'object') {
+    throw new TypeError(
+      `[astrobook] Named export '${storyName}' from '${importPath}' should be an object, but got ${typeof storyObject}`,
+    )
+  }
+
+  const decorators =
+    'decorators' in storyObject ? storyObject.decorators : undefined
+
+  if (decorators != null && !Array.isArray(decorators)) {
+    throw new TypeError(
+      `[astrobook] The 'decorators' property of the named export '${storyName}' from '${importPath}' should be an array or undefined, but got ${typeof decorators}`,
+    )
+  }
+
+  const args = 'args' in storyObject ? storyObject.args : undefined
+  if (args != null && typeof args !== 'object') {
+    throw new TypeError(
+      `[astrobook] The 'args' property of the named export '${storyName}' from '${importPath}' should be an object or undefined, but got ${typeof args}`,
+    )
+  }
+
+  return { decorators, args }
+}

package/src/core/index.ts

@@ -0,0 +1,7 @@
+// Vendored from astrobook 0.13.3 (index.ts) — see LICENSE-astrobook.
+// Divergence: relative imports carry the .ts extension so node can load this graph directly
+// (upstream is bundled before it ships; this package is not).
+export {
+  createAstrobookIntegration,
+  type IntegrationOptions,
+} from './astro-integration.ts'

package/src/core/lib/components/empty.astro

@@ -0,0 +1 @@
+<!-- Empty home component, used when `home: false` is set in the Astrobook integration options -->

package/src/core/lib/components/head.astro

@@ -0,0 +1 @@
+<slot />

package/src/core/lib/components/home.astro

@@ -0,0 +1,8 @@
+---
+// Vendored from astrobook 0.13.3 (packages/astrobook/lib/components/home.astro) — see
+// ../../LICENSE-astrobook.
+// Divergence: `@astrobook/ui/components/home.astro` → the vendored UI, by relative path.
+import Home from '../../../ui/components/home.astro'
+---
+
+<Home />

package/src/core/lib/components/with-decorators.astro

@@ -0,0 +1,22 @@
+---
+interface Decorator {
+  component: any
+  props?: any
+}
+
+interface Props {
+  decorators?: Decorator[] | null | undefined
+}
+
+const decorators: Decorator[] = (Astro.props.decorators || []).slice().reverse()
+---
+
+{
+  decorators.reduce(
+    (children, decorator) => {
+      const Decorator = decorator.component
+      return <Decorator {...decorator?.props}>{children}</Decorator>
+    },
+    <slot />,
+  )
+}

package/src/core/lib/pages/app.astro

@@ -0,0 +1,19 @@
+---
+// Vendored from astrobook 0.13.3 (packages/astrobook/lib/pages/app.astro) — see
+// ../../LICENSE-astrobook.
+// Divergence: `@astrobook/ui/components/app.astro` → the vendored UI, by relative path.
+import AppComponent from '../../../ui/components/app.astro'
+import type { GetStaticPathsResult } from 'astro'
+
+export function getStaticPaths(): GetStaticPathsResult {
+  return [
+    {
+      params: {
+        path: undefined,
+      },
+    },
+  ]
+}
+---
+
+<AppComponent />

package/src/core/lib/pages/preview.astro

@@ -0,0 +1,17 @@
+---
+// The bare story page — <subpath>/stories/<id>. New in this package: upstream routed the preview
+// through the same `story.astro` as the dashboard, so a bare story also received the lab's
+// chrome stylesheet, its head and its scripts.
+//
+// ../../virtual-module/virtual-routes.ts picks this page for the preview route and ./story.astro
+// for the dashboard route. The split exists so the lab's own styling stops at the preview's edge
+// (decided 2026-09-22 — ../../../ui/lab.css).
+import LayoutComponent from '../../../ui/components/preview-layout.astro'
+import type { ComponentProps } from 'astro/types'
+
+type Props = ComponentProps<typeof LayoutComponent>
+---
+
+<LayoutComponent {...Astro.props}>
+  <slot />
+</LayoutComponent>

package/src/core/lib/pages/story.astro

@@ -0,0 +1,16 @@
+---
+// Vendored from astrobook 0.13.3 (packages/astrobook/lib/pages/story.astro) — see
+// ../../LICENSE-astrobook.
+// Divergence: `@astrobook/ui/components/layout.astro` → the vendored UI's DASHBOARD layout, by
+// relative path. Upstream used one layout for the dashboard and the bare story alike; this page
+// is now the dashboard only (chrome + the story inside it), and the bare story route renders
+// through ./preview.astro. Why the two split: ../../../ui/lab.css.
+import LayoutComponent from '../../../ui/components/dashboard-layout.astro'
+import type { ComponentProps } from 'astro/types'
+
+type Props = ComponentProps<typeof LayoutComponent>
+---
+
+<LayoutComponent {...Astro.props}>
+  <slot />
+</LayoutComponent>

package/src/core/lib-paths.ts

@@ -0,0 +1,72 @@
+// Absolute paths to the vendored .astro files in ./lib/ — the one file in src/core/ with no
+// upstream counterpart.
+//
+// Upstream emits BARE specifiers for these ('astrobook/pages/story.astro' and friends), which
+// node resolves by walking up for a node_modules directory. In an agent git worktree that walk
+// leaves the checkout and finds the MAIN clone's copy, so the worktree's own edits are silently
+// ignored — measured 2026-09-06 on a real consuming site. An absolute path computed from
+// import.meta.url cannot go wrong
+// that way: it names this file's own neighbour, in whichever checkout this file was loaded from.
+//
+// Posix slashes via slash(), matching how virtual-routes.ts normalises the entrypoints it
+// generates; Vite resolves an absolute fs path in an import specifier, which is already how
+// upstream emits the story module's own import.
+import { fileURLToPath } from 'node:url'
+
+import slash from 'slash'
+
+/**
+ * The base these paths resolve against — ALWAYS `src/core/`, even when this module is the compiled
+ * copy in `dist/core/`.
+ *
+ * Why it cannot just be `import.meta.url`. For npm, `scripts/build-core.mjs` compiles this tree to
+ * `dist/core/` so Node can load it from inside `node_modules` (Node refuses to strip types there).
+ * The `.astro` files named below do NOT move with it, and must not: they import sideways into
+ * `../../ui/`, so a copy under `dist/` would need a second copy of the whole UI beside it — and
+ * two copies of the UI in one build means duplicate components and duplicate CSS in the
+ * consumer's output. Measured: moving them produced
+ * `Could not resolve '../../../ui/components/app.astro'`.
+ *
+ * So the compiled copy reaches back across the two directories to the real ones. `endsWith` rather
+ * than `includes`, so a consumer whose own project path happens to contain `dist/core` cannot
+ * trip it.
+ */
+const LIB_BASE = new URL(
+  import.meta.url.endsWith('/dist/core/lib-paths.js') ? '../../src/core/' : './',
+  import.meta.url,
+)
+
+function libFile(relative: string): string {
+  return slash(fileURLToPath(new URL(relative, LIB_BASE)))
+}
+
+/** The vendored `@astrobook/core` client helpers, imported by every generated route. */
+export const CLIENT_MODULE = libFile('./client.ts')
+
+/** `astrobook/pages/story.astro` — the DASHBOARD page (chrome + the story inside it). */
+export const STORY_PAGE = libFile('./lib/pages/story.astro')
+
+/**
+ * The BARE STORY page. No upstream counterpart: upstream routes both the dashboard and the
+ * preview through `story.astro`, so a bare story also received the lab's chrome. Splitting them
+ * is what lets the lab's own styling stop at the preview's edge (decided 2026-09-22) — see
+ * ../ui/lab.css and ./virtual-module/virtual-routes.ts, which picks between the two.
+ */
+export const PREVIEW_PAGE = libFile('./lib/pages/preview.astro')
+
+/** `astrobook/pages/app.astro` */
+export const APP_PAGE = libFile('./lib/pages/app.astro')
+
+/** `astrobook/components/with-decorators.astro` */
+export const WITH_DECORATORS_COMPONENT = libFile(
+  './lib/components/with-decorators.astro',
+)
+
+/** `astrobook/components/head.astro` */
+export const HEAD_COMPONENT = libFile('./lib/components/head.astro')
+
+/** `astrobook/components/home.astro` */
+export const HOME_COMPONENT = libFile('./lib/components/home.astro')
+
+/** `astrobook/components/empty.astro` */
+export const EMPTY_COMPONENT = libFile('./lib/components/empty.astro')