@latest-thinking/lt-player 3.0.0-beta.2 → 3.0.0-beta.21

package/README.md

@@ -1,7 +1,7 @@
 # LT Player
 
 `@latest-thinking/lt-player` is the Latest Thinking video player package. Version 3 is currently
-available as a beta and provides the stock Video.js React player foundation for browser
+available as a beta and provides the internal Video.js 10 media-engine foundation for browser
 applications.
 
 The package is ESM-only and bundles its runtime dependencies. Consumers need Node.js 20 or newer
@@ -19,38 +19,81 @@ Beta interfaces may change before the stable v3 release.
 
 ## Use the player
 
-Import both the package entry and its required stylesheet from your application:
+Import the factory and the required stylesheet, then create a player in an existing host:
 
-```js
+```ts
+import { createPlayer, type PlayerConfig } from '@latest-thinking/lt-player';
 import '@latest-thinking/lt-player/styles.css';
-import '@latest-thinking/lt-player';
-```
-
-Add an `lt-player` host element to the document. The optional `data-src` attribute supplies a
-browser-supported media URL:
 
-```html
-<lt-player data-src="https://example.com/video.mp4"></lt-player>
+const config: PlayerConfig = {
+  version: 3,
+  layout: 'landscape',
+  content: {
+    sources: [{ src: 'https://example.com/video.mp4', type: 'video/mp4' }],
+    chapters: [{ name: 'Opening', start: 0 }],
+  },
+  capabilities: {
+    speed: { options: [1, 1.5, 2] },
+  },
+  strings: {
+    coverButton: 'Watch now',
+  },
+};
+
+const host = document.querySelector<HTMLElement>('#player');
+if (host) {
+  const player = createPlayer(host, config);
+  player.on('play', ({ currentTime }) => console.log('Playing at', currentTime));
+}
 ```
 
-The package scans for `lt-player` elements when it loads and mounts one player in each host. Load
-the package after creating dynamically inserted hosts, because this foundation release does not
-observe later DOM changes. A host without `data-src` receives an empty player.
+Only `layout` and `content.sources` are required by the type contract. Optional values remain
+optional until configuration defaults are resolved by the player. String override keys are open
+so capabilities added by future releases can contribute their own catalog entries. At runtime,
+the current module catalog accepts declared keys such as `coverButton`; undeclared keys are omitted
+and included in the configuration application's single consolidated warning.
+
+`createPlayer` returns a stable handle for updates, state snapshots, playback and preference
+commands, share and context-panel actions, event subscriptions, and destruction. The package does
+not scan the consumer document when imported. The stylesheet gives the host, media-engine
+container, video element, and LT-owned headless controls their complete baseline presentation.
+Width remains an application layout decision; the selected landscape or portrait shell owns its
+aspect ratio. Core controls can be removed individually through configuration, including a
+supported fully chromeless surface that remains operable through the page API.
+
+## Use the feed
+
+The optional feed entry coordinates an ordered list of complete portrait configurations while
+reusing one player and media element:
+
+```ts
+import { createFeed } from '@latest-thinking/lt-player/feed';
+import type { PlayerConfig } from '@latest-thinking/lt-player';
+
+const configurations: PlayerConfig[] = [firstPortraitVideo, secondPortraitVideo];
+const host = document.querySelector<HTMLElement>('#shorts');
+if (host) {
+  const feed = createFeed(host, configurations);
+  feed.on('indexChange', ({ index }) => console.log('Current item', index));
+}
+```
 
-The stylesheet contains the stock player skin and gives the host block layout. Width and aspect
-ratio remain application layout decisions. The stock skin uses the `videojs-default` CSS cascade
-layer, so unlayered application reset rules can take precedence over it.
+The host owns the feed's available height. Each snap item fills that height, so applications can
+use the module inside a full viewport or another explicitly sized container.
 
 ## Package exports
 
-| Export                                    | Purpose                     |
-| ----------------------------------------- | --------------------------- |
-| `@latest-thinking/lt-player`              | Effectful ESM package entry |
-| `@latest-thinking/lt-player/styles.css`   | Bundled player stylesheet   |
-| `@latest-thinking/lt-player/package.json` | Published package metadata  |
-
-The baseline player supports formats the browser can play natively. Streaming media engines are
-not included in this foundation release.
+| Export                                    | Purpose                                       |
+| ----------------------------------------- | --------------------------------------------- |
+| `@latest-thinking/lt-player`              | `createPlayer` and public v3 TypeScript types |
+| `@latest-thinking/lt-player/feed`         | `createFeed` and public feed TypeScript types |
+| `@latest-thinking/lt-player/styles.css`   | Bundled player stylesheet                     |
+| `@latest-thinking/lt-player/package.json` | Published package metadata                    |
+
+HLS playback uses the package's `dist/hls.js` chunk. The player imports it dynamically only when an
+HLS source requires the hls.js adapter, and it is never fetched from a CDN. Consumer bundlers that
+support code splitting keep the adapter lazy; bundlers without code splitting include it in their
+own application bundle.
 
 ## License
 

package/THIRD-PARTY-NOTICES.md

@@ -2,25 +2,27 @@
 
 # Third-Party Notices
 
-`@latest-thinking/lt-player` bundles the following third-party packages. Their license
-terms apply to those packages independently of the proprietary LT Player license.
+`@latest-thinking/lt-player` bundles the following third-party packages and font assets.
+Their license terms apply independently of the proprietary LT Player license.
 
 ## Bundled package inventory
 
 | Package | Version | SPDX license |
 | --- | --- | --- |
-| `@videojs/core` | `10.0.0-beta.31` | `Apache-2.0` |
-| `@videojs/media` | `10.0.0-beta.31` | `Apache-2.0` |
-| `@videojs/react` | `10.0.0-beta.31` | `Apache-2.0` |
-| `@videojs/store` | `10.0.0-beta.31` | `Apache-2.0` |
-| `@videojs/utils` | `10.0.0-beta.31` | `Apache-2.0` |
+| `@videojs/core` | `10.0.0-beta.32` | `Apache-2.0` |
+| `@videojs/media` | `10.0.0-beta.32` | `Apache-2.0` |
+| `@videojs/react` | `10.0.0-beta.32` | `Apache-2.0` |
+| `@videojs/store` | `10.0.0-beta.32` | `Apache-2.0` |
+| `@videojs/utils` | `10.0.0-beta.32` | `Apache-2.0` |
+| `Nunito Sans` | `v19` | `OFL-1.1` |
+| `hls.js` | `1.7.1` | `Apache-2.0` |
 | `react-dom` | `19.2.8` | `MIT` |
 | `react` | `19.2.8` | `MIT` |
 | `scheduler` | `0.27.0` | `MIT` |
 
 ## Package license notices
 
-### @videojs/core 10.0.0-beta.31
+### @videojs/core 10.0.0-beta.32
 
 SPDX-License-Identifier: Apache-2.0
 
@@ -47,7 +49,7 @@ The project is maintained independently by the open-source community,
 governed by the Video.js Technical Steering Committee.
 ```
 
-### @videojs/media 10.0.0-beta.31
+### @videojs/media 10.0.0-beta.32
 
 SPDX-License-Identifier: Apache-2.0
 
@@ -74,7 +76,7 @@ The project is maintained independently by the open-source community,
 governed by the Video.js Technical Steering Committee.
 ```
 
-### @videojs/react 10.0.0-beta.31
+### @videojs/react 10.0.0-beta.32
 
 SPDX-License-Identifier: Apache-2.0
 
@@ -101,7 +103,7 @@ The project is maintained independently by the open-source community,
 governed by the Video.js Technical Steering Committee.
 ```
 
-### @videojs/store 10.0.0-beta.31
+### @videojs/store 10.0.0-beta.32
 
 SPDX-License-Identifier: Apache-2.0
 
@@ -128,7 +130,7 @@ The project is maintained independently by the open-source community,
 governed by the Video.js Technical Steering Committee.
 ```
 
-### @videojs/utils 10.0.0-beta.31
+### @videojs/utils 10.0.0-beta.32
 
 SPDX-License-Identifier: Apache-2.0
 
@@ -155,6 +157,139 @@ The project is maintained independently by the open-source community,
 governed by the Video.js Technical Steering Committee.
 ```
 
+### Nunito Sans v19
+
+SPDX-License-Identifier: OFL-1.1
+
+```text
+Copyright 2016 The Nunito Sans Project Authors (https://github.com/Fonthausen/NunitoSans) NunitoSans-Italic[YTLC,opsz,wdth,wght].ttf: Copyright 2016 The Nunito Sans Project Authors (https://github.com/Fonthausen/NunitoSans)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any Modified
+Version, except to acknowledge the contribution(s) of the Copyright
+Holder(s) and the Author(s) or with their explicit written permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created using
+the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS
+IN THE FONT SOFTWARE.
+```
+
+### hls.js 1.7.1
+
+SPDX-License-Identifier: Apache-2.0
+
+```text
+Copyright (c) 2017 Dailymotion (http://www.dailymotion.com)
+
+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.
+
+src/remux/mp4-generator.js and src/demux/exp-golomb.ts implementation in this project
+are derived from the HLS library for video.js (https://github.com/videojs/videojs-contrib-hls)
+
+That work is also covered by the Apache 2 License, following copyright:
+Copyright (c) 2013-2015 Brightcove
+
+
+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.
+```
+
 ### react-dom 19.2.8
 
 SPDX-License-Identifier: MIT

package/dist/feed.d.ts

@@ -0,0 +1,257 @@
+declare const CONTEXT_PANEL_VIEWS: readonly ["knowledge", "underlyingPublication", "relatedVideos"];
+
+declare type ContextPanelView = (typeof CONTEXT_PANEL_VIEWS)[number];
+
+export declare function createFeed(host: HTMLElement, configurations: readonly PlayerConfig[]): FeedHandle;
+
+export declare type FeedEventHandler<Event extends FeedEventName> = (payload: FeedEventMap[Event]) => void;
+
+export declare interface FeedEventMap extends PlayerEventMap {
+    indexChange: {
+        index: number;
+    };
+}
+
+export declare type FeedEventName = keyof FeedEventMap;
+
+export declare type FeedEventUnsubscribe = () => void;
+
+export declare interface FeedHandle {
+    previous(): void;
+    next(): void;
+    goTo(index: number): void;
+    getIndex(): number;
+    destroy(): void;
+    on<Event extends FeedEventName>(event: Event, handler: FeedEventHandler<Event>): FeedEventUnsubscribe;
+}
+
+declare interface PlayerCapabilities {
+    chapters?: boolean;
+    captions?: boolean;
+    speed?: boolean | PlayerSpeedOptions;
+    share?: boolean | PlayerShareOptions;
+    contextPanel?: boolean;
+}
+
+declare interface PlayerCaptionsState {
+    enabled: boolean;
+    language?: string;
+}
+
+declare interface PlayerChapter {
+    name: string;
+    start: number;
+}
+
+declare interface PlayerConfig {
+    version?: 3;
+    layout: PlayerLayout;
+    language?: PlayerLanguage;
+    content: PlayerContent;
+    controls?: PlayerControls;
+    capabilities?: PlayerCapabilities;
+    strings?: PlayerStrings;
+}
+
+declare interface PlayerContent {
+    title?: string;
+    author?: string;
+    description?: string;
+    poster?: string;
+    duration?: number;
+    sources: PlayerSource[];
+    tracks?: PlayerTrack[];
+    chapters?: PlayerChapter[];
+    metadata?: PlayerMetadata;
+}
+
+declare interface PlayerControls {
+    cover?: boolean | PlayerCoverOptions;
+    playPause?: PlayerControlSwitch;
+    timeline?: boolean | PlayerTimelineOptions;
+    time?: PlayerControlSwitch;
+    volume?: PlayerControlSwitch;
+    fullscreen?: PlayerControlSwitch;
+    pip?: PlayerControlSwitch;
+    buffering?: PlayerControlSwitch;
+    inputFeedback?: PlayerControlSwitch;
+    logo?: PlayerControlSwitch;
+    gestures?: PlayerControlSwitch;
+    hotkeys?: PlayerControlSwitch;
+}
+
+declare type PlayerControlSwitch = boolean | PlayerEmptyOptions;
+
+declare interface PlayerCoverButtonOptions {
+    label?: string;
+}
+
+declare interface PlayerCoverOptions {
+    image?: boolean;
+    title?: boolean;
+    author?: boolean;
+    button?: boolean | PlayerCoverButtonOptions;
+}
+
+declare type PlayerEmptyOptions = Record<string, never>;
+
+declare interface PlayerEventBase {
+    currentTime: number;
+}
+
+declare interface PlayerEventMap {
+    ready: PlayerEventBase & {
+        duration: number;
+    };
+    play: PlayerEventBase;
+    pause: PlayerEventBase;
+    ended: PlayerEventBase;
+    seeked: PlayerEventBase;
+    buffering: PlayerEventBase & {
+        buffering: boolean;
+    };
+    error: PlayerEventBase & {
+        kind: 'configuration' | 'startup' | 'mid-playback';
+    };
+    timeUpdate: PlayerEventBase;
+    chapterChange: PlayerEventBase & {
+        chapter: PlayerChapter | null;
+    };
+    volumeChange: PlayerEventBase & {
+        volume: number;
+        muted: boolean;
+    };
+    rateChange: PlayerEventBase & {
+        rate: number;
+    };
+    captionsChange: PlayerEventBase & {
+        captions: PlayerCaptionsState;
+    };
+    pipChange: PlayerEventBase & {
+        pip: boolean;
+    };
+    shareOpen: PlayerEventBase & {
+        source: 'player' | 'page';
+    };
+    panelOpen: PlayerEventBase & {
+        view: PlayerPanelView;
+    };
+    panelClose: PlayerEventBase;
+    videoChange: PlayerEventBase;
+}
+
+declare interface PlayerInANutshellMetadata {
+    generatedByAi?: boolean;
+    keyTakeaway?: string;
+    summary?: string;
+}
+
+declare interface PlayerKeyConcept {
+    label: string;
+    description: string;
+    start?: number;
+}
+
+declare interface PlayerKeyConceptsMetadata {
+    generatedByAi?: boolean;
+    items?: PlayerKeyConcept[];
+}
+
+declare type PlayerLanguage = string | string[];
+
+declare type PlayerLayout = 'landscape' | 'portrait';
+
+declare interface PlayerMetadata {
+    inANutshell?: PlayerInANutshellMetadata;
+    keyConcepts?: PlayerKeyConceptsMetadata;
+    researchField?: PlayerResearchFieldMetadata;
+    transcript?: PlayerTranscriptMetadata;
+    underlyingPublication?: PlayerUnderlyingPublicationMetadata;
+    relatedVideos?: PlayerRelatedVideosMetadata;
+}
+
+declare type PlayerPanelView = ContextPanelView;
+
+declare interface PlayerPublication {
+    title: string;
+    authors: string[];
+    journal: string;
+    abstract: string;
+    url: string;
+}
+
+declare interface PlayerRelatedVideo {
+    title: string;
+    poster: string;
+    url: string;
+}
+
+declare interface PlayerRelatedVideosMetadata {
+    generatedByAi?: boolean;
+    related?: PlayerRelatedVideo[];
+    forYou?: PlayerRelatedVideo[];
+}
+
+declare interface PlayerResearchFieldMetadata {
+    generatedByAi?: boolean;
+    sections?: PlayerResearchFieldSection[];
+}
+
+declare interface PlayerResearchFieldSection {
+    title: string;
+    description: string;
+}
+
+declare interface PlayerShareOptions {
+    canonicalUrl?: string;
+    embedUrl?: string;
+    playerTrigger?: boolean;
+    targets?: PlayerShareTarget[];
+    templates?: PlayerShareTemplates;
+}
+
+declare type PlayerShareTarget = 'link' | 'embed' | 'facebook' | 'x' | 'linkedin' | 'whatsapp' | 'more';
+
+declare interface PlayerShareTemplates {
+    message?: string;
+}
+
+declare interface PlayerSource {
+    src: string;
+    type?: string;
+}
+
+declare interface PlayerSpeedOptions {
+    options?: number[];
+}
+
+declare type PlayerStrings = Record<string, string>;
+
+declare interface PlayerTimelineOptions {
+    seekStep?: number;
+}
+
+declare interface PlayerTrack {
+    src: string;
+    kind?: string;
+    label?: string;
+    srclang?: string;
+    default?: boolean;
+}
+
+declare interface PlayerTranscriptEntry {
+    start: number;
+    text: string;
+}
+
+declare interface PlayerTranscriptMetadata {
+    generatedByAi?: boolean;
+    entries?: PlayerTranscriptEntry[];
+}
+
+declare interface PlayerUnderlyingPublicationMetadata {
+    generatedByAi?: boolean;
+    items?: PlayerPublication[];
+}
+
+export { }