@getnarro/atlas 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,70 @@
+# @getnarro/atlas
+
+## 0.2.0
+
+### Minor Changes
+
+- cea1117: Three more scenes for `@getnarro/atlas`: a map, a gigapixel image, and a web page
+
+  **`@getnarro/atlas/map`** — a camera over real geography. Web Mercator is a plane, so
+  projecting the world onto the unit square turns longitude, latitude and zoom into an
+  ordinary framing: the same interpolation, the same checker, the same timeline, with no
+  second camera anywhere. The provider only converts on the way out.
+
+  It _tells_ the map where to be rather than asking it to fly. `flyTo` decides the camera
+  from the wall clock, which is the one thing a renderer advancing a frame counter cannot
+  use; a `jumpTo` per frame from a camera that is a pure function of time works in a deck, a
+  video and a page alike, and the frame is held until tiles and style have both arrived.
+  `maplibre-gl` is an optional peer that nothing here imports. Routes come with it:
+  `routeCamera` follows a traveller, and `routeTo` returns the line behind them, ending
+  exactly where they are.
+
+  **`@getnarro/atlas/image`** — a Deep Zoom pyramid, so a camera can fly all the way into a
+  40000×30000 scan for the same handful of tiles it costs at any other zoom. Cost follows the
+  screen, not the source. The readiness gate covers exactly the tiles the current framing
+  draws, and a tile that 404s counts as settled so one missing file cannot stall a render.
+
+  **`@getnarro/atlas/web`** and **`/embed`** — `<narro-atlas>`, driven by the page's scroll.
+  The third clock after a presenter's keypress and a renderer's frame counter, and nearly
+  free because the camera was already a pure function of a moment. The page's own markup is
+  both the scene and the no-JavaScript fallback: the element slots it rather than copying it,
+  and a waypoint can name any element in it. Reduced motion snaps to the nearest waypoint
+  rather than removing the feature. 8.5 KB, 3.6 KB gzipped, no framework.
+
+  `@getnarro/atlas/web` is importable during server rendering; the element itself lives in
+  `/embed`, because a class extending `HTMLElement` cannot be evaluated in Node.
+
+- cea1117: Add `@getnarro/atlas` — a zooming canvas, and an ` ```atlas ` fence for it
+
+  One plane, many named framings, and a camera that moves between them instead of cutting.
+  Authored as a fence in markdown mode, as `<Atlas>` in React, and as `<AtlasScene>` in a
+  video, all over the same camera path.
+
+  **The camera does not lurch.** Every product in this field — and narro's own
+  `TransformSlide` — tweens the centre and the zoom as independent curves, which makes
+  _apparent_ speed vary by more than an order of magnitude across one flight. That mismatch
+  is the mechanical cause of the motion-sickness complaint the whole category attracts. This
+  uses van Wijk & Nuij's interpolation, which holds perceived speed constant; the property is
+  asserted by a test rather than claimed in a comment. It also means a flight knows how long
+  it should take, so `duration` is rarely worth setting.
+
+  **A waypoint frames a rectangle, not a scale.** `at: 0, 0, 4000` is a fact about the world
+  and survives a change of render target; a scale is a ratio against a viewport and does not.
+  A waypoint can also name a reference — `at: "#ingest"` — which the scene resolves.
+
+  **`narro check` refuses paths nobody could watch.** A zoom jump above 8x, a duration far
+  from what the move needs (including milliseconds typed into a seconds field), a framing
+  that cannot be rendered, a selector that matches nothing in a recording, a canvas with
+  nothing to show. Every one is decidable before anything is rendered, and nothing in this
+  field checks them.
+
+  **Zooming into a recorded app.** `@getnarro/atlas/replay` puts the camera over a
+  `@getnarro/replay` cast, so a control magnified 3x is still live DOM — sharp and
+  selectable, where a screenshot falls apart. Waypoints name a CSS selector rather than
+  coordinates, and `findInCast` verifies them offline.
+
+  **Cost.** One `translate3d(…) scale(…)` on one element per frame, whatever the scene holds;
+  nodes outside the frame are unmounted; `will-change: transform` is switched on for a flight
+  and off on arrival, so resting frames are sharp. `prefers-reduced-motion` is honoured by
+  cutting between waypoints rather than by hiding anything. The package reaches a deck only
+  when it has a fence.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getnarro/atlas",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "A spatial canvas for Narro — a camera path as text, one pure camera function over it, and scene providers a deck, a video and a web page all render the same way",
   "license": "MIT",
@@ -104,7 +104,7 @@
     "tsup": "8.5.1",
     "typescript": "5.9.3",
     "vitest": "4.0.14",
-    "@getnarro/replay": "0.1.0",
+    "@getnarro/replay": "0.2.0",
     "@getnarro/video": "0.7.0"
   },
   "scripts": {