@restless-dreams/orbit 0.1.0 → 0.2.0

package/dist/core/svg-renderer.d.ts

@@ -26,29 +26,18 @@ export declare class OrbitSVGRenderer {
     private readonly definitions;
     /** The camera as last written to the world: a spin repaints every frame without moving it. */
     private worldTransform;
-    /** The orbit's turn as last written to the layers of its planets and moons (see `paintTurn`). */
-    private turnTransform;
     /** The theme the shading was last placed for (see `placeShading`). */
     private shadingTheme;
-    /** The turn the shading of specks is turned back by (see `turnShading`). */
-    private speckLighting;
-    /** The on-screen radius (px) below which bodies were last drawn as specks (see `speckRadius`). */
-    private specksBelow;
-    /**
-     * The nodes as last painted at rest, with what they were drawn for: while
-     * only the camera or the orbit's turn changes, they hold still, all but
-     * the bodies turned back upright (see `paintNodes`).
-     */
-    private stillNodes;
     private readonly layers;
     private readonly labelLayer;
     /** The fonts the labels are drawn with, which names are measured and fitted in. */
     private readonly labelFonts;
+    private readonly labelPainter;
     /** Stops listening for fonts that finish loading. */
     private readonly stopWatchingFonts;
     /** What node types draw inside their nodes, between the nodes and the labels. */
     private readonly contentLayer;
-    private readonly contents;
+    private readonly contentPainter;
     /** This map's node types, actions and status words, then the registered ones. */
     private extensions;
     /** The words the map speaks, in its language, and the language and words they were made for. */
@@ -110,32 +99,8 @@ export declare class OrbitSVGRenderer {
     private wheelZoom;
     private display;
     private restingDisplay;
-    /**
-     * Nodes in the order their labels are placed, for one display, and their
-     * ids for a scene at rest: the order holds while the orbit spins, only the
-     * entries are new each frame.
-     */
-    private labelOrder;
-    private readonly nodeViews;
-    /** The family group each node's element is in (see `Family`). */
-    private readonly nodeGroups;
-    private readonly families;
-    /** Counts flights, so each one's arrivals get groups of their own. */
-    private flightCount;
-    private familyCount;
-    private readonly labels;
-    private readonly ringViews;
-    /** Each view keeps what it last wrote, so the elements of a map that didn't move aren't touched. */
-    private readonly linkViews;
-    private readonly counts;
-    /** The camera labels and counts were last placed for, and the nodes they were placed for. */
-    private labelsPlaced;
-    /** Names planned to show that wait for a later frame (see `LABELS_SHOWN_PER_FRAME`), placed for `labelsPlaced`'s camera, and whether the map moved then. */
-    private waitingLabels;
-    private labelLayerTransform;
-    private readonly lightText;
-    /** The theme's label colors, resolved when first needed after each theme change. */
-    private textColors;
+    private readonly ringsAndLinks;
+    private readonly nodePainter;
     /** The node that holds the map's single tab stop. */
     private activeId;
     private tabStopsChanged;
@@ -165,8 +130,6 @@ export declare class OrbitSVGRenderer {
     private dropFrom;
     /** A long press no one took a menu for, on a node it lifts: let go without moving, the node is typed into. */
     private editOnLift;
-    /** The lifted node and the drop target last drawn, so a change draws every node again. */
-    private dragMarks;
     private ambientRunning;
     /** Drift not painted yet, in degrees: less than a `DRIFT_STEP`. */
     private pendingDrift;
@@ -342,6 +305,8 @@ export declare class OrbitSVGRenderer {
      * outline entries carry on too; the copy lends only its places in the source.
      */
     private adoptTree;
+    /** How edits keep top-level nodes' colors: the palette's colors after the root's, and each node's own color or its type's. */
+    private branchColorRules;
     /** Shows an edit, keeping the reader's place, and reports it. */
     private afterEdit;
     /** Adds a node; `arrival`, where a new idea was typed, is where it first shows. */
@@ -462,36 +427,6 @@ export declare class OrbitSVGRenderer {
     /** Stops every camera and orbit motion except a flight between views. */
     private stopMotion;
     private paint;
-    private paintRings;
-    private paintLinks;
-    /**
-     * Turns the layers of the planets and moons with the orbit (see
-     * `OrbitTurn`). Returns the turn (degrees) its bodies are drawn in, or
-     * undefined when each is drawn where it is.
-     */
-    private paintTurn;
-    private paintNodes;
-    /**
-     * The on-screen radius (px) below which flat bodies are specks, for this
-     * screen's pixels; the stylesheet sizes specks' rims from it.
-     */
-    private speckRadius;
-    /**
-     * A family whose members don't all move alike in this flight (some travel
-     * on, the rest leave) splits in two, the fewer of them moving to a group of
-     * their own, so each part moves as one.
-     */
-    private splitIfMixed;
-    /**
-     * The group a node is drawn in: its family's, in the layer of its role. A
-     * node stays in its group while its parent and role do, so nothing moves
-     * between groups when a flight lands; the ideas a flight brings in get a
-     * group of their own, so they can move as one while their siblings travel.
-     */
-    private placeInFamily;
-    /** A new family's group; one that starts hidden (newcomers yet to appear) is hidden before it joins the map, so its members aren't styled until they show. */
-    private createFamily;
-    private moveIntoFamily;
     /** The node whose text is being typed on the map, if any. */
     private editedId;
     private paintAddSlot;
@@ -506,45 +441,7 @@ export declare class OrbitSVGRenderer {
      * it grows, as names do, to keep clear of the count.
      */
     private editorPlacement;
-    private removeNodeView;
-    /**
-     * While only the camera moves (a pan, a pinch, a zoom, a glide), labels and counts ride along
-     * as one layer instead of being placed again on every frame, which for a big view means
-     * restyling hundreds of them. They're placed again once the camera rests, or has gone far
-     * enough that they'd be too big or too small, or missing for nodes coming into view. Returns
-     * the layer's transform from where they were placed, or null to place them now.
-     */
-    private labelRide;
-    /** Fits and places every label again, where it is (the fonts changed). */
-    private fitLabelsAgain;
-    /** Whether the labels were placed for this very view: the same nodes, the camera where it was, nothing changed. */
-    private labelsStill;
-    private setLabelLayerTransform;
-    private paintLabels;
-    /** Shows a planned label: its view (made when it has none yet) placed and fitted as planned. */
-    private showLabel;
-    /**
-     * While the labels ride along with the camera, shows the next names
-     * waiting to: placed as planned, for the camera the labels were placed
-     * at, so they ride along with the rest.
-     */
-    private showWaitingLabels;
-    /** Whether the node shows a picture or its type's own content, so its label goes outside. */
-    private showsImage;
-    /**
-     * Draws what node types render inside their nodes: a 100 × 100 px box per
-     * node, moved and scaled with it each frame, created when the node comes
-     * on the map and cleaned up when it leaves.
-     */
-    private paintContents;
-    private removeContent;
-    /** Whether the theme's light text has more contrast on this node's color than its dark text. Measured once per node and color. */
-    private usesLightText;
-    /** The theme's label colors as plain values. */
-    private resolveTextColors;
     private paintOverlay;
-    /** The "+N" of nodes with children that aren't drawn, at their lower right. In the label layer, so they ride along with the labels. */
-    private paintCounts;
     private clearViews;
     /** One tab stop for the whole map (roving tabindex); arrow keys move between nodes. */
     private updateTabStops;

package/dist/core/types.d.ts

@@ -15,6 +15,14 @@ export interface OrbitNode {
     level: number;
     /** Any CSS color. Without one, the node takes its branch's color from the theme or `palette`. */
     color?: string;
+    /**
+     * Which of the palette's colors the node takes when it has no `color` of
+     * its own: `1` is the first after the root's, cycling. Without one, a
+     * top-level node takes the next in turn and a deeper node a shade of its
+     * branch's. Edits on the map write it to keep a top-level node's color
+     * when the nodes around it change.
+     */
+    paletteColor?: number;
     /** An emoji (or any short symbol) shown before the text. */
     icon?: string;
     /** Hide the node's children until it is opened. */
@@ -211,7 +219,7 @@ export interface OrbitEdit {
     tree: OrbitNode;
 }
 /** What `addNode` and `updateNode` take: a node's text and attributes. */
-export type OrbitNodeInput = Partial<Pick<OrbitNode, 'text' | 'icon' | 'color' | 'status' | 'priority' | 'tags' | 'collapsed' | 'link' | 'note' | 'noteFormat' | 'image' | 'video' | 'embed' | 'type' | 'typeVersion' | 'attrs'>>;
+export type OrbitNodeInput = Partial<Pick<OrbitNode, 'text' | 'icon' | 'color' | 'paletteColor' | 'status' | 'priority' | 'tags' | 'collapsed' | 'link' | 'note' | 'noteFormat' | 'image' | 'video' | 'embed' | 'type' | 'typeVersion' | 'attrs'>>;
 /** What `addNode` takes: a node's text and attributes, and the nodes to add under it, as many levels down as you like. */
 export type OrbitNewNode = OrbitNodeInput & {
     text: string;

package/dist/core/web-page/page.d.ts

@@ -2,7 +2,8 @@
  * A map as a web page: one HTML file with Orbit, the map and its pictures
  * inside, which opens in any browser, offline. Readers explore it with
  * Orbit's own controls, or present it: one idea at a time, in reading order,
- * with its note as a caption (see runtime.ts, the page's script).
+ * with its note as a caption (see runtime.ts, the page's script). Printed,
+ * it's the map laid out for paper (print-layout.ts) instead.
  */
 import { type OrbitStrings } from '../languages.js';
 import type { OrbitDocument, OrbitRendererTheme, ViewMode } from '../types.js';

package/dist/core/web-page/runtime.d.ts

@@ -3,7 +3,7 @@
  * from the page's JSON, with its pictures swapped for the ones inside the
  * page, and presents it on request: one idea at a time, in reading order,
  * with its note as a caption, stepped with keys, buttons or swipes, full
- * screen where the browser allows.
+ * screen where the browser allows. Printed, it's the map laid out for paper.
  */
 import type { OrbitSVGRenderer } from '../svg-renderer.js';
 import type { OrbitDocument } from '../types.js';