@chuzi/shared 1.3.45 → 1.3.47

package/dist/realms/cosmos/components/index.d.ts

@@ -77,6 +77,10 @@ interface ConstellationSceneEntry {
     id: string;
     /** Visual with final position already computed by the consumer. */
     visual: AtomVisualProps;
+    /** Title scene — arc starts here. */
+    isTitle?: boolean;
+    /** End scene — arc ends here. */
+    isEnd?: boolean;
     /** Scene label shown beneath the preview card. */
     label?: string;
     /** Static preview image (coverbox, poster frame, etc.). */
@@ -175,10 +179,12 @@ interface DistributeOptions {
  * sessions.
  */
 declare function distributeStars(count: number, options?: DistributeOptions): Vec3[];
-/** World-space gap between adjacent scenes along the story spine. */
-declare const COSMOS_SCENE_LEVEL_SPACING = 6;
+/** World-space gap between adjacent tree levels along +Z (chronological depth). */
+declare const COSMOS_SCENE_LEVEL_SPACING = 11;
 /** Branch spread multiplier for tree_graph x offsets. */
-declare const COSMOS_SCENE_BRANCH_SPACING = 1.1;
+declare const COSMOS_SCENE_BRANCH_SPACING = 1.6;
+/** Maximum distance between two connected scene stars (fallback spine only). */
+declare const COSMOS_MAX_SCENE_EDGE_LENGTH = 14;
 /** Minimum empty space between constellation bounds, in scene spacings. */
 declare const COSMOS_CONSTELLATION_GAP_SCENES = 2;
 /** Halo around a lone title star before scenes load. */
@@ -192,6 +198,10 @@ interface ConstellationLayoutScene {
     order?: number;
     created_at?: string;
 }
+interface ConstellationLayoutEdge {
+    source: string;
+    target: string;
+}
 interface ConstellationLayoutNode {
     id: string;
     level: number;
@@ -200,6 +210,7 @@ interface ConstellationLayoutNode {
 }
 interface ConstellationLayoutGraph {
     nodes: ConstellationLayoutNode[];
+    edges?: ConstellationLayoutEdge[];
     meta?: {
         root_id?: string | null;
     };
@@ -215,7 +226,10 @@ interface ConstellationAnchorOptions {
     visualPadding?: number;
 }
 /**
- * Scene positions relative to the title star at the origin (constellation anchor).
+ * Scene positions relative to the title star at the constellation anchor.
+ * When a tree_graph is present, level maps to +Z depth (chronological "after")
+ * and x spreads branches laterally. Without a graph, scenes fall back to a
+ * linear spine along +Z.
  */
 declare function computeConstellationScenePositions(scenes: ConstellationLayoutScene[], graph: ConstellationLayoutGraph | undefined, anchor?: Vec3): Map<string, Vec3>;
 /** Bounding radius from the title anchor to the outermost scene plus visual padding. */
@@ -244,4 +258,4 @@ interface StarBillboardProps {
  */
 declare function StarBillboard({ label, appearance, previewImageUrl, previewContent, dimmed, focused, visible, controlsSlot, }: StarBillboardProps): react_jsx_runtime.JSX.Element | null;
 
-export { COSMOS_CONSTELLATION_GAP_SCENES, COSMOS_CONSTELLATION_VISUAL_PADDING, COSMOS_DEFAULT_FOOTPRINT_RADIUS, COSMOS_SCENE_BRANCH_SPACING, COSMOS_SCENE_LEVEL_SPACING, Constellation, type ConstellationAnchorInput, type ConstellationAnchorOptions, ConstellationAppearance, type ConstellationBounds, ConstellationEdge, type ConstellationEdgeEntry, type ConstellationEdgeProps, type ConstellationLayoutGraph, type ConstellationLayoutNode, type ConstellationLayoutScene, type ConstellationProps, type ConstellationSceneEntry, type ConstellationStoryOverlay, ConstellationTitle, type ConstellationTitleProps, CosmosSandbox, type CosmosSandboxProps, type DistributeOptions, Star, StarBillboard, type StarBillboardProps, type StarProps, type Vec3, World, type WorldProps, computeConstellationBounds, computeConstellationScenePositions, constellationFootprintRadius, distributeConstellationAnchors, distributeStars };
+export { COSMOS_CONSTELLATION_GAP_SCENES, COSMOS_CONSTELLATION_VISUAL_PADDING, COSMOS_DEFAULT_FOOTPRINT_RADIUS, COSMOS_MAX_SCENE_EDGE_LENGTH, COSMOS_SCENE_BRANCH_SPACING, COSMOS_SCENE_LEVEL_SPACING, Constellation, type ConstellationAnchorInput, type ConstellationAnchorOptions, ConstellationAppearance, type ConstellationBounds, ConstellationEdge, type ConstellationEdgeEntry, type ConstellationEdgeProps, type ConstellationLayoutEdge, type ConstellationLayoutGraph, type ConstellationLayoutNode, type ConstellationLayoutScene, type ConstellationProps, type ConstellationSceneEntry, type ConstellationStoryOverlay, ConstellationTitle, type ConstellationTitleProps, CosmosSandbox, type CosmosSandboxProps, type DistributeOptions, Star, StarBillboard, type StarBillboardProps, type StarProps, type Vec3, World, type WorldProps, computeConstellationBounds, computeConstellationScenePositions, constellationFootprintRadius, distributeConstellationAnchors, distributeStars };

package/dist/realms/cosmos/components/index.js

@@ -200,20 +200,30 @@ function ConstellationTitle({
   const centerX = svgWidth / 2;
   const arcY = svgHeight * 0.88;
   const arcPeak = svgHeight * 0.06;
-  let arcStartX = svgWidth * 0.04;
-  let arcEndX = svgWidth * 0.96;
+  const minArcSpan = Math.max(240, title.trim().length * 15);
+  let arcStartX = centerX - minArcSpan / 2;
+  let arcEndX = centerX + minArcSpan / 2;
   if (arcFrom && arcTo) {
     const [fromX] = arcFrom;
     const [toX] = arcTo;
     arcStartX = centerX + (fromX - bounds.center[0]) * WORLD_TO_SVG;
     arcEndX = centerX + (toX - bounds.center[0]) * WORLD_TO_SVG;
-    arcStartX = Math.max(12, Math.min(arcStartX, svgWidth - 12));
-    arcEndX = Math.max(12, Math.min(arcEndX, svgWidth - 12));
     if (arcStartX > arcEndX) {
       const swap = arcStartX;
       arcStartX = arcEndX;
       arcEndX = swap;
     }
+    if (arcEndX - arcStartX < minArcSpan) {
+      const mid = (arcStartX + arcEndX) / 2;
+      arcStartX = mid - minArcSpan / 2;
+      arcEndX = mid + minArcSpan / 2;
+    }
+  }
+  arcStartX = Math.max(12, Math.min(arcStartX, svgWidth - 12));
+  arcEndX = Math.max(12, Math.min(arcEndX, svgWidth - 12));
+  if (arcEndX - arcStartX < minArcSpan * 0.65) {
+    arcStartX = Math.max(12, centerX - minArcSpan / 2);
+    arcEndX = Math.min(svgWidth - 12, centerX + minArcSpan / 2);
   }
   const arcMidX = (arcStartX + arcEndX) / 2;
   const arcPath = `M ${arcStartX} ${arcY} Q ${arcMidX} ${arcPeak} ${arcEndX} ${arcY}`;
@@ -583,6 +593,8 @@ function Constellation({
   const bounds = computeConstellationBounds(
     scenes.map((s) => s.visual.position)
   );
+  const titleScene = scenes.find((s) => s.isTitle) ?? scenes[0];
+  const endScene = scenes.find((s) => s.isEnd) ?? scenes[scenes.length - 1];
   const resolvedEdges = [];
   for (const edge of edges) {
     const src = sceneMap.get(edge.source);
@@ -598,8 +610,8 @@ function Constellation({
         title: storyTitle,
         bounds,
         appearance,
-        arcFrom: scenes[0]?.visual.position,
-        arcTo: scenes[scenes.length - 1]?.visual.position,
+        arcFrom: titleScene?.visual.position,
+        arcTo: endScene?.visual.position,
         storyOverlay
       }
     ) : null,
@@ -728,11 +740,13 @@ function mulberry32(seed) {
     return ((t ^ t >>> 14) >>> 0) / 4294967296;
   };
 }
-var COSMOS_SCENE_LEVEL_SPACING = 6;
-var COSMOS_SCENE_BRANCH_SPACING = 1.1;
+var COSMOS_SCENE_LEVEL_SPACING = 11;
+var COSMOS_SCENE_BRANCH_SPACING = 1.6;
+var COSMOS_MAX_SCENE_EDGE_LENGTH = 14;
 var COSMOS_CONSTELLATION_GAP_SCENES = 2;
 var COSMOS_DEFAULT_FOOTPRINT_RADIUS = 10;
 var COSMOS_CONSTELLATION_VISUAL_PADDING = 6;
+var GOLDEN_ANGLE = 2.399963229728653;
 function sortScenesForConstellationLayout(sceneList) {
   return [...sceneList].sort((a, b) => {
     if (a.is_title !== b.is_title) return a.is_title ? -1 : 1;
@@ -768,35 +782,122 @@ function orderScenesForConstellationLayout(sceneList, graph) {
   }
   return ordered;
 }
+function hashSceneId(id, salt = "") {
+  let h = 0;
+  const key = id + salt;
+  for (let i = 0; i < key.length; i++) {
+    h = h * 31 + key.charCodeAt(i) >>> 0;
+  }
+  return h / 4294967296;
+}
+function clampEdgeLength(positions, sourceId, targetId, maxLength) {
+  const src = positions.get(sourceId);
+  const tgt = positions.get(targetId);
+  if (!src || !tgt) return;
+  const dx = tgt[0] - src[0];
+  const dy = tgt[1] - src[1];
+  const dz = tgt[2] - src[2];
+  const len = Math.hypot(dx, dy, dz);
+  if (len <= maxLength || len === 0) return;
+  const scale = maxLength / len;
+  positions.set(targetId, [
+    src[0] + dx * scale,
+    src[1] + dy * scale,
+    src[2] + dz * scale
+  ]);
+}
+function buildParentByChild(ordered, edges) {
+  const parentByChild = /* @__PURE__ */ new Map();
+  const orderIndex = new Map(ordered.map((scene, idx) => [scene.id, idx]));
+  const sortedEdges = [...edges].sort((a, b) => {
+    const aIdx = orderIndex.get(a.target) ?? Number.MAX_SAFE_INTEGER;
+    const bIdx = orderIndex.get(b.target) ?? Number.MAX_SAFE_INTEGER;
+    return aIdx - bIdx;
+  });
+  for (const edge of sortedEdges) {
+    if (!parentByChild.has(edge.target)) {
+      parentByChild.set(edge.target, edge.source);
+    }
+  }
+  return parentByChild;
+}
+function sceneLevelJitter(sceneId) {
+  return (hashSceneId(sceneId, "y") - 0.5) * 1.2;
+}
 function computeConstellationScenePositions(scenes, graph, anchor = [0, 0, 0]) {
   const positions = /* @__PURE__ */ new Map();
   const ordered = orderScenesForConstellationLayout(scenes, graph);
-  const count = ordered.length;
-  if (!graph?.nodes?.length) {
-    ordered.forEach((scene, idx) => {
-      const along = count === 1 ? 0 : idx * COSMOS_SCENE_LEVEL_SPACING;
-      positions.set(scene.id, [anchor[0] + along, anchor[1], anchor[2]]);
-    });
-    return positions;
-  }
-  const nodeById = new Map(graph.nodes.map((node) => [node.id, node]));
-  const rootId = graph.meta?.root_id ?? graph.nodes[0]?.id;
-  const rootNode = rootId ? nodeById.get(rootId) : graph.nodes[0];
-  ordered.forEach((scene, idx) => {
-    const node = nodeById.get(scene.id);
-    if (node && rootNode) {
-      const alongPath = node.level * COSMOS_SCENE_LEVEL_SPACING;
-      const branchSpread = (node.x - rootNode.x) * COSMOS_SCENE_BRANCH_SPACING;
+  if (ordered.length === 0) return positions;
+  const root = ordered.find((scene) => scene.is_title) ?? ordered[0];
+  positions.set(root.id, [anchor[0], anchor[1], anchor[2]]);
+  const nodeById = new Map(
+    (graph?.nodes ?? []).map((node) => [node.id, node])
+  );
+  if (nodeById.size > 0) {
+    const rootNode = nodeById.get(root.id);
+    const rootX = rootNode?.x ?? 0;
+    for (const scene of ordered) {
+      if (scene.id === root.id) continue;
+      const node = nodeById.get(scene.id);
+      if (!node) continue;
       positions.set(scene.id, [
-        anchor[0] + alongPath,
-        anchor[1],
-        anchor[2] + branchSpread
+        anchor[0] + (node.x - rootX) * COSMOS_SCENE_BRANCH_SPACING,
+        anchor[1] + sceneLevelJitter(scene.id),
+        anchor[2] + node.level * COSMOS_SCENE_LEVEL_SPACING
       ]);
-      return;
     }
-    const along = count === 1 ? 0 : idx * COSMOS_SCENE_LEVEL_SPACING;
-    positions.set(scene.id, [anchor[0] + along, anchor[1], anchor[2]]);
-  });
+    let fallbackLevel = 0;
+    for (const scene of ordered) {
+      if (positions.has(scene.id)) continue;
+      fallbackLevel += 1;
+      positions.set(scene.id, [
+        anchor[0],
+        anchor[1] + sceneLevelJitter(scene.id),
+        anchor[2] + fallbackLevel * COSMOS_SCENE_LEVEL_SPACING
+      ]);
+    }
+    return positions;
+  }
+  const edges = graph?.edges ?? [];
+  const parentByChild = edges.length > 0 ? buildParentByChild(ordered, edges) : /* @__PURE__ */ new Map();
+  let spineIndex = 0;
+  for (const scene of ordered) {
+    if (scene.id === root.id) continue;
+    let parentId = parentByChild.get(scene.id);
+    if (!parentId || !positions.has(parentId)) {
+      const prevScene = ordered[spineIndex] ?? root;
+      parentId = prevScene.id;
+    }
+    const parentPos = positions.get(parentId) ?? [anchor[0], anchor[1], anchor[2]];
+    const angle = spineIndex * GOLDEN_ANGLE + hashSceneId(scene.id) * 0.55;
+    const dist = COSMOS_MAX_SCENE_EDGE_LENGTH * (0.9 + hashSceneId(scene.id, "d") * 0.1);
+    const yJitter = sceneLevelJitter(scene.id);
+    positions.set(scene.id, [
+      parentPos[0] + Math.cos(angle) * dist,
+      parentPos[1] + yJitter,
+      parentPos[2] + Math.sin(angle) * dist
+    ]);
+    spineIndex += 1;
+  }
+  if (edges.length > 0) {
+    for (const edge of edges) {
+      clampEdgeLength(
+        positions,
+        edge.source,
+        edge.target,
+        COSMOS_MAX_SCENE_EDGE_LENGTH
+      );
+    }
+  } else {
+    for (let i = 1; i < ordered.length; i++) {
+      clampEdgeLength(
+        positions,
+        ordered[i - 1].id,
+        ordered[i].id,
+        COSMOS_MAX_SCENE_EDGE_LENGTH
+      );
+    }
+  }
   return positions;
 }
 function constellationFootprintRadius(localPositions, padding = COSMOS_CONSTELLATION_VISUAL_PADDING) {
@@ -863,6 +964,6 @@ function CosmosSandbox({
   )) });
 }
 
-export { COSMOS_CONSTELLATION_GAP_SCENES, COSMOS_CONSTELLATION_VISUAL_PADDING, COSMOS_DEFAULT_FOOTPRINT_RADIUS, COSMOS_SCENE_BRANCH_SPACING, COSMOS_SCENE_LEVEL_SPACING, Constellation, ConstellationEdge, ConstellationTitle, CosmosSandbox, DEFAULT_CONSTELLATION_APPEARANCE, Star, StarBillboard, World, computeConstellationBounds, computeConstellationScenePositions, constellationFootprintRadius, distributeConstellationAnchors, distributeStars, mergeConstellationAppearance };
+export { COSMOS_CONSTELLATION_GAP_SCENES, COSMOS_CONSTELLATION_VISUAL_PADDING, COSMOS_DEFAULT_FOOTPRINT_RADIUS, COSMOS_MAX_SCENE_EDGE_LENGTH, COSMOS_SCENE_BRANCH_SPACING, COSMOS_SCENE_LEVEL_SPACING, Constellation, ConstellationEdge, ConstellationTitle, CosmosSandbox, DEFAULT_CONSTELLATION_APPEARANCE, Star, StarBillboard, World, computeConstellationBounds, computeConstellationScenePositions, constellationFootprintRadius, distributeConstellationAnchors, distributeStars, mergeConstellationAppearance };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map