@cardstack/boxel-cli 0.10.0 → 0.10.1-unstable.0

package/bundled-realms/pretui/media-examples.gts

@@ -0,0 +1,315 @@
+// Pretui — media-examples: fixtures for the media territory.
+//
+// A media kit whose examples only work online is a kit you cannot review on
+// a plane, cannot test headlessly, and cannot trust. So the primary fixtures
+// here are GENERATED at module scope and carry no network dependency at all:
+//
+//   • `TONE_WAV` — six seconds of real, playable PCM audio, synthesised as a
+//     `data:audio/wav` URL. A speech-shaped desk note over the twelve-note
+//     bed: formants, syllable pulses, phrase pauses. A raw sine run paints
+//     twelve identical blocks; this one has to look like a waveform people
+//     recognise. No `Math.random`, no `Date.now`, no fetch: the same bytes
+//     on every machine and every reindex.
+//   • `SOURCING_VTT` — a real WebVTT file, also a data URL, compiled from
+//     the same cue list the transcript renders. One source of truth for the
+//     browser's caption channel and ours.
+//   • `platePoster(...)` — deterministic SVG posters, so a grid of assets
+//     has pictures without shipping a single binary.
+//
+// The colour literals in the generated SVGs are CONTENT, not styling: they
+// stand in for photographs. Nothing in a component reads them, and the
+// no-hand-authored-colours rule is about component CSS.
+//
+// The video fixture is the one exception and is marked as such: there is no
+// way to synthesise an mp4 in twenty lines. It points at the public test
+// asset Media Chrome's own documentation uses, and every demo takes it as a
+// replaceable knob. Offline it exercises the error channel, which is a
+// perfectly good thing for a demo to show.
+import { seedFrom } from './examples';
+import type { MediaTrackSpec, TranscriptCue } from './components/media-player';
+import { formatClock } from './internal/reading-format';
+import type { MediaAssetSpec } from './internal/media-viewer';
+
+// ── A playable tone, from arithmetic ─────────────────────────────────────
+
+const TONE_RATE = 22050;
+const TONE_NOTE_SECONDS = 0.5;
+// A plain modal run. Fixed, so the waveform is byte-identical everywhere.
+const TONE_NOTES = [
+  392, 440, 523.25, 587.33, 659.25, 523.25, 440, 392, 349.23, 392, 440, 523.25,
+];
+// Phrase energy for the six one-second cues in SOURCING_TRANSCRIPT — buyer
+// lines hit harder, the close tapers. Index is floor(t).
+const TONE_PHRASE = [0.82, 0.7, 1, 0.56, 0.94, 0.46];
+
+/** Seconds of audio in `TONE_WAV`. */
+export const TONE_SECONDS = TONE_NOTES.length * TONE_NOTE_SECONDS;
+
+/** Speech-shaped amplitude at time `t` (seconds). Deterministic: the same
+ * syllable pulses and pauses on every machine, so the painted peaks stay
+ * a desk note rather than twelve equal bricks. */
+function toneEnvelope(t: number): number {
+  const phrase = Math.min(TONE_PHRASE.length - 1, Math.floor(t));
+  const local = t - Math.floor(t);
+  const attack = Math.min(1, local / 0.045);
+  const release = Math.min(1, Math.max(0, (0.9 - local) / 0.08));
+  const pause = local > 0.86 ? 0.12 : 1;
+  const rate = 4.15 + (phrase % 3) * 0.38;
+  const syllable = Math.sin(Math.PI * rate * local);
+  const pulse = 0.22 + 0.78 * syllable * syllable;
+  return TONE_PHRASE[phrase] * attack * release * pause * pulse;
+}
+
+/** One PCM sample in [-1, 1]: the note bed, two formants, a sibilant on
+ * the syllable attack, and a thin room tone so quiet gaps still draw. */
+function toneSample(t: number): number {
+  const note = TONE_NOTES[Math.min(TONE_NOTES.length - 1, Math.floor(t / TONE_NOTE_SECONDS))];
+  const env = toneEnvelope(t);
+  const twoPi = 2 * Math.PI * t;
+  const bed =
+    0.62 * Math.sin(twoPi * note) +
+    0.22 * Math.sin(twoPi * note * 2) +
+    0.1 * Math.sin(twoPi * note * 3);
+  const formant =
+    0.16 * Math.sin(twoPi * 720) * env + 0.09 * Math.sin(twoPi * 1380) * env;
+  const sibilant = 0.07 * Math.sin(twoPi * 4100) * env * env;
+  const room = 0.035 * Math.sin(twoPi * 68) + 0.02 * Math.sin(twoPi * 190);
+  const value = bed * env + formant + sibilant + room;
+  return Math.max(-1, Math.min(1, value * 0.78));
+}
+
+function toneWav(): string {
+  const samples = Math.round(TONE_RATE * TONE_SECONDS);
+  const dataBytes = samples * 2;
+  const bytes: number[] = [];
+  const ascii = (text: string) => {
+    for (let i = 0; i < text.length; i++) {
+      bytes.push(text.charCodeAt(i));
+    }
+  };
+  const u32 = (n: number) => {
+    bytes.push(n & 255, (n >>> 8) & 255, (n >>> 16) & 255, (n >>> 24) & 255);
+  };
+  const u16 = (n: number) => {
+    bytes.push(n & 255, (n >>> 8) & 255);
+  };
+  const i16 = (n: number) => {
+    const v = n < 0 ? n + 65536 : n;
+    bytes.push(v & 255, (v >>> 8) & 255);
+  };
+  // Canonical 44-byte RIFF/WAVE header: PCM, mono, 16-bit signed.
+  ascii('RIFF');
+  u32(36 + dataBytes);
+  ascii('WAVE');
+  ascii('fmt ');
+  u32(16);
+  u16(1);
+  u16(1);
+  u32(TONE_RATE);
+  u32(TONE_RATE * 2);
+  u16(2);
+  u16(16);
+  ascii('data');
+  u32(dataBytes);
+  for (let i = 0; i < samples; i++) {
+    i16(Math.round(toneSample(i / TONE_RATE) * 32767));
+  }
+  let binary = '';
+  for (let i = 0; i < bytes.length; i += 4096) {
+    binary += String.fromCharCode(...bytes.slice(i, i + 4096));
+  }
+  return `data:audio/wav;base64,${btoa(binary)}`;
+}
+
+/** Six seconds of playable audio, with no network and no binary in tree. */
+export const TONE_WAV: string = toneWav();
+
+// ── The transcript, and the VTT compiled from it ─────────────────────────
+
+/** The sourcing desk, dictating a lot note over the tone. Cue boundaries
+ * line up with the twelve half-second notes. */
+export const SOURCING_TRANSCRIPT: readonly TranscriptCue[] = [
+  {
+    start: 0,
+    end: 1,
+    speaker: 'Desk',
+    text: 'Lot B-1180, second flush, booked against the Kandy line.',
+  },
+  {
+    start: 1,
+    end: 2,
+    speaker: 'Desk',
+    text: 'Twenty-six chests landed, two held back for the cupping table.',
+  },
+  {
+    start: 2,
+    end: 3,
+    speaker: 'Buyer',
+    text: 'Colour is right. The liquor reads a shade thin against last season.',
+  },
+  {
+    start: 3,
+    end: 4,
+    speaker: 'Desk',
+    text: 'Noted. I will flag it on the manifest before it goes out.',
+  },
+  {
+    start: 4,
+    end: 5,
+    speaker: 'Buyer',
+    text: 'Price holds. Take the whole line and we settle on Friday.',
+  },
+  {
+    start: 5,
+    end: 6,
+    speaker: 'Desk',
+    text: 'Agreed — the whole line, Friday. Recording ends.',
+  },
+];
+
+function vttTime(seconds: number): string {
+  const whole = Math.floor(seconds);
+  const ms = Math.round((seconds - whole) * 1000);
+  const hh = String(Math.floor(whole / 3600)).padStart(2, '0');
+  const mm = String(Math.floor(whole / 60) % 60).padStart(2, '0');
+  const ss = String(whole % 60).padStart(2, '0');
+  return `${hh}:${mm}:${ss}.${String(ms).padStart(3, '0')}`;
+}
+
+/** Compile cues to a WebVTT document. The transcript and the browser's own
+ * caption track then cannot disagree, which is the bug every hand-written
+ * example in this space eventually ships. */
+export function vttFrom(cues: readonly TranscriptCue[]): string {
+  const body = cues
+    .map((cue, i) => {
+      const who = cue.speaker ? `<v ${cue.speaker}>` : '';
+      return `${i + 1}\n${vttTime(cue.start)} --> ${vttTime(cue.end)}\n${who}${cue.text}`;
+    })
+    .join('\n\n');
+  return `WEBVTT\n\n${body}\n`;
+}
+
+/** The same cues as a `data:text/vtt` URL, ready for a `<track src>`. */
+export const SOURCING_VTT: string = `data:text/vtt;charset=utf-8,${encodeURIComponent(
+  vttFrom(SOURCING_TRANSCRIPT),
+)}`;
+
+/** One English captions track, offline. */
+export const SOURCING_TRACKS: readonly MediaTrackSpec[] = [
+  {
+    src: SOURCING_VTT,
+    label: 'English',
+    srclang: 'en',
+    kind: 'captions',
+    isDefault: true,
+  },
+];
+
+// ── Deterministic SVG posters ────────────────────────────────────────────
+
+const PLATE_INKS = [
+  ['#1f2933', '#7b8794'],
+  ['#26343f', '#8aa1a8'],
+  ['#2f2a3a', '#9a8fb0'],
+  ['#33291f', '#b09a7d'],
+  ['#1f3329', '#7fae94'],
+];
+
+/** A poster that looks composed rather than generated: two-tone ground, a
+ * horizon, one disc. Seeded from the label, so the same asset always wears
+ * the same plate. */
+export function platePoster(label: string, ratio = '16 / 9'): string {
+  const seed = seedFrom(label);
+  const parts = ratio.split('/');
+  const w = 640;
+  const h = Math.round(
+    (640 * (Number(parts[1]) || 9)) / (Number(parts[0]) || 16),
+  );
+  const inks = PLATE_INKS[seed % PLATE_INKS.length];
+  const horizon = Math.round(h * (0.42 + ((seed >>> 3) % 24) / 100));
+  const cx = Math.round(w * (0.24 + ((seed >>> 7) % 52) / 100));
+  const r = Math.round(h * (0.1 + ((seed >>> 11) % 12) / 100));
+  const svg = [
+    `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${w} ${h}">`,
+    `<rect width="${w}" height="${h}" fill="${inks[0]}"/>`,
+    `<rect y="${horizon}" width="${w}" height="${h - horizon}" fill="${inks[1]}" opacity="0.35"/>`,
+    `<circle cx="${cx}" cy="${horizon}" r="${r}" fill="${inks[1]}" opacity="0.85"/>`,
+    `<rect y="${horizon}" width="${w}" height="1.5" fill="${inks[1]}"/>`,
+    `</svg>`,
+  ].join('');
+  return `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
+}
+
+// ── The one networked fixture ────────────────────────────────────────────
+
+/** Public test clip used by Media Chrome's own documentation. Every demo
+ * takes it as a knob; offline, the player lands on its error channel. */
+export const SAMPLE_VIDEO_SRC =
+  'https://stream.mux.com/A3VXy02VoUinw01pwyomEO3bHnG4P32xzV7u1j1FSzjNg/high.mp4';
+
+/** A generated poster rather than a fetched thumbnail, so the reserved
+ * space is filled even with no network. */
+export const SAMPLE_VIDEO_POSTER: string = platePoster('tea-trade-reel');
+
+// ── An asset shelf for the grid and the viewer ───────────────────────────
+
+const SHELF: Array<[string, string, string, number, number, number]> = [
+  ['Kandy plate 04', 'jpg', 'image/jpeg', 1600, 1067, 842_000],
+  ['Dust grade macro', 'jpg', 'image/jpeg', 1400, 1400, 1_140_000],
+  ['Chest 118 stencil', 'png', 'image/png', 900, 1200, 318_000],
+  ['Estate reel', 'mp4', 'video/mp4', 1920, 1080, 18_400_000],
+  ['Cupping notes', 'wav', 'audio/wav', 0, 0, 1_320_000],
+  ['Auction floor', 'jpg', 'image/jpeg', 2000, 1333, 1_680_000],
+  ['Crate, exploded', 'glb', 'model/gltf-binary', 0, 0, 4_900_000],
+  ['Grading chart', 'png', 'image/png', 1200, 800, 210_000],
+];
+
+/** Eight assets across four kinds, so `MediaViewer` routing and `AssetGrid`
+ * both have something honest to chew on — including one kind (`model`) that
+ * deliberately has no adapter yet. */
+export const SAMPLE_ASSETS: readonly MediaAssetSpec[] = SHELF.map(
+  ([name, ext, mime, width, height, bytes]) => {
+    const kindRatio = width && height ? `${width} / ${height}` : '16 / 9';
+    const timeBased = mime.startsWith('audio') || mime.startsWith('video');
+    return {
+      src: mime.startsWith('audio')
+        ? TONE_WAV
+        : mime.startsWith('video')
+          ? SAMPLE_VIDEO_SRC
+          : `https://assets.example.invalid/sourcing/${encodeURIComponent(name)}.${ext}`,
+      name,
+      mimeType: mime,
+      thumbnail: platePoster(name, kindRatio),
+      poster: platePoster(name, kindRatio),
+      alt: `${name} — a generated stand-in plate`,
+      width: width || undefined,
+      height: height || undefined,
+      bytes,
+      duration: timeBased ? TONE_SECONDS : undefined,
+      tracks: timeBased ? SOURCING_TRACKS : undefined,
+      transcript: timeBased ? SOURCING_TRANSCRIPT : undefined,
+      meta: {
+        Format: ext.toUpperCase(),
+        Origin: 'Sourcing desk',
+        Duration: timeBased ? formatClock(TONE_SECONDS) : '—',
+      },
+    };
+  },
+);
+
+/** The audio asset on its own, for the single-asset demos. */
+export const TONE_ASSET: MediaAssetSpec = {
+  src: TONE_WAV,
+  name: 'Lot B-1180 — desk note',
+  mimeType: 'audio/wav',
+  thumbnail: platePoster('Lot B-1180 — desk note', '1 / 1'),
+  duration: TONE_SECONDS,
+  bytes: TONE_RATE * TONE_SECONDS * 2 + 44,
+  tracks: SOURCING_TRACKS,
+  transcript: SOURCING_TRANSCRIPT,
+  meta: {
+    Format: 'WAV · 22 kHz · 16-bit mono',
+    Origin: 'Synthesised in media-examples.gts',
+    Duration: formatClock(TONE_SECONDS),
+  },
+};

package/bundled-realms/pretui/model-viewer/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/{LICENSE → bundled-realms/pretui/model-viewer/LICENSE-gainmap-js}

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Cardstack
+Copyright (c) 2023 MONOGRID
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/bundled-realms/pretui/model-viewer/LICENSE-lit

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2017 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/bundled-realms/pretui/model-viewer/LICENSE-three

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/bundled-realms/pretui/model-viewer/NOTICE

@@ -0,0 +1,67 @@
+Pretui vendored copy of @google/model-viewer
+============================================
+
+This directory contains a redistribution of <model-viewer>, in modified form.
+
+Original work
+-------------
+  @google/model-viewer
+  Copyright 2020 Google LLC
+  Licensed under the Apache License, Version 2.0 (the "License"); you may not
+  use this file except in compliance with the License. You may obtain a copy of
+  the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+  License for the specific language governing permissions and limitations under
+  the License.
+
+  The full licence text is in ./LICENSE.
+
+  The upstream project ships no NOTICE file of its own; Apache-2.0 section
+  4(d) therefore imposes no NOTICE-propagation duty here. This file exists to
+  satisfy sections 4(a), 4(b) and 4(c).
+
+Statement of changes (Apache-2.0 section 4(b))
+----------------------------------------------
+`index.js` is not the upstream distribution. It differs as follows, and the
+same statement appears as a banner comment at the top of the file itself:
+
+  1. It is a single self-contained ES module produced by esbuild from the
+     package's TypeScript sources, rather than the upstream rollup output.
+     Its bundled dependencies (three, lit, @monogrid/gainmap-js) are inlined.
+  2. A temporary server-safe globals shim is prepended, and a matching
+     teardown is appended. Neither is part of the upstream work. The shim
+     installs stand-ins for `HTMLElement`, `document`, `customElements` and
+     related globals ONLY when they are absent — i.e. never in a browser — and
+     the footer deletes them again as soon as the library body has finished
+     evaluating. Its sole purpose is to let the Boxel realm indexer, which
+     evaluates modules outside a browser, load this module without throwing.
+  3. Minification with `--legal-comments=none` strips the per-file licence
+     headers of the original sources; the banner and this NOTICE carry the
+     attribution in their place.
+
+No functional change was made to model-viewer's own code.
+
+Bundled third-party components
+------------------------------
+  three            0.183.2   MIT              — see ./LICENSE-three
+  lit              3.3.3     BSD-3-Clause     — see ./LICENSE-lit
+  @monogrid/gainmap-js  3.4.0  MIT           — see ./LICENSE-gainmap-js
+
+  lit's BSD-3-Clause carries a no-endorsement clause in addition to the notice
+  clause: the names of the copyright holder and its contributors may not be
+  used to endorse or promote products derived from this software without prior
+  written permission.
+
+Provenance
+----------
+  Source:  local checkout at github.com/google/model-viewer
+  Commit:  297ed2bd  (`git describe --tags` → v4.3.1-12-g297ed2bd)
+  Version: 4.3.1 as declared in packages/model-viewer/package.json — the
+           commit is 12 commits AFTER the v4.3.1 tag and does not correspond
+           to any published release.
+  SPDX:    Apache-2.0, read from the checkout's own LICENSE file.