@olomonhelpdesk2/helpdesk 0.1.17 → 0.1.19

package/helpdesk-seed.mjs

@@ -1001,8 +1001,14 @@ var CAPTURE_CONTRACT = {
   timezone: "UTC",
   /**
    * Injected before every shot. Necessary, not sufficient — see above.
+   *
+   * Every CSS animation ends at once, on its last frame, rather than being
+   * removed. An entrance starts its element at opacity 0 and keeps the last
+   * frame it animates to, and `animation: none` left that element at opacity
+   * 0, so a site's hero was blank in every frame. One that loops ends after a
+   * single instant pass, back at its element's own style.
    */
-  motionOff: "*,*::before,*::after{animation:none!important;transition:none!important;caret-color:transparent!important}",
+  motionOff: "*,*::before,*::after{animation-duration:0s!important;animation-delay:0s!important;animation-iteration-count:1!important;transition:none!important;caret-color:transparent!important}",
   /**
    * What an app uses to leave its own floating widgets out of the pictures.
    *

package/helpdesk.mjs

@@ -148,6 +148,34 @@ function depth(path) {
   return path === "/" ? 0 : path.split("/").filter(Boolean).length;
 }
 
+// core/discovery/apps.ts
+var ROOT_SHARE = 0.8;
+function appRoot(routes) {
+  const screens = documentable(routes);
+  const root = [];
+  for (; ; ) {
+    const counts = /* @__PURE__ */ new Map();
+    for (const route of screens) {
+      const segments = staticSegments(route.path);
+      const next = segments[root.length];
+      if (next && root.every((segment2, index) => segments[index] === segment2)) counts.set(next, (counts.get(next) ?? 0) + 1);
+    }
+    const [segment, count = 0] = [...counts].sort((a, b) => b[1] - a[1])[0] ?? [];
+    if (!segment || count < Math.max(3, screens.length * ROOT_SHARE)) return root;
+    root.push(segment);
+  }
+}
+function belowAppRoot(path, root) {
+  const segments = path.split("/").filter(Boolean);
+  return root.length && root.every((segment, index) => segments[index] === segment) ? segments.slice(root.length) : segments;
+}
+function staticSegments(path) {
+  return path.split("/").filter((segment) => segment && !segment.startsWith("["));
+}
+function documentable(routes) {
+  return routes.filter((route) => !route.skipped);
+}
+
 // core/discovery/article-plan.ts
 var MONEY_OR_ACCESS = /* @__PURE__ */ new Set([
   "billing",
@@ -226,9 +254,9 @@ function slugFor(path) {
   const segments = path.split("/").filter(Boolean).filter((segment) => !segment.startsWith("["));
   return segments.length ? segments.join("/") : "overview";
 }
-function titleFor(route) {
-  const segments = route.path.split("/").filter(Boolean).filter((s) => !s.startsWith("["));
-  if (!segments.length) return "Getting around";
+function titleFor(route, root) {
+  const segments = belowAppRoot(route.path, root).filter((s) => !s.startsWith("["));
+  if (!segments.length) return route.params.length ? "Working with a record" : "Getting around";
   const words = segments[segments.length - 1].replace(/[-_]/g, " ");
   const subject = words.charAt(0).toUpperCase() + words.slice(1);
   if (!route.params.length) return subject;
@@ -280,6 +308,7 @@ function buildArticlePlan(options) {
     }
   }
   let covered = 0;
+  const root = appRoot(options.routes);
   const needs = [...merged.entries()].map(([slug, group], index) => {
     const rank = index + 1;
     const claimed = [group.entry.route.path, ...group.routes.slice(1) ?? []].map((path) => options.documented?.[path]).find(Boolean);
@@ -287,7 +316,7 @@ function buildArticlePlan(options) {
     if (already) covered += 1;
     return {
       slug,
-      title: group.title ?? titleFor(group.entry.route),
+      title: group.title ?? titleFor(group.entry.route, root),
       route: group.entry.route.path,
       ...group.routes.length > 1 ? { alsoCovers: group.routes.slice(1) } : {},
       tier: tierFor(rank, merged.size),
@@ -951,8 +980,8 @@ function readProduct(routes, options) {
     }
     return found;
   };
-  const documentable = routes.filter((route) => !route.skipped);
-  const total = Math.min(documentable.length, maxScreens);
+  const documentable2 = routes.filter((route) => !route.skipped);
+  const total = Math.min(documentable2.length, maxScreens);
   const reading = { how: "source", commit: options.commit ?? null };
   let done = 0;
   let withFacts = 0;
@@ -984,10 +1013,10 @@ function hasAnything(facts) {
   );
 }
 function describeReading(routes) {
-  const documentable = routes.filter((route) => !route.skipped);
-  const read = documentable.filter((route) => route.facts && hasAnything(route.facts));
+  const documentable2 = routes.filter((route) => !route.skipped);
+  const read = documentable2.filter((route) => route.facts && hasAnything(route.facts));
   return {
-    screens: documentable.length,
+    screens: documentable2.length,
     read: read.length,
     rendered: read.filter((route) => route.facts?.read?.how === "rendered").length,
     pathsOnly: read.length === 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olomonhelpdesk2/helpdesk",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Reads a product's screens, plans its help articles, and photographs them.",
   "type": "module",
   "engines": {