@arraypress/waveform-sounds 0.0.0-stage → 0.1.1

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.
@@ -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 Pt=Object.freeze({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"});function $(n){return n==null?"":String(n).replace(/[&<>"']/g,t=>Pt[t])}var Nt=/[^\p{L}\p{N}]+/u,Ot=/\p{Mn}+/gu;function x(n){return!n||typeof n!="string"?"":n.toLowerCase().normalize("NFD").replace(Ot,"")}function I(n){return x(n).split(Nt).filter(t=>t!=="")}function rt(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 p=e[o-1]===s[l-1]?0:1;a[l]=Math.min(i[l]+1,a[l-1]+1,i[l-1]+p),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 it(n,t,e={}){let s=e.fuzzyFrom??4,r=x(n),i=I(n);return I(t).every(o=>{if(r.includes(o))return!0;let a=Array.from(o).length;return a<s?!1:i.some(l=>rt(o,l)<=1||rt(o,Array.from(l).slice(0,a).join(""))<=1)})}function N(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 H(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 T(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 Dt={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 P(n){if(!n)return 1/0;let t=n.endsWith("m"),e=t?n.slice(0,-1):n,s=Dt[e];return s===void 0?1e3:s*2+(t?1:0)}function O(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 Ft(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 zt(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 j(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):zt(n.url),type:n.type?String(n.type):"",bpm:Number.isFinite(s)&&s>0?Math.round(s*100)/100:null,key:T(n.key),duration:Ft(n.duration),tags:r,peaks:H(n.peaks,e),waveform:n.waveform?String(n.waveform):null,download:n.download?String(n.download):null}}function D(n){let t=Array.isArray(n)?n:Array.isArray(n?.sounds)?n.sounds:[],e=Array.isArray(n)?1:Number(n?.peakScale)||1;return S(t,e)}function S(n,t=1){let e=new Set,s=[];return(Array.isArray(n)?n:[]).forEach((r,i)=>{let o=j(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 _(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)=>P(o)-P(a)||o.localeCompare(a)),bpm:s===1/0?null:{min:s,max:r},hasDuration:i}}function F(n,t={}){if(t.type&&n.type!==t.type||t.key&&n.key!==T(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=I(t.query||"");if(r.length){let i=[n.title,n.type,n.key,...n.tags||[]].join(" "),o=x(i),a=r.filter(l=>!(/^\d+$/.test(l)&&!o.includes(l)&&n.bpm!=null&&Math.round(n.bpm)===Number(l)));if(a.length&&!it(i,a.join(" ")))return!1}return!0}var k=["default","title","bpm","key","duration"],qt={default:()=>!0,title:()=>!0,bpm:n=>n.bpm!==null,key:n=>n.keys.length>0,duration:n=>n.hasDuration};function z(n,t){return n.filter(e=>qt[e]?.(t))}function E(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)=>P(i.s.key)-P(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 Bt(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 G(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 Ut(n,t,e,s){let r=s.barWidth+s.barGap,i=G(n,Math.max(1,Math.floor((t+s.barGap)/r))),o=i.reduce((l,p)=>p>l?p:l,0),a=o>0?1/o:1;return i.map((l,p)=>{let c=Math.max(l*a,.04);if(s.style==="bars"){let st=Math.max(1,c*e);return{x:p*r,y:e-st,w:s.barWidth,h:st}}let h=Math.max(1,c*(e-2));return{x:p*r,y:e/2-h/2,w:s.barWidth,h}})}function ot(n,t,e,s){let r=Bt(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 p=new Path2D;for(let h of Ut(t,o,a,s))p.rect(h.x,h.y,h.w,h.h);i.fillStyle=s.color,i.fill(p);let c=Math.min(Math.max(e,0),1)*o;c>0&&(i.save(),i.beginPath(),i.rect(0,0,c,a),i.clip(),i.fillStyle=s.progressColor,i.fill(p),i.restore())}var Kt=["onLoad","onPlay","onPause","onEnd","onTimeUpdate","onError"];function at(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 Kt)i[o]=(...a)=>{e[o]?.(...a),typeof s[o]=="function"&&s[o](...a)};return i}function lt(n,t){return t==="strip"&&n.waveform||n.peaks||null}function Ht(n,t){let e=x(String(t??"")).trim();return!e||x(String(n??"")).includes(e)}function ut(n,t,e){return Math.max(0,Math.min(e-1,n+t))}function v(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 W=n=>n.search||n.list,V=(n,t=!1)=>[...n.list.querySelectorAll('[role="option"]')].filter(e=>!t||!e.hidden),q=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=v(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),W(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=v(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"]')),W(e).focus()}close(t){let e=this.openMenu;if(!e)return;this.openMenu=null;let s=v(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=v(s),i=null;for(let o of V(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=v(t),r=null;for(let i of V(s))i.hidden=!Ht(i.textContent,e),i.hidden||(r??=i);s.none.hidden=r!==null,this._activate(t,r)}_activate(t,e){let s=v(t);for(let i of s.list.querySelectorAll(".is-active"))i.classList.remove("is-active");let r=W(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=v(s),i=V(r,!0),o=i.indexOf(r.list.querySelector(".is-active")),a=p=>{t.preventDefault(),this._activate(s,i[p])},l=t.target.matches("input");switch(t.key){case"ArrowDown":return a(ut(o,1,i.length));case"ArrowUp":return a(ut(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 y="[WaveformSounds]";function Y(n,t=0,e=1){return Math.min(Math.max(n,t),e)}function ct(n,t){return t&&t.width?Y((n-t.left)/t.width):0}function pt(n){return!!n&&(n.isContentEditable||/^(INPUT|SELECT|TEXTAREA)$/.test(n.tagName))}function dt(n,t,e){let s=new CustomEvent(`waveformsounds:${t}`,{bubbles:!0,detail:e});return n.dispatchEvent(s),s}function ht(n){let t=5381;for(let e of n)t=t*33+e.codePointAt(0)>>>0;return t}var ft=.1;function mt(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 yt(n,t){return t!=="ArrowRight"&&t!=="ArrowLeft"?null:Y(n+(t==="ArrowRight"?ft:-ft),0,.999)}function wt(n,t){let e=new Set(n.slice(0,t));return{visible:e,remaining:n.length-e.size}}function gt(n,t){return t>=n?t+1:n}var w={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}"},bt={default:"sortDefault",title:"sortTitle",bpm:"sortBpm",key:"sortKey",duration:"sortDuration"};function f(n,t={}){return String(n).replace(/\{(\w+)\}/g,(e,s)=>s in t?String(t[s]):e)}function B(n,t,e=w){return n!==t?f(e.countFiltered,{count:n,total:t}):t===1?e.countOne:f(e.count,{count:t})}var St=["type","key","bpm"],_t=["type","bpm","key","duration"],m={player:"inline",search:!0,filters:[...St],sorts:[...k],loopToggle:!0,showCount:!0,menuSearch:8,pageSize:50,columns:[..._t],maxTypeChips:10};function xt(n){let t={};for(let e in n??{})n[e]!==void 0&&(t[e]=n[e]);return t}function J(n,t,e){return Array.isArray(n)?n.filter(s=>t.includes(s)):e}function Q(n,t){let e=Number(n);return Number.isFinite(e)&&e>=0?Math.floor(e):t}function C(n={}){let t={...m,...xt(n)};return{...t,player:t.player==="strip"?"strip":"inline",filters:J(t.filters,St,m.filters),sorts:J(t.sorts,k,m.sorts),columns:J(t.columns,_t,m.columns),menuSearch:Q(t.menuSearch,m.menuSearch),maxTypeChips:Q(t.maxTypeChips,m.maxTypeChips),pageSize:Q(t.pageSize,m.pageSize),strings:{...w,...xt(n.strings)}}}var U={...m,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 M(n){if(n===""||n==="true")return!0;if(n==="false")return!1}function X(n){if(n!=null)return n.split(",").map(t=>t.trim()).filter(Boolean)}function L(n){return n===void 0||n===""?void 0:Number(n)}function jt(n){if(n===void 0)return;let t=M(n);return t===void 0?n:t}function vt(n,t){if(n)try{return JSON.parse(n)}catch{console.warn(`${y} Ignoring invalid JSON in data-${t}`);return}}function Mt(n){let t=n.dataset||{},e={player:t.player||void 0,manifest:t.manifest||void 0,search:M(t.search),filters:X(t.filters),sorts:X(t.sorts),showCount:M(t.showCount),menuSearch:L(t.menuSearch),idPrefix:t.idPrefix||void 0,urlState:jt(t.urlState),loopToggle:M(t.loopToggle),pageSize:L(t.pageSize),maxTypeChips:L(t.maxTypeChips),columns:X(t.columns),waveformStyle:t.waveformStyle||void 0,waveformColor:t.waveformColor||void 0,progressColor:t.progressColor||void 0,barWidth:L(t.barWidth),barGap:L(t.barGap),loop:M(t.loop),autoAdvance:M(t.autoAdvance),arrowAudition:M(t.arrowAudition),strings:vt(t.strings,"strings"),playerOptions:vt(t.playerOptions,"player-options")};for(let s of Object.keys(e))e[s]===void 0&&delete e[s];return e}function At(...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 Gt=new Set(["input","br","img"]);function d(n){return $(n??"")}function Wt(n={}){let t="";for(let[e,s]of Object.entries(n))s===!0?t+=` ${e}`:s!==!1&&s!=null&&(t+=` ${e}="${$(s)}"`);return t}function u(n,t={},...e){let s=`<${n}${Wt(t)}>`;return Gt.has(n)?s:s+e.flat(1/0).filter(r=>r!=null&&r!==!1&&r!=="").join("")+`</${n}>`}function A(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 g={play:A("M8 5.5v13l11-6.5z","ws-icon-play"),pause:A("M7 5h3.5v14H7zM13.5 5H17v14h-3.5z","ws-icon-pause"),search:A("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:A("M6.4 8.6 12 14.2l5.6-5.6L19 10l-7 7-7-7z","ws-menu-chevron"),check:A("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:A("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:A("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 Vt(n){let t=[n.length,...n.map(e=>e.url)].join("|");return`ws${ht(t).toString(36)}`}function Yt(n,t){let e=t.filters.includes("type")&&n.types.length>1,s=z(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 Jt(n){return u("label",{class:"ws-search"},g.search,u("span",{class:"ws-sr"},d(n.search)),u("input",{type:"search",class:"ws-search-input","data-ws-search":!0,placeholder:n.searchPlaceholder,autocomplete:"off",spellcheck:"false"}))}function Qt(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"},d(t.prefix)):u("span",{class:"ws-sr"},d(`${t.label}: `)),u("span",{class:"ws-menu-value","data-ws-menu-value":!0},d(s.label)),g.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,p)=>u("li",{role:"option",id:`${t.id}-${n}-${p}`,class:"ws-menu-option","data-value":l.value,"aria-selected":String(l===s)},g.check,u("span",{class:"ws-menu-text"},d(l.label)),l.count!=null&&u("span",{class:"ws-menu-count"},d(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},d(t.noMatches))))}function Xt(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"},d(n.bpm)))}function Zt(n){return u("button",{type:"button",class:"ws-loop","data-ws-loop":!0,"aria-pressed":"false"},g.loop,u("span",{},d(n.loop)))}function Tt(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"},d(t))," ",u("span",{class:"ws-chip-count"},d(e)))}function te(n,{o:t,s:e,f:s,total:r,id:i}){let o=(c,h)=>Qt(c,{id:i,searchFrom:t.menuSearch,noMatches:e.noMatches,...h}),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&&Xt(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[bt[c]]}))}),n.loop&&Zt(e)].filter(Boolean),l=n.types==="chips"&&u("div",{class:"ws-types",role:"group","aria-label":e.types},Tt("",e.all,r,!0),s.types.map(c=>Tt(c.name,c.name,c.count,!1))),p=n.count&&u("p",{class:"ws-count","data-ws-count":!0,"aria-live":"polite"},d(B(r,r,e)));return u("div",{class:"ws-toolbar"},n.search&&Jt(e),a.length>0&&u("div",{class:"ws-controls"},a),(l||p)&&u("div",{class:"ws-meta"},l,p))}var ee={type:n=>d(n.type),bpm:n=>d(n.bpm??""),key:n=>d(n.key),duration:n=>d(O(n.duration))};function ne(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}`},ee[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?N(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":f(r.play,i)},g.play,g.pause),u("span",{class:"ws-cell ws-title"},d(n.title)),o.length>0&&u("span",{class:"ws-cells"},o),e.player==="inline"&&u("span",{class:"ws-wave",role:"slider","aria-label":f(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":f(r.download,i)},g.download))}function se({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},d(t.empty)," ",u("button",{type:"button",class:"ws-clear","data-ws-clear":!0},d(t.clear))),u("button",{type:"button",class:"ws-more","data-ws-more":!0,hidden:r===0},d(f(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 R(n,t={}){let e=C(t),s=S(n),r={o:e,s:e.strings,f:_(s),total:s.length,id:e.idPrefix||Vt(s)},i=e.pageSize>0?e.pageSize:1/0;return te(Yt(r.f,e),r)+u("ul",{class:`ws-list ws-list--${e.player}`,role:"list","data-ws-list":!0},s.map((o,a)=>ne(o,a,e,a>=i)))+se(r)}function re(n,t={},e=""){let s=C(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},R(n,t))}var Z=":scope > [data-ws-index]";function kt(n){let t=[...n.querySelectorAll(Z)].sort((s,r)=>Number(s.dataset.wsIndex)-Number(r.dataset.wsIndex)),e=[];for(let s of t){let r=s.dataset,i=j({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 Et(n){let t=[];return n.querySelectorAll(Z).forEach(e=>{t[Number(e.dataset.wsIndex)]=e}),t}function tt(n){return[...n.querySelectorAll(Z)].filter(t=>!t.hidden)}function Ct(n,t){let e=document.createDocumentFragment();for(let s of t)s&&e.appendChild(s);n.appendChild(e)}function ie(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 Lt(n,t=.95){for(let e=n;e&&e.nodeType===1;e=e.parentElement||e.getRootNode?.().host){let s=getComputedStyle(e).backgroundColor;if(ie(s)>t)return s}return"#fff"}function et(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 nt(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 oe(n){let t=String(n??"").match(/^(\d*)-(\d*)$/);return t&&(t[1]||t[2])?{bpmMin:t[1],bpmMax:t[2]}:null}function ae(n,t){let e=n??"",s=t??"";return e!==""||s!==""?`${e}-${s}`:""}function Rt(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(h=>h.name===a)&&(r.filter.type=a);let l=T(i.get(t.key));l&&e.keys.includes(l)&&(r.filter.key=l);let p=oe(i.get(t.bpm));p&&Object.assign(r.filter,p);let c=i.get(t.sort);return c&&s.includes(c)&&(r.sort=c),r}function It(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,ae(e.bpmMin,e.bpmMax)),o(t.sort,s!==r?s:""),i.href}var $t=Object.freeze({query:"",type:"",key:"",bpmMin:"",bpmMax:""}),le=120,ue=200,ce=250,b=class n{static instances=new Map;constructor(t,e={}){let s=typeof t=="string"?document.querySelector(t):t;if(!s)throw new Error(`${y} Container not found: ${t}`);this.container=s,this.options=At(U,e,Mt(s)),this.options.waveformStyle=this.options.waveformStyle==="bars"?"bars":"mirror",this.strings={...w,...this.options.strings||{}},this.render={...C(this.options),strings:this.strings},this.sounds=[],this.rows=[],this.filter={...$t},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(`${y} 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=kt(e);else{if(this._originalHTML=t.innerHTML,this.sounds=await this._loadSounds(),this.destroyed)return;t.innerHTML=R(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=z(this.render.sorts,_(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 S(this.options.sounds||[]);let t=await fetch(this.options.manifest);if(!t.ok)throw new Error(`${y} Manifest ${this.options.manifest}: HTTP ${t.status}`);return D(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=Et(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}),le)},t),e.search?.addEventListener("keydown",a=>{a.key==="ArrowDown"&&(a.preventDefault(),this._focusRow(tt(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??""}),ue)};e.bpmMin?.addEventListener("input",o,t),e.bpmMax?.addEventListener("input",o,t),this.menus=new q(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),ct(e,t.getBoundingClientRect())),this._focusRowQuietly(s)}_onKey(t){if(t.defaultPrevented||t.altKey||t.ctrlKey||t.metaKey)return;if(t.key==="/"&&!pt(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=yt(this.progress,t.key);if(r!==null){if(s!==this.currentIndex||!this.engine)return;t.preventDefault(),this._seekRow(s,r);return}let i=tt(this.$.list),o=mt(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",Lt(this.container))),this.colors={wave:this.options.waveformColor||et(this.container,"var(--ws-wave-color)")||"rgba(128,128,128,.5)",progress:this.options.progressColor||et(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);ot(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=nt(this.options.urlState);if(!t||typeof location>"u")return;let{filter:e,sort:s}=Rt(location.search,t,_(this.sounds),this._sorts);this.filter={...this.filter,...e},s&&(this.sortBy=s,this._sortSet=!0)}_queueUrl(){let t=nt(this.options.urlState);!t||typeof location>"u"||(clearTimeout(this._urlTimer),this._urlTimer=setTimeout(()=>{if(this.destroyed)return;let e=It(location.href,t,this.filter,this.sortBy,this._sorts?.[0]||"default");e!==location.href&&history.replaceState(history.state,"",e)},ce))}get visible(){return E(this.sounds.filter(t=>F(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($t)}setSort(t){this._sortSet=!0,this.sortBy=k.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)&&(Ct(e.list,E(this.sounds,this.sortBy).map(o=>this.rows[this.sounds.indexOf(o)])),this._lastSort=this.sortBy);let s=this.visible,{visible:r,remaining:i}=wt(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=f(this.strings.showMore,{count:Math.min(i,this.render.pageSize||i)})),e.empty&&(e.empty.hidden=s.length>0),e.count&&(e.count.textContent=B(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,at(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(`${y} @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:lt(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=gt(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=G(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=f(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",f(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={}){dt(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(`${y} 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()}};b.utils={encodePeaks:N,decodePeaks:H,normalizeKey:T,normalizeSounds:S,parseManifest:D,facets:_,matches:F,sortSounds:E,formatDuration:O,renderSounds:R};b.DEFAULT_OPTIONS=U;b.DEFAULT_STRINGS=w;typeof window<"u"&&(window.WaveformSounds=b);var K=b;var cn=K;typeof document<"u"&&document.documentElement?.dataset?.waveformAutoinit!=="false"&&(document.readyState==="loading"?document.addEventListener("DOMContentLoaded",()=>K.init(),{once:!0}):K.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
+ }
@@ -0,0 +1,2 @@
1
+ export * from './index.js';
2
+ export {default} from './index.js';
package/package.json CHANGED
@@ -1,6 +1,98 @@
1
1
  {
2
2
  "name": "@arraypress/waveform-sounds",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.1.1",
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';