@ksp-gonogo/kerbcast 1.4.0 → 1.5.0

package/README.md

@@ -12,6 +12,12 @@ rolling their own transport.
 The Rust crate and this package ship the same SemVer version,
 bumped together by `./scripts/bump-version.sh`.
 
+Building a React app? Use
+[`@ksp-gonogo/kerbcast-react`](https://www.npmjs.com/package/@ksp-gonogo/kerbcast-react),
+which wraps this client in a ready-made `CameraFeed` component plus
+hooks. This package is its core dependency; reach for it directly when
+you want the raw client, a non-React consumer, or your own transport.
+
 ## Install
 
 Hosted on public npm. No registry route or auth needed:
@@ -34,6 +40,11 @@ await cam.setFov(35);
 await cam.setRenderSize(384, 384);
 await cam.setDegrade(0.5);
 
+// Pan/tilt and zoom, when the camera's mount supports it.
+await cam.setPan(10, -5); // absolute yaw/pitch in degrees
+await cam.setPanRate(0.5, 0); // persistent velocity, -1..1; 0,0 stops
+await cam.setZoomRate(1); // +1 zooms in, holds until superseded
+
 const videoEl = document.querySelector("video")!;
 videoEl.srcObject = cam.mediaStream;
 
@@ -81,9 +92,12 @@ controls each part actually supports.
 
 - `supportsZoom`, `fov`, `fovMin`, `fovMax`. 19 of 21 stock Hullcam
   VDS parts support runtime FoV via `MuMechModuleHullCameraZoom`.
-- `supportsPan`, `panYawMin/Max`, `panPitchMin/Max`. Reserved for the
-  planned mod extension that adds steerable mounts. Always `false`
-  right now.
+- `supportsPan`, `panYawMin/Max`, `panPitchMin/Max`. Whether this
+  camera's mount steers. Pan/tilt is fully wired end to end (`setPan`,
+  `setPanRate`, and the `PanZoomController` helper below); this flag
+  tells you whether a given part will act on it. Stock Hullcam VDS
+  mounts are fixed and report `false`; steerable mounts report `true`
+  with their travel limits. Hide the pan controls when `false`.
 - `encoderBitrateBps`, `targetBitrateBps`. Current encoder bitrate
   and the REMB-driven target. They diverge briefly when receivers'
   bandwidth estimates move.
@@ -93,6 +107,31 @@ controls each part actually supports.
   in-game CommNet signal loss. Also a real CPU optimisation when
   every consumer wants degraded video.
 
+## Pan/zoom input helper
+
+Driving pan and zoom from a gamepad stick, nudge buttons, or an FoV
+slider means rate deduplication, an analog deadzone, optimistic
+accumulators for discrete nudges, a debounced slider, and echo-sync
+while idle. `PanZoomController` is a headless state machine that handles
+all of that with no DOM or React dependency. A `KerbcastCameraHandle`
+satisfies its command sink structurally, so pass a camera straight in:
+
+```ts
+import { PanZoomController } from "@ksp-gonogo/kerbcast";
+
+const cam = client.camera(flightId);
+const ctrl = new PanZoomController(cam);
+
+ctrl.setPanRate(stickX, stickY); // analog stick
+ctrl.nudgePan(1, 0); // discrete "pan right" button
+ctrl.nudgeZoom(-1); // discrete "zoom in" button
+
+// Keep the controller's view in sync with echoed camera state.
+cam.on("change", (s) => ctrl.syncFromState(s));
+
+ctrl.stop(); // on teardown
+```
+
 ## Multi-language
 
 `typeshare` also generates Kotlin, Swift, Scala, and Go. Those

package/dist/__generated__/types.d.ts

@@ -175,6 +175,15 @@ export interface HelloPayload {
     sidecarVersion: string;
     encoderBackend: string;
 }
+/**
+ * Scene-state change: whether KSP is currently in a flight scene. Sent
+ * after `Hello` (priming) and whenever the polled in-flight flag flips,
+ * so clients can show a calm out-of-flight standby instead of per-camera
+ * SIGNAL LOST when the whole scene unloads.
+ */
+export interface SceneStateChangedPayload {
+    inFlight: boolean;
+}
 export interface SetDegradePayload {
     flightId: number;
     /**
@@ -526,4 +535,12 @@ export type ServerMessage =
  | {
     type: "settings-state";
     content: SettingsStatePayload;
+}
+/**
+ * Whether KSP is in a flight scene. Primed after `Hello` and
+ * re-broadcast when the polled in-flight flag changes.
+ */
+ | {
+    type: "scene-state-changed";
+    content: SceneStateChangedPayload;
 };

package/dist/client.d.ts

@@ -201,6 +201,13 @@ export interface KerbcastClientEvents {
      * reflects what the plugin has applied, not just what was requested.
      */
     "settings-change": SettingsStatePayload;
+    /**
+     * Fired when a `scene-state-changed` message arrives. `true` in a
+     * flight scene, `false` otherwise, `undefined` before the first
+     * signal. Consumers use this to show a calm out-of-flight standby
+     * instead of per-camera SIGNAL LOST.
+     */
+    "scene-change": boolean | undefined;
 }
 /**
  * Pluggable WebRTC transport. Production code uses the default
@@ -319,6 +326,8 @@ export declare class KerbcastClient extends TypedEmitter<KerbcastClientEvents> {
     private _captureUt;
     private _captureEpoch;
     private _warpRate;
+    /** Whether KSP is in a flight scene. `undefined` until the first signal. */
+    private _inFlight;
     constructor(cfg: KerbcastClientConfig, transport?: KerbcastTransport);
     get state(): KerbcastConnectionState;
     get cameras(): ReadonlyArray<CameraState>;
@@ -343,6 +352,12 @@ export declare class KerbcastClient extends TypedEmitter<KerbcastClientEvents> {
         epoch: number;
         warpRate: number;
     };
+    /**
+     * Whether KSP is currently in a flight scene, from the sidecar's
+     * `scene-state-changed`. `undefined` until the first signal (so a
+     * consumer never flashes the out-of-flight standby on connect).
+     */
+    get inFlight(): boolean | undefined;
     /**
      * Send a `set-throttle-main-screen` command to the sidecar, which writes
      * `global.control.json` for the plugin to apply. The plugin persists the

package/dist/client.js

@@ -233,16 +233,20 @@ class CameraHandle extends TypedEmitter {
         this._sourceless = raw === null;
         const noiseEnabled = this.client._resolveNoise(this._noiseOverride);
         if (noiseEnabled) {
+            // Sourceless feeds show static in flight, but go blank (black, no
+            // noise) out of flight so a whole-scene unload is calm.
+            const showStatic = raw ? this._showStatic : this._sourcelessShowStatic();
             // Reuse an existing pipeline; otherwise try to create one.
             if (!this._noisePipeline) {
                 const initial = raw ? this._liveIntensity() : SOURCELESS_INTENSITY;
                 this._noisePipeline = tryCreateNoisePipeline(raw, initial, {
-                    showStatic: this._showStatic,
+                    showStatic,
                     onStallChange: (stalled) => this._setStalled(stalled),
                 });
             }
             else {
                 this._noisePipeline.setSource(raw);
+                this._noisePipeline.setShowStatic(showStatic);
             }
             const pipeline = this._noisePipeline;
             if (pipeline) {
@@ -261,6 +265,23 @@ class CameraHandle extends TypedEmitter {
         // expose the raw stream directly, or null when there's no source.
         this._setOutput(raw);
     }
+    /**
+     * Whether a sourceless (destroyed/absent) feed should render static. True
+     * in flight (or before the scene signal), false out of flight so the feed
+     * goes blank rather than a wall of red static when the whole scene unloads.
+     */
+    _sourcelessShowStatic() {
+        return this._showStatic && this.client.inFlight !== false;
+    }
+    /**
+     * Internal — called by the client when the scene flag flips. Re-drives an
+     * existing sourceless pipeline so it switches between static and blank.
+     */
+    _refreshSceneState() {
+        if (this._sourceless) {
+            this._noisePipeline?.setShowStatic(this._sourcelessShowStatic());
+        }
+    }
     _setOutput(stream) {
         this._mediaStream = stream;
         this.emit("stream", stream);
@@ -409,6 +430,8 @@ export class KerbcastClient extends TypedEmitter {
         this._captureUt = null;
         this._captureEpoch = 0;
         this._warpRate = 1;
+        /** Whether KSP is in a flight scene. `undefined` until the first signal. */
+        this._inFlight = undefined;
         this.cfg = cfg;
         this.transport =
             transport ??
@@ -451,6 +474,14 @@ export class KerbcastClient extends TypedEmitter {
             warpRate: this._warpRate,
         };
     }
+    /**
+     * Whether KSP is currently in a flight scene, from the sidecar's
+     * `scene-state-changed`. `undefined` until the first signal (so a
+     * consumer never flashes the out-of-flight standby on connect).
+     */
+    get inFlight() {
+        return this._inFlight;
+    }
     /**
      * Send a `set-throttle-main-screen` command to the sidecar, which writes
      * `global.control.json` for the plugin to apply. The plugin persists the
@@ -740,6 +771,16 @@ export class KerbcastClient extends TypedEmitter {
                 this._warpRate = msg.content.timeWarpRate ?? 1;
                 this.emit("settings-change", msg.content);
                 break;
+            case "scene-state-changed":
+                this._inFlight = msg.content.inFlight;
+                /* Re-drive every handle: out of flight, sourceless feeds go blank
+                   instead of showing static. Scene state carries no per-camera
+                   state, so nudge each handle to re-evaluate its presentation. */
+                for (const handle of this.handles.values()) {
+                    handle._refreshSceneState();
+                }
+                this.emit("scene-change", this._inFlight);
+                break;
         }
     }
     /**

package/dist/testing/index.d.ts

@@ -120,6 +120,8 @@ export declare class MockSidecar {
     get throttleMainScreen(): boolean;
     /** Push a `settings-state` event to the client (simulates a plugin-status-change broadcast). */
     fireSettingsState(payload: SettingsStatePayload): void;
+    /** Push a `scene-state-changed` event to the client (flight scene or not). */
+    fireSceneState(inFlight: boolean): void;
     /** Configure the slot-pool mids before connecting (dynamic mode). */
     withSlots(mids: string[]): this;
     /**

package/dist/testing/index.js

@@ -211,6 +211,10 @@ export class MockSidecar {
         this._throttleMainScreen = payload.throttleMainScreen;
         this._sendToClient({ type: "settings-state", content: payload });
     }
+    /** Push a `scene-state-changed` event to the client (flight scene or not). */
+    fireSceneState(inFlight) {
+        this._sendToClient({ type: "scene-state-changed", content: { inFlight } });
+    }
     /** Configure the slot-pool mids before connecting (dynamic mode). */
     withSlots(mids) {
         this._slotMids = [...mids];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ksp-gonogo/kerbcast",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "TypeScript client for the kerbcast KSP camera-streaming sidecar. KerbcastClient wraps the WebRTC peer + control channel; wire-format types are typeshare-generated from the sidecar's Rust protocol module.",
   "license": "CC-BY-NC-SA-4.0",
   "author": "Jon Pepler",
@@ -40,6 +40,13 @@
     "README.md",
     "CHANGELOG.md"
   ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "regen": "typeshare ../../sidecar/src --lang=typescript --output-file=src/__generated__/types.ts",
+    "prepublishOnly": "pnpm run build"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -47,11 +54,5 @@
     "jsdom": "^29.0.2",
     "typescript": "^5.4.0",
     "vitest": "^4.1.4"
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "regen": "typeshare ../../sidecar/src --lang=typescript --output-file=src/__generated__/types.ts"
   }
-}
+}

package/src/__generated__/types.ts

@@ -190,6 +190,16 @@ export interface HelloPayload {
 	encoderBackend: string;
 }
 
+/**
+ * Scene-state change: whether KSP is currently in a flight scene. Sent
+ * after `Hello` (priming) and whenever the polled in-flight flag flips,
+ * so clients can show a calm out-of-flight standby instead of per-camera
+ * SIGNAL LOST when the whole scene unloads.
+ */
+export interface SceneStateChangedPayload {
+	inFlight: boolean;
+}
+
 export interface SetDegradePayload {
 	flightId: number;
 	/**
@@ -484,5 +494,10 @@ export type ServerMessage =
 	 * so a freshly-connected client shows correct state immediately, and
 	 * re-broadcast whenever the polled plugin status shows a change.
 	 */
-	| { type: "settings-state", content: SettingsStatePayload };
+	| { type: "settings-state", content: SettingsStatePayload }
+	/**
+	 * Whether KSP is in a flight scene. Primed after `Hello` and
+	 * re-broadcast when the polled in-flight flag changes.
+	 */
+	| { type: "scene-state-changed", content: SceneStateChangedPayload };
 

package/src/client.test.ts

@@ -1522,6 +1522,27 @@ describe("KerbcastClient.inboundVideoStats", () => {
     expect(client.throttleMainScreen).toBe(true);
   });
 
+  it("tracks inFlight from scene-state-changed and emits scene-change", async () => {
+    const sidecar = new MockSidecar();
+    const client = new KerbcastClient(
+      { host: "h", port: 1 },
+      sidecar.createTransport(),
+    );
+    vi.spyOn(globalThis, "fetch").mockImplementation(() =>
+      Promise.resolve(MockSidecar.makeOfferResponse([])),
+    );
+    const seen: (boolean | undefined)[] = [];
+    client.on("scene-change", (v) => seen.push(v));
+    await client.connect();
+    sidecar.open();
+    expect(client.inFlight).toBeUndefined();
+    sidecar.fireSceneState(false);
+    expect(client.inFlight).toBe(false);
+    sidecar.fireSceneState(true);
+    expect(client.inFlight).toBe(true);
+    expect(seen).toEqual([false, true]);
+  });
+
   it("setThrottleMainScreen sends the correct command", async () => {
     const sidecar = new MockSidecar();
     const client = new KerbcastClient(

package/src/client.ts

@@ -230,6 +230,13 @@ export interface KerbcastClientEvents {
    * reflects what the plugin has applied, not just what was requested.
    */
   "settings-change": SettingsStatePayload;
+  /**
+   * Fired when a `scene-state-changed` message arrives. `true` in a
+   * flight scene, `false` otherwise, `undefined` before the first
+   * signal. Consumers use this to show a calm out-of-flight standby
+   * instead of per-camera SIGNAL LOST.
+   */
+  "scene-change": boolean | undefined;
 }
 
 // ---------------------------------------------------------------------------
@@ -557,15 +564,19 @@ class CameraHandle
     const noiseEnabled = this.client._resolveNoise(this._noiseOverride);
 
     if (noiseEnabled) {
+      // Sourceless feeds show static in flight, but go blank (black, no
+      // noise) out of flight so a whole-scene unload is calm.
+      const showStatic = raw ? this._showStatic : this._sourcelessShowStatic();
       // Reuse an existing pipeline; otherwise try to create one.
       if (!this._noisePipeline) {
         const initial = raw ? this._liveIntensity() : SOURCELESS_INTENSITY;
         this._noisePipeline = tryCreateNoisePipeline(raw, initial, {
-          showStatic: this._showStatic,
+          showStatic,
           onStallChange: (stalled) => this._setStalled(stalled),
         });
       } else {
         this._noisePipeline.setSource(raw);
+        this._noisePipeline.setShowStatic(showStatic);
       }
 
       const pipeline = this._noisePipeline;
@@ -586,6 +597,25 @@ class CameraHandle
     this._setOutput(raw);
   }
 
+  /**
+   * Whether a sourceless (destroyed/absent) feed should render static. True
+   * in flight (or before the scene signal), false out of flight so the feed
+   * goes blank rather than a wall of red static when the whole scene unloads.
+   */
+  private _sourcelessShowStatic(): boolean {
+    return this._showStatic && this.client.inFlight !== false;
+  }
+
+  /**
+   * Internal — called by the client when the scene flag flips. Re-drives an
+   * existing sourceless pipeline so it switches between static and blank.
+   */
+  _refreshSceneState(): void {
+    if (this._sourceless) {
+      this._noisePipeline?.setShowStatic(this._sourcelessShowStatic());
+    }
+  }
+
   private _setOutput(stream: MediaStream | null): void {
     this._mediaStream = stream;
     this.emit("stream", stream);
@@ -747,6 +777,8 @@ export class KerbcastClient extends TypedEmitter<KerbcastClientEvents> {
   private _captureUt: number | null = null;
   private _captureEpoch = 0;
   private _warpRate = 1;
+  /** Whether KSP is in a flight scene. `undefined` until the first signal. */
+  private _inFlight: boolean | undefined = undefined;
 
   constructor(cfg: KerbcastClientConfig, transport?: KerbcastTransport) {
     super();
@@ -799,6 +831,15 @@ export class KerbcastClient extends TypedEmitter<KerbcastClientEvents> {
     };
   }
 
+  /**
+   * Whether KSP is currently in a flight scene, from the sidecar's
+   * `scene-state-changed`. `undefined` until the first signal (so a
+   * consumer never flashes the out-of-flight standby on connect).
+   */
+  get inFlight(): boolean | undefined {
+    return this._inFlight;
+  }
+
   /**
    * Send a `set-throttle-main-screen` command to the sidecar, which writes
    * `global.control.json` for the plugin to apply. The plugin persists the
@@ -1122,6 +1163,16 @@ export class KerbcastClient extends TypedEmitter<KerbcastClientEvents> {
         this._warpRate = msg.content.timeWarpRate ?? 1;
         this.emit("settings-change", msg.content);
         break;
+      case "scene-state-changed":
+        this._inFlight = msg.content.inFlight;
+        /* Re-drive every handle: out of flight, sourceless feeds go blank
+           instead of showing static. Scene state carries no per-camera
+           state, so nudge each handle to re-evaluate its presentation. */
+        for (const handle of this.handles.values()) {
+          handle._refreshSceneState();
+        }
+        this.emit("scene-change", this._inFlight);
+        break;
     }
   }
 

package/src/testing/index.ts

@@ -270,6 +270,11 @@ export class MockSidecar {
     this._sendToClient({ type: "settings-state", content: payload });
   }
 
+  /** Push a `scene-state-changed` event to the client (flight scene or not). */
+  fireSceneState(inFlight: boolean): void {
+    this._sendToClient({ type: "scene-state-changed", content: { inFlight } });
+  }
+
   /** Configure the slot-pool mids before connecting (dynamic mode). */
   withSlots(mids: string[]): this {
     this._slotMids = [...mids];

package/LICENSE

@@ -1,369 +0,0 @@
-kerbcast
-Copyright (c) 2026 Jon Pepler
-
-This work is licensed under the Creative Commons
-Attribution-NonCommercial-ShareAlike 4.0 International License.
-Full legal text follows.
-
-
-Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International
-Public License
-
-By exercising the Licensed Rights (defined below), You accept and agree
-to be bound by the terms and conditions of this Creative Commons
-Attribution-NonCommercial-ShareAlike 4.0 International Public License
-("Public License"). To the extent this Public License may be
-interpreted as a contract, You are granted the Licensed Rights in
-consideration of Your acceptance of these terms and conditions, and the
-Licensor grants You such rights in consideration of benefits the
-Licensor receives from making the Licensed Material available under
-these terms and conditions.
-
-
-Section 1 -- Definitions.
-
-  a. Adapted Material means material subject to Copyright and Similar
-     Rights that is derived from or based upon the Licensed Material
-     and in which the Licensed Material is translated, altered,
-     arranged, transformed, or otherwise modified in a manner requiring
-     permission under the Copyright and Similar Rights held by the
-     Licensor. For purposes of this Public License, where the Licensed
-     Material is a musical work, performance, or sound recording,
-     Adapted Material is always produced where the Licensed Material is
-     synched in timed relation with a moving image.
-
-  b. Adapter's License means the license You apply to Your Copyright
-     and Similar Rights in Your contributions to Adapted Material in
-     accordance with the terms and conditions of this Public License.
-
-  c. BY-NC-SA Compatible License means a license listed at
-     creativecommons.org/compatiblelicenses, approved by Creative
-     Commons as essentially the equivalent of this Public License.
-
-  d. Copyright and Similar Rights means copyright and/or similar rights
-     closely related to copyright including, without limitation,
-     performance, broadcast, sound recording, and Sui Generis Database
-     Rights, without regard to how the rights are labeled or
-     categorized. For purposes of this Public License, the rights
-     specified in Section 2(b)(1)-(2) are not Copyright and Similar
-     Rights.
-
-  e. Effective Technological Measures means those measures that, in the
-     absence of proper authority, may not be circumvented under laws
-     fulfilling obligations under Article 11 of the WIPO Copyright
-     Treaty adopted on December 20, 1996, and/or similar international
-     agreements.
-
-  f. Exceptions and Limitations means fair use, fair dealing, and/or
-     any other exception or limitation to Copyright and Similar Rights
-     that applies to Your use of the Licensed Material.
-
-  g. License Elements means the license attributes listed in the name
-     of a Creative Commons Public License. The License Elements of this
-     Public License are Attribution, NonCommercial, and ShareAlike.
-
-  h. Licensed Material means the artistic or literary work, database,
-     or other material to which the Licensor applied this Public
-     License.
-
-  i. Licensed Rights means the rights granted to You subject to the
-     terms and conditions of this Public License, which are limited to
-     all Copyright and Similar Rights that apply to Your use of the
-     Licensed Material and that the Licensor has authority to license.
-
-  j. Licensor means the individual(s) or entity(ies) granting rights
-     under this Public License.
-
-  k. NonCommercial means not primarily intended for or directed towards
-     commercial advantage or monetary compensation. For purposes of
-     this Public License, the exchange of the Licensed Material for
-     other material subject to Copyright and Similar Rights by digital
-     file-sharing or similar means is NonCommercial provided there is
-     no payment of monetary compensation in connection with the
-     exchange.
-
-  l. Share means to provide material to the public by any means or
-     process that requires permission under the Licensed Rights, such
-     as reproduction, public display, public performance, distribution,
-     dissemination, communication, or importation, and to make material
-     available to the public including in ways that members of the
-     public may access the material from a place and at a time
-     individually chosen by them.
-
-  m. Sui Generis Database Rights means rights other than copyright
-     resulting from Directive 96/9/EC of the European Parliament and of
-     the Council of 11 March 1996 on the legal protection of databases,
-     as amended and/or succeeded, as well as other essentially
-     equivalent rights anywhere in the world.
-
-  n. You means the individual or entity exercising the Licensed Rights
-     under this Public License. Your has a corresponding meaning.
-
-
-Section 2 -- Scope.
-
-  a. License grant.
-
-       1. Subject to the terms and conditions of this Public License,
-          the Licensor hereby grants You a worldwide, royalty-free,
-          non-sublicensable, non-exclusive, irrevocable license to
-          exercise the Licensed Rights in the Licensed Material to:
-
-            a. reproduce and Share the Licensed Material, in whole or
-               in part, for NonCommercial purposes only; and
-
-            b. produce, reproduce, and Share Adapted Material for
-               NonCommercial purposes only.
-
-       2. Exceptions and Limitations. For the avoidance of doubt, where
-          Exceptions and Limitations apply to Your use, this Public
-          License does not apply, and You do not need to comply with
-          its terms and conditions.
-
-       3. Term. The term of this Public License is specified in Section
-          6(a).
-
-       4. Media and formats; technical modifications allowed. The
-          Licensor authorizes You to exercise the Licensed Rights in
-          all media and formats whether now known or hereafter created,
-          and to make technical modifications necessary to do so. The
-          Licensor waives and/or agrees not to assert any right or
-          authority to forbid You from making technical modifications
-          necessary to exercise the Licensed Rights, including
-          technical modifications necessary to circumvent Effective
-          Technological Measures. For purposes of this Public License,
-          simply making modifications authorized by this Section 2(a)
-          (4) never produces Adapted Material.
-
-       5. Downstream recipients.
-
-            a. Offer from the Licensor -- Licensed Material. Every
-               recipient of the Licensed Material automatically
-               receives an offer from the Licensor to exercise the
-               Licensed Rights under the terms and conditions of this
-               Public License.
-
-            b. Additional offer from the Licensor -- Adapted Material.
-               Every recipient of Adapted Material from You
-               automatically receives an offer from the Licensor to
-               exercise the Licensed Rights in the Adapted Material
-               under the conditions of the Adapter's License You apply.
-
-            c. No downstream restrictions. You may not offer or impose
-               any additional or different terms or conditions on, or
-               apply any Effective Technological Measures to, the
-               Licensed Material if doing so restricts exercise of the
-               Licensed Rights by any recipient of the Licensed
-               Material.
-
-       6. No endorsement. Nothing in this Public License constitutes or
-          may be construed as permission to assert or imply that You
-          are, or that Your use of the Licensed Material is, connected
-          with, or sponsored, endorsed, or granted official status by,
-          the Licensor or others designated to receive attribution as
-          provided in Section 3(a)(1)(A)(i).
-
-  b. Other rights.
-
-       1. Moral rights, such as the right of integrity, are not
-          licensed under this Public License, nor are publicity,
-          privacy, and/or other similar personality rights; however, to
-          the extent possible, the Licensor waives and/or agrees not to
-          assert any such rights held by the Licensor to the limited
-          extent necessary to allow You to exercise the Licensed
-          Rights, but not otherwise.
-
-       2. Patent and trademark rights are not licensed under this
-          Public License.
-
-       3. To the extent possible, the Licensor waives any right to
-          collect royalties from You for the exercise of the Licensed
-          Rights, whether directly or through a collecting society
-          under any voluntary or waivable statutory or compulsory
-          licensing scheme. In all other cases the Licensor expressly
-          reserves any right to collect such royalties, including when
-          the Licensed Material is used other than for NonCommercial
-          purposes.
-
-
-Section 3 -- License Conditions.
-
-Your exercise of the Licensed Rights is expressly made subject to the
-following conditions.
-
-  a. Attribution.
-
-       1. If You Share the Licensed Material (including in modified
-          form), You must:
-
-            a. retain the following if it is supplied by the Licensor
-               with the Licensed Material:
-
-                 i. identification of the creator(s) of the Licensed
-                    Material and any others designated to receive
-                    attribution, in any reasonable manner requested by
-                    the Licensor (including by pseudonym if
-                    designated);
-
-                ii. a copyright notice;
-
-               iii. a notice that refers to this Public License;
-
-                iv. a notice that refers to the disclaimer of
-                    warranties;
-
-                 v. a URI or hyperlink to the Licensed Material to the
-                    extent reasonably practicable;
-
-            b. indicate if You modified the Licensed Material and
-               retain an indication of any previous modifications; and
-
-            c. indicate the Licensed Material is licensed under this
-               Public License, and include the text of, or the URI or
-               hyperlink to, this Public License.
-
-       2. You may satisfy the conditions in Section 3(a)(1) in any
-          reasonable manner based on the medium, means, and context in
-          which You Share the Licensed Material. For example, it may be
-          reasonable to satisfy the conditions by providing a URI or
-          hyperlink to a resource that includes the required
-          information.
-       3. If requested by the Licensor, You must remove any of the
-          information required by Section 3(a)(1)(A) to the extent
-          reasonably practicable.
-
-  b. ShareAlike.
-
-     In addition to the conditions in Section 3(a), if You Share
-     Adapted Material You produce, the following conditions also apply.
-
-       1. The Adapter's License You apply must be a Creative Commons
-          license with the same License Elements, this version or
-          later, or a BY-NC-SA Compatible License.
-
-       2. You must include the text of, or the URI or hyperlink to, the
-          Adapter's License You apply. You may satisfy this condition
-          in any reasonable manner based on the medium, means, and
-          context in which You Share Adapted Material.
-
-       3. You may not offer or impose any additional or different terms
-          or conditions on, or apply any Effective Technological
-          Measures to, Adapted Material that restrict exercise of the
-          rights granted under the Adapter's License You apply.
-
-
-Section 4 -- Sui Generis Database Rights.
-
-Where the Licensed Rights include Sui Generis Database Rights that
-apply to Your use of the Licensed Material:
-
-  a. for the avoidance of doubt, Section 2(a)(1) grants You the right
-     to extract, reuse, reproduce, and Share all or a substantial
-     portion of the contents of the database for NonCommercial purposes
-     only;
-
-  b. if You include all or a substantial portion of the database
-     contents in a database in which You have Sui Generis Database
-     Rights, then the database in which You have Sui Generis Database
-     Rights (but not its individual contents) is Adapted Material,
-     including for purposes of Section 3(b); and
-
-  c. You must comply with the conditions in Section 3(a) if You Share
-     all or a substantial portion of the contents of the database.
-
-For the avoidance of doubt, this Section 4 supplements and does not
-replace Your obligations under this Public License where the Licensed
-Rights include other Copyright and Similar Rights.
-
-
-Section 5 -- Disclaimer of Warranties and Limitation of Liability.
-
-  a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE
-     EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS
-     AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF
-     ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS,
-     IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION,
-     WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR
-     PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS,
-     ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT
-     KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT
-     ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU.
-
-  b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE
-     TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION,
-     NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT,
-     INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES,
-     COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR
-     USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN
-     ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR
-     DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR
-     IN PART, THIS LIMITATION MAY NOT APPLY TO YOU.
-
-  c. The disclaimer of warranties and limitation of liability provided
-     above shall be interpreted in a manner that, to the extent
-     possible, most closely approximates an absolute disclaimer and
-     waiver of all liability.
-
-
-Section 6 -- Term and Termination.
-
-  a. This Public License applies for the term of the Copyright and
-     Similar Rights licensed here. However, if You fail to comply with
-     this Public License, then Your rights under this Public License
-     terminate automatically.
-
-  b. Where Your right to use the Licensed Material has terminated under
-     Section 6(a), it reinstates:
-
-       1. automatically as of the date the violation is cured, provided
-          it is cured within 30 days of Your discovery of the
-          violation; or
-
-       2. upon express reinstatement by the Licensor.
-
-     For the avoidance of doubt, this Section 6(b) does not affect any
-     right the Licensor may have to seek remedies for Your violations
-     of this Public License.
-
-  c. For the avoidance of doubt, the Licensor may also offer the
-     Licensed Material under separate terms or conditions or stop
-     distributing the Licensed Material at any time; however, doing so
-     will not terminate this Public License.
-
-  d. Sections 1, 5, 6, 7, and 8 survive termination of this Public
-     License.
-
-
-Section 7 -- Other Terms and Conditions.
-
-  a. The Licensor shall not be bound by any additional or different
-     terms or conditions communicated by You unless expressly agreed.
-
-  b. Any arrangements, understandings, or agreements regarding the
-     Licensed Material not stated herein are separate from and
-     independent of the terms and conditions of this Public License.
-
-
-Section 8 -- Interpretation.
-
-  a. For the avoidance of doubt, this Public License does not, and
-     shall not be interpreted to, reduce, limit, restrict, or impose
-     conditions on any use of the Licensed Material that could lawfully
-     be made without permission under this Public License.
-
-  b. To the extent possible, if any provision of this Public License is
-     deemed unenforceable, it shall be automatically reformed to the
-     minimum extent necessary to make it enforceable. If the provision
-     cannot be reformed, it shall be severed from this Public License
-     without affecting the enforceability of the remaining terms and
-     conditions.
-
-  c. No term or condition of this Public License will be waived and no
-     failure to comply consented to unless expressly agreed to by the
-     Licensor.
-
-  d. Nothing in this Public License constitutes or may be interpreted
-     as a limitation upon, or waiver of, any privileges and immunities
-     that apply to the Licensor or You, including from the legal
-     processes of any jurisdiction or authority.
-