@motionstudies/web 0.1.0-alpha.31 → 0.1.0-alpha.33

package/README.md

@@ -25,6 +25,28 @@ Build release candidates with `npm run build:packages`. Distribution manifests a
 
 Source workspace manifests always stay private. `npm run check:release` builds public candidates, tests their packed consumer and records the tested tarball hashes; `npm run release:dry-run` inspects the publication without writing to npm. The manual main-branch `release.yml` workflow publishes those same tarballs with public access and provenance. See [release instructions](https://github.com/emmettl/motionstudies/blob/main/docs/RELEASING.md) for bootstrap-token and trusted-publisher setup. All four shared packages are MIT-licensed; each distribution includes `LICENSE`.
 
+## Edition maintenance and layout observation
+
+These exports are introduced in coordinated release `0.1.0-alpha.33`; earlier releases do not expose them.
+
+`checkEditionBoundary` from `@motionstudies/data/edition-boundary` verifies the four
+shared registry pins, lockfile metadata, installed package identity, public exports
+and declared source imports. Pass `directories` for the edition's required source
+and worker roots, and `additionalPackages` for other packages needing the same
+exact-pin/public-export checks. `root` defaults to the working directory. The
+checker performs no installation, mutation or network access. It rejects missing
+configured directories, workspaces, shared source copies and installed links.
+`moduleReferences` from `@motionstudies/data/module-references` supplies the same
+AST-based import analysis to local policy tests; it reports nonliteral imports as
+unverifiable. Dataset, worker and publication policy remain edition-owned.
+
+`observeLayout` from `@motionstudies/web/observe-layout` measures once immediately,
+then batches resize notifications into one animation frame. Call its returned
+cleanup before removing the observed elements; it disconnects the observer and
+cancels pending work. Without ResizeObserver it still performs the initial
+measurement. The caller owns the elements, geometry, CSS variables and their
+cleanup; the helper does not choose clearance values or depend on React.
+
 ## Timetable patterns, station calls and observation windows
 
 `@motionstudies/core/domain/network-patterns` provides a transport-neutral repeated-schedule codec. `@motionstudies/web/use-pattern-network-day` lazily decodes current/adjacent chunks after verifying byte length and SHA-256; it exposes retry and drops old-source state when the manifest URL changes. Supply stable options and a stable asset resolver. Format/category options support existing edition wire contracts.

package/components/ButtonTooltips.js

@@ -126,6 +126,14 @@ export function ButtonTooltips() {
         window.addEventListener('resize', hide);
         window.addEventListener('blur', hide);
         capability.addEventListener('change', hide);
+        // Lazy loading may finish after the first hover or keyboard focus event.
+        // Recover the current target instead of requiring the user to leave and return.
+        const focused = buttonAt(document.activeElement);
+        const hovered = document.querySelector('button:hover');
+        if (focused?.matches(':focus-visible'))
+            show(focused, 0);
+        else if (hovered && !window.matchMedia('(any-pointer: coarse)').matches)
+            show(hovered, 400);
         return () => {
             hide();
             observer.disconnect();

package/observe-layout.d.ts

@@ -0,0 +1,4 @@
+/** Measure once immediately, then coalesce resize notifications into animation frames.
+ * Keep geometry and CSS policy in the caller. Dispose before removing its elements.
+ */
+export declare function observeLayout(elements: readonly Element[], measure: () => void): () => void;

package/observe-layout.js

@@ -0,0 +1,32 @@
+/** Measure once immediately, then coalesce resize notifications into animation frames.
+ * Keep geometry and CSS policy in the caller. Dispose before removing its elements.
+ */
+export function observeLayout(elements, measure) {
+    let frame;
+    let disposed = false;
+    const observer = typeof ResizeObserver === 'undefined' ? undefined : new ResizeObserver(() => {
+        if (disposed || frame !== undefined)
+            return;
+        frame = requestAnimationFrame(() => {
+            frame = undefined;
+            if (!disposed)
+                measure();
+        });
+    });
+    const dispose = () => {
+        disposed = true;
+        if (frame !== undefined)
+            cancelAnimationFrame(frame);
+        frame = undefined;
+        observer?.disconnect();
+    };
+    try {
+        elements.forEach(element => observer?.observe(element));
+        measure();
+    }
+    catch (error) {
+        dispose();
+        throw error;
+    }
+    return dispose;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motionstudies/web",
-  "version": "0.1.0-alpha.31",
+  "version": "0.1.0-alpha.33",
   "private": false,
   "type": "module",
   "description": "Browser controls and loaders for Motion Studies.",
@@ -166,7 +166,12 @@
       "import": "./components/TimelineScrubber.js",
       "default": "./components/TimelineScrubber.js"
     },
-    "./timeline-scrubber.css": "./components/timeline-scrubber.css"
+    "./timeline-scrubber.css": "./components/timeline-scrubber.css",
+    "./observe-layout": {
+      "types": "./observe-layout.d.ts",
+      "import": "./observe-layout.js",
+      "default": "./observe-layout.js"
+    }
   },
   "files": [
     "**/*.js",
@@ -183,7 +188,7 @@
     "**/*.css"
   ],
   "dependencies": {
-    "@motionstudies/core": "0.1.0-alpha.31"
+    "@motionstudies/core": "0.1.0-alpha.33"
   },
   "peerDependencies": {
     "react": "^19.3.0",