@orbytes/astrolab 0.3.0 → 0.4.0-next.2

package/index.mjs

@@ -11,9 +11,10 @@
 //
 // ── the pin board (./src/pin/, moved in 2026-09-22) ─────────────────────────────────────────────
 // Decided 2026-09-22: the lab and the pin board are ONE app, bundled and working as one — not two
-// packages a site installs separately. So `/lab` and `/pin` come from one call, one install, one
-// dev server. `pin: false` omits it entirely — a site may want the lab alone — and `pin: {…}` passes
-// options straight through (ops/standalone-plan.md › The pin board merges in; docs/PIN.md).
+// packages a site installs separately. So the lab (`<subpath>`) and its Tasks board
+// (`<subpath>/tasks`) come from one call, one install, one dev server. `pin: false` omits it
+// entirely — a site may want the lab alone — and `pin: {…}` passes options straight through
+// (ops/standalone-plan.md › The pin board merges in; docs/PIN.md).
 //
 // The pin half is DEV ONLY and gates itself four times over; it is registered in staging builds
 // along with the lab and does nothing there, because its first assertion is `command === "dev"`.
@@ -25,22 +26,21 @@
 //      components (which render the consumer's head inside them).
 //   2. inject the shell's routes, prerendered like every Astrobook route:
 //        <subpath>/browse/[...path]   folder pages          → ./src/shell/Browse.astro
-//        <subpath>/viewport/[...id]   viewport configurator → ./src/shell/Viewport.astro
+//        <subpath>/pages/[...path]    the site's pages      → ./src/chrome/views/Pages.astro
+//        <subpath>/assets             the site's images     → ./src/chrome/views/Assets.astro
+//        <subpath>/[section]          support, settings     → ./src/chrome/views/Placeholder.astro
+//        <subpath>/viewport/[...id]   a redirect, kept for old links → ./src/shell/Viewport.astro
 //        <subpath>/index.json         the lab index         → ./src/shell/index.json.ts
+//      (the task views, <subpath>/tasks and /tasks/all, are the pin half's, dev only)
 //      and define `virtual:orbytes-lab/*` so those pages can read the resolved options, the
 //      consumer's head component and the consumer's CSS without importing anything by path.
-//   3. serve the two mark APIs on the Vite dev server only (astro:server:setup never runs in a
-//      build, so a deployed lab has no write path and the switches hide themselves):
-//        GET /__lab/cull         { marked: string[], updated: string | null }
-//        PUT /__lab/cull         body { marked: string[] } — every entry must be an existing
-//                                stories file in the CULLABLE tier AND not live on any page;
-//                                otherwise 400 with the offenders. Writes <directory>/cull.json.
+//   3. serve the responsive marks API on the Vite dev server only (astro:server:setup never runs
+//      in a build, so a deployed lab has no write path and the switches hide themselves):
 //        GET /__lab/responsive   { done: string[], approved: string[], updated: string | null }
 //        PUT /__lab/responsive   body { done: string[], approved?: string[] } — every entry must
 //                                be an existing stories file in the RESPONSIVE tier; otherwise 400
 //                                with the offenders. Writes <directory>/responsive.json.
-//      Marks only. NOTHING HERE DELETES A FILE — that is `orbytes-lab-cull`, a separate command,
-//      run by hand and with a dry run first.
+//      Marks only. NOTHING HERE DELETES A FILE.
 //
 // Gotcha (2026-09-06): Astro re-imports astro.config.mjs on a config change, but this module and
 // its ./src/shell/*.mjs imports stay in Node's ESM cache for the life of the process — so an edit
@@ -55,15 +55,7 @@ import { fileURLToPath } from "node:url";
 import { createAstrobookIntegration } from "./dist/core/index.js";
 import { resolveLabOptions } from "./defaults.mjs";
 import orbytesPin from "./src/pin/index.mjs";
-import { defaultImports, liveComponentFiles, storyComponentFile } from "./src/shell/live-files.mjs";
-import {
-  cullOffence,
-  readCull,
-  readResponsive,
-  responsiveOffence,
-  writeCull,
-  writeResponsive,
-} from "./src/shell/marks.mjs";
+import { readResponsive, responsiveOffence, writeResponsive } from "./src/shell/marks.mjs";
 
 const file = (relative) => fileURLToPath(new URL(relative, import.meta.url));
 
@@ -80,22 +72,6 @@ const RESOLVED = {
   [VIRTUAL.css]: "__virtual_orbytes_lab_user_css__.mjs",
 };
 
-/**
- * Why an entry may not be marked for deletion, or null when it may. `importedByLive` maps a
- * component file to the live section that imports it, so an exploration a live section uses is
- * refused here with the same reason the cull script would give later.
- */
-const cullEntryOffence = (rootDir, config, entry, liveByFile, importedByLive) => {
-  const bad = cullOffence(rootDir, config, entry);
-  if (bad) return bad;
-  const component = storyComponentFile(rootDir, entry);
-  const mount = component ? liveByFile.get(component) : undefined;
-  if (mount) return `live on ${mount.page} (slot ${mount.slot}: ${component})`;
-  const user = component ? importedByLive.get(component) : undefined;
-  if (user) return `used by live section ${user}`;
-  return null;
-};
-
 const readBody = (req) =>
   new Promise((resolve, reject) => {
     let body = "";
@@ -117,14 +93,23 @@ const send = (res, status, payload) => {
   res.end(JSON.stringify(payload));
 };
 
+/**
+ * What the lab and the pin half tell each other at setup. One object, created per `orbytesLab()`
+ * call and handed to both. The pin half fills `tasks` in its own `astro:config:setup` — only in dev,
+ * only when it found a repository — and the lab reads it when its config module LOADS, which Vite
+ * does on first request, after every integration's setup hook has run. So the lab's Tasks group
+ * exists exactly when the board does, and neither half decides for the other.
+ * @typedef {{ tasks: import("./defaults.mjs").LabConfig["tasks"] | { base: string; api: string; assets: string; repoRoot: string; backlogDir: string } }} Shared
+ */
+
 /** The virtual modules the package's own pages read. Everything in them is JSON-serialisable. */
-const virtualModulesPlugin = (config, headEntrypoint) => ({
+const virtualModulesPlugin = (config, headEntrypoint, shared) => ({
   name: "orbytes-lab/virtual",
   resolveId: (id) => RESOLVED[id],
   load(id) {
     switch (id) {
       case RESOLVED[VIRTUAL.config]:
-        return `export default ${JSON.stringify(config)};`;
+        return `export default ${JSON.stringify({ ...config, tasks: shared.tasks ?? null })};`;
       case RESOLVED[VIRTUAL.head]:
         return `export { default } from ${JSON.stringify(headEntrypoint)};`;
       case RESOLVED[VIRTUAL.css]:
@@ -133,8 +118,8 @@ const virtualModulesPlugin = (config, headEntrypoint) => ({
   },
 });
 
-/** @param {Record<string, unknown>} [options] */
-function labShell(options) {
+/** @param {Record<string, unknown>} [options] @param {Shared} [shared] */
+function labShell(options, shared = { tasks: null }) {
   const config = resolveLabOptions(options);
   let rootDir = process.cwd();
   return {
@@ -153,6 +138,9 @@ function labShell(options) {
 
         for (const [pattern, entrypoint] of [
           [`${config.subpath}/browse/[...path]`, "./src/shell/Browse.astro"],
+          [`${config.subpath}/pages/[...path]`, "./src/chrome/views/Pages.astro"],
+          [`${config.subpath}/assets`, "./src/chrome/views/Assets.astro"],
+          [`${config.subpath}/[section]`, "./src/chrome/views/Placeholder.astro"],
           [`${config.subpath}/viewport/[...id]`, "./src/shell/Viewport.astro"],
           [`${config.subpath}/index.json`, "./src/shell/index.json.ts"],
         ]) {
@@ -161,66 +149,27 @@ function labShell(options) {
 
         updateConfig({
           vite: {
-            plugins: [virtualModulesPlugin(config, head)],
+            plugins: [virtualModulesPlugin(config, head, shared)],
             // This package ships SOURCE — .astro and .ts compiled by the consumer's Vite, the way
             // Starlight ships its components. Vite externalises node_modules for SSR by default,
             // and an externalised .astro file is handed to Node, which cannot read it. The
             // consumer should need one line in its config and nothing more, so the exemption is
             // declared here rather than there.
             ssr: { noExternal: ["@orbytes/astrolab"] },
-            // Marking writes JSON files under src/; keep Vite from treating those as source
-            // changes and reloading the lab mid-triage.
+            // Marking writes a JSON file under src/; keep Vite from treating it as a source
+            // change and reloading the lab mid-triage.
             server: {
-              watch: { ignored: [`**/${config.cullFile}`, `**/${config.responsiveFile}`] },
+              watch: { ignored: [`**/${config.responsiveFile}`] },
             },
           },
         });
         logger.info(
-          `folder pages at ${config.subpath}/browse, viewport at ${config.subpath}/viewport, index at ${config.subpath}/index.json`,
+          `pages at ${config.subpath}/pages, folders at ${config.subpath}/browse, assets at ${config.subpath}/assets, index at ${config.subpath}/index.json`,
         );
       },
       "astro:server:setup": ({ server, logger }) => {
-        server.middlewares.use(async (req, res, next) => {
-          const url = new URL(req.url ?? "/", "http://x");
-          if (url.pathname !== "/__lab/cull") return next();
-          try {
-            if (req.method === "GET") return send(res, 200, readCull(rootDir, config));
-            if (req.method === "PUT") {
-              const body = await readBody(req);
-              if (!Array.isArray(body.marked))
-                return send(res, 400, { error: "body must be { marked: string[] }" });
-              const live = liveComponentFiles(rootDir);
-              // First mount wins, so the refusal names the page a reader would look at first.
-              const liveByFile = new Map();
-              for (const l of live) if (!liveByFile.has(l.file)) liveByFile.set(l.file, l);
-              const importedByLive = new Map();
-              for (const l of live) {
-                for (const dep of defaultImports(rootDir, l.file)) {
-                  if (!importedByLive.has(dep.file)) importedByLive.set(dep.file, l.file);
-                }
-              }
-              const offenders = body.marked
-                .map((entry) => ({
-                  path: entry,
-                  reason: cullEntryOffence(rootDir, config, entry, liveByFile, importedByLive),
-                }))
-                .filter((o) => o.reason !== null);
-              if (offenders.length > 0) {
-                return send(res, 400, { error: "some entries cannot be marked", offenders });
-              }
-              const data = writeCull(rootDir, config, body.marked);
-              logger.info(`cull marks saved: ${data.marked.length} → ${config.cullFile}`);
-              return send(res, 200, { ok: true, file: config.cullFile, ...data });
-            }
-            return send(res, 405, { error: "GET or PUT" });
-          } catch (e) {
-            return send(res, 500, { error: String(e?.message ?? e) });
-          }
-        });
-
-        // The responsive marks — same shape of API as the cull one above, and deliberately its
-        // sibling rather than a second mechanism: a section version is marked responsive (and,
-        // separately, approved for that work) by hand, because neither fact is in the code.
+        // The responsive marks: a section version is marked responsive (and, separately, approved
+        // for that work) by hand, because neither fact is in the code.
         server.middlewares.use(async (req, res, next) => {
           const url = new URL(req.url ?? "/", "http://x");
           if (url.pathname !== "/__lab/responsive") return next();
@@ -253,7 +202,7 @@ function labShell(options) {
           }
         });
 
-        logger.info("mark APIs at /__lab/cull and /__lab/responsive (dev only)");
+        logger.info("mark API at /__lab/responsive (dev only)");
       },
     },
   };
@@ -277,7 +226,7 @@ function labShell(options) {
  * @param {Record<string, unknown>} [options] the lab's options
  * @param {import("./defaults.mjs").LabConfig} config the RESOLVED lab config
  */
-const pinHalf = (options, config) => {
+const pinHalf = (options, config, shared) => {
   const pin = options?.pin;
   if (pin === false || pin === null) return [];
   const given = typeof pin === "object" ? pin : {};
@@ -289,7 +238,11 @@ const pinHalf = (options, config) => {
         { href: "/", label: "Site" },
         { href: config.subpath || "/", label: "Lab" },
       ],
+      // ONE URL (decided 2026-09-24): the board lives under the lab, at <subpath>/tasks, drawn in
+      // the lab's own chrome. `/pin` still answers, with a redirect. A consumer's `route` wins.
+      route: `${config.subpath}/tasks`,
       ...given,
+      lab: { shared },
     }),
   ];
 };
@@ -302,6 +255,8 @@ const pinHalf = (options, config) => {
  */
 export default function orbytesLab(options = {}) {
   const config = resolveLabOptions(options);
+  /** @type {Shared} */
+  const shared = { tasks: null };
   return [
     createAstrobookIntegration({
       directory: config.directory,
@@ -313,8 +268,8 @@ export default function orbytesLab(options = {}) {
       head: "@orbytes/astrolab/head",
       home: "@orbytes/astrolab/home",
     }),
-    labShell(options),
-    ...pinHalf(options, config),
+    labShell(options, shared),
+    ...pinHalf(options, config, shared),
   ];
 }
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@orbytes/astrolab",
-  "version": "0.3.0",
+  "version": "0.4.0-next.2",
   "type": "module",
-  "description": "The orbytes component lab and pin board — an Astrobook shell for Astro sites (live/used-by pills, a viewport configurator, responsive and cull marks, a parameters panel) plus a dev-only click-to-ticket feedback board at /pin.",
+  "description": "The orbytes lab for Astro sites — every page, section and component rendered live, which of them the site actually mounts, a viewport canvas to size them on, and a dev-only click-to-ticket pin board — in one integration, all local.",
   "keywords": [
     "astro",
     "astro-integration",
@@ -28,10 +28,10 @@
     "preview": "npm --workspace testbed-orbytes-v2 run preview",
     "build:staging": "npm --workspace testbed-orbytes-v2 run build:staging",
     "check:isolation": "npm --workspace testbed-orbytes-v2 run check:isolation",
+    "check:lab-index": "npm --workspace testbed-orbytes-v2 run check:lab-index",
     "verify": "npm --workspace testbed-orbytes-v2 run verify"
   },
   "bin": {
-    "orbytes-lab-cull": "bin/lab-cull.mjs",
     "orbytes-pin-gallery": "bin/pin-gallery.mjs"
   },
   "main": "./index.mjs",
@@ -70,6 +70,10 @@
     "src",
     "virtual.d.ts"
   ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "next"
+  },
   "dependencies": {
     "@sveltejs/acorn-typescript": "^1.0.12",
     "acorn": "^8.18.0",