shaka-ts 5.2.4

package/NOTICE

@@ -0,0 +1,16 @@
+shaka-ts
+Copyright 2026 Julian Tellez
+
+This product transpiles and redistributes a derivative work of:
+
+  Shaka Player
+  Copyright 2016 Google LLC
+  https://github.com/shaka-project/shaka-player
+  Licensed under the Apache License, Version 2.0
+
+Shaka Player is a trademark of Google LLC. This project is not affiliated with,
+endorsed by, or supported by Google LLC.
+
+Source files derived from Shaka Player retain their original copyright headers
+and SPDX-License-Identifier declarations. A copy of the Apache License, Version
+2.0 is included in the LICENSE file at the root of this repository.

package/README.md

@@ -0,0 +1,141 @@
+# shaka-ts
+
+Transpile [Shaka Player](https://github.com/shaka-project/shaka-player) from Closure annotated
+JavaScript into real TypeScript, with no Google Closure Compiler and no generated blob.
+
+> **Unofficial.** This project is not affiliated with, endorsed by, or supported by Google.
+> Shaka Player is a trademark of Google LLC. Please report Shaka Player bugs
+> [upstream](https://github.com/shaka-project/shaka-player/issues), not here.
+
+## Why
+
+Shaka Player is excellent, but consuming it means accepting the Closure toolchain: a Java
+compiler driven by Python build scripts, type information locked inside JSDoc comments, and a
+published artifact that is an opaque minified bundle. TypeScript consumers get definitions
+generated by a separate tool rather than types that came from the source.
+
+This repository is not a fork. It is a **pipeline**: it fetches a pinned upstream release,
+transpiles it, and proves the result still works by running Shaka's own test suite against it.
+When a new Shaka version ships, you retarget it with one command instead of hand merging a
+diverged fork.
+
+## How it works
+
+```
+pinned upstream release  (fetched, never committed here)
+          |
+          v
+  module transform        goog.provide / goog.require  ->  ES modules
+          |
+          v
+  runtime shims           goog.asserts, goog.DEBUG, goog.Uri
+          |
+          v
+  type translation        Closure JSDoc  ->  TypeScript syntax
+          |
+          v
+  patch overlay           the residue that is not worth automating
+          |
+          v
+  esbuild + tsc           bundle and .d.ts, no Closure Compiler
+          |
+          v
+  Shaka's own test suite  <- the correctness oracle
+```
+
+Upstream Shaka source is never committed to this repository. It is fetched at build time and
+verified against a recorded checksum.
+
+## Testing
+
+There are two tiers.
+
+The **oracle** runs Shaka's own unmodified util unit specs in a DOM-like environment without a real
+browser, so it fits in the normal test pass and gates every build. If the transform changed
+behaviour in that layer, the oracle goes red.
+
+The **suite** loads the whole transpiled library as a global in real headless Chrome through Karma
+and asserts its public surface resolves on `window.shaka`, one spec per symbol, plus that the
+polyfills install without throwing. This is the real browser check the oracle cannot be: it runs the
+library's top level module initialisation the way a consumer's browser does. That is how it earns
+its keep. It found a transpiler bug on the first run: a polyfill's static self reference bound to a
+shadowing parameter, so the library threw during initialisation before `window.shaka` was ever set.
+The check would have failed on it, and now guards against the whole class.
+
+Running Shaka's own behavioural specs against the library is the next tier. Those specs are written
+for Shaka's test harness (the `shaka.test.*` helpers, custom matchers and asset servers) and are
+coupled to each other and to a real playback pipeline, so standing them up is a port in its own
+right, tracked separately. This surface check is the first tier of that work: it proves the library
+loads and initialises in the real runtime.
+
+Run it with `npm run build` then `npm run test:suite`.
+
+## Why it is tractable
+
+The obvious objection is that rewriting 125,000 lines of someone else's player is madness.
+Measured against Shaka 4.16.5, it is more mechanical than it looks:
+
+- **The Closure Library surface is tiny.** Across `lib` and `ui` the entire `goog.*` usage is
+  `goog.require`, `goog.provide`, `goog.asserts.assert`, `goog.requireType`, `goog.Uri`,
+  `goog.DEBUG` and a single `goog.exportSymbol`. There is no `goog.array`, `goog.string`,
+  `goog.object`, `goog.events` or inheritance helper anywhere.
+- **The dependency graph is acyclic.** 291 files, 1552 hard require edges, and zero cycles.
+  Upstream already uses `goog.requireType` to break the 69 type only edges. Cycles are what
+  normally make a Closure to ES modules conversion painful, and they are simply not present.
+- **The source is already modern.** 344 symbols are plain ES2015 `class` declarations. There is
+  no `goog.inherits` and no prototype surgery.
+- **Half the type translation already exists.** Upstream's own `build/generateTsDefs.py` runs
+  `@teppeis/clutz` over its externs to produce TypeScript definitions, which gives both prior art
+  and a reference to diff our output against.
+- **The tests come free.** 192 spec files and 99,543 lines of Jasmine tests that we do not modify
+  and that tell us whether the transform preserved behaviour.
+
+The known risk is bundle size. Closure's property renaming and dead code elimination produce a
+786 KB player build from roughly 3.8 MB of source, and esbuild will not match that. Measuring the
+regression is an early milestone rather than a late surprise.
+
+## Versions
+
+Rather than one pinned release, the toolchain transpiles several Shaka versions and publishes each
+to npm under the same version as upstream. So `shaka-ts@4.16.43` is Shaka 4.16.43 transpiled, and a
+consumer picks the version that matches the Shaka they were on. The published set lives in
+[`src/versions.json`](src/versions.json); today it is the recent 4.x line:
+
+- 4.15.55
+- 4.16.5
+- 4.16.43
+
+Each entry records the checksum of the exact upstream source it builds from and its own strict
+`checkJs` ratchet ceiling, both measured from that release. Every entry builds and passes the
+oracle. The 5.x line is not published yet: its device detection modules do not transpile cleanly,
+so it needs transpiler work before it can be trusted.
+
+Adding a version is one entry in that file plus its recorded checksum and baseline. The
+`Publish versions` workflow builds and verifies every target and publishes any that are not already
+on npm.
+
+## Keeping current
+
+A weekly workflow checks whether upstream Shaka has released a version newer than the pin. It always
+opens a tracking issue. When an npm token is configured it also retargets the pipeline at the new
+version, builds it, and publishes `shaka-ts@<version>` on its own, then opens a pull request that
+records the new checksum and baseline so the repository tracks what is on npm. Two guardrails stop a
+bad release from shipping: the oracle must still pass, and the `checkJs` count must stay under a
+ceiling, so a version that does not transpile cleanly fails loudly instead of publishing. With no
+token the publish step stays dormant and only the tracking issue is opened.
+
+## Status
+
+The pipeline is built and the roadmap through the multi-version publishing milestone is done.
+Publishing is wired but not switched on: nothing is on npm until an automation token is added to the
+repository, so treat the package as not yet installable. Progress is tracked in the open:
+
+- [Project board](https://github.com/users/juliantellez/projects/1)
+- [Milestones](https://github.com/juliantellez/shaka-ts/milestones)
+
+## Licence
+
+This project is licensed under the [Apache License 2.0](LICENSE), matching Shaka Player.
+
+Output produced by this pipeline is a derivative work of Shaka Player, also Apache 2.0. Upstream
+copyright headers are preserved through the transform. See [NOTICE](NOTICE) for attribution.

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "shaka-ts",
+  "version": "5.2.4",
+  "description": "Shaka Player transpiled from Closure JavaScript to TypeScript. Unofficial, not affiliated with Google.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "shaka-player.min.js",
+  "types": "shaka-player.d.ts",
+  "files": [
+    "shaka-player.min.js",
+    "shaka-player.d.ts",
+    "NOTICE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/juliantellez/shaka-ts.git"
+  },
+  "keywords": [
+    "shaka",
+    "dash",
+    "hls",
+    "video",
+    "player",
+    "typescript"
+  ]
+}

package/shaka-player.d.ts

@@ -0,0 +1,82 @@
+export { Deprecate } from './lib/deprecate/deprecate.ts';
+export { Player } from './lib/player.ts';
+export { SimpleAbrManager } from './lib/abr/simple_abr_manager.ts';
+export { AdManager } from './lib/ads/ad_manager.ts';
+export { CastProxy } from './lib/cast/cast_proxy.ts';
+export { CastReceiver } from './lib/cast/cast_receiver.ts';
+export { DashJsonParser } from './lib/dash/dash_json_parser.ts';
+export { DashParser } from './lib/dash/dash_parser.ts';
+export { AllDevices } from './lib/device/all.ts';
+export { FairPlay } from './lib/drm/fairplay.ts';
+export { HlsParser } from './lib/hls/hls_parser.ts';
+export { log } from './lib/debug/log.ts';
+export { InitSegmentReference } from './lib/media/segment_reference.ts';
+export { ManifestParser } from './lib/media/manifest_parser.ts';
+export { PreferenceBasedCriteria } from './lib/media/preference_based_criteria.ts';
+export { PresentationTimeline } from './lib/media/presentation_timeline.ts';
+export { SegmentIndex } from './lib/media/segment_index.ts';
+export { SegmentReference } from './lib/media/segment_reference.ts';
+export { Id3Utils } from './lib/metadata/id3_utils.ts';
+export { Id3V1Utils } from './lib/metadata/id3v1_utils.ts';
+export { IlstUtils } from './lib/metadata/ilst_utils.ts';
+export { Metadata } from './lib/metadata/metadata.ts';
+export { VorbisUtils } from './lib/metadata/vorbis_utils.ts';
+export { MSFParser } from './lib/msf/msf_parser.ts';
+export { DataUriPlugin } from './lib/net/data_uri_plugin.ts';
+export { HttpFetchPlugin } from './lib/net/http_fetch_plugin.ts';
+export { HttpXHRPlugin } from './lib/net/http_xhr_plugin.ts';
+export { QueueManager } from './lib/queue/queue_manager.ts';
+export { OfflineManifestParser } from './lib/offline/offline_manifest_parser.ts';
+export { OfflineScheme } from './lib/offline/offline_scheme.ts';
+export { Storage } from './lib/offline/storage.ts';
+export { StorageMechanism } from './lib/offline/indexeddb/storage_mechanism.ts';
+export { Aria } from './lib/polyfill/aria.ts';
+export { EmeEncryptionScheme } from './lib/polyfill/eme_encryption_scheme.ts';
+export { Fullscreen } from './lib/polyfill/fullscreen.ts';
+export { PolyfillMap } from './lib/polyfill/map.ts';
+export { MCapEncryptionScheme } from './lib/polyfill/mcap_encryption_scheme.ts';
+export { MediaSource } from './lib/polyfill/mediasource.ts';
+export { MediaCapabilities } from './lib/polyfill/media_capabilities.ts';
+export { Orientation } from './lib/polyfill/orientation.ts';
+export { PatchedMediaKeysApple } from './lib/polyfill/patchedmediakeys_apple.ts';
+export { PatchedMediaKeysWebkit } from './lib/polyfill/patchedmediakeys_webkit.ts';
+export { PiPWebkit } from './lib/polyfill/pip_webkit.ts';
+export { RandomUUID } from './lib/polyfill/random_uuid.ts';
+export { PolyfillSymbol } from './lib/polyfill/symbol.ts';
+export { TypedArray } from './lib/polyfill/typed_array.ts';
+export { URLSearchParams } from './lib/polyfill/url_search_params.ts';
+export { VTTCue } from './lib/polyfill/vttcue.ts';
+export { VideoFrameCallback } from './lib/polyfill/videoframecallback.ts';
+export { VideoPlayPromise } from './lib/polyfill/video_play_promise.ts';
+export { VideoPlaybackQuality } from './lib/polyfill/videoplaybackquality.ts';
+export { polyfill } from './lib/polyfill/all.ts';
+export { Cue } from './lib/text/cue.ts';
+export { Mp4TtmlParser } from './lib/text/mp4_ttml_parser.ts';
+export { Mp4VttParser } from './lib/text/mp4_vtt_parser.ts';
+export { TextEngine } from './lib/text/text_engine.ts';
+export { SpeechToText } from './lib/text/speech_to_text.ts';
+export { SrtTextParser } from './lib/text/srt_text_parser.ts';
+export { TtmlTextParser } from './lib/text/ttml_text_parser.ts';
+export { VttTextParser } from './lib/text/vtt_text_parser.ts';
+export { WebVttGenerator } from './lib/text/web_vtt_generator.ts';
+export { CeaDecoder } from './lib/cea/cea_decoder.ts';
+export { Mp4CeaParser } from './lib/cea/mp4_cea_parser.ts';
+export { TsCeaParser } from './lib/cea/ts_cea_parser.ts';
+export { AacTransmuxer } from './lib/transmuxer/aac_transmuxer.ts';
+export { Ac3 } from './lib/transmuxer/ac3.ts';
+export { Ac3Transmuxer } from './lib/transmuxer/ac3_transmuxer.ts';
+export { ADTS } from './lib/transmuxer/adts.ts';
+export { Ec3 } from './lib/transmuxer/ec3.ts';
+export { Ec3Transmuxer } from './lib/transmuxer/ec3_transmuxer.ts';
+export { H264 } from './lib/transmuxer/h264.ts';
+export { H265 } from './lib/transmuxer/h265.ts';
+export { LocTransmuxer } from './lib/transmuxer/loc_transmuxer.ts';
+export { Mp3Transmuxer } from './lib/transmuxer/mp3_transmuxer.ts';
+export { MpegAudio } from './lib/transmuxer/mpeg_audio.ts';
+export { MpegTsTransmuxer } from './lib/transmuxer/mpeg_ts_transmuxer.ts';
+export { Opus } from './lib/transmuxer/opus.ts';
+export { TransmuxerEngine } from './lib/transmuxer/transmuxer_engine.ts';
+export { TsTransmuxer } from './lib/transmuxer/ts_transmuxer.ts';
+export { Dom } from './lib/util/dom_utils.ts';
+export { UtilError } from './lib/util/error.ts';
+export { Iterables } from './lib/util/iterables.ts';