@getnarro/atlas 0.1.0

package/dist/web/index.d.ts

@@ -0,0 +1,89 @@
+import { R as Rect } from '../view-BzztOpV6.js';
+import { S as SceneProvider } from '../provider-CjL3i-0A.js';
+import { T as Timeline } from '../timeline-B_dNydQA.js';
+export { A as AtlasMode, T as TAG } from '../tag-BP51cBza.js';
+import '../path-BIxJH8g2.js';
+
+/**
+ * A scene that is just the page's own markup.
+ *
+ * The web embed's default, and the reason it needs no build step: whatever a page puts
+ * inside `<narro-atlas>` *is* the scene. A waypoint that says `at: "#pricing"` resolves
+ * against the element with that id, exactly as a reader would expect from a fragment
+ * link, and the same markup is what shows with JavaScript off.
+ *
+ * Measured with `offsetLeft`/`offsetTop` rather than `getBoundingClientRect`, because the
+ * camera's own transform is on an ancestor: a rect would include it and every waypoint
+ * would resolve to a different place depending on where the camera happened to be.
+ *
+ * @packageDocumentation
+ */
+
+interface DomProviderOptions {
+    /** The element whose coordinate system the world is. */
+    root: HTMLElement | null;
+    /** Padding when framing a matched element, as a fraction. @defaultValue 0.15 */
+    padding?: number;
+    /** The world grid, used when the root has not been laid out yet. */
+    fallback?: Rect;
+}
+/** An element's box in the root's coordinates, following the offset chain. */
+declare function offsetRectWithin(element: HTMLElement, root: HTMLElement): Rect;
+declare function domProvider(options: DomProviderOptions): SceneProvider;
+
+/**
+ * Scroll as a clock.
+ *
+ * The third clock, after a presenter's keypress and a renderer's frame counter, and the
+ * one a web page wants. It costs almost nothing to add because the camera is a pure
+ * function of a moment: a deck asks for the moment a flight has reached, a video asks for
+ * `frame / fps`, and a page asks how far it has been scrolled. Same camera, same path,
+ * same checker.
+ *
+ * Pure arithmetic here, so the part that is fiddly — what "how far through" means for an
+ * element that is taller than the window and sticky inside it — is pinned by tests rather
+ * than discovered on a phone.
+ *
+ * @packageDocumentation
+ */
+
+/** What the page can tell us, without this module touching the DOM. */
+interface ScrollGeometry {
+    /** The scroller's top edge relative to the viewport — `getBoundingClientRect().top`. */
+    top: number;
+    /** Its full height, which is what gives the camera room to travel. */
+    height: number;
+    /** The window's height. */
+    viewportHeight: number;
+}
+/**
+ * How far through the camera path a scroll position is, in `[0, 1]`.
+ *
+ * The scroller is taller than the window and holds a window-height panel stuck to the top
+ * of it; the camera travels while that panel is stuck. So the travel distance is
+ * `height - viewportHeight`, and progress is how much of it has gone by. A scroller no
+ * taller than the window has nowhere to travel and sits at the start, which is the
+ * honest answer rather than a division by zero.
+ */
+declare function scrollProgress(geometry: ScrollGeometry): number;
+/** The height a scroller needs to give every waypoint `perWaypoint` screens of travel. */
+declare function scrollerHeight(waypointCount: number, viewportHeight: number, perWaypoint?: number): number;
+/**
+ * The moment on the timeline a scroll progress corresponds to.
+ *
+ * Holds are dropped from the mapping deliberately: a hold is time spent not moving, and a
+ * reader who keeps scrolling through one has the distinct experience of a broken page.
+ * Scroll drives the *flights*; the rests belong to autoplay and video.
+ */
+declare function progressToSeconds(timeline: Timeline, progress: number): number;
+/**
+ * The nearest waypoint's arrival time — what a reduced-motion reader gets.
+ *
+ * Scrolling is the reader's own doing, so the motion is theirs to control; what they have
+ * asked not to have is the camera sliding under them while they do it. Snapping to the
+ * waypoint they are nearest keeps every framing reachable by scrolling and removes the
+ * travel between, which is the same trade the deck host makes by cutting.
+ */
+declare function snapToWaypoint(timeline: Timeline, seconds: number): number;
+
+export { type DomProviderOptions, type ScrollGeometry, domProvider, offsetRectWithin, progressToSeconds, scrollProgress, scrollerHeight, snapToWaypoint };

package/dist/web/index.js

@@ -0,0 +1,4 @@
+export { TAG, domProvider, offsetRectWithin, progressToSeconds, scrollProgress, scrollerHeight, snapToWaypoint } from '../chunk-UTCNNNPT.js';
+import '../chunk-RWYOYDBD.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@getnarro/atlas",
+  "version": "0.1.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",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/getnarro/narro.git",
+    "directory": "packages/atlas"
+  },
+  "homepage": "https://github.com/getnarro/narro/tree/main/packages/atlas",
+  "bugs": {
+    "url": "https://github.com/getnarro/narro/issues"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./video": {
+      "types": "./dist/video/index.d.ts",
+      "import": "./dist/video/index.js"
+    },
+    "./replay": {
+      "types": "./dist/replay/index.d.ts",
+      "import": "./dist/replay/index.js"
+    },
+    "./check": {
+      "types": "./dist/check/index.d.ts",
+      "import": "./dist/check/index.js"
+    },
+    "./package.json": "./package.json",
+    "./map": {
+      "types": "./dist/map/index.d.ts",
+      "import": "./dist/map/index.js"
+    },
+    "./image": {
+      "types": "./dist/image/index.d.ts",
+      "import": "./dist/image/index.js"
+    },
+    "./web": {
+      "types": "./dist/web/index.d.ts",
+      "import": "./dist/web/index.js"
+    },
+    "./embed": {
+      "types": "./dist/web/embed.d.ts",
+      "import": "./dist/web/embed.js"
+    }
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "presentation",
+    "zooming",
+    "infinite-canvas",
+    "camera",
+    "prezi",
+    "react",
+    "developer-tools"
+  ],
+  "peerDependencies": {
+    "@getnarro/replay": ">=0.1.0",
+    "@getnarro/video": ">=0.7.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "@getnarro/replay": {
+      "optional": true
+    },
+    "@getnarro/video": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.7",
+    "@testing-library/jest-dom": "6.9.1",
+    "@testing-library/react": "16.3.0",
+    "@types/node": "22.16.0",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "19.2.3",
+    "esbuild": "0.27.0",
+    "jsdom": "27.2.0",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.14",
+    "@getnarro/replay": "0.1.0",
+    "@getnarro/video": "0.7.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup && node scripts/bundle-embed.mjs",
+    "lint": "biome lint .",
+    "format": "biome format --write .",
+    "check": "biome check --write . && tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}