@lucaismyname/ginger 0.0.37 → 0.0.40

package/dist/experimental-gapless/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/experimental-gapless/index.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useGingerPlayback } from \"../context/GingerSplitContexts\";\n\nexport type ExperimentalGaplessState = {\n  supported: false;\n  reason: string;\n  preloadedTrackIds: string[];\n};\n\n/**\n * Experimental-only helper surface.\n *\n * @deprecated This export is intentionally non-production and currently reports capabilities only.\n * It does not alter Ginger playback behavior.\n */\nexport function useExperimentalGapless(): ExperimentalGaplessState {\n  const { tracks } = useGingerPlayback();\n  return useMemo(\n    () => ({\n      supported: false as const,\n      reason: \"Gapless playback requires dedicated Web Audio graph orchestration.\",\n      preloadedTrackIds: tracks.map((track) => track.id ?? track.fileUrl),\n    }),\n    [tracks],\n  );\n}\n"],"names":["useExperimentalGapless","tracks","useGingerPlayback","useMemo","track"],"mappings":";;AAeO,SAASA,IAAmD;AACjE,QAAM,EAAE,QAAAC,EAAA,IAAWC,EAAA;AACnB,SAAOC;AAAA,IACL,OAAO;AAAA,MACL,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,mBAAmBF,EAAO,IAAI,CAACG,MAAUA,EAAM,MAAMA,EAAM,OAAO;AAAA,IAAA;AAAA,IAEpE,CAACH,CAAM;AAAA,EAAA;AAEX;"}
+{"version":3,"file":"index.js","sources":["../../src/experimental-gapless/probeGaplessCapability.ts","../../src/experimental-gapless/index.ts"],"sourcesContent":["/**\n * Milestone 1 gapless probe: detects whether the **browser** exposes the minimum APIs\n * for a future Web Audio decode + schedule path. Ginger does not implement gapless\n * playback yet; this never touches the live `HTMLAudioElement` or playback.\n */\n\nexport type GaplessHints = {\n  /**\n   * Use on `HTMLMediaElement` (and matching `fetch`) when audio is cross-origin so\n   * decoded samples can be routed without tainting (required for Web Audio).\n   */\n  crossOrigin: \"anonymous\" | \"use-credentials\" | null;\n  /**\n   * Short guidance on containers/codecs and fetch constraints for a decode path.\n   */\n  format: string;\n};\n\nexport type GaplessCapabilityResult = {\n  /**\n   * True when `AudioContext` (or legacy equivalent) and `decodeAudioData` appear\n   * available in a secure context — i.e. the environment could support a decode-based\n   * gapless implementation. Does **not** mean Ginger ships gapless playback.\n   */\n  supported: boolean;\n  /** Human-readable explanation, including caveats and fallback behavior. */\n  reason: string;\n  hints: GaplessHints;\n};\n\nconst DEFAULT_HINTS: GaplessHints = {\n  crossOrigin: \"anonymous\",\n  format:\n    \"Full-file fetch + decode is the portable path; Media Source Extensions help only when you control containerized segments. Prefer HTTP(S) or blob: URLs; cross-origin media needs CORS and matching crossOrigin on <audio>. Codec support (MP3, AAC/MP4, Opus, …) is browser-specific.\",\n};\n\nfunction hasDecodeAudioDataOnPrototype(ctor: typeof AudioContext | undefined): boolean {\n  return Boolean(ctor && typeof ctor.prototype.decodeAudioData === \"function\");\n}\n\n/**\n * Inspect globals only (no `AudioContext` construction) so it is safe to call during SSR\n * or in tests without user gesture.\n */\nexport function probeGaplessCapability(): GaplessCapabilityResult {\n  if (typeof globalThis === \"undefined\") {\n    return {\n      supported: false,\n      reason: \"No global object (probe unsupported in this runtime).\",\n      hints: DEFAULT_HINTS,\n    };\n  }\n\n  const g = globalThis as unknown as {\n    window?: Window;\n    isSecureContext?: boolean;\n    AudioContext?: typeof AudioContext;\n    webkitAudioContext?: typeof AudioContext;\n    MediaSource?: typeof MediaSource;\n  };\n\n  if (typeof g.window === \"undefined\") {\n    return {\n      supported: false,\n      reason:\n        \"No window (SSR or non-browser). Run the probe in the browser if you need live results.\",\n      hints: DEFAULT_HINTS,\n    };\n  }\n\n  const secure =\n    typeof g.isSecureContext === \"boolean\" ? g.isSecureContext : g.window.isSecureContext !== false;\n  if (!secure) {\n    return {\n      supported: false,\n      reason:\n        \"A secure context (HTTPS or localhost) is required for Web Audio in most browsers. Gapless decode path would not be available here.\",\n      hints: DEFAULT_HINTS,\n    };\n  }\n\n  const Ctor = g.AudioContext ?? g.webkitAudioContext;\n  if (!Ctor || !hasDecodeAudioDataOnPrototype(Ctor)) {\n    return {\n      supported: false,\n      reason:\n        \"Web Audio API is unavailable or decodeAudioData is missing. A gapless decode path cannot run in this environment.\",\n      hints: DEFAULT_HINTS,\n    };\n  }\n\n  const mse = typeof g.MediaSource !== \"undefined\";\n  const mseNote = mse\n    ? \"MediaSource is available for segment-based strategies; Ginger still uses a single <audio> for playback today.\"\n    : \"MediaSource is not exposed; only full-buffer decode (or progressive chunking in user code) applies.\";\n\n  return {\n    supported: true,\n    reason: `Browser exposes Web Audio decode primitives (${mseNote}). Ginger does not yet schedule gapless transitions — keep using Ginger.Player and existing queue actions.`,\n    hints: DEFAULT_HINTS,\n  };\n}\n","import { useMemo } from \"react\";\nimport { useGingerPlayback } from \"../context/GingerSplitContexts\";\nimport { type GaplessCapabilityResult, probeGaplessCapability } from \"./probeGaplessCapability\";\n\nexport type { GaplessCapabilityResult, GaplessHints } from \"./probeGaplessCapability\";\nexport { probeGaplessCapability } from \"./probeGaplessCapability\";\n\nexport type ExperimentalGaplessState = GaplessCapabilityResult & {\n  /**\n   * Ginger does not yet implement gapless scheduling; playback always uses\n   * the usual `Ginger.Player` + `<audio>` pipeline.\n   */\n  gingerGaplessPlayback: false;\n  /** Track identifiers for prefetch / experimentation (id, else file URL). */\n  preloadedTrackIds: string[];\n};\n\n/**\n * Reports **environment** capability for a future gapless decode path plus queue ids.\n * Does not change Ginger playback behavior.\n */\nexport function useExperimentalGapless(): ExperimentalGaplessState {\n  const { tracks } = useGingerPlayback();\n  return useMemo(() => {\n    const probe = probeGaplessCapability();\n    return {\n      ...probe,\n      gingerGaplessPlayback: false as const,\n      preloadedTrackIds: tracks.map((track) => track.id ?? track.fileUrl),\n    };\n  }, [tracks]);\n}\n"],"names":["DEFAULT_HINTS","hasDecodeAudioDataOnPrototype","ctor","probeGaplessCapability","g","Ctor","useExperimentalGapless","tracks","useGingerPlayback","useMemo","track"],"mappings":";;AA8BA,MAAMA,IAA8B;AAAA,EAClC,aAAa;AAAA,EACb,QACE;AACJ;AAEA,SAASC,EAA8BC,GAAgD;AACrF,SAAO,GAAQA,KAAQ,OAAOA,EAAK,UAAU,mBAAoB;AACnE;AAMO,SAASC,IAAkD;AAChE,MAAI,OAAO,aAAe;AACxB,WAAO;AAAA,MACL,WAAW;AAAA,MACX,QAAQ;AAAA,MACR,OAAOH;AAAA,IAAA;AAIX,QAAMI,IAAI;AAQV,MAAI,OAAOA,EAAE,SAAW;AACtB,WAAO;AAAA,MACL,WAAW;AAAA,MACX,QACE;AAAA,MACF,OAAOJ;AAAA,IAAA;AAMX,MAAI,EADF,OAAOI,EAAE,mBAAoB,YAAYA,EAAE,kBAAkBA,EAAE,OAAO,oBAAoB;AAE1F,WAAO;AAAA,MACL,WAAW;AAAA,MACX,QACE;AAAA,MACF,OAAOJ;AAAA,IAAA;AAIX,QAAMK,IAAOD,EAAE,gBAAgBA,EAAE;AACjC,SAAI,CAACC,KAAQ,CAACJ,EAA8BI,CAAI,IACvC;AAAA,IACL,WAAW;AAAA,IACX,QACE;AAAA,IACF,OAAOL;AAAA,EAAA,IASJ;AAAA,IACL,WAAW;AAAA,IACX,QAAQ,gDAPE,OAAOI,EAAE,cAAgB,MAEjC,kHACA,qGAI6D;AAAA,IAC/D,OAAOJ;AAAA,EAAA;AAEX;AChFO,SAASM,IAAmD;AACjE,QAAM,EAAE,QAAAC,EAAA,IAAWC,EAAA;AACnB,SAAOC,EAAQ,OAEN;AAAA,IACL,GAFYN,EAAA;AAAA,IAGZ,uBAAuB;AAAA,IACvB,mBAAmBI,EAAO,IAAI,CAACG,MAAUA,EAAM,MAAMA,EAAM,OAAO;AAAA,EAAA,IAEnE,CAACH,CAAM,CAAC;AACb;"}

package/dist/experimental-gapless/probeGaplessCapability.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Milestone 1 gapless probe: detects whether the **browser** exposes the minimum APIs
+ * for a future Web Audio decode + schedule path. Ginger does not implement gapless
+ * playback yet; this never touches the live `HTMLAudioElement` or playback.
+ */
+export type GaplessHints = {
+    /**
+     * Use on `HTMLMediaElement` (and matching `fetch`) when audio is cross-origin so
+     * decoded samples can be routed without tainting (required for Web Audio).
+     */
+    crossOrigin: "anonymous" | "use-credentials" | null;
+    /**
+     * Short guidance on containers/codecs and fetch constraints for a decode path.
+     */
+    format: string;
+};
+export type GaplessCapabilityResult = {
+    /**
+     * True when `AudioContext` (or legacy equivalent) and `decodeAudioData` appear
+     * available in a secure context — i.e. the environment could support a decode-based
+     * gapless implementation. Does **not** mean Ginger ships gapless playback.
+     */
+    supported: boolean;
+    /** Human-readable explanation, including caveats and fallback behavior. */
+    reason: string;
+    hints: GaplessHints;
+};
+/**
+ * Inspect globals only (no `AudioContext` construction) so it is safe to call during SSR
+ * or in tests without user gesture.
+ */
+export declare function probeGaplessCapability(): GaplessCapabilityResult;
+//# sourceMappingURL=probeGaplessCapability.d.ts.map

package/dist/experimental-gapless/probeGaplessCapability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probeGaplessCapability.d.ts","sourceRoot":"","sources":["../../src/experimental-gapless/probeGaplessCapability.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,WAAW,EAAE,WAAW,GAAG,iBAAiB,GAAG,IAAI,CAAC;IACpD;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAYF;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,uBAAuB,CAyDhE"}

package/dist/experimental-gapless/probeGaplessCapability.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=probeGaplessCapability.test.d.ts.map

package/dist/experimental-gapless/probeGaplessCapability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probeGaplessCapability.test.d.ts","sourceRoot":"","sources":["../../src/experimental-gapless/probeGaplessCapability.test.ts"],"names":[],"mappings":""}