@arraypress/waveform-sounds 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +123 -2
- package/dist/waveform-sounds-no-autoinit.cjs +1935 -0
- package/dist/waveform-sounds-no-autoinit.esm.js +1913 -0
- package/dist/waveform-sounds-render.cjs +525 -0
- package/dist/waveform-sounds-render.esm.js +503 -0
- package/dist/waveform-sounds.cjs +1957 -0
- package/dist/waveform-sounds.css +378 -0
- package/dist/waveform-sounds.esm.js +1935 -0
- package/dist/waveform-sounds.js +1920 -0
- package/dist/waveform-sounds.min.css +1 -0
- package/dist/waveform-sounds.min.js +13 -0
- package/index.d.ts +291 -0
- package/no-autoinit.d.ts +2 -0
- package/package.json +96 -4
- package/render.d.ts +3 -0
- package/src/css/waveform-sounds.css +378 -0
- package/src/js/core/WaveformSounds.js +883 -0
- package/src/js/core/engine.js +57 -0
- package/src/js/core/options.js +163 -0
- package/src/js/data/navigation.js +73 -0
- package/src/js/data/sounds.js +306 -0
- package/src/js/data/url-state.js +102 -0
- package/src/js/dom/colors.js +59 -0
- package/src/js/dom/draw.js +93 -0
- package/src/js/dom/menus.js +232 -0
- package/src/js/dom/rows.js +74 -0
- package/src/js/entry.js +25 -0
- package/src/js/index.js +24 -0
- package/src/js/render/html.js +55 -0
- package/src/js/render/icons.js +29 -0
- package/src/js/render/markup.js +295 -0
- package/src/js/render/options.js +90 -0
- package/src/js/render/strings.js +76 -0
- package/src/js/render-entry.js +6 -0
- package/src/js/shared/utils.js +73 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
.waveform-sounds{--ws-accent: currentColor;--ws-on-accent: var(--ws-surface, rgb(from currentColor calc(255 - r) calc(255 - g) calc(255 - b) ));--ws-muted: color-mix(in srgb, currentColor 62%, transparent);--ws-border: color-mix(in srgb, currentColor 12%, transparent);--ws-hover: color-mix(in srgb, currentColor 5%, transparent);--ws-current: color-mix(in srgb, var(--ws-accent) 7%, transparent);--ws-field: color-mix(in srgb, currentColor 5%, transparent);--ws-wave-color: color-mix(in srgb, currentColor 30%, transparent);--ws-progress-color: var(--ws-accent);--ws-radius: 10px;--ws-control-radius: 999px;--ws-row-height: 3.25rem;--ws-wave-height: 28px;--ws-mono: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;container-type:inline-size;color:inherit;font:inherit}.waveform-sounds *,.waveform-sounds *:before,.waveform-sounds *:after{box-sizing:border-box}.waveform-sounds [hidden]{display:none!important}.ws-sr{position:absolute!important;width:1px;height:1px;margin:-1px;padding:0;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}.ws-icon{width:1em;height:1em;fill:currentColor;flex:none}.ws-toolbar{display:flex;flex-wrap:wrap;align-items:center;gap:.75rem;margin-bottom:1rem}.ws-search{flex:1 1 16rem;display:flex;align-items:center;gap:.6rem;min-width:0;height:2.75rem;padding:0 1rem;border:1px solid var(--ws-border);border-radius:var(--ws-control-radius);background:var(--ws-field);color:inherit;cursor:text}.ws-search:focus-within{border-color:var(--ws-accent)}.ws-search-input{flex:1;min-width:0;height:100%;border:0;background:none;color:inherit;font:inherit;outline:none}.ws-search .ws-icon{color:var(--ws-muted)}.ws-search-input::placeholder{color:var(--ws-muted)}.ws-search-input::-webkit-search-cancel-button,.ws-menu-search::-webkit-search-cancel-button{-webkit-appearance:none;width:.9em;height:.9em;background:currentColor;opacity:.55;cursor:pointer;-webkit-mask:url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M6.4 5 5 6.4 10.6 12 5 17.6 6.4 19l5.6-5.6 5.6 5.6 1.4-1.4-5.6-5.6L19 6.4 17.6 5 12 10.6z'/%3E%3C/svg%3E") center / contain no-repeat}.ws-controls{display:flex;flex-wrap:wrap;align-items:center;gap:.5rem}.ws-bpm-range input{height:2.75rem;border:1px solid var(--ws-border);border-radius:var(--ws-control-radius);background:var(--ws-field);color:inherit;font:inherit;font-size:.9em}.ws-menu{position:relative}.ws-menu-btn{display:inline-flex;align-items:center;gap:.45rem;height:2.75rem;max-width:16rem;padding:0 .85rem 0 1rem;border:1px solid var(--ws-border);border-radius:var(--ws-control-radius);background:var(--ws-field);color:inherit;font:inherit;font-size:.9em;cursor:pointer}.ws-menu-btn:hover{background:var(--ws-hover)}.ws-menu-btn[aria-expanded=true]{border-color:var(--ws-accent)}.ws-menu-prefix{color:var(--ws-muted)}.ws-menu-value{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ws-menu-chevron{font-size:1.1em;color:var(--ws-muted);transition:transform .15s}.ws-menu-btn[aria-expanded=true] .ws-menu-chevron{transform:rotate(180deg)}.ws-menu-pop{position:absolute;top:calc(100% + .4rem);left:0;z-index:20;width:max-content;min-width:max(100%,14rem);max-width:min(22rem,90vw);padding:.35rem;border:1px solid var(--ws-border);border-radius:var(--ws-radius);background:var(--ws-popover-bg, var(--ws-surface, Canvas));box-shadow:0 18px 40px -16px #00000073}.ws-menu--end .ws-menu-pop{left:auto;right:0}.ws-menu-search{display:block;width:100%;height:2.4rem;margin-bottom:.3rem;padding:0 .75rem;border:1px solid var(--ws-border);border-radius:calc(var(--ws-radius) * .7);background:var(--ws-field);color:inherit;font:inherit;font-size:.9em;outline:none}.ws-menu-search:focus{border-color:var(--ws-accent)}.ws-menu-list{list-style:none;margin:0;padding:0;max-height:18rem;overflow-y:auto;outline:none}.ws-menu-option{display:flex;align-items:center;gap:.5rem;padding:.5rem .6rem;border-radius:calc(var(--ws-radius) * .6);font-size:.9em;cursor:pointer}.ws-menu-option:hover,.ws-menu-option.is-active{background:var(--ws-hover)}.ws-menu-option.is-active{outline:1px solid var(--ws-border)}.ws-menu-check{visibility:hidden;flex:none}.ws-menu-option[aria-selected=true]{font-weight:600}.ws-menu-option[aria-selected=true] .ws-menu-check{visibility:visible}.ws-menu-text{flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.ws-menu-count{font-family:var(--ws-mono);font-size:.85em;color:var(--ws-muted)}.ws-menu-none{margin:0;padding:.6rem;color:var(--ws-muted);font-size:.9em}.ws-bpm-range{display:inline-flex;align-items:center;gap:.35rem;color:var(--ws-muted);font-size:.9em}.ws-bpm-range input{width:5rem;padding:0 .85rem;-moz-appearance:textfield}.ws-bpm-range input::-webkit-inner-spin-button{display:none}.ws-loop{display:inline-flex;align-items:center;gap:.45rem;height:2.75rem;padding:0 1rem;border:1px solid var(--ws-border);border-radius:var(--ws-control-radius);background:none;color:inherit;font:inherit;font-size:.9em;cursor:pointer}.ws-loop[aria-pressed=true]{border-color:var(--ws-accent);background:var(--ws-accent)}.ws-loop[aria-pressed=true]>*{color:var(--ws-on-accent)}.ws-meta{flex-basis:100%;display:flex;flex-wrap:wrap;align-items:center;gap:.5rem 1rem}.ws-types{display:flex;flex-wrap:wrap;gap:.4rem;flex:1 1 auto;min-width:0}.ws-chip{display:inline-flex;align-items:center;gap:.4rem;height:2.25rem;padding:0 .9rem;border:1px solid var(--ws-border);border-radius:var(--ws-control-radius);background:none;color:inherit;font:inherit;font-size:.88em;cursor:pointer;transition:border-color .15s,background .15s}.ws-chip:hover{background:var(--ws-hover)}.ws-chip[aria-pressed=true]{border-color:var(--ws-accent);background:var(--ws-accent)}.ws-chip[aria-pressed=true]>*{color:var(--ws-on-accent)}.ws-chip-count{font-family:var(--ws-mono);font-size:.85em;opacity:.7}.ws-chip[aria-pressed=true] .ws-chip-count{opacity:1}.ws-count{margin:0 0 0 auto;color:var(--ws-muted);font-size:.88em;font-variant-numeric:tabular-nums}.ws-list{list-style:none;margin:0;padding:0;border-top:1px solid var(--ws-border)}.ws-row{display:flex;align-items:center;gap:1rem;min-height:var(--ws-row-height);padding:.4rem .75rem .4rem .4rem;border-bottom:1px solid var(--ws-border);cursor:pointer;transition:background .12s}.ws-row:hover{background:var(--ws-hover)}.ws-row.is-current{background:var(--ws-current)}.ws-row.is-error .ws-title{text-decoration:line-through;opacity:.6}.ws-play{flex:none;display:grid;place-items:center;width:2.25rem;height:2.25rem;border:0;border-radius:999px;background:var(--ws-field);color:inherit;font-size:.95rem;cursor:pointer;transition:background .15s,color .15s}.ws-row:hover .ws-play{background:color-mix(in srgb,currentColor 12%,transparent)}.ws-row.is-current .ws-play{background:var(--ws-accent)}.ws-row.is-current .ws-play>*{color:var(--ws-on-accent)}.ws-play .ws-icon-pause,.ws-row.is-playing .ws-play .ws-icon-play{display:none}.ws-row.is-playing .ws-play .ws-icon-pause{display:block}.ws-play:focus-visible,.ws-chip:focus-visible,.ws-menu-btn:focus-visible,.ws-loop:focus-visible,.ws-more:focus-visible,.ws-clear:focus-visible,.ws-wave:focus-visible,.ws-download:focus-visible{outline:2px solid var(--ws-accent);outline-offset:2px}.ws-cell{min-width:0;font-size:.9em;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.ws-title{flex:1.4 1 9rem;font-weight:500}.ws-type{flex:1 1 6rem;color:var(--ws-muted)}.ws-bpm,.ws-key,.ws-duration{flex:none;font-family:var(--ws-mono);font-size:.82em;color:var(--ws-muted);font-variant-numeric:tabular-nums}.ws-bpm{width:3.25ch;text-align:right}.ws-key{width:3.5ch}.ws-duration{width:4.5ch;text-align:right}.ws-wave{flex:2 1 8rem;position:relative;height:var(--ws-wave-height);min-width:6rem;cursor:pointer;touch-action:pan-y;border-radius:4px}.ws-canvas{display:block;width:100%;height:100%}.ws-download{flex:none;display:grid;place-items:center;width:2.25rem;height:2.25rem;border-radius:999px;color:var(--ws-muted);font-size:1.05rem;text-decoration:none;transition:color .15s,background .15s}.ws-download:hover{color:inherit;background:var(--ws-hover)}.ws-cells{display:contents}@container (max-width: 560px){.ws-row{display:grid;grid-template-columns:auto minmax(0,1fr) auto;grid-template-areas:"play title dl" "play cells cells" "play wave wave";column-gap:.85rem;row-gap:.2rem;padding:.7rem .5rem}.ws-play{grid-area:play;align-self:center}.ws-title{grid-area:title;white-space:normal;overflow-wrap:anywhere}.ws-cells{grid-area:cells;display:flex;flex-wrap:wrap;align-items:baseline;gap:0 .5rem;min-width:0}.ws-cells>.ws-cell{flex:none;width:auto;text-align:left;font-size:.78em}.ws-cells>.ws-cell:empty{display:none}.ws-cells>.ws-cell+.ws-cell:not(:empty):before{content:"\b7";margin-right:.5rem;opacity:.6}.ws-wave{grid-area:wave;margin-top:.35rem;min-width:0}.ws-download{grid-area:dl;align-self:start}}.ws-empty{margin:1.5rem 0;color:var(--ws-muted)}.ws-clear,.ws-more{border:1px solid var(--ws-border);border-radius:var(--ws-control-radius);background:none;color:inherit;font:inherit;cursor:pointer}.ws-clear{margin-left:.5rem;padding:.35rem .85rem;font-size:.88em}.ws-more{display:block;margin:1.25rem auto 0;padding:.7rem 1.4rem;font-size:.92em}.ws-more:hover,.ws-clear:hover{background:var(--ws-hover)}.ws-engine--strip{position:sticky;bottom:0;margin-top:1rem;padding:.75rem;border:1px solid var(--ws-border);border-radius:var(--ws-radius);background:var(--ws-strip-bg, Canvas);z-index:1}@media(pointer:coarse){.ws-play,.ws-download{width:2.75rem;height:2.75rem}.ws-chip{height:2.5rem}.ws-search-input,.ws-menu-search,.ws-bpm-range input{font-size:16px}.ws-menu-option{padding:.75rem .6rem}}@media(prefers-reduced-motion:reduce){.ws-row,.ws-chip,.ws-play{transition:none}}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
(()=>{var Bt=Object.freeze({"&":"&","<":"<",">":">",'"':""","'":"'"});function P(n){return n==null?"":String(n).replace(/[&<>"']/g,t=>Bt[t])}var Ut=/[^\p{L}\p{N}]+/u,Kt=/\p{Mn}+/gu;function S(n){return!n||typeof n!="string"?"":n.toLowerCase().normalize("NFD").replace(Kt,"")}function O(n){return S(n).split(Ut).filter(t=>t!=="")}function lt(n,t){let e=Array.from(n??""),s=Array.from(t??""),r=[],i=Array.from({length:s.length+1},(o,a)=>a);for(let o=1;o<=e.length;o++){let a=[o];for(let l=1;l<=s.length;l++){let d=e[o-1]===s[l-1]?0:1;a[l]=Math.min(i[l]+1,a[l-1]+1,i[l-1]+d),o>1&&l>1&&e[o-1]===s[l-2]&&e[o-2]===s[l-1]&&(a[l]=Math.min(a[l],r[l-2]+1))}r=i,i=a}return i[s.length]}function ut(n,t,e={}){let s=e.fuzzyFrom??4,r=S(n),i=O(n);return O(t).every(o=>{if(r.includes(o))return!0;let a=Array.from(o).length;return a<s?!1:i.some(l=>lt(o,l)<=1||lt(o,Array.from(l).slice(0,a).join(""))<=1)})}function F(n){if(!Array.isArray(n))return"";let t="";for(let e of n){let s=Math.round(Math.min(Math.max(Number(e)||0,0),1)*255);t+=(s<16?"0":"")+s.toString(16)}return t}function V(n,t=1){if(n==null||n==="")return null;if(typeof n=="string"){if(!/^[0-9a-f]+$/i.test(n)||n.length%2)return null;let r=new Array(n.length/2);for(let i=0;i<r.length;i++)r[i]=parseInt(n.substr(i*2,2),16)/255;return r}if(!Array.isArray(n))return null;let e=Number(t)>0?Number(t):1,s=n.map(r=>Math.min(Math.max((Number(r)||0)/e,0),1));return s.length?s:null}function k(n){if(n==null)return"";let t=String(n).trim(),e=t.match(/^([A-Ga-g])[\s_-]*([#♯b♭]?)[\s_-]*(m|min|minor|maj|major)?$/i);if(!e)return t;let s=e[1].toUpperCase(),r=e[2]==="\u266F"?"#":e[2]==="\u266D"?"b":e[2],i=e[3]&&/^m(in(or)?)?$/i.test(e[3])&&e[3]!=="M";return s+r+(i?"m":"")}var Ht={C:0,"C#":1,Db:1,D:2,"D#":3,Eb:3,E:4,F:5,"F#":6,Gb:6,G:7,"G#":8,Ab:8,A:9,"A#":10,Bb:10,B:11};function D(n){if(!n)return 1/0;let t=n.endsWith("m"),e=t?n.slice(0,-1):n,s=Ht[e];return s===void 0?1e3:s*2+(t?1:0)}function z(n){if(n==null||n==="")return"";let t=Number(n);if(!Number.isFinite(t)||t<0)return"";let e=Math.round(t);return`${Math.floor(e/60)}:${String(e%60).padStart(2,"0")}`}function jt(n){if(n==null||n==="")return null;if(typeof n=="number")return Number.isFinite(n)&&n>=0?n:null;let t=String(n).trim();if(/^\d+(\.\d+)?$/.test(t))return Number(t);let e=t.split(":").map(Number);return e.length<2||e.some(s=>!Number.isFinite(s))?null:e.reduce((s,r)=>s*60+r,0)}function Gt(n){let e=(String(n||"").split(/[?#]/)[0].split("/").pop()||"").replace(/\.[a-z0-9]+$/i,"");try{e=decodeURIComponent(e)}catch{}return e.replace(/[_]+/g," ").replace(/\s+/g," ").trim()}function Y(n,t,e=1){if(!n||typeof n!="object"||!n.url)return null;let s=Number(n.bpm),r=Array.isArray(n.tags)?n.tags.map(i=>String(i).trim()).filter(Boolean):typeof n.tags=="string"?n.tags.split(",").map(i=>i.trim()).filter(Boolean):[];return{id:n.id!=null&&n.id!==""?String(n.id):`sound-${t+1}`,url:String(n.url),title:n.title?String(n.title):Gt(n.url),type:n.type?String(n.type):"",bpm:Number.isFinite(s)&&s>0?Math.round(s*100)/100:null,key:k(n.key),duration:jt(n.duration),tags:r,peaks:V(n.peaks,e),waveform:n.waveform?String(n.waveform):null,download:n.download?String(n.download):null}}function q(n){let t=Array.isArray(n)?n:Array.isArray(n?.sounds)?n.sounds:[],e=Array.isArray(n)?1:Number(n?.peakScale)||1;return _(t,e)}function _(n,t=1){let e=new Set,s=[];return(Array.isArray(n)?n:[]).forEach((r,i)=>{let o=Y(r,i,t);if(!o)return;let a=o.id,l=2;for(;e.has(a);)a=`${o.id}-${l++}`;o.id=a,e.add(a),s.push(o)}),s}function v(n){let t=new Map,e=new Set,s=1/0,r=-1/0,i=!1;for(let o of n)o.type&&t.set(o.type,(t.get(o.type)||0)+1),o.key&&e.add(o.key),o.bpm!=null&&(s=Math.min(s,o.bpm),r=Math.max(r,o.bpm)),o.duration!=null&&(i=!0);return{types:[...t].map(([o,a])=>({name:o,count:a})),keys:[...e].sort((o,a)=>D(o)-D(a)||o.localeCompare(a)),bpm:s===1/0?null:{min:s,max:r},hasDuration:i}}function B(n,t={}){if(t.type&&n.type!==t.type||t.key&&n.key!==k(t.key))return!1;let e=Number(t.bpmMin),s=Number(t.bpmMax);if((t.bpmMin!=null&&t.bpmMin!==""&&Number.isFinite(e)||t.bpmMax!=null&&t.bpmMax!==""&&Number.isFinite(s))&&(n.bpm==null||t.bpmMin!=null&&t.bpmMin!==""&&n.bpm<e||t.bpmMax!=null&&t.bpmMax!==""&&n.bpm>s))return!1;let r=O(t.query||"");if(r.length){let i=[n.title,n.type,n.key,...n.tags||[]].join(" "),o=S(i),a=r.filter(l=>!(/^\d+$/.test(l)&&!o.includes(l)&&n.bpm!=null&&Math.round(n.bpm)===Number(l)));if(a.length&&!ut(i,a.join(" ")))return!1}return!0}var C=["default","title","bpm","key","duration"],Wt={default:()=>!0,title:()=>!0,bpm:n=>n.bpm!==null,key:n=>n.keys.length>0,duration:n=>n.hasDuration};function U(n,t){return n.filter(e=>Wt[e]?.(t))}function L(n,t="default"){let e=n.map((i,o)=>({s:i,i:o})),s=i=>i??1/0,r={title:(i,o)=>i.s.title.localeCompare(o.s.title,void 0,{numeric:!0,sensitivity:"base"}),bpm:(i,o)=>s(i.s.bpm)-s(o.s.bpm),key:(i,o)=>D(i.s.key)-D(o.s.key),duration:(i,o)=>s(i.s.duration)-s(o.s.duration)}[t];return r&&e.sort((i,o)=>r(i,o)||i.i-o.i),e.map(i=>i.s)}function Vt(n){let t=n.getBoundingClientRect();if(!t.width||!t.height)return null;let e=Math.min(window.devicePixelRatio||1,3),s=Math.round(t.width*e),r=Math.round(t.height*e);return n.width!==s&&(n.width=s),n.height!==r&&(n.height=r),{width:t.width,height:t.height,dpr:e}}function J(n,t){if(!n?.length||t<=0)return[];if(n.length===t)return n;let e=new Array(t),s=n.length/t;for(let r=0;r<t;r++){let i=Math.floor(r*s),o=Math.max(i+1,Math.floor((r+1)*s)),a=0;for(let l=i;l<o&&l<n.length;l++)n[l]>a&&(a=n[l]);e[r]=a}return e}function ct(n,t,e,s){let r=Vt(n),i=r&&n.getContext&&n.getContext("2d");if(!i)return;let{width:o,height:a,dpr:l}=r;if(i.setTransform(l,0,0,l,0,0),i.clearRect(0,0,o,a),!t?.length){i.fillStyle=s.color,i.fillRect(0,Math.floor(a/2),o,1);return}let d=s.barWidth+s.barGap,c=Math.max(1,Math.floor((o+s.barGap)/d)),b=J(t,c),N=0;for(let x of b)x>N&&(N=x);let Ft=N>0?1/N:1,zt=e*o,qt=a/2;for(let x=0;x<b.length;x++){let W=x*d,at=Math.max(b[x]*Ft,.04);if(i.fillStyle=W+s.barWidth/2<=zt?s.progressColor:s.color,s.style==="bars"){let E=Math.max(1,at*a);i.fillRect(W,a-E,s.barWidth,E)}else{let E=Math.max(1,at*(a-2));i.fillRect(W,qt-E/2,s.barWidth,E)}}}var Yt=["onLoad","onPlay","onPause","onEnd","onTimeUpdate","onError"];function pt(n,t,e){let s=n||{},r=t==="strip",i={height:r?48:32,waveformStyle:r?"mirror":"bars",preload:"metadata",singlePlay:!0,...s,audioMode:"self"};for(let o of Yt)i[o]=(...a)=>{e[o]?.(...a),typeof s[o]=="function"&&s[o](...a)};return i}function dt(n,t){return t==="strip"&&n.waveform||n.peaks||null}function Jt(n,t){let e=S(String(t??"")).trim();return!e||S(String(n??"")).includes(e)}function ht(n,t,e){return Math.max(0,Math.min(e-1,n+t))}function M(n){return{button:n.querySelector("[data-ws-menu-btn]"),pop:n.querySelector("[data-ws-menu-pop]"),search:n.querySelector("[data-ws-menu-search]"),list:n.querySelector("[data-ws-menu-list]"),none:n.querySelector("[data-ws-menu-none]"),value:n.querySelector("[data-ws-menu-value]")}}var Q=n=>n.search||n.list,X=(n,t=!1)=>[...n.list.querySelectorAll('[role="option"]')].filter(e=>!t||!e.hidden),K=class{constructor(t,{onPick:e,signal:s}){this.container=t,this.onPick=e,this.menus=Object.fromEntries([...t.querySelectorAll("[data-ws-menu]")].map(r=>[r.dataset.wsMenu,r])),this.openMenu=null,this._bind(s)}_bind(t){let e={signal:t};for(let[s,r]of Object.entries(this.menus)){let i=M(r);i.button.addEventListener("click",()=>this.openMenu===r?this.close(!0):this.open(r),e),i.button.addEventListener("keydown",o=>{(o.key==="ArrowDown"||o.key==="ArrowUp")&&(o.preventDefault(),this.open(r))},e),i.list.addEventListener("click",o=>{let a=o.target.closest('[role="option"]');a&&this._pick(s,a.dataset.value)},e),i.list.addEventListener("mousedown",o=>o.preventDefault(),e),i.search?.addEventListener("input",()=>this._filter(r,i.search.value),e),Q(i).addEventListener("keydown",o=>this._onKey(o,s,r),e)}document.addEventListener("pointerdown",s=>{this.openMenu&&!this.openMenu.contains(s.target)&&this.close(!1)},e),this.container.addEventListener("focusout",s=>{this.openMenu&&!this.openMenu.contains(s.relatedTarget)&&this.close(!1)},e)}open(t){this.openMenu&&this.openMenu!==t&&this.close(!1);let e=M(t);e.button.setAttribute("aria-expanded","true"),e.pop.hidden=!1,this.openMenu=t,e.search&&(e.search.value="",this._filter(t,"")),t.classList.remove("ws-menu--end"),e.pop.getBoundingClientRect().right>this.container.getBoundingClientRect().right+1&&t.classList.add("ws-menu--end"),this._activate(t,e.list.querySelector('[role="option"][aria-selected="true"]')),Q(e).focus()}close(t){let e=this.openMenu;if(!e)return;this.openMenu=null;let s=M(e);s.pop.hidden=!0,s.button.setAttribute("aria-expanded","false"),t&&s.button.focus()}setValue(t,e){let s=this.menus[t];if(!s)return;let r=M(s),i=null;for(let o of X(r)){let a=o.dataset.value===String(e??"");o.setAttribute("aria-selected",String(a)),a&&(i=o.querySelector(".ws-menu-text")?.textContent??"")}i!==null&&(r.value.textContent=i)}_filter(t,e){let s=M(t),r=null;for(let i of X(s))i.hidden=!Jt(i.textContent,e),i.hidden||(r??=i);s.none.hidden=r!==null,this._activate(t,r)}_activate(t,e){let s=M(t);for(let i of s.list.querySelectorAll(".is-active"))i.classList.remove("is-active");let r=Q(s);if(!e||e.hidden){r.removeAttribute("aria-activedescendant");return}e.classList.add("is-active"),r.setAttribute("aria-activedescendant",e.id),e.scrollIntoView?.({block:"nearest"})}_onKey(t,e,s){let r=M(s),i=X(r,!0),o=i.indexOf(r.list.querySelector(".is-active")),a=d=>{t.preventDefault(),this._activate(s,i[d])},l=t.target.matches("input");switch(t.key){case"ArrowDown":return a(ht(o,1,i.length));case"ArrowUp":return a(ht(o,-1,i.length));case"Home":return l?void 0:a(0);case"End":return l?void 0:a(i.length-1);case"Enter":t.preventDefault(),o>=0&&this._pick(e,i[o].dataset.value);return;case"Escape":return t.preventDefault(),t.stopPropagation(),this.close(!0);case"Tab":return this.close(!1);default:return}}_pick(t,e){this.close(!0),this.onPick(t,e)}};var m="[WaveformSounds]";function Z(n,t=0,e=1){return Math.min(Math.max(n,t),e)}function ft(n,t){return t&&t.width?Z((n-t.left)/t.width):0}function mt(n){return!!n&&(n.isContentEditable||/^(INPUT|SELECT|TEXTAREA)$/.test(n.tagName))}function yt(n,t,e){let s=new CustomEvent(`waveformsounds:${t}`,{bubbles:!0,detail:e});return n.dispatchEvent(s),s}function wt(n){let t=5381;for(let e of n)t=t*33+e.codePointAt(0)>>>0;return t}var gt=.1;function bt(n,t,e){if(!e)return null;switch(n){case"ArrowDown":return t+1<e?t+1:null;case"ArrowUp":return t>0?t-1:"search";case"Home":return 0;case"End":return e-1;default:return null}}function xt(n,t){return t!=="ArrowRight"&&t!=="ArrowLeft"?null:Z(n+(t==="ArrowRight"?gt:-gt),0,.999)}function St(n,t){let e=new Set(n.slice(0,t));return{visible:e,remaining:n.length-e.size}}function _t(n,t){return t>=n?t+1:n}var y={search:"Search sounds",searchPlaceholder:"Search sounds\u2026",all:"All",types:"Type",key:"Key",anyKey:"Any key",allTypes:"All types",findType:"Find a type\u2026",findKey:"Find a key\u2026",noMatches:"No matches",bpm:"BPM",bpmMin:"Min BPM",bpmMax:"Max BPM",sort:"Sort",sortBy:"Sort by",sortDefault:"Default",sortTitle:"Name",sortBpm:"BPM",sortKey:"Key",sortDuration:"Length",loop:"Loop",play:"Play {title}",pause:"Pause {title}",seek:"Seek {title}",download:"Download {title}",count:"{count} sounds",countOne:"1 sound",countFiltered:"{count} of {total} sounds",showMore:"Show {count} more",empty:"No sounds match.",clear:"Clear filters",nowPlaying:"Playing {title}"},vt={default:"sortDefault",title:"sortTitle",bpm:"sortBpm",key:"sortKey",duration:"sortDuration"};function h(n,t={}){return String(n).replace(/\{(\w+)\}/g,(e,s)=>s in t?String(t[s]):e)}function H(n,t,e=y){return n!==t?h(e.countFiltered,{count:n,total:t}):t===1?e.countOne:h(e.count,{count:t})}var At=["type","key","bpm"],Tt=["type","bpm","key","duration"],f={player:"inline",search:!0,filters:[...At],sorts:[...C],loopToggle:!0,showCount:!0,menuSearch:8,pageSize:50,columns:[...Tt],maxTypeChips:10};function Mt(n){let t={};for(let e in n??{})n[e]!==void 0&&(t[e]=n[e]);return t}function tt(n,t,e){return Array.isArray(n)?n.filter(s=>t.includes(s)):e}function et(n,t){let e=Number(n);return Number.isFinite(e)&&e>=0?Math.floor(e):t}function R(n={}){let t={...f,...Mt(n)};return{...t,player:t.player==="strip"?"strip":"inline",filters:tt(t.filters,At,f.filters),sorts:tt(t.sorts,C,f.sorts),columns:tt(t.columns,Tt,f.columns),menuSearch:et(t.menuSearch,f.menuSearch),maxTypeChips:et(t.maxTypeChips,f.maxTypeChips),pageSize:et(t.pageSize,f.pageSize),strings:{...y,...Mt(n.strings)}}}var j={...f,sounds:null,manifest:null,waveformStyle:"mirror",waveformColor:null,progressColor:null,barWidth:2,barGap:1,loop:!1,autoAdvance:!1,arrowAudition:!0,idPrefix:null,urlState:!1,playerOptions:null,playerClass:null,strings:null,onReady:null,onPlay:null,onPause:null,onEnd:null,onFilter:null,onError:null};function A(n){if(n===""||n==="true")return!0;if(n==="false")return!1}function nt(n){if(n!=null)return n.split(",").map(t=>t.trim()).filter(Boolean)}function I(n){return n===void 0||n===""?void 0:Number(n)}function Qt(n){if(n===void 0)return;let t=A(n);return t===void 0?n:t}function kt(n,t){if(n)try{return JSON.parse(n)}catch{console.warn(`${m} Ignoring invalid JSON in data-${t}`);return}}function Et(n){let t=n.dataset||{},e={player:t.player||void 0,manifest:t.manifest||void 0,search:A(t.search),filters:nt(t.filters),sorts:nt(t.sorts),showCount:A(t.showCount),menuSearch:I(t.menuSearch),idPrefix:t.idPrefix||void 0,urlState:Qt(t.urlState),loopToggle:A(t.loopToggle),pageSize:I(t.pageSize),maxTypeChips:I(t.maxTypeChips),columns:nt(t.columns),waveformStyle:t.waveformStyle||void 0,waveformColor:t.waveformColor||void 0,progressColor:t.progressColor||void 0,barWidth:I(t.barWidth),barGap:I(t.barGap),loop:A(t.loop),autoAdvance:A(t.autoAdvance),arrowAudition:A(t.arrowAudition),strings:kt(t.strings,"strings"),playerOptions:kt(t.playerOptions,"player-options")};for(let s of Object.keys(e))e[s]===void 0&&delete e[s];return e}function Ct(...n){let t={};for(let e of n)if(e)for(let s in e)e[s]!==null&&e[s]!==void 0&&(t[s]=e[s]);return t}var Xt=new Set(["input","br","img"]);function p(n){return P(n??"")}function Zt(n={}){let t="";for(let[e,s]of Object.entries(n))s===!0?t+=` ${e}`:s!==!1&&s!=null&&(t+=` ${e}="${P(s)}"`);return t}function u(n,t={},...e){let s=`<${n}${Zt(t)}>`;return Xt.has(n)?s:s+e.flat(1/0).filter(r=>r!=null&&r!==!1&&r!=="").join("")+`</${n}>`}function T(n,t=""){return`<svg class="${t?`ws-icon ${t}`:"ws-icon"}" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="${n}"/></svg>`}var w={play:T("M8 5.5v13l11-6.5z","ws-icon-play"),pause:T("M7 5h3.5v14H7zM13.5 5H17v14h-3.5z","ws-icon-pause"),search:T("M10.5 4a6.5 6.5 0 1 0 4.03 11.6l4.43 4.43 1.41-1.41-4.43-4.43A6.5 6.5 0 0 0 10.5 4zm0 2a4.5 4.5 0 1 1 0 9 4.5 4.5 0 0 1 0-9z"),chevron:T("M6.4 8.6 12 14.2l5.6-5.6L19 10l-7 7-7-7z","ws-menu-chevron"),check:T("M9.5 16.2 5.3 12l-1.4 1.4 5.6 5.6 11-11-1.4-1.4z","ws-menu-check"),download:T("M11 4h2v8.6l3.3-3.3 1.4 1.4L12 16.4l-5.7-5.7 1.4-1.4 3.3 3.3zM5 18h14v2H5z"),loop:T("M17 4l3 3-3 3V8H8a3 3 0 0 0-3 3v1H3v-1a5 5 0 0 1 5-5h9V4zM7 20l-3-3 3-3v2h9a3 3 0 0 0 3-3v-1h2v1a5 5 0 0 1-5 5H7v2z")};function te(n){let t=[n.length,...n.map(e=>e.url)].join("|");return`ws${wt(t).toString(36)}`}function ee(n,t){let e=t.filters.includes("type")&&n.types.length>1,s=U(t.sorts,n);return{types:e?n.types.length>t.maxTypeChips?"menu":"chips":null,key:t.filters.includes("key")&&n.keys.length>1,bpm:t.filters.includes("bpm")&&n.bpm!==null&&n.bpm.max>n.bpm.min,sorts:s.length>1?s:[],search:!!t.search,loop:!!t.loopToggle,count:!!t.showCount}}function ne(n){return u("label",{class:"ws-search"},w.search,u("span",{class:"ws-sr"},p(n.search)),u("input",{type:"search",class:"ws-search-input","data-ws-search":!0,placeholder:n.searchPlaceholder,autocomplete:"off",spellcheck:"false"}))}function se(n,t){let e=`${t.id}-${n}-list`,s=t.options.find(l=>l.value===t.value)??t.options[0],r=t.placeholder&&t.options.length>t.searchFrom,i=u("button",{type:"button",class:"ws-menu-btn","data-ws-menu-btn":!0,"aria-haspopup":"listbox","aria-expanded":"false","aria-controls":e},t.prefix?u("span",{class:"ws-menu-prefix"},p(t.prefix)):u("span",{class:"ws-sr"},p(`${t.label}: `)),u("span",{class:"ws-menu-value","data-ws-menu-value":!0},p(s.label)),w.chevron),o=r&&u("input",{type:"search",class:"ws-menu-search","data-ws-menu-search":!0,role:"combobox","aria-expanded":"true","aria-controls":e,"aria-autocomplete":"list","aria-label":t.placeholder,placeholder:t.placeholder,autocomplete:"off",spellcheck:"false"}),a=t.options.map((l,d)=>u("li",{role:"option",id:`${t.id}-${n}-${d}`,class:"ws-menu-option","data-value":l.value,"aria-selected":String(l===s)},w.check,u("span",{class:"ws-menu-text"},p(l.label)),l.count!=null&&u("span",{class:"ws-menu-count"},p(l.count))));return u("div",{class:"ws-menu","data-ws-menu":n},i,u("div",{class:"ws-menu-pop","data-ws-menu-pop":!0,hidden:!0},o,u("ul",{class:"ws-menu-list",role:"listbox",id:e,"aria-label":t.label,tabindex:"-1","data-ws-menu-list":!0},a),u("p",{class:"ws-menu-none","data-ws-menu-none":!0,hidden:!0},p(t.noMatches))))}function re(n,t){let e=(s,r,i)=>u("input",{type:"number",inputmode:"numeric",[s]:!0,"aria-label":r,placeholder:i,min:"0",step:"1"});return u("span",{class:"ws-bpm-range",role:"group","aria-label":n.bpm},e("data-ws-bpm-min",n.bpmMin,t.min),u("span",{"aria-hidden":"true"},"\u2013"),e("data-ws-bpm-max",n.bpmMax,t.max),u("span",{class:"ws-bpm-unit","aria-hidden":"true"},p(n.bpm)))}function ie(n){return u("button",{type:"button",class:"ws-loop","data-ws-loop":!0,"aria-pressed":"false"},w.loop,u("span",{},p(n.loop)))}function Lt(n,t,e,s){return u("button",{type:"button",class:"ws-chip","data-ws-type":n,"aria-pressed":String(s)},u("span",{class:"ws-chip-label"},p(t))," ",u("span",{class:"ws-chip-count"},p(e)))}function oe(n,{o:t,s:e,f:s,total:r,id:i}){let o=(c,b)=>se(c,{id:i,searchFrom:t.menuSearch,noMatches:e.noMatches,...b}),a=[n.types==="menu"&&o("type",{label:e.types,value:"",placeholder:e.findType,options:[{value:"",label:e.allTypes,count:r},...s.types.map(c=>({value:c.name,label:c.name,count:c.count}))]}),n.key&&o("key",{label:e.key,value:"",placeholder:e.findKey,options:[{value:"",label:e.anyKey},...s.keys.map(c=>({value:c,label:c}))]}),n.bpm&&re(e,s.bpm),n.sorts.length>0&&o("sort",{label:e.sort,prefix:e.sortBy,value:n.sorts[0],options:n.sorts.map(c=>({value:c,label:e[vt[c]]}))}),n.loop&&ie(e)].filter(Boolean),l=n.types==="chips"&&u("div",{class:"ws-types",role:"group","aria-label":e.types},Lt("",e.all,r,!0),s.types.map(c=>Lt(c.name,c.name,c.count,!1))),d=n.count&&u("p",{class:"ws-count","data-ws-count":!0,"aria-live":"polite"},p(H(r,r,e)));return u("div",{class:"ws-toolbar"},n.search&&ne(e),a.length>0&&u("div",{class:"ws-controls"},a),(l||d)&&u("div",{class:"ws-meta"},l,d))}var ae={type:n=>p(n.type),bpm:n=>p(n.bpm??""),key:n=>p(n.key),duration:n=>p(z(n.duration))};function le(n,t,e,s=!1){let r=e.strings,i={title:n.title},o=e.columns.map(a=>u("span",{class:`ws-cell ws-${a}`},ae[a](n)));return u("li",{class:"ws-row","data-ws-index":t,"data-ws-id":n.id,"data-url":n.url,"data-title":n.title,"data-type":n.type||null,"data-bpm":n.bpm,"data-key":n.key||null,"data-duration":n.duration,"data-tags":n.tags?.length?n.tags.join(","):null,"data-peaks":n.peaks?F(n.peaks):null,"data-waveform":n.waveform,"data-download":n.download,hidden:s},u("button",{type:"button",class:"ws-play","aria-pressed":"false","aria-label":h(r.play,i)},w.play,w.pause),u("span",{class:"ws-cell ws-title"},p(n.title)),o.length>0&&u("span",{class:"ws-cells"},o),e.player==="inline"&&u("span",{class:"ws-wave",role:"slider","aria-label":h(r.seek,i),"aria-valuemin":"0","aria-valuemax":"100","aria-valuenow":"0",tabindex:"-1"},u("canvas",{class:"ws-canvas","aria-hidden":"true"})),n.download&&u("a",{class:"ws-download",href:n.download,download:!0,"aria-label":h(r.download,i)},w.download))}function ue({o:n,s:t,total:e}){let s=n.pageSize>0?n.pageSize:e,r=Math.max(0,e-s),i=n.player==="strip";return[u("p",{class:"ws-empty","data-ws-empty":!0,hidden:!0},p(t.empty)," ",u("button",{type:"button",class:"ws-clear","data-ws-clear":!0},p(t.clear))),u("button",{type:"button",class:"ws-more","data-ws-more":!0,hidden:r===0},p(h(t.showMore,{count:Math.min(r,s)}))),u("div",{class:i?"ws-engine ws-engine--strip":"ws-engine","data-ws-engine":!0,hidden:!i}),u("p",{class:"ws-sr","data-ws-status":!0,"aria-live":"polite"})].join("")}function $(n,t={}){let e=R(t),s=_(n),r={o:e,s:e.strings,f:v(s),total:s.length,id:e.idPrefix||te(s)},i=e.pageSize>0?e.pageSize:1/0;return oe(ee(r.f,e),r)+u("ul",{class:`ws-list ws-list--${e.player}`,role:"list","data-ws-list":!0},s.map((o,a)=>le(o,a,e,a>=i)))+ue(r)}function ce(n,t={},e=""){let s=R(t),r=["waveform-sounds",`waveform-sounds--${s.player}`,e].filter(Boolean).join(" ");return u("div",{class:r,"data-waveform-sounds":!0,"data-player":s.player},$(n,t))}var st=":scope > [data-ws-index]";function Rt(n){let t=[...n.querySelectorAll(st)].sort((s,r)=>Number(s.dataset.wsIndex)-Number(r.dataset.wsIndex)),e=[];for(let s of t){let r=s.dataset,i=Y({id:r.wsId,url:r.url,title:r.title,type:r.type,bpm:r.bpm,key:r.key,duration:r.duration,tags:r.tags,peaks:r.peaks,waveform:r.waveform,download:r.download},e.length);if(!i){s.remove();continue}s.dataset.wsIndex=String(e.length),e.push(i)}return e}function It(n){let t=[];return n.querySelectorAll(st).forEach(e=>{t[Number(e.dataset.wsIndex)]=e}),t}function rt(n){return[...n.querySelectorAll(st)].filter(t=>!t.hidden)}function $t(n,t){let e=document.createDocumentFragment();for(let s of t)s&&e.appendChild(s);n.appendChild(e)}function pe(n){let t=String(n??"").trim();if(!t||t==="transparent")return 0;let e=t.match(/\/\s*([\d.]+)(%?)\s*\)$/);if(e)return Number(e[1])/(e[2]?100:1);let s=t.match(/^rgba\(\s*[^,]+,[^,]+,[^,]+,\s*([\d.]+)\s*\)$/);return s?Number(s[1]):1}function Nt(n,t=.95){for(let e=n;e&&e.nodeType===1;e=e.parentElement||e.getRootNode?.().host){let s=getComputedStyle(e).backgroundColor;if(pe(s)>t)return s}return"#fff"}function it(n,t){let e=document.createElement("span");e.style.cssText="position:absolute;width:0;height:0;overflow:hidden;visibility:hidden",e.style.color=t,n.appendChild(e);let s=getComputedStyle(e).color;return e.remove(),s}function ot(n){if(!n)return null;let t=typeof n=="string"?`${n}-`:"";return{q:`${t}q`,type:`${t}type`,key:`${t}key`,bpm:`${t}bpm`,sort:`${t}sort`}}function de(n){let t=String(n??"").match(/^(\d*)-(\d*)$/);return t&&(t[1]||t[2])?{bpmMin:t[1],bpmMax:t[2]}:null}function he(n,t){let e=n??"",s=t??"";return e!==""||s!==""?`${e}-${s}`:""}function Ot(n,t,e,s){let r={filter:{},sort:null};if(!t)return r;let i=new URLSearchParams(n),o=i.get(t.q);o&&(r.filter.query=o);let a=i.get(t.type);a&&e.types.some(b=>b.name===a)&&(r.filter.type=a);let l=k(i.get(t.key));l&&e.keys.includes(l)&&(r.filter.key=l);let d=de(i.get(t.bpm));d&&Object.assign(r.filter,d);let c=i.get(t.sort);return c&&s.includes(c)&&(r.sort=c),r}function Pt(n,t,e,s,r){if(!t)return n;let i=new URL(n),o=(a,l)=>l?i.searchParams.set(a,l):i.searchParams.delete(a);return o(t.q,String(e.query??"").trim()),o(t.type,e.type),o(t.key,e.key),o(t.bpm,he(e.bpmMin,e.bpmMax)),o(t.sort,s!==r?s:""),i.href}var Dt=Object.freeze({query:"",type:"",key:"",bpmMin:"",bpmMax:""}),fe=120,me=200,ye=250,g=class n{static instances=new Map;constructor(t,e={}){let s=typeof t=="string"?document.querySelector(t):t;if(!s)throw new Error(`${m} Container not found: ${t}`);this.container=s,this.options=Ct(j,e,Et(s)),this.options.waveformStyle=this.options.waveformStyle==="bars"?"bars":"mirror",this.strings={...y,...this.options.strings||{}},this.render={...R(this.options),strings:this.strings},this.sounds=[],this.rows=[],this.filter={...Dt},this.sortBy="default",this.limit=this._pageSize(),this.currentIndex=null,this.playing=!1,this.progress=0,this.loop=!!this.options.loop,this.engine=null,this.menus=null,this.destroyed=!1,this._ctl=new AbortController,this._originalHTML=null,this._pendingSeek=null,this._raf=0,n.instances.set(s,this),s.dataset.wsInitialized="true",this.ready=Promise.resolve().then(()=>this._init()).catch(r=>{console.error(`${m} Failed to initialise:`,r),this._emit("error",{error:r}),this.options.onError?.(r,this)})}async _init(){let t=this.container,e=t.querySelector("[data-ws-list]");if(e)this.sounds=Rt(e);else{if(this._originalHTML=t.innerHTML,this.sounds=await this._loadSounds(),this.destroyed)return;t.innerHTML=$(this.sounds,{...this.render,idPrefix:this.options.idPrefix||t.id||void 0})}this.destroyed||(this._addedClasses=["waveform-sounds",`waveform-sounds--${this.render.player}`].filter(s=>!t.classList.contains(s)),t.classList.add(...this._addedClasses),this._cacheRefs(),this._bind(),this._observe(),this._resolveColors(),this._setLoop(this.loop),this._sorts=U(this.render.sorts,v(this.sounds)),this._sortSet||(this.sortBy=this._sorts[0]||"default"),this._readUrl(),this._syncControls(),this._apply({resort:this.sortBy!=="default"}),this._playerClass()&&this._ensureEngine(),this._emit("ready",{sounds:this.sounds.length}),this.options.onReady?.(this))}async _loadSounds(){if(this.options.sounds||!this.options.manifest)return _(this.options.sounds||[]);let t=await fetch(this.options.manifest);if(!t.ok)throw new Error(`${m} Manifest ${this.options.manifest}: HTTP ${t.status}`);return q(await t.json())}_cacheRefs(){let t=e=>this.container.querySelector(e);this.$={list:t("[data-ws-list]"),search:t("[data-ws-search]"),bpmMin:t("[data-ws-bpm-min]"),bpmMax:t("[data-ws-bpm-max]"),loop:t("[data-ws-loop]"),count:t("[data-ws-count]"),empty:t("[data-ws-empty]"),more:t("[data-ws-more]"),engine:t("[data-ws-engine]"),status:t("[data-ws-status]"),chips:[...this.container.querySelectorAll("[data-ws-type]")]},this.rows=It(this.$.list)}_bind(){let t={signal:this._ctl.signal},e=this.$,s=this.container;s.addEventListener("click",a=>this._onClick(a),t),s.addEventListener("pointerdown",a=>this._onPointerDown(a),t),s.addEventListener("keydown",a=>this._onKey(a),t);let r=0,i=0;e.search?.addEventListener("input",()=>{clearTimeout(r),r=setTimeout(()=>this.setFilter({query:e.search.value}),fe)},t),e.search?.addEventListener("keydown",a=>{a.key==="ArrowDown"&&(a.preventDefault(),this._focusRow(rt(e.list)[0])),a.key==="Escape"&&e.search.value&&(a.preventDefault(),e.search.value="",this.setFilter({query:""}))},t);let o=()=>{clearTimeout(i),i=setTimeout(()=>this.setFilter({bpmMin:e.bpmMin?.value??"",bpmMax:e.bpmMax?.value??""}),me)};e.bpmMin?.addEventListener("input",o,t),e.bpmMax?.addEventListener("input",o,t),this.menus=new K(s,{signal:this._ctl.signal,onPick:(a,l)=>a==="sort"?this.setSort(l):this.setFilter({[a]:l})}),document.addEventListener("waveformplayer:play",a=>{let l=a.detail?.player;l&&l!==this.engine&&this.playing&&this.pause()},t)}_onClick(t){let e=t.target,s=e.closest("[data-ws-type]");if(s){this.setFilter({type:s.dataset.wsType});return}if(e.closest("[data-ws-more]")){this.showMore();return}if(e.closest("[data-ws-clear]")){this.clearFilters();return}if(e.closest("[data-ws-loop]")){this.setLoop(!this.loop);return}let r=e.closest(".ws-wave");if(r){this._lastPointer==="touch"&&this._seekAt(r,t.clientX);return}let i=e.closest("[data-ws-index]");!i||e.closest(".ws-download")||(this.toggle(Number(i.dataset.wsIndex)),this._focusRowQuietly(i))}_onPointerDown(t){this._lastPointer=t.pointerType;let e=t.target.closest(".ws-wave");!e||t.button!==0||t.pointerType==="touch"||(t.preventDefault(),this._seekAt(e,t.clientX))}_seekAt(t,e){let s=t.closest("[data-ws-index]");this._seekRow(Number(s.dataset.wsIndex),ft(e,t.getBoundingClientRect())),this._focusRowQuietly(s)}_onKey(t){if(t.defaultPrevented||t.altKey||t.ctrlKey||t.metaKey)return;if(t.key==="/"&&!mt(t.target)&&this.$.search){t.preventDefault(),this.$.search.focus();return}let e=t.target.closest?.("[data-ws-index]");if(!e)return;let s=Number(e.dataset.wsIndex),r=xt(this.progress,t.key);if(r!==null){if(s!==this.currentIndex||!this.engine)return;t.preventDefault(),this._seekRow(s,r);return}let i=rt(this.$.list),o=bt(t.key,i.indexOf(e),i.length);if(o!==null){if(t.preventDefault(),o==="search"){this.$.search?.focus();return}this._focusRow(i[o]),this.options.arrowAudition&&this.playing&&this.play(Number(i[o].dataset.wsIndex))}}_focusRow(t){t?.querySelector(".ws-play")?.focus()}_focusRowQuietly(t){let e=t?.querySelector(".ws-play");e&&document.activeElement!==e&&e.focus({preventScroll:!0})}_observe(){if(this.render.player!=="inline"||typeof window>"u")return;if(this._drawn=new Set,"IntersectionObserver"in window?(this._io=new IntersectionObserver(s=>{for(let r of s){if(!r.isIntersecting)continue;let i=Number(r.target.dataset.wsIndex);this._drawn.add(i),this._drawRow(i)}},{rootMargin:"200px 0px"}),this.rows.forEach(s=>s&&this._io.observe(s))):this.rows.forEach((s,r)=>s&&this._drawn.add(r)),"ResizeObserver"in window){let s=0;this._ro=new ResizeObserver(([r])=>{let i=Math.round(r.contentRect.width);i!==s&&(s=i,this._redrawAll())}),this._ro.observe(this.$.list)}let t=()=>requestAnimationFrame(()=>{this._resolveColors(),this._redrawAll()});this._mo=new MutationObserver(t);let e={attributes:!0,attributeFilter:["class","data-theme","data-color-scheme","style"]};this._mo.observe(document.documentElement,e),document.body&&this._mo.observe(document.body,e);try{window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change",t,{signal:this._ctl.signal})}catch{}}_resolveColors(){(this._autoSurface||!getComputedStyle(this.container).getPropertyValue("--ws-surface").trim())&&(this._autoSurface=!0,this.container.style.removeProperty("--ws-surface"),this.container.style.setProperty("--ws-surface",Nt(this.container))),this.colors={wave:this.options.waveformColor||it(this.container,"var(--ws-wave-color)")||"rgba(128,128,128,.5)",progress:this.options.progressColor||it(this.container,"var(--ws-progress-color)")||"currentColor"}}_drawRow(t){if(this.render.player!=="inline"||t==null||!this._drawn?.has(t))return;let e=this.rows[t],s=e?.querySelector("canvas");if(!s||e.hidden)return;let r=Number(this.options.barGap);ct(s,this.sounds[t].peaks,t===this.currentIndex?this.progress:0,{style:this.options.waveformStyle,color:this.colors?.wave||"rgba(128,128,128,.5)",progressColor:this.colors?.progress||"currentColor",barWidth:Math.max(1,Number(this.options.barWidth)||2),barGap:Number.isFinite(r)?Math.max(0,r):1})}_redrawAll(){this._drawn?.forEach(t=>this._drawRow(t))}_readUrl(){let t=ot(this.options.urlState);if(!t||typeof location>"u")return;let{filter:e,sort:s}=Ot(location.search,t,v(this.sounds),this._sorts);this.filter={...this.filter,...e},s&&(this.sortBy=s,this._sortSet=!0)}_queueUrl(){let t=ot(this.options.urlState);!t||typeof location>"u"||(clearTimeout(this._urlTimer),this._urlTimer=setTimeout(()=>{if(this.destroyed)return;let e=Pt(location.href,t,this.filter,this.sortBy,this._sorts?.[0]||"default");e!==location.href&&history.replaceState(history.state,"",e)},ye))}get visible(){return L(this.sounds.filter(t=>B(t,this.filter)),this.sortBy)}setFilter(t={}){this.filter={...this.filter,...t},this.limit=this._pageSize(),this._syncControls(),this._apply({resort:!1})}clearFilters(){this.setFilter(Dt)}setSort(t){this._sortSet=!0,this.sortBy=C.includes(t)?t:"default",this.menus?.setValue("sort",this.sortBy),this._apply({resort:!0})}showMore(){this.limit!==1/0&&(this.limit+=this.render.pageSize,this._apply({resort:!1}))}_pageSize(){return this.render.pageSize>0?this.render.pageSize:1/0}_syncControls(){let t=this.$,e=this.filter;t&&(t.search&&t.search.value!==e.query&&(t.search.value=e.query),this.menus?.setValue("type",e.type||""),this.menus?.setValue("key",e.key||""),this.menus?.setValue("sort",this.sortBy),t.bpmMin&&t.bpmMin.value!==String(e.bpmMin)&&(t.bpmMin.value=e.bpmMin),t.bpmMax&&t.bpmMax.value!==String(e.bpmMax)&&(t.bpmMax.value=e.bpmMax),t.chips.forEach(s=>s.setAttribute("aria-pressed",String(s.dataset.wsType===(e.type||"")))))}_apply({resort:t}){let e=this.$;if(!e)return;(t||this.sortBy!==this._lastSort)&&($t(e.list,L(this.sounds,this.sortBy).map(o=>this.rows[this.sounds.indexOf(o)])),this._lastSort=this.sortBy);let s=this.visible,{visible:r,remaining:i}=St(s,this.limit);this.sounds.forEach((o,a)=>{this.rows[a]&&(this.rows[a].hidden=!r.has(o))}),e.more&&(e.more.hidden=i<=0,e.more.textContent=h(this.strings.showMore,{count:Math.min(i,this.render.pageSize||i)})),e.empty&&(e.empty.hidden=s.length>0),e.count&&(e.count.textContent=H(s.length,this.sounds.length,this.strings)),this._queueUrl(),this._emit("filter",{visible:s.length,total:this.sounds.length,filter:{...this.filter},sort:this.sortBy}),this.options.onFilter?.(s,this)}_indexOf(t){if(t==null)return this.currentIndex??(this.visible[0]?this.sounds.indexOf(this.visible[0]):null);if(typeof t=="number")return this.sounds[t]?t:null;let e=typeof t=="object"?this.sounds.indexOf(t):this.sounds.findIndex(s=>s.id===String(t));return e>=0?e:null}_playerClass(){return this.options.playerClass||(typeof window<"u"?window.WaveformPlayer:null)||null}_ensureEngine(){if(this.engine)return this.engine;let t=this._playerClass();return t?(this.engine=new t(this.$.engine,pt(this.options.playerOptions,this.render.player,{onLoad:()=>this._onEngineLoad(),onPlay:()=>this._setPlaying(!0),onPause:()=>this._setPlaying(!1),onEnd:()=>this._onEnd(),onTimeUpdate:(e,s)=>this._onTime(e,s),onError:e=>this._onEngineError(e)})),this.engine):(console.error(`${m} @arraypress/waveform-player is required: load it before playing (or pass playerClass).`),null)}play(t,e={}){if(!this.$){this.ready.then(()=>{this.destroyed||this.play(t,e)});return}let s=this._indexOf(t);if(s==null)return;let r=this._ensureEngine();if(!r)return;if(s===this.currentIndex&&r.audio?.src){e.at!=null&&this._seekRow(s,e.at),this.playing||r.play();return}let i=this.currentIndex;this.currentIndex=s,this.progress=0,this._pendingSeek=e.at??null,i!=null&&this._paintRow(i),this._paintRow(s);let o=this.sounds[s];r.loadTrack(o.url,o.title,o.type||null,{waveform:dt(o,this.render.player),autoplay:!0})}pause(){this.engine&&this.playing&&this.engine.pause()}toggle(t){let e=this._indexOf(t);e!=null&&(e===this.currentIndex&&this.playing?this.pause():this.play(e))}next(){this._step(1)}previous(){this._step(-1)}_step(t){let e=this.visible,s=this.currentIndex==null?-1:e.indexOf(this.sounds[this.currentIndex]),r=e[s+t];if(!r)return!1;let i=_t(this.limit,s+t);return i!==this.limit&&(this.limit=i,this._apply({resort:!1})),this.play(this.sounds.indexOf(r)),!0}setLoop(t){this.loop=!!t,this._setLoop(this.loop)}_setLoop(t){this.$?.loop?.setAttribute("aria-pressed",String(t)),this.engine?.audio&&(this.engine.audio.loop=t)}_seekRow(t,e){if(t!==this.currentIndex||!this.engine){this.play(t,{at:e});return}let s=this.engine.audio?.duration;if(!Number.isFinite(s)||s<=0){this._pendingSeek=e;return}this.engine.seekTo(e*s),this.progress=e,this._paintRow(t),this.playing||this.engine.play()}_onEngineLoad(){this.engine?.audio&&(this.engine.audio.loop=this.loop);let t=this.sounds[this.currentIndex];t&&!t.peaks&&this.engine?.waveformData?.length&&(t.peaks=J(this.engine.waveformData,96),this._drawRow(this.currentIndex));let e=this.engine?.audio?.duration;this._pendingSeek!=null&&Number.isFinite(e)&&e>0&&(this.engine.seekTo(this._pendingSeek*e),this.progress=this._pendingSeek,this._pendingSeek=null)}_onTime(t,e){if(!(this.currentIndex==null||!e)){if(this._pendingSeek!=null){let s=this._pendingSeek;this._pendingSeek=null,this.engine.seekTo(s*e);return}this.progress=Math.min(Math.max(t/e,0),1),!this._raf&&(this._raf=requestAnimationFrame(()=>{this._raf=0,this._drawRow(this.currentIndex),this.rows[this.currentIndex]?.querySelector(".ws-wave")?.setAttribute("aria-valuenow",String(Math.round(this.progress*100)))}))}}_onEnd(){let t=this.sounds[this.currentIndex];this._emit("end",{sound:t,index:this.currentIndex}),this.options.onEnd?.(t,this),!(this.options.autoAdvance&&this._step(1))&&(this.progress=0,this._setPlaying(!1))}_onEngineError(t){this.rows[this.currentIndex]?.classList.add("is-error"),this._emit("error",{error:t,sound:this.sounds[this.currentIndex],index:this.currentIndex}),this.options.onError?.(t,this)}_setPlaying(t){let e=this.playing!==t;this.playing=t;let s=this.currentIndex;if(s==null||(this._paintRow(s),!e))return;let r=this.sounds[s];t&&this.$.status&&(this.$.status.textContent=h(this.strings.nowPlaying,{title:r.title})),this._emit(t?"play":"pause",{sound:r,index:s}),(t?this.options.onPlay:this.options.onPause)?.(r,this)}_paintRow(t){let e=this.rows[t];if(!e)return;let s=t===this.currentIndex,r=s&&this.playing;e.classList.toggle("is-current",s),e.classList.toggle("is-playing",r);let i=e.querySelector(".ws-play");i&&(i.setAttribute("aria-pressed",String(r)),i.setAttribute("aria-label",h(r?this.strings.pause:this.strings.play,{title:this.sounds[t].title})));let o=e.querySelector(".ws-wave");o&&(o.tabIndex=s?0:-1,s||o.setAttribute("aria-valuenow","0")),this._drawRow(t)}_emit(t,e={}){yt(this.container,t,{...e,instance:this})}get current(){return this.currentIndex==null?null:this.sounds[this.currentIndex]}destroy(){if(!this.destroyed){this.destroyed=!0,this._ctl.abort(),this._io?.disconnect(),this._ro?.disconnect(),this._mo?.disconnect(),this._raf&&cancelAnimationFrame(this._raf),clearTimeout(this._urlTimer);try{this.engine?.destroy()}catch{}this.engine=null,this._originalHTML!=null&&(this.container.innerHTML=this._originalHTML),this._addedClasses?.length&&this.container.classList.remove(...this._addedClasses),this._autoSurface&&this.container.style.removeProperty("--ws-surface"),delete this.container.dataset.wsInitialized,n.instances.delete(this.container)}}static init(t=document){if(typeof document>"u")return[];let e=t||document,s=[...e.matches?.("[data-waveform-sounds]")?[e]:[],...e.querySelectorAll("[data-waveform-sounds]")],r=[];for(let i of s)if(!(i.dataset.wsInitialized==="true"||n.instances.has(i)))try{r.push(new n(i))}catch(o){console.error(`${m} Failed to initialise:`,o,i)}return r}static getInstance(t){let e=typeof t=="string"?document.querySelector(t):t;return e&&n.instances.get(e)||null}static prune(){for(let[t,e]of n.instances)t.isConnected||e.destroy()}};g.utils={encodePeaks:F,decodePeaks:V,normalizeKey:k,normalizeSounds:_,parseManifest:q,facets:v,matches:B,sortSounds:L,formatDuration:z,renderSounds:$};g.DEFAULT_OPTIONS=j;g.DEFAULT_STRINGS=y;typeof window<"u"&&(window.WaveformSounds=g);var G=g;var yn=G;typeof document<"u"&&document.documentElement?.dataset?.waveformAutoinit!=="false"&&(document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>G.init(),{once:!0}):G.init());})();
|
|
2
|
+
/**
|
|
3
|
+
* @arraypress/waveform-sounds
|
|
4
|
+
* A searchable, filterable list of sounds for WaveformPlayer.
|
|
5
|
+
*
|
|
6
|
+
* Importing this entry initialises every `[data-waveform-sounds]` element
|
|
7
|
+
* once the DOM is ready. Opt out page-wide with
|
|
8
|
+
* `<html data-waveform-autoinit="false">` (the family's switch), or import
|
|
9
|
+
* `@arraypress/waveform-sounds/no-autoinit`.
|
|
10
|
+
*
|
|
11
|
+
* @author ArrayPress
|
|
12
|
+
* @license MIT
|
|
13
|
+
*/
|
package/index.d.ts
ADDED
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @arraypress/waveform-sounds — hand-written types.
|
|
3
|
+
*
|
|
4
|
+
* The four `waveform-sounds-*` wrappers derive their prop types from
|
|
5
|
+
* `WaveformSoundsOptions` here. Add or rename an option in `src/js/core.js`
|
|
6
|
+
* (`DEFAULT_OPTIONS`) and in this file in the same change.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
/** One sound, as given (a manifest entry, a `sounds` item). */
|
|
10
|
+
export interface SoundInput {
|
|
11
|
+
/** Audio URL. Required. */
|
|
12
|
+
url: string;
|
|
13
|
+
/** Display name. Defaults to the file name. */
|
|
14
|
+
title?: string;
|
|
15
|
+
/** Kind of sound ("Drum loops", "Bass", "One-shots"): the type chips. */
|
|
16
|
+
type?: string;
|
|
17
|
+
/** Tempo. Enables the BPM range filter and sort. */
|
|
18
|
+
bpm?: number | string;
|
|
19
|
+
/** Musical key, any common spelling ("F minor", "Fmin", "F#"). Shown
|
|
20
|
+
* and filtered in a short canonical form ("Fm", "F#"). */
|
|
21
|
+
key?: string;
|
|
22
|
+
/** Length: seconds (8.02) or "m:ss". */
|
|
23
|
+
duration?: number | string;
|
|
24
|
+
/** Extra words the search matches. */
|
|
25
|
+
tags?: string[] | string;
|
|
26
|
+
/** Low-resolution peaks for the row waveform: an 8-bit hex string
|
|
27
|
+
* (two characters per bar, what `waveform-gen --manifest` writes) or
|
|
28
|
+
* numbers 0..1. Without them the row shows a flat line until played. */
|
|
29
|
+
peaks?: string | number[];
|
|
30
|
+
/** Full-resolution peaks for the `strip` player (a waveform-gen `.json`
|
|
31
|
+
* URL or an array). */
|
|
32
|
+
waveform?: string | number[];
|
|
33
|
+
/** Optional download link for this sound (a free sample, the `.mid` of
|
|
34
|
+
* a MIDI preview). Rows with one get a download button; rows without
|
|
35
|
+
* carry nothing. A plain `<a download>`: gating is the site's job. */
|
|
36
|
+
download?: string;
|
|
37
|
+
/** Stable id for `play('id')`. Defaults to `sound-<n>`, 1-based
|
|
38
|
+
* (`sound-1` is the first sound). */
|
|
39
|
+
id?: string;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** A sound after normalisation (what the runtime holds). */
|
|
43
|
+
export interface Sound {
|
|
44
|
+
id: string;
|
|
45
|
+
url: string;
|
|
46
|
+
title: string;
|
|
47
|
+
type: string;
|
|
48
|
+
bpm: number | null;
|
|
49
|
+
key: string;
|
|
50
|
+
duration: number | null;
|
|
51
|
+
tags: string[];
|
|
52
|
+
peaks: number[] | null;
|
|
53
|
+
waveform: string | null;
|
|
54
|
+
download: string | null;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** What `waveform-gen --manifest` writes (a bare array also works). */
|
|
58
|
+
export interface SoundsManifest {
|
|
59
|
+
version?: number;
|
|
60
|
+
/** Scale of integer `peaks` arrays (e.g. 100). Ignored for hex peaks. */
|
|
61
|
+
peakScale?: number;
|
|
62
|
+
sounds: SoundInput[];
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export interface SoundsFilter {
|
|
66
|
+
/** Words matched (all of them, any order) against title, type, key and
|
|
67
|
+
* tags; a number also matches the BPM exactly. */
|
|
68
|
+
query: string;
|
|
69
|
+
/** One type, or '' for all. */
|
|
70
|
+
type: string;
|
|
71
|
+
/** One key, or '' for any. */
|
|
72
|
+
key: string;
|
|
73
|
+
bpmMin: number | string;
|
|
74
|
+
bpmMax: number | string;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export type SoundsSort = 'default' | 'title' | 'bpm' | 'key' | 'duration';
|
|
78
|
+
export type SoundsLayout = 'inline' | 'strip';
|
|
79
|
+
export type SoundsFilterControl = 'type' | 'key' | 'bpm';
|
|
80
|
+
export type SoundsColumn = 'type' | 'bpm' | 'key' | 'duration';
|
|
81
|
+
|
|
82
|
+
/** Every visible or announced word. `{title}`, `{count}`, `{total}` are filled in. */
|
|
83
|
+
export interface WaveformSoundsStrings {
|
|
84
|
+
search: string;
|
|
85
|
+
searchPlaceholder: string;
|
|
86
|
+
all: string;
|
|
87
|
+
types: string;
|
|
88
|
+
key: string;
|
|
89
|
+
anyKey: string;
|
|
90
|
+
allTypes: string;
|
|
91
|
+
findType: string;
|
|
92
|
+
findKey: string;
|
|
93
|
+
noMatches: string;
|
|
94
|
+
bpm: string;
|
|
95
|
+
bpmMin: string;
|
|
96
|
+
bpmMax: string;
|
|
97
|
+
sort: string;
|
|
98
|
+
sortBy: string;
|
|
99
|
+
sortDefault: string;
|
|
100
|
+
sortTitle: string;
|
|
101
|
+
sortBpm: string;
|
|
102
|
+
sortKey: string;
|
|
103
|
+
sortDuration: string;
|
|
104
|
+
loop: string;
|
|
105
|
+
play: string;
|
|
106
|
+
pause: string;
|
|
107
|
+
seek: string;
|
|
108
|
+
download: string;
|
|
109
|
+
count: string;
|
|
110
|
+
countOne: string;
|
|
111
|
+
countFiltered: string;
|
|
112
|
+
showMore: string;
|
|
113
|
+
empty: string;
|
|
114
|
+
clear: string;
|
|
115
|
+
nowPlaying: string;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
export interface WaveformSoundsOptions {
|
|
119
|
+
/** The sounds. Or `manifest`, or server-rendered rows in the container. */
|
|
120
|
+
sounds?: SoundInput[] | null;
|
|
121
|
+
/** URL of a sounds manifest (JSON), fetched when there are no `sounds`
|
|
122
|
+
* and no server-rendered rows. */
|
|
123
|
+
manifest?: string | null;
|
|
124
|
+
/** `'inline'` (default): a mini waveform per row, the playing row fills
|
|
125
|
+
* and seeks. `'strip'`: plain rows and one full player docked below. */
|
|
126
|
+
player?: SoundsLayout;
|
|
127
|
+
/** Show the search box. Default true. */
|
|
128
|
+
search?: boolean;
|
|
129
|
+
/** Which filter controls to offer (each appears only when the data has
|
|
130
|
+
* something to filter: 2+ types, 2+ keys, a BPM range). Drop one to
|
|
131
|
+
* remove it, e.g. `['type']` for no key or BPM filtering — and leave
|
|
132
|
+
* it out of `columns` and `sorts` to remove it everywhere. `[]` = no
|
|
133
|
+
* filters. */
|
|
134
|
+
filters?: SoundsFilterControl[];
|
|
135
|
+
/** The sort orders the Sort menu offers, in order; the first is the
|
|
136
|
+
* starting order. Orders the data can't use are dropped (no BPM sort
|
|
137
|
+
* without BPMs). `[]` (or one usable order) hides the menu.
|
|
138
|
+
* Default `['default', 'title', 'bpm', 'key', 'duration']`. */
|
|
139
|
+
sorts?: SoundsSort[];
|
|
140
|
+
/** Show the "12 of 300 sounds" count. Default true. */
|
|
141
|
+
showCount?: boolean;
|
|
142
|
+
/** A dropdown (type / key / sort) gets a search field when it has more
|
|
143
|
+
* than this many options. Default 8. */
|
|
144
|
+
menuSearch?: number;
|
|
145
|
+
/** Prefix for the dropdowns' element ids. Default: the container's `id`,
|
|
146
|
+
* else a hash of the sounds — so two lists of the SAME sounds on one
|
|
147
|
+
* page each need one (or an `id`). Wrappers pass a framework-unique id. */
|
|
148
|
+
idPrefix?: string;
|
|
149
|
+
/** Keep the filters in the address (`?q=bass&type=Bass+loops&key=Fm&
|
|
150
|
+
* bpm=120-130&sort=bpm`), so a filtered list can be shared and survives
|
|
151
|
+
* a refresh. `true` uses those names; a string prefixes them
|
|
152
|
+
* (`'pack'` → `pack-q`, `pack-type`, …) for several lists on a page.
|
|
153
|
+
* Uses replaceState: filtering adds no history entries. Default false. */
|
|
154
|
+
urlState?: boolean | string;
|
|
155
|
+
/** Show the Loop toggle. Default true. */
|
|
156
|
+
loopToggle?: boolean;
|
|
157
|
+
/** Up to this many types show as chips; more become a "Type" menu
|
|
158
|
+
* (a pack has a handful, a whole library can have fifty). Default 10. */
|
|
159
|
+
maxTypeChips?: number;
|
|
160
|
+
/** Rows shown before "Show more" (0 = all). Default 50. */
|
|
161
|
+
pageSize?: number;
|
|
162
|
+
/** Columns after the title, in order. Default all four. */
|
|
163
|
+
columns?: SoundsColumn[];
|
|
164
|
+
/** Row waveform style. Default `'mirror'`. */
|
|
165
|
+
waveformStyle?: 'mirror' | 'bars';
|
|
166
|
+
/** Row waveform colour. Default: CSS `--ws-wave-color`. */
|
|
167
|
+
waveformColor?: string | null;
|
|
168
|
+
/** Played-part colour. Default: CSS `--ws-progress-color` (the accent). */
|
|
169
|
+
progressColor?: string | null;
|
|
170
|
+
/** Row bar width in CSS px. Default 2. */
|
|
171
|
+
barWidth?: number;
|
|
172
|
+
/** Gap between row bars in CSS px. Default 1. */
|
|
173
|
+
barGap?: number;
|
|
174
|
+
/** Start with Loop on. Default false. */
|
|
175
|
+
loop?: boolean;
|
|
176
|
+
/** Play the next visible sound when one ends. Default false. */
|
|
177
|
+
autoAdvance?: boolean;
|
|
178
|
+
/** While a sound plays, ↑/↓ move to the next row AND play it (the
|
|
179
|
+
* sample-browser audition). Default true. */
|
|
180
|
+
arrowAudition?: boolean;
|
|
181
|
+
/** Options for the engine `WaveformPlayer` (colours, height, … — and its
|
|
182
|
+
* callbacks, which are called alongside the list's own). `audioMode` is
|
|
183
|
+
* always `'self'`. As markup: `data-player-options` (JSON). */
|
|
184
|
+
playerOptions?: Record<string, unknown> | null;
|
|
185
|
+
/** The `WaveformPlayer` class, for ESM setups without the global. */
|
|
186
|
+
playerClass?: unknown;
|
|
187
|
+
/** UI strings (partial: merged over the English defaults). As markup:
|
|
188
|
+
* `data-strings='{"count":"{count} geluiden"}'` (JSON). */
|
|
189
|
+
strings?: Partial<WaveformSoundsStrings> | null;
|
|
190
|
+
onReady?: ((instance: WaveformSounds) => void) | null;
|
|
191
|
+
onPlay?: ((sound: Sound, instance: WaveformSounds) => void) | null;
|
|
192
|
+
onPause?: ((sound: Sound, instance: WaveformSounds) => void) | null;
|
|
193
|
+
onEnd?: ((sound: Sound, instance: WaveformSounds) => void) | null;
|
|
194
|
+
/** After every filter/sort/page change, with the matching sounds. */
|
|
195
|
+
onFilter?: ((visible: Sound[], instance: WaveformSounds) => void) | null;
|
|
196
|
+
onError?: ((error: unknown, instance: WaveformSounds) => void) | null;
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
/** `detail` of the `waveformsounds:*` DOM events (all bubble). */
|
|
200
|
+
export interface WaveformSoundsEventMap {
|
|
201
|
+
'waveformsounds:ready': CustomEvent<{sounds: number; instance: WaveformSounds}>;
|
|
202
|
+
'waveformsounds:play': CustomEvent<{sound: Sound; index: number; instance: WaveformSounds}>;
|
|
203
|
+
'waveformsounds:pause': CustomEvent<{sound: Sound; index: number; instance: WaveformSounds}>;
|
|
204
|
+
'waveformsounds:end': CustomEvent<{sound: Sound; index: number; instance: WaveformSounds}>;
|
|
205
|
+
'waveformsounds:filter': CustomEvent<{visible: number; total: number; filter: SoundsFilter; sort: SoundsSort; instance: WaveformSounds}>;
|
|
206
|
+
'waveformsounds:error': CustomEvent<{error: unknown; sound?: Sound; index?: number; instance: WaveformSounds}>;
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
export declare class WaveformSounds {
|
|
210
|
+
constructor(container: HTMLElement | string, options?: WaveformSoundsOptions);
|
|
211
|
+
readonly container: HTMLElement;
|
|
212
|
+
readonly options: Required<WaveformSoundsOptions>;
|
|
213
|
+
/** Resolves once the list is built (after a manifest fetch, if any).
|
|
214
|
+
* The build always happens after the constructor returns, so listeners
|
|
215
|
+
* attached straight after `new WaveformSounds()` see `ready`. It never
|
|
216
|
+
* rejects: a failed build (e.g. the manifest 404s) resolves it too and
|
|
217
|
+
* is reported through `onError` / `waveformsounds:error`. Calls made
|
|
218
|
+
* before it resolves are honoured: `setFilter`/`setSort` show in the
|
|
219
|
+
* controls once built, and `play()` waits for the list. */
|
|
220
|
+
readonly ready: Promise<void>;
|
|
221
|
+
readonly sounds: Sound[];
|
|
222
|
+
readonly filter: SoundsFilter;
|
|
223
|
+
readonly sortBy: SoundsSort;
|
|
224
|
+
readonly playing: boolean;
|
|
225
|
+
/** The engine `WaveformPlayer`, created on first play. */
|
|
226
|
+
readonly engine: unknown;
|
|
227
|
+
/** The sounds passing the filter, in sort order. */
|
|
228
|
+
readonly visible: Sound[];
|
|
229
|
+
/** The current (playing or paused) sound. */
|
|
230
|
+
readonly current: Sound | null;
|
|
231
|
+
|
|
232
|
+
play(target?: number | string | Sound, opts?: {at?: number}): void;
|
|
233
|
+
pause(): void;
|
|
234
|
+
toggle(target?: number | string | Sound): void;
|
|
235
|
+
next(): void;
|
|
236
|
+
previous(): void;
|
|
237
|
+
setLoop(on: boolean): void;
|
|
238
|
+
setFilter(patch: Partial<SoundsFilter>): void;
|
|
239
|
+
clearFilters(): void;
|
|
240
|
+
setSort(by: SoundsSort): void;
|
|
241
|
+
showMore(): void;
|
|
242
|
+
/** Tear down listeners, observers and the engine. Markup the instance
|
|
243
|
+
* rendered is restored; ADOPTED server markup is left as it is (rows may
|
|
244
|
+
* be re-sorted/hidden) — re-render it before building a new instance. */
|
|
245
|
+
destroy(): void;
|
|
246
|
+
|
|
247
|
+
static instances: Map<Element, WaveformSounds>;
|
|
248
|
+
static init(root?: ParentNode): WaveformSounds[];
|
|
249
|
+
static getInstance(el: Element | string): WaveformSounds | null;
|
|
250
|
+
/** Destroy instances whose element has left the document. */
|
|
251
|
+
static prune(): void;
|
|
252
|
+
static DEFAULT_OPTIONS: WaveformSoundsOptions;
|
|
253
|
+
static DEFAULT_STRINGS: WaveformSoundsStrings;
|
|
254
|
+
static utils: {
|
|
255
|
+
encodePeaks: typeof encodePeaks;
|
|
256
|
+
decodePeaks: typeof decodePeaks;
|
|
257
|
+
normalizeKey: typeof normalizeKey;
|
|
258
|
+
normalizeSounds: typeof normalizeSounds;
|
|
259
|
+
parseManifest: typeof parseManifest;
|
|
260
|
+
facets: typeof facets;
|
|
261
|
+
matches: typeof matches;
|
|
262
|
+
sortSounds: typeof sortSounds;
|
|
263
|
+
formatDuration: typeof formatDuration;
|
|
264
|
+
renderSounds: typeof renderSounds;
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
export declare const DEFAULT_OPTIONS: WaveformSoundsOptions;
|
|
269
|
+
export declare const DEFAULT_STRINGS: WaveformSoundsStrings;
|
|
270
|
+
export declare function encodePeaks(peaks: number[]): string;
|
|
271
|
+
export declare function decodePeaks(value: string | number[] | null | undefined, scale?: number): number[] | null;
|
|
272
|
+
export declare function normalizeKey(key: string | null | undefined): string;
|
|
273
|
+
export declare function normalizeSounds(list: SoundInput[], peakScale?: number): Sound[];
|
|
274
|
+
export declare function parseManifest(manifest: SoundsManifest | SoundInput[]): Sound[];
|
|
275
|
+
export declare function facets(sounds: Sound[]): {types: {name: string; count: number}[]; keys: string[]; bpm: {min: number; max: number} | null; hasDuration: boolean};
|
|
276
|
+
export declare function matches(sound: Sound, filter?: Partial<SoundsFilter>): boolean;
|
|
277
|
+
export declare function sortSounds(sounds: Sound[], by?: SoundsSort): Sound[];
|
|
278
|
+
export declare function formatDuration(seconds: number | null | undefined): string;
|
|
279
|
+
/** The component's inner markup, for server rendering (also exported, DOM-free, from `@arraypress/waveform-sounds/render`). */
|
|
280
|
+
export declare function renderSounds(sounds: SoundInput[], options?: WaveformSoundsOptions): string;
|
|
281
|
+
/** The whole element (wrapper div included). */
|
|
282
|
+
export declare function renderSoundsElement(sounds: SoundInput[], options?: WaveformSoundsOptions, className?: string): string;
|
|
283
|
+
|
|
284
|
+
export default WaveformSounds;
|
|
285
|
+
|
|
286
|
+
declare global {
|
|
287
|
+
interface Window {
|
|
288
|
+
WaveformSounds: typeof WaveformSounds;
|
|
289
|
+
}
|
|
290
|
+
interface HTMLElementEventMap extends WaveformSoundsEventMap {}
|
|
291
|
+
}
|
package/no-autoinit.d.ts
ADDED
package/package.json
CHANGED
|
@@ -1,6 +1,98 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@arraypress/waveform-sounds",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Searchable, filterable sound list for WaveformPlayer: audition hundreds of sample previews with inline waveforms, keyboard navigation and one shared audio engine.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "dist/waveform-sounds.cjs",
|
|
7
|
+
"module": "dist/waveform-sounds.esm.js",
|
|
8
|
+
"unpkg": "dist/waveform-sounds.min.js",
|
|
9
|
+
"types": "index.d.ts",
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"types": "./index.d.ts",
|
|
13
|
+
"import": "./dist/waveform-sounds.esm.js",
|
|
14
|
+
"require": "./dist/waveform-sounds.cjs",
|
|
15
|
+
"default": "./dist/waveform-sounds.esm.js"
|
|
16
|
+
},
|
|
17
|
+
"./no-autoinit": {
|
|
18
|
+
"types": "./no-autoinit.d.ts",
|
|
19
|
+
"import": "./dist/waveform-sounds-no-autoinit.esm.js",
|
|
20
|
+
"require": "./dist/waveform-sounds-no-autoinit.cjs",
|
|
21
|
+
"default": "./dist/waveform-sounds-no-autoinit.esm.js"
|
|
22
|
+
},
|
|
23
|
+
"./render": {
|
|
24
|
+
"types": "./render.d.ts",
|
|
25
|
+
"import": "./dist/waveform-sounds-render.esm.js",
|
|
26
|
+
"require": "./dist/waveform-sounds-render.cjs",
|
|
27
|
+
"default": "./dist/waveform-sounds-render.esm.js"
|
|
28
|
+
},
|
|
29
|
+
"./styles.css": "./dist/waveform-sounds.css",
|
|
30
|
+
"./dist/*": "./dist/*",
|
|
31
|
+
"./package.json": "./package.json"
|
|
32
|
+
},
|
|
33
|
+
"files": [
|
|
34
|
+
"dist/",
|
|
35
|
+
"src/",
|
|
36
|
+
"index.d.ts",
|
|
37
|
+
"render.d.ts",
|
|
38
|
+
"no-autoinit.d.ts",
|
|
39
|
+
"README.md",
|
|
40
|
+
"LICENSE"
|
|
41
|
+
],
|
|
42
|
+
"sideEffects": [
|
|
43
|
+
"./dist/waveform-sounds.esm.js",
|
|
44
|
+
"./dist/waveform-sounds.cjs",
|
|
45
|
+
"./dist/waveform-sounds.js",
|
|
46
|
+
"./dist/waveform-sounds.min.js",
|
|
47
|
+
"./src/js/index.js",
|
|
48
|
+
"*.css"
|
|
49
|
+
],
|
|
50
|
+
"scripts": {
|
|
51
|
+
"build": "npm run build:css && npm run build:iife && npm run build:min && npm run build:esm && npm run build:cjs && npm run build:no-autoinit && npm run build:render",
|
|
52
|
+
"build:css": "cp src/css/waveform-sounds.css dist/waveform-sounds.css && esbuild src/css/waveform-sounds.css --minify --outfile=dist/waveform-sounds.min.css",
|
|
53
|
+
"build:iife": "esbuild src/js/index.js --bundle --format=iife --outfile=dist/waveform-sounds.js",
|
|
54
|
+
"build:min": "esbuild src/js/index.js --bundle --format=iife --minify --outfile=dist/waveform-sounds.min.js",
|
|
55
|
+
"build:esm": "esbuild src/js/index.js --bundle --format=esm --outfile=dist/waveform-sounds.esm.js",
|
|
56
|
+
"build:cjs": "esbuild src/js/index.js --bundle --format=cjs --outfile=dist/waveform-sounds.cjs",
|
|
57
|
+
"build:no-autoinit": "esbuild src/js/entry.js --bundle --format=esm --outfile=dist/waveform-sounds-no-autoinit.esm.js && esbuild src/js/entry.js --bundle --format=cjs --outfile=dist/waveform-sounds-no-autoinit.cjs",
|
|
58
|
+
"build:render": "esbuild src/js/render-entry.js --bundle --format=esm --outfile=dist/waveform-sounds-render.esm.js && esbuild src/js/render-entry.js --bundle --format=cjs --outfile=dist/waveform-sounds-render.cjs",
|
|
59
|
+
"dev": "esbuild src/js/index.js --bundle --format=iife --outfile=dist/waveform-sounds.js --watch",
|
|
60
|
+
"size": "npm run build && echo 'JS:' && gzip -c dist/waveform-sounds.min.js | wc -c && echo 'CSS:' && gzip -c dist/waveform-sounds.min.css | wc -c",
|
|
61
|
+
"serve": "npx http-server -p 8000",
|
|
62
|
+
"test": "vitest run",
|
|
63
|
+
"test:watch": "vitest",
|
|
64
|
+
"prepublishOnly": "npm test && npm run build"
|
|
65
|
+
},
|
|
66
|
+
"keywords": [
|
|
67
|
+
"audio",
|
|
68
|
+
"waveform",
|
|
69
|
+
"samples",
|
|
70
|
+
"sample-pack",
|
|
71
|
+
"sound-browser",
|
|
72
|
+
"preview",
|
|
73
|
+
"presets",
|
|
74
|
+
"player",
|
|
75
|
+
"filter",
|
|
76
|
+
"search"
|
|
77
|
+
],
|
|
78
|
+
"author": "ArrayPress",
|
|
79
|
+
"license": "MIT",
|
|
80
|
+
"repository": {
|
|
81
|
+
"type": "git",
|
|
82
|
+
"url": "git+https://github.com/arraypress/waveform-sounds.git"
|
|
83
|
+
},
|
|
84
|
+
"bugs": {
|
|
85
|
+
"url": "https://github.com/arraypress/waveform-sounds/issues"
|
|
86
|
+
},
|
|
87
|
+
"homepage": "https://github.com/arraypress/waveform-sounds#readme",
|
|
88
|
+
"peerDependencies": {
|
|
89
|
+
"@arraypress/waveform-player": "^1.24.5"
|
|
90
|
+
},
|
|
91
|
+
"devDependencies": {
|
|
92
|
+
"@arraypress/text": "^2.2.0",
|
|
93
|
+
"@arraypress/waveform-player": "^1.29.1",
|
|
94
|
+
"esbuild": "^0.28.1",
|
|
95
|
+
"jsdom": "^29.1.1",
|
|
96
|
+
"vitest": "^4.1.9"
|
|
97
|
+
}
|
|
98
|
+
}
|
package/render.d.ts
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
/** DOM-free server renderer: `@arraypress/waveform-sounds/render`. */
|
|
2
|
+
export {renderSounds, renderSoundsElement, DEFAULT_STRINGS, normalizeSounds, parseManifest, encodePeaks, decodePeaks, normalizeKey, facets, formatDuration} from './index.js';
|
|
3
|
+
export type {SoundInput, Sound, SoundsManifest, WaveformSoundsOptions, WaveformSoundsStrings} from './index.js';
|