playlist-data-engine 1.7.3 → 1.8.0

package/dist/playlist-data-engine.mjs

@@ -2,8 +2,8 @@ import { d as an, h as sn, l as Fi, n as nn, o as rn, p as on, q as ln, s as cn,
 import { A as Hp, C as zp, E as qp, F as Up, k as jp, B as Gp, j as Vp, H as Zp, I as Yp, J as Xp, D as Kp, K as Jp, L as Qp, M as em, N as tm, O as am, Q as im, T as sm, U as nm, V as rm, e as om, W as lm, X as cm, Y as um, Z as dm, _ as hm, $ as pm, G as mm, a0 as gm, a1 as fm, a2 as ym, a3 as vm, a4 as bm, a5 as wm, a6 as Sm, a7 as _m, a8 as km, a9 as Am, aa as Tm, ab as Cm, ac as Im, ad as Mm, ae as Em, P as Dm, af as Rm, R as xm, ag as Pm, ah as $m, ai as Nm, S as Om, aj as Bm, ak as Lm, al as Fm, am as Wm, an as Hm, a as zm, ao as qm, ap as Um, aq as jm, ar as Gm, as as Vm, at as Zm, au as Ym, av as Xm, aw as Km, ax as Jm, ay as Qm, az as eg, aA as tg, aB as ag, aC as ig, aD as sg, aE as ng, aF as rg, aG as og, aH as lg, aI as cg, aJ as ug, aK as dg, aL as hg, aM as pg, aN as mg, aO as gg, aP as fg, aQ as yg, aR as vg, aS as bg, aT as wg, i as Sg, aU as _g, f as kg, aV as Ag, aW as Tg, aX as Cg, b as Ig, aY as Mg, m as Eg, aZ as Dg, a_ as Rg, a$ as xg, b0 as Pg, r as $g, v as Ng, b1 as Og, b2 as Bg, b3 as Lg, b4 as Fg, b5 as Wg, b6 as Hg } from "./unifyBeatMap-k6vw_JPQ.js";
 import { a as wt, L as ye } from "./arweaveGatewayManager-DDSO5sLJ.js";
 import { A as qg, D as Ug, K as jg, b as Gg, c as Vg, d as Zg, g as Yg, i as Xg, p as Kg } from "./arweaveGatewayManager-DDSO5sLJ.js";
-import { M as ge, g as gn, r as fn } from "./gateway-C_p9Ku3O.js";
-import { D as Qg, K as ef, e as tf, a as af, f as sf, b as nf, c as rf, d as of, h as lf, i as cf, j as uf, k as df, l as hf, m as pf, n as mf, o as gf, p as ff, q as yf, s as vf, t as bf, u as wf, v as Sf, w as _f, x as kf, y as Af, z as Tf } from "./gateway-C_p9Ku3O.js";
+import { M as ge, g as gn, r as fn } from "./gateway-CDMPqFEH.js";
+import { D as Qg, E as ef, a as tf, K as af, e as sf, b as nf, c as rf, f as of, d as lf, h as cf, i as uf, j as df, k as hf, l as pf, m as mf, n as gf, o as ff, p as yf, q as vf, s as bf, t as wf, u as Sf, v as _f, w as kf, x as Af, y as Tf, z as Cf, A as If, B as Mf } from "./gateway-CDMPqFEH.js";
 const yn = {
   0: "",
   1: "I",
@@ -31608,6 +31608,8 @@ export {
   um as EASY_QUARTER_NOTE_BPM,
   S as ENCHANTMENT_LIBRARY,
   Da as ENEMY_COUNT_MULTIPLIER,
+  ef as ENGINE_DOC_ARCHIVE,
+  tf as ENGINE_DOC_TOPICS,
   es as EXPECTED_WIN_RATES,
   ve as EnchantmentLibrary,
   it as EnemyGenerator,
@@ -31635,7 +31637,7 @@ export {
   oa as ITEM_CREATION_TEMPLATES,
   kn as InitiativeRoller,
   jg as KNOWN_GATEWAY_HOSTS,
-  ef as KNOWN_IPFS_GATEWAY_HOSTS,
+  af as KNOWN_IPFS_GATEWAY_HOSTS,
   ke as LevelUpProcessor,
   Gg as LogLevel,
   ye as Logger,
@@ -31747,6 +31749,7 @@ export {
   Js as displayEnvironmentalDiagnostics,
   Qs as displayGamingDiagnostics,
   jd as displaySystemDashboard,
+  sf as engineHelp,
   Uh as ensureAllDefaultsInitialized,
   xs as ensureAppearanceDefaultsInitialized,
   Ws as ensureClassDefaultsInitialized,
@@ -31756,11 +31759,11 @@ export {
   Bs as ensureRaceDefaultsInitialized,
   hd as ensureSkillDefaultsInitialized,
   ia as ensureSpellDefaultsInitialized,
-  tf as evaluateMixConditions,
-  af as extractIPFSPath,
+  nf as evaluateMixConditions,
+  rf as extractIPFSPath,
   ap as extractKeyMap,
   Ym as findActiveSegment,
-  sf as findMixByName,
+  of as findMixByName,
   Xm as gaussianSmooth,
   Km as generateSeed,
   pn as getAccuracyThresholdsForPreset,
@@ -31769,8 +31772,8 @@ export {
   Yg as getAllGatewayUrls,
   Fn as getAllRarities,
   Jm as getAllowedGridTypes,
-  nf as getArtists,
-  rf as getAudioUrls,
+  lf as getArtists,
+  cf as getAudioUrls,
   Cn as getAveragePartyLevel,
   Hi as getCRFromXP,
   Vi as getClassData,
@@ -31785,15 +31788,15 @@ export {
   Cp as getEnchantmentsByType,
   kt as getEncounterMultiplier,
   xh as getFeatureQuery,
-  of as getFullTracks,
+  uf as getFullTracks,
   ag as getGaussianSmoothMs,
-  lf as getGenres,
+  df as getGenres,
   cn as getGroovePenaltiesForPreset,
   Bt as getGrooveTier,
   un as getGrooveWindowMs,
   dh as getHigherRarity,
   ig as getHopSizeMs,
-  cf as getImageUrls,
+  hf as getImageUrls,
   Bp as getItemsWithProperty,
   np as getKeyCount,
   Pp as getMagicItem,
@@ -31802,8 +31805,8 @@ export {
   sg as getMelBands,
   ng as getMetricGroupSize,
   rg as getMinHotnessForTier,
-  uf as getMixTracks,
-  df as getMixes,
+  pf as getMixTracks,
+  mf as getMixes,
   og as getPatternById,
   lg as getPatternLibrary,
   cg as getPatternLibraryStats,
@@ -31811,7 +31814,7 @@ export {
   dg as getPatternsByDifficulty,
   hg as getPatternsByKeyCount,
   pg as getPatternsByTags,
-  hf as getPreferredMixByQuality,
+  gf as getPreferredMixByQuality,
   ua as getRaceData,
   Rh as getRaceDataAsync,
   mg as getRandomPattern,
@@ -31823,21 +31826,21 @@ export {
   Eh as getSpellQuery,
   Yi as getSpellSlotsForClass,
   on as getSubdivisionDensity,
-  pf as getTags,
+  ff as getTags,
   oh as getTemplateById,
   ch as getTemplatesByArchetype,
   lh as getTemplatesByCategory,
   yg as getTempoAwareAllowedGridTypes,
-  mf as getTotalDuration,
-  gf as getTrackCount,
+  yf as getTotalDuration,
+  vf as getTrackCount,
   gn as getTrackExtras,
-  ff as getTrackMetadata,
-  yf as getTrackTitles,
-  vf as getTracks,
-  bf as getUniqueMixes,
+  bf as getTrackMetadata,
+  wf as getTrackTitles,
+  Sf as getTracks,
+  _f as getUniqueMixes,
   rp as getUsedKeys,
-  wf as getVRMTracks,
-  Sf as getVRMs,
+  kf as getVRMTracks,
+  Af as getVRMs,
   ca as getXPBudgetForParty,
   Tn as getXPBudgetPerLevel,
   Wi as getXPForCR,
@@ -31858,7 +31861,7 @@ export {
   Xg as isArweaveUrl,
   Sg as isFullBeatMapExportData,
   _g as isGridTypeAllowed,
-  _f as isIPFS,
+  Tf as isIPFS,
   kg as isLevelPackExport,
   Ag as isMetricStrongBeat,
   Tg as isMetricWeakBeat,
@@ -31885,10 +31888,10 @@ export {
   xg as performSTFT,
   Pg as reapplyDownbeatConfig,
   $g as resampleAudio,
-  kf as resolveIPFSLink,
-  Af as resolveMixUrl,
+  Cf as resolveIPFSLink,
+  If as resolveMixUrl,
   fn as resolveSelectedMix,
-  Tf as selectMix,
+  Mf as selectMix,
   Oh as shouldAccuracyBreakCombo,
   Qh as subdivideBeatMap,
   wn as toPrestigeLevel,

package/dist/utils/engineDocs.d.ts

@@ -0,0 +1,33 @@
+export interface EngineDocTopic {
+    /** Slug accepted by engineHelp(topic) and `npx playlist-data-engine docs <topic>` */
+    slug: string;
+    /** File path relative to the package root */
+    file: string;
+    summary: string;
+}
+export declare const ENGINE_DOC_TOPICS: readonly EngineDocTopic[];
+/**
+ * Timestamped Arweave snapshots of docs/, newest last. Arweave TXs are
+ * immutable, so every entry stays addressable forever — re-uploading after a
+ * docs change adds a new entry and never retires the old ones. Append the
+ * paste-ready output of `node scripts/upload-docs.cjs <wallet.json> --yes`.
+ */
+export interface EngineDocArchiveEntry {
+    /** Engine version the docs describe */
+    version: string;
+    /** ISO timestamp of the upload */
+    uploadedAt: string;
+    /** docs/-relative path → Turbo transaction id */
+    files: Record<string, string>;
+}
+export declare const ENGINE_DOC_ARCHIVE: readonly EngineDocArchiveEntry[];
+/**
+ * Self-describing docs entry point: the doc index, one topic's location, or
+ * the Claude Code skill file. Inlined content only — safe in browsers and
+ * always version-matched to the installed package.
+ *
+ * @param topic - Omit for the doc index; a topic slug (or alias) for one doc's
+ *   location; `'skill'` for the SKILL.md contents.
+ */
+export declare function engineHelp(topic?: string): string;
+//# sourceMappingURL=engineDocs.d.ts.map

package/dist/utils/engineDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engineDocs.d.ts","sourceRoot":"","sources":["../../src/utils/engineDocs.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC3B,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAiBtD,CAAC;AAYF;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,eAAO,MAAM,kBAAkB,EAAE,SAAS,qBAAqB,EAuB9D,CAAC;AAqEF;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAIjD"}