@johnmorrisdotca/kyogijo-stadiums 0.4.0 → 0.6.0

package/dist/element-entry.d.ts

@@ -1 +1,3 @@
-export { KYOGIJO_ATTRIBUTES, KYOGIJO_TAG, KyogijoField, defineKyogijoField, optionsFromAttributes, replaySettingsFromAttributes } from "./element.ts";
+export { KYOGIJO_ATTRIBUTES, KYOGIJO_TAG, KyogijoField, defineKyogijoField, optionsFromAttributes, replaySettingsFromAttributes, turnSettingsFromAttributes, turnWanted } from "./element.ts";
+export { useEmblems } from "./emblems-source.ts";
+export type { EmblemRenderer } from "./emblems-source.ts";

package/dist/element-entry.js

@@ -1,2 +1,3 @@
 // The custom element's class and its registration function; importing this entry registers nothing.
-export { KYOGIJO_ATTRIBUTES, KYOGIJO_TAG, KyogijoField, defineKyogijoField, optionsFromAttributes, replaySettingsFromAttributes } from "./element.js";
+export { KYOGIJO_ATTRIBUTES, KYOGIJO_TAG, KyogijoField, defineKyogijoField, optionsFromAttributes, replaySettingsFromAttributes, turnSettingsFromAttributes, turnWanted } from "./element.js";
+export { useEmblems } from "./emblems-source.js";

package/dist/element.d.ts

@@ -1,10 +1,16 @@
 import { type KyogijoReplay } from "./mount.ts";
+import { type KyogijoTurn } from "./turn.dom.ts";
+import type { TurnSettings } from "./turn.model.ts";
 import type { ReplaySettings, ReplayTimeline } from "./replay.types.ts";
 import type { ScoreOptions, SurfaceOptions } from "./types.ts";
 /** The tag of the element. */
 export declare const KYOGIJO_TAG = "kyogijo-field";
 /** The attributes the element reads. */
-export declare const KYOGIJO_ATTRIBUTES: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "description", "options", "loop", "speed", "autoplay", "controls", "trail"];
+export declare const KYOGIJO_ATTRIBUTES: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "arena", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options", "loop", "speed", "autoplay", "controls", "trail", "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch"];
+/** The settings of a 3D view an element's attributes make: `turn-view` names the viewpoint it opens on, `turn-controls="false"` and `turn-uprights="false"` leave the buttons and what stands on the surface out, `turn-score="floor"` leaves the score panel on the floor, `turn-touch="turn"` keeps every touch for the view. */
+export declare function turnSettingsFromAttributes(read: (name: string) => string | null, base?: TurnSettings): TurnSettings;
+/** Whether an element's `turn` attribute asks for the 3D view: present, and not `false`. */
+export declare const turnWanted: (read: (name: string) => string | null) => boolean;
 /** The settings of a replay an element's attributes make: `loop`, `autoplay` and `controls="false"` are switches, `speed` and `trail` numbers. */
 export declare function replaySettingsFromAttributes(read: (name: string) => string | null, base?: ReplaySettings): ReplaySettings;
 /** The options an element's attributes (and its `options` attribute and property) make. */
@@ -18,7 +24,7 @@ export declare function optionsFromAttributes(read: (name: string) => string | n
 declare const Base: typeof HTMLElement;
 export declare class KyogijoField extends Base {
     #private;
-    static observedAttributes: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "description", "options", "loop", "speed", "autoplay", "controls", "trail"];
+    static observedAttributes: readonly ["sport", "league", "size", "theme", "language", "orientation", "park", "ground", "arena", "year", "detail", "margin", "stripes", "exact-lines", "uppercase", "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks", "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color", "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options", "loop", "speed", "autoplay", "controls", "trail", "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch"];
     /** The options given as a property: an object, laid under the attributes. */
     get options(): Partial<ScoreOptions> | undefined;
     set options(value: Partial<ScoreOptions> | undefined);
@@ -30,6 +36,11 @@ export declare class KyogijoField extends Base {
     set replaySettings(value: ReplaySettings | undefined);
     /** The controller of the replay while there is one: play, pause, seek, step, speed. */
     get replay(): KyogijoReplay | undefined;
+    /** Settings of the 3D view beyond the attributes: `motion`, `lens`, `floor`, `onChange` and the rest of `TurnSettings`. */
+    get turnSettings(): TurnSettings | undefined;
+    set turnSettings(value: TurnSettings | undefined);
+    /** The 3D view while the element has the `turn` attribute: its viewpoints, `set`, `reset`. */
+    get turn(): KyogijoTurn | undefined;
     connectedCallback(): void;
     disconnectedCallback(): void;
     attributeChangedCallback(name: string): void;

package/dist/element.js

@@ -9,23 +9,44 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _KyogijoField_instances, _KyogijoField_mount, _KyogijoField_host, _KyogijoField_options, _KyogijoField_theme, _KyogijoField_timeline, _KyogijoField_replaySettings, _KyogijoField_replay, _KyogijoField_replayOf, _KyogijoField_attach, _KyogijoField_draw;
+var _KyogijoField_instances, _KyogijoField_mount, _KyogijoField_host, _KyogijoField_options, _KyogijoField_theme, _KyogijoField_timeline, _KyogijoField_replaySettings, _KyogijoField_replay, _KyogijoField_replayOf, _KyogijoField_turn, _KyogijoField_turnSettings, _KyogijoField_attach, _KyogijoField_draw;
 import { SPORTS } from "./draw.js";
 import { leagueIds } from "./leagues.js";
 import { parseRange } from "./ranges.names.js";
 import { mountKyogijo } from "./mount.js";
+import { TURN_PRESET_NAMES } from "./turn.camera.js";
+import { mountKyogijoTurn } from "./turn.dom.js";
 /** The tag of the element. */
 export const KYOGIJO_TAG = "kyogijo-field";
 /** The attributes the element reads. */
 export const KYOGIJO_ATTRIBUTES = [
-    "sport", "league", "size", "theme", "language", "orientation", "park", "ground", "year", "detail", "margin", "stripes", "exact-lines", "uppercase",
+    "sport", "league", "size", "theme", "language", "orientation", "park", "ground", "arena", "year", "detail", "margin", "stripes", "exact-lines", "uppercase",
     "pitch", "pitch-type", "half", "range", "range-end", "goals", "stripe-pattern", "corner-flags", "look", "line-width", "line-dash", "line-opacity", "landmarks", "walls", "quirks",
     "home", "away", "home-abbr", "away-abbr", "home-score", "away-score", "home-penalties", "away-penalties", "score", "home-logo", "away-logo", "home-color", "away-color",
-    "status", "competition", "date", "label", "winner", "home-side", "description", "options",
+    "status", "competition", "date", "label", "winner", "home-side", "pageant", "description", "options",
     "loop", "speed", "autoplay", "controls", "trail",
+    "turn", "turn-view", "turn-controls", "turn-uprights", "turn-score", "turn-touch",
 ];
 /** The attributes that are about a replay and not about the drawing. */
 const REPLAY_ATTRIBUTES = ["loop", "speed", "autoplay", "controls", "trail"];
+/** The settings of a 3D view an element's attributes make: `turn-view` names the viewpoint it opens on, `turn-controls="false"` and `turn-uprights="false"` leave the buttons and what stands on the surface out, `turn-score="floor"` leaves the score panel on the floor, `turn-touch="turn"` keeps every touch for the view. */
+export function turnSettingsFromAttributes(read, base = {}) {
+    const out = { ...base };
+    const view = read("turn-view");
+    if (view !== null && TURN_PRESET_NAMES.includes(view))
+        out.preset = view;
+    if (read("turn-controls") === "false")
+        out.controls = false;
+    if (read("turn-uprights") === "false")
+        out.uprights = false;
+    if (read("turn-score") === "floor")
+        out.score = "floor";
+    if (read("turn-touch") === "turn")
+        out.touch = "turn";
+    return out;
+}
+/** Whether an element's `turn` attribute asks for the 3D view: present, and not `false`. */
+export const turnWanted = (read) => read("turn") !== null && read("turn") !== "false";
 /** The settings of a replay an element's attributes make: `loop`, `autoplay` and `controls="false"` are switches, `speed` and `trail` numbers. */
 export function replaySettingsFromAttributes(read, base = {}) {
     const out = { ...base };
@@ -88,6 +109,7 @@ export function optionsFromAttributes(read, base) {
     text("orientation");
     text("park");
     text("ground");
+    text("arena");
     text("detail");
     text("pitch");
     text("pitch-type");
@@ -127,6 +149,16 @@ export function optionsFromAttributes(read, base) {
     const status = read("status");
     if (status !== null && status !== "")
         o.status = status;
+    // `pageant="carpet"` or `"stage"`, or `"true"` for a carpet; `"false"` leaves out what the `options` say.
+    const pageant = read("pageant");
+    if (pageant !== null) {
+        if (pageant === "carpet" || pageant === "stage")
+            o.pageant = pageant;
+        else if (pageant === "true" || pageant === "")
+            o.pageant = true;
+        else if (pageant === "false")
+            delete o.pageant;
+    }
     const side = read("home-side");
     if (side === "left" || side === "right")
         o.homeSide = side;
@@ -222,6 +254,8 @@ export class KyogijoField extends Base {
         _KyogijoField_replaySettings.set(this, void 0);
         _KyogijoField_replay.set(this, void 0);
         _KyogijoField_replayOf.set(this, void 0);
+        _KyogijoField_turn.set(this, void 0);
+        _KyogijoField_turnSettings.set(this, void 0);
     }
     /** The options given as a property: an object, laid under the attributes. */
     get options() {
@@ -251,6 +285,20 @@ export class KyogijoField extends Base {
     get replay() {
         return __classPrivateFieldGet(this, _KyogijoField_replay, "f");
     }
+    /** Settings of the 3D view beyond the attributes: `motion`, `lens`, `floor`, `onChange` and the rest of `TurnSettings`. */
+    get turnSettings() {
+        return __classPrivateFieldGet(this, _KyogijoField_turnSettings, "f");
+    }
+    set turnSettings(value) {
+        __classPrivateFieldSet(this, _KyogijoField_turnSettings, value, "f");
+        __classPrivateFieldGet(this, _KyogijoField_turn, "f")?.destroy();
+        __classPrivateFieldSet(this, _KyogijoField_turn, undefined, "f");
+        __classPrivateFieldGet(this, _KyogijoField_instances, "m", _KyogijoField_draw).call(this);
+    }
+    /** The 3D view while the element has the `turn` attribute: its viewpoints, `set`, `reset`. */
+    get turn() {
+        return __classPrivateFieldGet(this, _KyogijoField_turn, "f");
+    }
     connectedCallback() {
         if (__classPrivateFieldGet(this, _KyogijoField_host, "f") === undefined) {
             const root = this.shadowRoot ?? this.attachShadow({ mode: "open" });
@@ -266,19 +314,27 @@ export class KyogijoField extends Base {
         __classPrivateFieldGet(this, _KyogijoField_theme, "f")?.disconnect();
         __classPrivateFieldGet(this, _KyogijoField_mount, "f")?.destroy();
         __classPrivateFieldSet(this, _KyogijoField_mount, undefined, "f");
+        __classPrivateFieldGet(this, _KyogijoField_turn, "f")?.destroy();
+        __classPrivateFieldSet(this, _KyogijoField_turn, undefined, "f");
         __classPrivateFieldSet(this, _KyogijoField_replay, undefined, "f");
         __classPrivateFieldSet(this, _KyogijoField_replayOf, undefined, "f");
     }
     attributeChangedCallback(name) {
         if (!this.isConnected)
             return;
+        if (name === "turn-view" && __classPrivateFieldGet(this, _KyogijoField_turn, "f") !== undefined) {
+            const view = this.getAttribute("turn-view");
+            if (view !== null && TURN_PRESET_NAMES.includes(view))
+                __classPrivateFieldGet(this, _KyogijoField_turn, "f").preset(view);
+            return;
+        }
         if (REPLAY_ATTRIBUTES.includes(name) && __classPrivateFieldGet(this, _KyogijoField_replay, "f") !== undefined)
             __classPrivateFieldGet(this, _KyogijoField_instances, "m", _KyogijoField_attach).call(this, name !== "speed" && name !== "loop");
         else
             __classPrivateFieldGet(this, _KyogijoField_instances, "m", _KyogijoField_draw).call(this);
     }
 }
-_KyogijoField_mount = new WeakMap(), _KyogijoField_host = new WeakMap(), _KyogijoField_options = new WeakMap(), _KyogijoField_theme = new WeakMap(), _KyogijoField_timeline = new WeakMap(), _KyogijoField_replaySettings = new WeakMap(), _KyogijoField_replay = new WeakMap(), _KyogijoField_replayOf = new WeakMap(), _KyogijoField_instances = new WeakSet(), _KyogijoField_attach = function _KyogijoField_attach(again) {
+_KyogijoField_mount = new WeakMap(), _KyogijoField_host = new WeakMap(), _KyogijoField_options = new WeakMap(), _KyogijoField_theme = new WeakMap(), _KyogijoField_timeline = new WeakMap(), _KyogijoField_replaySettings = new WeakMap(), _KyogijoField_replay = new WeakMap(), _KyogijoField_replayOf = new WeakMap(), _KyogijoField_turn = new WeakMap(), _KyogijoField_turnSettings = new WeakMap(), _KyogijoField_instances = new WeakSet(), _KyogijoField_attach = function _KyogijoField_attach(again) {
     if (__classPrivateFieldGet(this, _KyogijoField_mount, "f") === undefined || __classPrivateFieldGet(this, _KyogijoField_timeline, "f") === undefined)
         return;
     const settings = replaySettingsFromAttributes((name) => this.getAttribute(name), __classPrivateFieldGet(this, _KyogijoField_replaySettings, "f"));
@@ -300,6 +356,25 @@ _KyogijoField_mount = new WeakMap(), _KyogijoField_host = new WeakMap(), _Kyogij
     const page = document.documentElement.getAttribute("data-theme");
     if (options.theme === undefined && (page === "light" || page === "dark"))
         options.theme = page;
+    if (turnWanted((name) => this.getAttribute(name))) {
+        // The 3D view takes the container over from the flat drawing; a replay does not play on it.
+        if (__classPrivateFieldGet(this, _KyogijoField_mount, "f") !== undefined) {
+            __classPrivateFieldGet(this, _KyogijoField_mount, "f").destroy();
+            __classPrivateFieldSet(this, _KyogijoField_mount, undefined, "f");
+            __classPrivateFieldSet(this, _KyogijoField_replay, undefined, "f");
+            __classPrivateFieldSet(this, _KyogijoField_replayOf, undefined, "f");
+        }
+        const settings = turnSettingsFromAttributes((name) => this.getAttribute(name), __classPrivateFieldGet(this, _KyogijoField_turnSettings, "f"));
+        if (__classPrivateFieldGet(this, _KyogijoField_turn, "f") === undefined)
+            __classPrivateFieldSet(this, _KyogijoField_turn, mountKyogijoTurn(__classPrivateFieldGet(this, _KyogijoField_host, "f"), options, settings), "f");
+        else
+            __classPrivateFieldGet(this, _KyogijoField_turn, "f").update(options);
+        return;
+    }
+    if (__classPrivateFieldGet(this, _KyogijoField_turn, "f") !== undefined) {
+        __classPrivateFieldGet(this, _KyogijoField_turn, "f").destroy();
+        __classPrivateFieldSet(this, _KyogijoField_turn, undefined, "f");
+    }
     if (__classPrivateFieldGet(this, _KyogijoField_mount, "f") === undefined)
         __classPrivateFieldSet(this, _KyogijoField_mount, mountKyogijo(__classPrivateFieldGet(this, _KyogijoField_host, "f"), options), "f");
     else

package/dist/emblems-source.d.ts

@@ -0,0 +1,50 @@
+/** The styles an emblem is drawn in: full colour with metallic gradients, one outline in the page's ink, or flat fills. */
+export type EmblemStyleName = "metal" | "line" | "color";
+/** What kyogijo asks of a renderer. It is a subset of dougu-sports' `EmblemOptions`. */
+export interface EmblemDrawOptions {
+    style?: EmblemStyleName;
+    /** The colour of the emblem's main part: a crest takes the team's colour. */
+    tint?: string;
+    /** A second colour: a crest's band. */
+    accent?: string;
+    /** The letters of a crest, up to three. */
+    initials?: string;
+    /** `inherit`, `auto` (by the device's setting), `light` or `dark`. */
+    theme?: "inherit" | "auto" | "light" | "dark";
+    size?: number;
+}
+/**
+ * A function that draws an emblem from its id as a document of SVG, and throws for an id it does not know: `renderEmblem` of `@johnmorrisdotca/dougu-sports/emblems` is one.
+ * The id may end in `/metal`, `/line` or `/color`, and the renderer reads that suffix.
+ */
+export type EmblemRenderer = (id: string, options?: EmblemDrawOptions) => string;
+type Known<T> = 0 extends 1 & T ? string : T;
+/** @ts-ignore optional: resolves only where @johnmorrisdotca/dougu-sports is installed; elsewhere it is `any`, which `Known` turns into `string`. */
+type DouguId = import("@johnmorrisdotca/dougu-sports/emblems").EmblemId;
+/**
+ * The ids of dougu-sports' emblems (`"trophy:cup"`, `"crest:shield"`), when that package is installed, so that an editor completes them; any other string otherwise. An id may end in `/metal`, `/line` or `/color`,
+ * and a trophy or an award may be written without its group (`"cup"`). Nothing is imported at run time.
+ */
+export type EmblemId = Known<DouguId>;
+/** An emblem as a logo, a mark or a pageant's emblem is given: its id, with or without a style, or any string (an address, a data address or an SVG document). */
+export type EmblemRef = EmblemId | `${EmblemId}/${EmblemStyleName}` | (string & {});
+/**
+ * Plug a renderer of ready-made emblems into kyogijo, for every drawing on the page: after this `logo: "crest:shield"` and `emblem: "trophy:hockey-cup"` are drawn. Call it once, at start-up. Without one, an id is
+ * an address and is refused. `useEmblems(undefined)` unplugs it.
+ * @example
+ * ```ts
+ * import { useEmblems } from "@johnmorrisdotca/kyogijo-stadiums";
+ * import { renderEmblem } from "@johnmorrisdotca/dougu-sports/emblems";
+ * useEmblems(renderEmblem);
+ * ```
+ */
+export declare function useEmblems(render: EmblemRenderer | undefined): void;
+/** Run a drawing with a renderer for that drawing alone (the `emblems` option), putting back whatever was there. Without a renderer it runs as it is. */
+export declare function withEmblems<T>(render: EmblemRenderer | undefined, draw: () => T): T;
+/** The renderer in use: the drawing's own, else the page's, else none. */
+export declare function emblemRenderer(): EmblemRenderer | undefined;
+/** An id with its group, which no address has in practice: what a missing renderer is told about. */
+export declare const GROUPED_ID: RegExp;
+/** The SVG document for a value that names an emblem, drawn by the renderer in use, or `undefined` (no renderer, not the look of an id, or an id the renderer does not know). */
+export declare function renderedEmblem(value: unknown, options?: EmblemDrawOptions): string | undefined;
+export {};

package/dist/emblems-source.js

@@ -0,0 +1,56 @@
+// Where kyogijo gets ready-made emblems from: a renderer that the page plugs in, so that kyogijo bundles no art and keeps zero dependencies. The renderer is
+// `renderEmblem` of @johnmorrisdotca/dougu-sports (or any function with its shape); `useEmblems(renderEmblem)` plugs it in for the page, `emblems: renderEmblem` for one drawing.
+// This module knows nothing of any emblem: it only decides whether a string might be an emblem's id, asks the renderer, and keeps what the renderer gives back.
+let plugged;
+let scoped;
+/**
+ * Plug a renderer of ready-made emblems into kyogijo, for every drawing on the page: after this `logo: "crest:shield"` and `emblem: "trophy:hockey-cup"` are drawn. Call it once, at start-up. Without one, an id is
+ * an address and is refused. `useEmblems(undefined)` unplugs it.
+ * @example
+ * ```ts
+ * import { useEmblems } from "@johnmorrisdotca/kyogijo-stadiums";
+ * import { renderEmblem } from "@johnmorrisdotca/dougu-sports/emblems";
+ * useEmblems(renderEmblem);
+ * ```
+ */
+export function useEmblems(render) {
+    plugged = typeof render === "function" ? render : undefined;
+}
+/** Run a drawing with a renderer for that drawing alone (the `emblems` option), putting back whatever was there. Without a renderer it runs as it is. */
+export function withEmblems(render, draw) {
+    if (typeof render !== "function")
+        return draw();
+    const before = scoped;
+    scoped = render;
+    try {
+        return draw();
+    }
+    finally {
+        scoped = before;
+    }
+}
+/** The renderer in use: the drawing's own, else the page's, else none. */
+export function emblemRenderer() {
+    return scoped ?? plugged;
+}
+/** The look of an id: lower-case words, optionally `group:name`, optionally a style. An address, a path with a dot or a slash, a data address or an SVG document never has it. */
+const ID = /^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*)?(?:\/(?:metal|line|color))?$/;
+/** An id with its group, which no address has in practice: what a missing renderer is told about. */
+export const GROUPED_ID = /^(?:trophy|medal|award|crest|sport|ball|gear):[a-z0-9]+(?:-[a-z0-9]+)*(?:\/(?:metal|line|color))?$/;
+/** The SVG document for a value that names an emblem, drawn by the renderer in use, or `undefined` (no renderer, not the look of an id, or an id the renderer does not know). */
+export function renderedEmblem(value, options) {
+    const render = emblemRenderer();
+    if (render === undefined || typeof value !== "string")
+        return undefined;
+    const text = value.trim();
+    if (text.length > 60 || !ID.test(text))
+        return undefined;
+    let svg;
+    try {
+        svg = render(text, options);
+    }
+    catch {
+        return undefined;
+    }
+    return typeof svg === "string" && /^\s*(?:<\?xml|<svg)\b/i.test(svg) ? svg : undefined;
+}

package/dist/eras.d.ts

@@ -54,6 +54,8 @@ export interface NhlRules {
     } | null;
     /** The gap between the two hash marks beside an end-zone face-off circle (Rule 1.9). */
     hashApart: number;
+    /** The centre red line judges the offside pass: a pass from inside a team's own defensive zone across both its blue line and the centre line, to a team-mate who has not touched it, stops play. Data only: the lines are drawn the same. */
+    twoLinePass: boolean;
 }
 /** The NBA court's markings in a season. Lengths are feet. */
 export interface NbaRules {
@@ -138,7 +140,7 @@ export interface EraChange {
  * import { eraChanges } from "@johnmorrisdotca/kyogijo-stadiums/eras";
  * const nhl = eraChanges("nhl");
  * console.log(nhl.length, nhl[0].id, nhl[0].from);
- * // 10 nhl.centreLine.1943 1943
+ * // 12 nhl.centreLine.1943 1943
  * ```
  */
 export declare function eraChanges(sport: EraSport): EraChange[];

package/dist/eras.js

@@ -29,7 +29,7 @@ const wikipedia = (id, title, revision, note) => ({
 });
 /** Every page a change was read from, by id. Wikipedia is cited by revision, for facts only. */
 export const ERA_SOURCES = Object.freeze(Object.fromEntries([
-    wikipedia("wp-offside", "Offside (ice hockey)", 1366324643, "the two blue lines of 1928-29, the centre red line introduced in 1943-44"),
+    wikipedia("wp-offside", "Offside (ice hockey)", 1366324643, "the two blue lines of 1928-29, the centre red line introduced in 1943-44, the offside pass judged by it until the 2005 collective bargaining agreement"),
     wikipedia("wp-rink", "Ice hockey rink", 1369579112, "the NHL's blue lines at 75 feet and goal lines at 11 feet; the trapezoid from 2005-06, 18 feet at the goal line, 22 feet from 2014-15"),
     wikipedia("wp-nhl-rules", "National Hockey League rules", 1379666522, "the trapezoid since 2005-06, lengthened by 2 feet each side in 2014"),
     {
@@ -152,6 +152,11 @@ const NHL_SPANS = {
         { from: 2005, value: { atGoalLine: 18, atBoards: 28 }, what: "The goaltender's trapezoid is marked behind each net: 18 feet at the goal line, 28 feet at the end boards.", ja: "各ゴールの裏に、ゴーリーがパックを扱える区域として台形（トラペゾイド）が引かれます。ゴールライン側が18フィート、エンドボード側が28フィートです。", sources: ["wp-rink", "wp-nhl-rules"] },
         { from: 2014, value: { atGoalLine: NHL.trapezoid.atGoalLine, atBoards: NHL.trapezoid.atBoards }, what: "The trapezoid is widened to 22 feet at the goal line (2 feet each side).", ja: "トラペゾイドのゴールライン側が左右2フィートずつ広がり、22フィートになります。", sources: ["wp-rink", "wp-nhl-rules"] },
     ],
+    twoLinePass: [
+        { from: null, value: false, what: "No two-line pass rule: there is no centre line to judge it by.", ja: "ツーライン・パス（2本のラインをまたぐパス）の反則はありません。判定に使うセンターラインがまだないためです。", sources: ["wp-offside"] },
+        { from: 1943, value: true, what: "The centre red line judges the two-line pass: a pass across both a team's own blue line and the centre line, to a team-mate who has not touched it, is an offside pass.", ja: "センターレッドラインでツーライン・パスを判定します。自陣のブルーラインとセンターラインの両方をまたぐパスを、まだ触れていない味方が受けると、オフサイドパスの反則になります。", sources: ["wp-offside"] },
+        { from: 2005, value: false, what: "The centre line no longer judges the offside pass, under the 2005 collective bargaining agreement, so a pass across two lines is legal.", ja: "2005年の労使協定により、センターラインはオフサイドパスの判定に使われなくなり、ツーライン・パスは反則ではなくなります。", sources: ["wp-offside"] },
+    ],
     hashApart: [
         { from: 2012, value: 3, what: "The two hash marks beside each end-zone face-off circle are 3 feet apart (Rule 1.9 of 2012-13; no earlier season is cited).", ja: "エンドゾーンのフェイスオフサークルの両脇にある2本のハッシュマークは、間隔が3フィート（約91cm）です（2012-13シーズンのルール1.9。それ以前のシーズンを示す資料は見つかっていません）。", sources: ["nhl-rules-2012", "nhl-hash-2014", "cbs-hash-2014"] },
         { from: 2014, value: NHL.hashApart, what: "The hash marks move apart to 5 feet 7 inches, more in line with the marks on international ice.", ja: "2本のハッシュマークの間隔が5フィート7インチ（約1.7m）に広がり、国際大会のリンクにあるマークに近づきます。", sources: ["nhl-hash-2014", "cbs-hash-2014"] },
@@ -258,7 +263,7 @@ const SPANS = {
 function present(sport) {
     switch (sport) {
         case "nhl":
-            return { centreLine: true, goalLine: NHL.goalLine, blueLine: NHL.blueLine, trapezoid: { atGoalLine: NHL.trapezoid.atGoalLine, atBoards: NHL.trapezoid.atBoards }, hashApart: NHL.hashApart };
+            return { centreLine: true, goalLine: NHL.goalLine, blueLine: NHL.blueLine, trapezoid: { atGoalLine: NHL.trapezoid.atGoalLine, atBoards: NHL.trapezoid.atBoards }, hashApart: NHL.hashApart, twoLinePass: false };
         case "nba":
             return { keyWidth: NBA.lane, threePoint: { radius: NBA.threePoint.radius }, restrictedArea: true };
         case "nfl":
@@ -298,7 +303,7 @@ const featuresOf = (sport) => Object.entries(SPANS[sport]);
  * import { eraChanges } from "@johnmorrisdotca/kyogijo-stadiums/eras";
  * const nhl = eraChanges("nhl");
  * console.log(nhl.length, nhl[0].id, nhl[0].from);
- * // 10 nhl.centreLine.1943 1943
+ * // 12 nhl.centreLine.1943 1943
  * ```
  */
 export function eraChanges(sport) {