@a2f0/skyline 0.1.3 → 0.1.5

package/docs/package.md

@@ -111,6 +111,13 @@ controls from the application's header and CSS. Embedding hides the standalone
 toolbar and study links so they do not overlap the host's navigation. Set
 `navigation: true` to show them. It retains stars, the traced
 loading silhouette, star controls, original comparison, and building details.
+The scene's control bar starts folded behind its star; set `controls: 'open'` to
+start it open, with no fold, from its first frame. Visitors can still fold it.
+Open, the bar shows the camera hint and the OpenStreetMap credit for the streets
+and footprints. Set `attribution: false` to leave the credit out. OpenStreetMap's
+[licence](https://www.openstreetmap.org/copyright) requires crediting its contributors
+wherever its data is shown, so do this only when the host page credits
+© OpenStreetMap contributors itself.
 A small independent **show original** button remains available until the first
 3D frame succeeds, and reappears if the graphics context is lost. The SVG stays
 reachable even if WebGL, the scene document, or its bootstrap script cannot load.

package/lib/skyline-package.d.ts

@@ -8,6 +8,14 @@ export interface SkylineOptions {
     title?: string;
     /** Show the standalone toolbar and study links. Hidden by default when embedded. */
     navigation?: boolean;
+    /** Start the 3D scene's control bar open, or folded behind its star. Closed by default. */
+    controls?: "open" | "closed";
+    /**
+     * Show the OpenStreetMap credit with the 3D scene's controls. Shown by default. OpenStreetMap's
+     * licence requires that credit wherever its data appears, so hide it only when the host page
+     * credits OpenStreetMap contributors itself.
+     */
+    attribution?: boolean;
 }
 export interface SkylineInstance {
     /** The viewer's frame; its styles are isolated from the host application. */
@@ -20,4 +28,4 @@ export interface SkylineInstance {
  * this module never touches the DOM; call it after mounting a browser component.
  * The container controls placement and size. Destroy it when that component leaves.
  */
-export declare function mountSkyline(container: HTMLElement, { assetsUrl, title, navigation }: SkylineOptions): SkylineInstance;
+export declare function mountSkyline(container: HTMLElement, { assetsUrl, title, navigation, controls, attribution }: SkylineOptions): SkylineInstance;

package/lib/skyline-package.js

@@ -3,7 +3,9 @@
  * this module never touches the DOM; call it after mounting a browser component.
  * The container controls placement and size. Destroy it when that component leaves.
  */
-export function mountSkyline(container, { assetsUrl, title = "Interactive Chicago skyline", navigation = false }) {
+export function mountSkyline(container, { assetsUrl, title = "Interactive Chicago skyline", navigation = false, controls = "closed", attribution = true }) {
+    if (controls !== "open" && controls !== "closed")
+        throw new TypeError('Skyline controls must be "open" or "closed".');
     const document = container.ownerDocument;
     const base = new URL(assetsUrl, document.baseURI);
     if (!/^(https?:)$/.test(base.protocol))
@@ -17,6 +19,10 @@ export function mountSkyline(container, { assetsUrl, title = "Interactive Chicag
     const viewerUrl = new URL("index.html", base);
     if (!navigation)
         viewerUrl.searchParams.set("embed", "1");
+    if (controls === "open")
+        viewerUrl.searchParams.set("controls", "open");
+    if (!attribution)
+        viewerUrl.searchParams.set("attribution", "hidden");
     element.src = viewerUrl.href;
     element.allowFullscreen = true;
     element.style.cssText = "display:block;width:100%;height:100%;border:0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2f0/skyline",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Interactive Chicago skyline viewer and reusable Three.js building models",
   "license": "UNLICENSED",
   "repository": {

package/site/skyline-3d.html

@@ -78,6 +78,26 @@
         </div>
       </div>
     </footer>
+    <script>
+      // Settings from this page's address, then from the viewer that frames it, applied before
+      // the bar's first frame. ?controls=open starts the bar open, with no fold; skyline-3d.ts
+      // folds it from there. ?attribution=hidden leaves out the OpenStreetMap credit.
+      (() => {
+        const settings = new URLSearchParams(location.search);
+        try {
+          if (parent !== window && parent.document.querySelector("#skyline-3d-scene")?.contentWindow === window) {
+            for (const [key, value] of new URLSearchParams(parent.location.search)) if (!settings.has(key)) settings.set(key, value);
+          }
+        } catch { /* A scene embedded on another origin reads only its own address. */ }
+        if (settings.get("controls") === "open") {
+          const toggle = document.querySelector("#menu-toggle");
+          toggle.setAttribute("aria-expanded", "true");
+          toggle.title = "Hide the controls";
+          document.querySelector(".control-bar").classList.add("open");
+        }
+        if (settings.get("attribution") === "hidden") document.querySelector(".attribution").hidden = true;
+      })();
+    </script>
     <div class="tooltip" id="tooltip" aria-hidden="true" hidden></div>
     <div class="context-menu" id="building-menu" hidden>
       <p class="context-menu-title" id="building-menu-title"></p>