create-playcanvas 0.14.0 → 0.15.0

package/README.md

@@ -38,7 +38,7 @@ Every format uses TypeScript and includes Vite, ESLint, Prettier and a productio
 
 ## Starters
 
-Choose from starter kits across basics, viewers, games, tools and XR. Run the creator to browse them; `spinning-cube` is the default.
+Choose from starter kits across basics, viewers, games, tools and XR. Run the creator to browse them, or pass `--help` to list them; `spinning-cube` is the default.
 
 ![The PlayCanvas starter scenes](images/starter-catalog.webp)
 
@@ -65,11 +65,14 @@ npm create playcanvas@latest my-game -- -f react -y
 | `--format <name>`  | `-f`      | Use a format from the list above                        |
 | `--starter <name>` | `-s`      | Use a starter from the list above                       |
 | `--overwrite`      |           | Remove existing files from a non-empty target directory |
+| `--keep`           |           | Add the project to a non-empty target directory         |
 | `--no-skills`      |           | Omit the PlayCanvas agent skills (included by default)  |
 | `--yes`            | `-y`      | Skip the prompts and take the defaults                  |
-| `--help`           | `-h`      | Show command help                                       |
+| `--help`           | `-h`      | Show command help, with the formats and starters        |
 
-`--yes` takes `playcanvas-project`, the `engine` format and the `spinning-cube` starter for anything you don't pass. It never deletes files, so a non-empty target directory still needs `--overwrite`. A run without a terminal, such as one started by an AI agent or in CI, takes the same defaults, so it never waits on a prompt. The previous `--template` and `--boilerplate` long flags remain accepted for compatibility.
+`--yes` takes `playcanvas-project`, the `engine` format and the `spinning-cube` starter for anything you don't pass. It never touches files that are already there, so a non-empty target directory still needs `--keep` or `--overwrite`. A run without a terminal, such as one started by an AI agent or in CI, takes the same defaults, so it never waits on a prompt. The previous `--template` and `--boilerplate` long flags remain accepted for compatibility.
+
+`--keep` adds the project to a directory that already holds files, such as a brief, assets or a README, and replaces none of them: where the project has a file of the same name, yours stays and the creator lists it. It stops at a directory with a `package.json`, which is a project already.
 
 ## Coding agents
 
@@ -102,6 +105,10 @@ To add a starter, list it in `STARTERS` in `templates/index.ts`, add `_shared/<s
 
 Write commands in a README or `AGENTS.md` for npm, as `npm install`, `npm run <script>` and `npm run <script> -- <args>`. The scaffolder rewrites them for the package manager that created the project, and leaves out the `## Agent skills` section of both when run with `--no-skills`.
 
+### Agent skills
+
+The skills given to each project come from the `@playcanvas/skills` dev dependency, pinned to a release tag of [playcanvas/skills](https://github.com/playcanvas/skills). `npm run build` copies them into `dist/skills`, and Renovate proposes each new release. Change a skill in that repository, not here.
+
 ## License
 
 [MIT](LICENSE)

package/dist/index.mjs

@@ -1,68 +1,86 @@
 #!/usr/bin/env node
-import{styleText as c}from"node:util";import j,{stdin as je,stdout as le}from"node:process";import Oe from"node:readline";import"node:tty";import w from"node:fs";import $ from"node:path";import{fileURLToPath as Le}from"node:url";const Pe=(()=>{const e=/[\uD800-\uDBFF][\uDC00-\uDFFF]/g;return t=>{let r=0;for(e.lastIndex=0;e.test(t);)r+=1;return t.length-r}})(),Be=e=>e===12288||e>=65281&&e<=65376||e>=65504&&e<=65510,Me=e=>e===8987||e===9001||e>=12272&&e<=12287||e>=12289&&e<=12350||e>=12441&&e<=12543||e>=12549&&e<=12591||e>=12593&&e<=12686||e>=12688&&e<=12771||e>=12783&&e<=12830||e>=12832&&e<=12871||e>=12880&&e<=19903||e>=65040&&e<=65049||e>=65072&&e<=65106||e>=65108&&e<=65126||e>=65128&&e<=65131||e>=127488&&e<=127490||e>=127504&&e<=127547||e>=127552&&e<=127560||e>=131072&&e<=196605||e>=196608&&e<=262141,Ne=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y,De=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y,ce=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu,We=/\t{1,1000}/y,ue=new RegExp("[\\u{1F1E6}-\\u{1F1FF}]{2}|\\u{1F3F4}[\\u{E0061}-\\u{E007A}]{2}[\\u{E0030}-\\u{E0039}\\u{E0061}-\\u{E007A}]{1,3}\\u{E007F}|(?:\\p{Emoji}\\uFE0F\\u20E3?|\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation})(?:\\u200D(?:\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation}|\\p{Emoji}\\uFE0F\\u20E3?))*","yu"),Ve=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y,Ue=new RegExp("\\p{M}+","gu"),Ge={limit:1/0,ellipsis:""},he=(e,t={},r={})=>{const i=t.limit??1/0,n=t.ellipsis??"",l=t?.ellipsisWidth??(n?he(n,Ge,r).width:0),a=0,o=r.controlWidth??0,s=r.tabWidth??8,u=r.emojiWidth??2,m=2,h=r.regularWidth??1,d=r.wideWidth??m,y=[[Ve,h],[Ne,a],[De,o],[We,s],[ue,u],[ce,d]];let f=0,b=0,F=e.length,T=0,R=!1,L=F,k=Math.max(0,i-l),v=0,S=0,x=0,E=0;e:for(;;){if(S>v||b>=F&&b>f){const p=e.slice(v,S)||e.slice(f,b);T=0;for(const _ of p.replaceAll(Ue,"")){const g=_.codePointAt(0)||0;if(Be(g)?E=m:Me(g)?E=d:E=h,x+E>k&&(L=Math.min(L,Math.max(v,f)+T)),x+E>i){R=!0;break e}T+=_.length,x+=E}v=S=0}if(b>=F)break e;for(let p=0,_=y.length;p<_;p++){const[g,C]=y[p];if(g.lastIndex=b,g.test(e)){if(T=g===ce?Pe(e.slice(b,g.lastIndex)):g===ue?1:g.lastIndex-b,E=T*C,x+E>k&&(L=Math.min(L,b+Math.floor((k-x)/C))),x+E>i){R=!0;break e}x+=E,v=f,S=b,b=f=g.lastIndex;continue e}}b+=1}return{width:R?k:x,index:R?L:F,truncated:R,ellipsed:R&&i>=l}},Ke={limit:1/0,ellipsis:"",ellipsisWidth:0},M=(e,t={})=>he(e,Ke,t).width,G="\x1B",me="\x9B",He=39,Q="\x07",de="[",ze="]",pe="m",ee=`${ze}8;;`,fe=new RegExp(`(?:\\${de}(?<code>\\d+)m|\\${ee}(?<uri>.*)${Q})`,"y"),ge=e=>{if(e>=30&&e<=37||e>=90&&e<=97)return 39;if(e>=40&&e<=47||e>=100&&e<=107)return 49;if(e===1||e===2)return 22;if(e===3)return 23;if(e===4)return 24;if(e===7)return 27;if(e===8)return 28;if(e===9)return 29;if(e===0)return 0},be=e=>`${G}${de}${e}${pe}`,ye=e=>`${G}${ee}${e}${Q}`,te=(e,t,r)=>{const i=t[Symbol.iterator]();let n=!1,l=!1,a=e.at(-1),o=a===void 0?0:M(a),s=i.next(),u=i.next(),m=0;for(;!s.done;){const h=s.value,d=M(h);o+d<=r?e[e.length-1]+=h:(e.push(h),o=0),(h===G||h===me)&&(n=!0,l=t.startsWith(ee,m+1)),n?l?h===Q&&(n=!1,l=!1):h===pe&&(n=!1):(o+=d,o===r&&!u.done&&(e.push(""),o=0)),s=u,u=i.next(),m+=h.length}a=e.at(-1),!o&&a!==void 0&&a.length&&e.length>1&&(e[e.length-2]+=e.pop())},Je=e=>{const t=e.split(" ");let r=t.length;for(;r&&!M(t[r-1]);)r--;return r===t.length?e:t.slice(0,r).join(" ")+t.slice(r).join("")},Ye=(e,t,r={})=>{if(r.trim!==!1&&e.trim()==="")return"";let i="",n,l;const a=e.split(" ");let o=[""],s=0;for(let h=0;h<a.length;h++){const d=a[h];if(r.trim!==!1){const f=o.at(-1)??"",b=f.trimStart();f.length!==b.length&&(o[o.length-1]=b,s=M(b))}h!==0&&(s>=t&&(r.wordWrap===!1||r.trim===!1)&&(o.push(""),s=0),(s||r.trim===!1)&&(o[o.length-1]+=" ",s++));const y=M(d);if(r.hard&&y>t){const f=t-s,b=1+Math.floor((y-f-1)/t);Math.floor((y-1)/t)<b&&o.push(""),te(o,d,t),s=M(o.at(-1)??"");continue}if(s+y>t&&s&&y){if(r.wordWrap===!1&&s<t){te(o,d,t),s=M(o.at(-1)??"");continue}o.push(""),s=0}if(s+y>t&&r.wordWrap===!1){te(o,d,t),s=M(o.at(-1)??"");continue}o[o.length-1]+=d,s+=y}r.trim!==!1&&(o=o.map(h=>Je(h)));const u=o.join(`
-`);let m=!1;for(let h=0;h<u.length;h++){const d=u[h];if(i+=d,m)m=!1;else if(m=d>="\uD800"&&d<="\uDBFF",m)continue;if(d===G||d===me){fe.lastIndex=h+1;const f=fe.exec(u)?.groups;if(f?.code!==void 0){const b=Number.parseFloat(f.code);n=b===He?void 0:b}else f?.uri!==void 0&&(l=f.uri.length===0?void 0:f.uri)}if(u[h+1]===`
-`){l&&(i+=ye(""));const y=n?ge(n):void 0;n&&y&&(i+=be(y))}else d===`
-`&&(n&&ge(n)&&(i+=be(n)),l&&(i+=ye(l)))}return i},qe=/\r?\n/;function K(e,t,r){return String(e).normalize().split(qe).map(i=>Ye(i,t,r)).join(`
-`)}function Xe(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var re,$e;function Ze(){if($e)return re;$e=1;const e="\x1B",t=`${e}[`,r="\x07",i={to(a,o){return o?`${t}${o+1};${a+1}H`:`${t}${a+1}G`},move(a,o){let s="";return a<0?s+=`${t}${-a}D`:a>0&&(s+=`${t}${a}C`),o<0?s+=`${t}${-o}A`:o>0&&(s+=`${t}${o}B`),s},up:(a=1)=>`${t}${a}A`,down:(a=1)=>`${t}${a}B`,forward:(a=1)=>`${t}${a}C`,backward:(a=1)=>`${t}${a}D`,nextLine:(a=1)=>`${t}E`.repeat(a),prevLine:(a=1)=>`${t}F`.repeat(a),left:`${t}G`,hide:`${t}?25l`,show:`${t}?25h`,save:`${e}7`,restore:`${e}8`},n={up:(a=1)=>`${t}S`.repeat(a),down:(a=1)=>`${t}T`.repeat(a)},l={screen:`${t}2J`,up:(a=1)=>`${t}1J`.repeat(a),down:(a=1)=>`${t}J`.repeat(a),line:`${t}2K`,lineEnd:`${t}K`,lineStart:`${t}1K`,lines(a){let o="";for(let s=0;s<a;s++)o+=this.line+(s<a-1?i.up():"");return a&&(o+=i.left),o}};return re={cursor:i,scroll:n,erase:l,beep:r},re}var P=Ze();function H(e,t,r){if(!r.some(a=>!a.disabled))return e;const i=e+t,n=Math.max(r.length-1,0),l=i<0?n:i>n?0:i;return r[l]?.disabled?H(l,t<0?-1:1,r):l}const Qe=["up","down","left","right","space","enter","cancel"],N={actions:new Set(Qe),aliases:new Map([["k","up"],["j","down"],["h","left"],["l","right"],["","cancel"],["escape","cancel"]]),withGuide:!0};function et(e){if(e!==void 0)return e;const t=process.env.ACCESSIBLE;return t!==void 0&&t!==""&&t!=="0"&&t!=="false"}function xe(e,t){if(typeof e=="string")return N.aliases.get(e)===t;for(const r of e)if(r!==void 0&&xe(r,t))return!0;return!1}function tt(e,t){if(e===t)return;const r=e.split(`
+import{styleText as u}from"node:util";import L,{stdin as Ue,stdout as ye}from"node:process";import Ge from"node:readline";import"node:tty";import y from"node:fs";import b from"node:path";import Ke from"node:os";import{fileURLToPath as He}from"node:url";const ze=(()=>{const e=/[\uD800-\uDBFF][\uDC00-\uDFFF]/g;return t=>{let r=0;for(e.lastIndex=0;e.test(t);)r+=1;return t.length-r}})(),Je=e=>e===12288||e>=65281&&e<=65376||e>=65504&&e<=65510,Ye=e=>e===8987||e===9001||e>=12272&&e<=12287||e>=12289&&e<=12350||e>=12441&&e<=12543||e>=12549&&e<=12591||e>=12593&&e<=12686||e>=12688&&e<=12771||e>=12783&&e<=12830||e>=12832&&e<=12871||e>=12880&&e<=19903||e>=65040&&e<=65049||e>=65072&&e<=65106||e>=65108&&e<=65126||e>=65128&&e<=65131||e>=127488&&e<=127490||e>=127504&&e<=127547||e>=127552&&e<=127560||e>=131072&&e<=196605||e>=196608&&e<=262141,qe=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y,Xe=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y,$e=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu,Qe=/\t{1,1000}/y,we=new RegExp("[\\u{1F1E6}-\\u{1F1FF}]{2}|\\u{1F3F4}[\\u{E0061}-\\u{E007A}]{2}[\\u{E0030}-\\u{E0039}\\u{E0061}-\\u{E007A}]{1,3}\\u{E007F}|(?:\\p{Emoji}\\uFE0F\\u20E3?|\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation})(?:\\u200D(?:\\p{Emoji_Modifier_Base}\\p{Emoji_Modifier}?|\\p{Emoji_Presentation}|\\p{Emoji}\\uFE0F\\u20E3?))*","yu"),Ze=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y,et=new RegExp("\\p{M}+","gu"),tt={limit:1/0,ellipsis:""},xe=(e,t={},r={})=>{const i=t.limit??1/0,n=t.ellipsis??"",o=t?.ellipsisWidth??(n?xe(n,tt,r).width:0),l=0,a=r.controlWidth??0,s=r.tabWidth??8,c=r.emojiWidth??2,d=2,h=r.regularWidth??1,m=r.wideWidth??d,f=[[Ze,h],[qe,l],[Xe,a],[Qe,s],[we,c],[$e,m]];let g=0,w=0,_=e.length,F=0,j=!1,M=_,O=Math.max(0,i-o),v=0,C=0,$=0,I=0;e:for(;;){if(C>v||w>=_&&w>g){const R=e.slice(v,C)||e.slice(g,w);F=0;for(const D of R.replaceAll(et,"")){const A=D.codePointAt(0)||0;if(Je(A)?I=d:Ye(A)?I=m:I=h,$+I>O&&(M=Math.min(M,Math.max(v,g)+F)),$+I>i){j=!0;break e}F+=D.length,$+=I}v=C=0}if(w>=_)break e;for(let R=0,D=f.length;R<D;R++){const[A,H]=f[R];if(A.lastIndex=w,A.test(e)){if(F=A===$e?ze(e.slice(w,A.lastIndex)):A===we?1:A.lastIndex-w,I=F*H,$+I>O&&(M=Math.min(M,w+Math.floor((O-$)/H))),$+I>i){j=!0;break e}$+=I,v=g,C=w,w=g=A.lastIndex;continue e}}w+=1}return{width:j?O:$,index:j?M:_,truncated:j,ellipsed:j&&i>=o}},rt={limit:1/0,ellipsis:"",ellipsisWidth:0},W=(e,t={})=>xe(e,rt,t).width,Z="\x1B",ve="\x9B",it=39,ce="\x07",Se="[",st="]",Ee="m",ue=`${st}8;;`,_e=new RegExp(`(?:\\${Se}(?<code>\\d+)m|\\${ue}(?<uri>.*)${ce})`,"y"),Ie=e=>{if(e>=30&&e<=37||e>=90&&e<=97)return 39;if(e>=40&&e<=47||e>=100&&e<=107)return 49;if(e===1||e===2)return 22;if(e===3)return 23;if(e===4)return 24;if(e===7)return 27;if(e===8)return 28;if(e===9)return 29;if(e===0)return 0},Fe=e=>`${Z}${Se}${e}${Ee}`,Ce=e=>`${Z}${ue}${e}${ce}`,he=(e,t,r)=>{const i=t[Symbol.iterator]();let n=!1,o=!1,l=e.at(-1),a=l===void 0?0:W(l),s=i.next(),c=i.next(),d=0;for(;!s.done;){const h=s.value,m=W(h);a+m<=r?e[e.length-1]+=h:(e.push(h),a=0),(h===Z||h===ve)&&(n=!0,o=t.startsWith(ue,d+1)),n?o?h===ce&&(n=!1,o=!1):h===Ee&&(n=!1):(a+=m,a===r&&!c.done&&(e.push(""),a=0)),s=c,c=i.next(),d+=h.length}l=e.at(-1),!a&&l!==void 0&&l.length&&e.length>1&&(e[e.length-2]+=e.pop())},nt=e=>{const t=e.split(" ");let r=t.length;for(;r&&!W(t[r-1]);)r--;return r===t.length?e:t.slice(0,r).join(" ")+t.slice(r).join("")},at=(e,t,r={})=>{if(r.trim!==!1&&e.trim()==="")return"";let i="",n,o;const l=e.split(" ");let a=[""],s=0;for(let h=0;h<l.length;h++){const m=l[h];if(r.trim!==!1){const g=a.at(-1)??"",w=g.trimStart();g.length!==w.length&&(a[a.length-1]=w,s=W(w))}h!==0&&(s>=t&&(r.wordWrap===!1||r.trim===!1)&&(a.push(""),s=0),(s||r.trim===!1)&&(a[a.length-1]+=" ",s++));const f=W(m);if(r.hard&&f>t){const g=t-s,w=1+Math.floor((f-g-1)/t);Math.floor((f-1)/t)<w&&a.push(""),he(a,m,t),s=W(a.at(-1)??"");continue}if(s+f>t&&s&&f){if(r.wordWrap===!1&&s<t){he(a,m,t),s=W(a.at(-1)??"");continue}a.push(""),s=0}if(s+f>t&&r.wordWrap===!1){he(a,m,t),s=W(a.at(-1)??"");continue}a[a.length-1]+=m,s+=f}r.trim!==!1&&(a=a.map(h=>nt(h)));const c=a.join(`
+`);let d=!1;for(let h=0;h<c.length;h++){const m=c[h];if(i+=m,d)d=!1;else if(d=m>="\uD800"&&m<="\uDBFF",d)continue;if(m===Z||m===ve){_e.lastIndex=h+1;const g=_e.exec(c)?.groups;if(g?.code!==void 0){const w=Number.parseFloat(g.code);n=w===it?void 0:w}else g?.uri!==void 0&&(o=g.uri.length===0?void 0:g.uri)}if(c[h+1]===`
+`){o&&(i+=Ce(""));const f=n?Ie(n):void 0;n&&f&&(i+=Fe(f))}else m===`
+`&&(n&&Ie(n)&&(i+=Fe(n)),o&&(i+=Ce(o)))}return i},ot=/\r?\n/;function ee(e,t,r){return String(e).normalize().split(ot).map(i=>at(i,t,r)).join(`
+`)}const me="\x1B",S=`${me}[`,V={to(e,t){return t?`${S}${t+1};${e+1}H`:`${S}${e+1}G`},move(e,t){let r="";return e<0?r+=`${S}${-e}D`:e>0&&(r+=`${S}${e}C`),t<0?r+=`${S}${-t}A`:t>0&&(r+=`${S}${t}B`),r},up:(e=1)=>`${S}${e}A`,down:(e=1)=>`${S}${e}B`,forward:(e=1)=>`${S}${e}C`,backward:(e=1)=>`${S}${e}D`,nextLine:(e=1)=>`${S}E`.repeat(e),prevLine:(e=1)=>`${S}F`.repeat(e),left:`${S}G`,hide:`${S}?25l`,show:`${S}?25h`,save:`${me}7`,restore:`${me}8`},de={screen:`${S}2J`,up:(e=1)=>`${S}1J`.repeat(e),down:(e=1)=>`${S}J`.repeat(e),line:`${S}2K`,lineEnd:`${S}K`,lineStart:`${S}1K`,lines(e){let t="";for(let r=0;r<e;r++)t+=this.line+(r<e-1?V.up():"");return e&&(t+=V.left),t}};function te(e,t,r){if(!r.some(l=>!l.disabled))return e;const i=e+t,n=Math.max(r.length-1,0),o=i<0?n:i>n?0:i;return r[o]?.disabled?te(o,t<0?-1:1,r):o}const lt=["up","down","left","right","space","enter","cancel"],U={actions:new Set(lt),aliases:new Map([["k","up"],["j","down"],["h","left"],["l","right"],["","cancel"],["escape","cancel"]]),withGuide:!0};function ct(e){if(e!==void 0)return e;const t=process.env.ACCESSIBLE;return t!==void 0&&t!==""&&t!=="0"&&t!=="false"}function ke(e,t){if(typeof e=="string")return U.aliases.get(e)===t;for(const r of e)if(r!==void 0&&ke(r,t))return!0;return!1}function ut(e,t){if(e===t)return;const r=e.split(`
 `),i=t.split(`
-`),n=Math.max(r.length,i.length),l=[];for(let a=0;a<n;a++)r[a]!==i[a]&&l.push(a);return{lines:l,numLinesBefore:r.length,numLinesAfter:i.length,numLines:n}}globalThis.process.platform.startsWith("win");const se=Symbol("clack:cancel");function V(e){return e===se}function z(e,t){const r=e;r.isTTY&&r.setRawMode(t)}const we=e=>"columns"in e&&typeof e.columns=="number"?e.columns:80,ve=e=>"rows"in e&&typeof e.rows=="number"?e.rows:20;function ie(e,t,r,i=r,n=r,l){const a=we(e??le);return K(t,a-r.length,{hard:!0,trim:!1}).split(`
-`).map((o,s,u)=>{const m=o;return s===0?`${i}${m}`:s===u.length-1?`${n}${m}`:`${r}${m}`}).join(`
-`)}function rt(e,t){if("~standard"in e){const r=e["~standard"].validate(t);return r instanceof Promise?r.then(i=>i.issues?.at(0)?.message):r.issues?.at(0)?.message}return e(t)}class Se{input;output;_abortSignal;rl;opts;_render;_track=!1;_prevFrame="";_subscribers=new Map;_cursor=0;state="initial";error="";value;userInput="";get accessible(){return et(this.opts.accessible)}constructor(t,r=!0){const{input:i=je,output:n=le,render:l,signal:a,...o}=t;this.opts=o,this.onKeypress=this.onKeypress.bind(this),this.close=this.close.bind(this),this.render=this.render.bind(this),this._render=l.bind(this),this._track=r,this._abortSignal=a,this.input=i,this.output=n}unsubscribe(){this._subscribers.clear()}setSubscriber(t,r){const i=this._subscribers.get(t)??[];i.push(r),this._subscribers.set(t,i)}on(t,r){this.setSubscriber(t,{cb:r})}once(t,r){this.setSubscriber(t,{cb:r,once:!0})}emit(t,...r){const i=this._subscribers.get(t)??[],n=[];for(const l of i)l.cb(...r),l.once&&n.push(()=>i.splice(i.indexOf(l),1));for(const l of n)l()}prompt(){return new Promise(t=>{if(this._abortSignal){if(this._abortSignal.aborted)return this.state="cancel",this.close(),t(se);this._abortSignal.addEventListener("abort",()=>{this.state="cancel",this.close()},{once:!0})}this.rl=Oe.createInterface({input:this.input,tabSize:2,prompt:"",escapeCodeTimeout:50,terminal:!0}),this.rl.prompt(),this.opts.initialUserInput!==void 0&&this._setUserInput(this.opts.initialUserInput,!0),this.input.on("keypress",this.onKeypress),z(this.input,!0),this.output.on("resize",this.render),this.render(),this.once("submit",()=>{this.output.write(P.cursor.show),this.output.off("resize",this.render),z(this.input,!1),t(this.value)}),this.once("cancel",()=>{this.output.write(P.cursor.show),this.output.off("resize",this.render),z(this.input,!1),t(se)})})}_isActionKey(t,r){return t==="	"}_shouldSubmit(t,r){return!0}_setValue(t){this.value=t,this.emit("value",this.value)}_setUserInput(t,r){this.userInput=t??"",this.emit("userInput",this.userInput),r&&this._track&&this.rl&&(this.rl.write(this.userInput),this._cursor=this.rl.cursor)}_clearUserInput(){this.rl?.write(null,{ctrl:!0,name:"u"}),this._setUserInput("")}async onKeypress(t,r){if(this.state!=="validating"){if(this._track&&r.name!=="return"&&(r.name&&this._isActionKey(t,r)&&this.rl?.write(null,{ctrl:!0,name:"h"}),this._cursor=this.rl?.cursor??0,this._setUserInput(this.rl?.line)),this.state==="error"&&(this.state="active"),r?.name&&(!this._track&&N.aliases.has(r.name)&&this.emit("cursor",N.aliases.get(r.name)),N.actions.has(r.name)&&this.emit("cursor",r.name)),t&&(t.toLowerCase()==="y"||t.toLowerCase()==="n")&&this.emit("confirm",t.toLowerCase()==="y"),this.emit("key",t,r),r?.name==="return"&&this._shouldSubmit(t,r)){if(this.opts.validate){const i=rt(this.opts.validate,this.value);let n;i instanceof Promise?(this.state="validating",this.render(),n=await i):n=i,n&&(this.error=n instanceof Error?n.message:n,this.state="error",this.rl?.write(this.userInput))}this.state!=="error"&&(this.state="submit")}xe([t,r?.name,r?.sequence],"cancel")&&(this.state="cancel"),(this.state==="submit"||this.state==="cancel")&&this.emit("finalize"),this.render(),(this.state==="submit"||this.state==="cancel")&&this.close()}}close(){this.input.unpipe(),this.input.removeListener("keypress",this.onKeypress),this.output.write(`
-`),z(this.input,!1),this.rl?.close(),this.rl=void 0,this.emit(`${this.state}`,this.value),this.unsubscribe()}restoreCursor(){const t=K(this._prevFrame,process.stdout.columns,{hard:!0,trim:!1}).split(`
-`).length-1;this.output.write(P.cursor.move(-999,t*-1))}render(){const t=K(this._render(this)??"",process.stdout.columns,{hard:!0,trim:!1});if(t!==this._prevFrame){if(this.state==="initial")this.output.write(P.cursor.hide);else{const r=tt(this._prevFrame,t),i=ve(this.output);if(this.restoreCursor(),r){const n=Math.max(0,r.numLinesAfter-i),l=Math.max(0,r.numLinesBefore-i);let a=r.lines.find(o=>o>=n);if(a===void 0){this._prevFrame=t;return}if(r.lines.length===1){this.output.write(P.cursor.move(0,a-l)),this.output.write(P.erase.lines(1));const o=t.split(`
-`);this.output.write(o[a]),this._prevFrame=t,this.output.write(P.cursor.move(0,o.length-a-1));return}else if(r.lines.length>1){if(n<l)a=n;else{const s=a-l;s>0&&this.output.write(P.cursor.move(0,s))}this.output.write(P.erase.down());const o=t.split(`
-`).slice(a);this.output.write(o.join(`
-`)),this._prevFrame=t;return}}this.output.write(P.erase.down())}this.output.write(t),this.state==="initial"&&(this.state="active"),this._prevFrame=t}}}let st=class extends Se{options;cursor=0;get _selectedValue(){return this.options[this.cursor]}changeValue(){const t=this._selectedValue;this.value=t===void 0?void 0:t.value}constructor(t){super(t,!1),this.options=t.options;const r=this.options.findIndex(({value:n})=>n===t.initialValue),i=r===-1?0:r;this.cursor=this.options[i]?.disabled?H(i,1,this.options):i,this.changeValue(),this.on("cursor",n=>{switch(n){case"left":case"up":this.cursor=H(this.cursor,-1,this.options);break;case"down":case"right":this.cursor=H(this.cursor,1,this.options);break}this.changeValue()})}};class it extends Se{get userInputWithCursor(){if(this.state==="submit")return this.userInput;const t=this.userInput;if(this.cursor>=t.length)return`${this.userInput}\u2588`;const r=t.slice(0,this.cursor),i=t.slice(this.cursor,this.cursor+1),n=t.slice(this.cursor+1);return`${r}${c("inverse",i)}${n}`}get cursor(){return this._cursor}constructor(t){super({...t,initialUserInput:t.initialUserInput??t.initialValue}),this.on("userInput",r=>{this._setValue(r)}),this.on("finalize",()=>{this.value||(this.value=t.defaultValue),this.value===void 0&&(this.value="")})}}function nt(){return j.platform!=="win32"?j.env.TERM!=="linux":!!j.env.CI||!!j.env.WT_SESSION||!!j.env.TERMINUS_SUBLIME||j.env.ConEmuTask==="{cmd::Cmder}"||j.env.TERM_PROGRAM==="Terminus-Sublime"||j.env.TERM_PROGRAM==="vscode"||j.env.TERM==="xterm-256color"||j.env.TERM==="alacritty"||j.env.TERMINAL_EMULATOR==="JetBrains-JediTerm"}const at=nt(),A=(e,t)=>at?e:t,Ee=A("\u25C6","*"),ot=A("\u25A0","x"),lt=A("\u25B2","x"),_e=A("\u25C7","o"),I=A("\u2502","|"),D=A("\u2514","\u2014"),ct=A("\u25CF",">"),Ie=A("\u25CB"," "),ut=A("\u25CF","\u2022"),ht=A("\u25C6","*"),mt=A("\u25B2","!"),dt=A("\u25A0","x"),Fe=e=>{switch(e){case"initial":case"active":return c("cyan",Ee);case"cancel":return c("red",ot);case"error":return c("yellow",lt);case"submit":return c("green",_e);case"validating":return c("dim",Ee)}},pt=e=>{switch(e){case"initial":case"active":return c("cyan",I);case"cancel":return c("red",I);case"error":return c("yellow",I);case"submit":return c("green",I)}};function ft(e,t){const r=[`${t?`${c("cyan",I)}  `:""}${e.join(" \u2022 ")}`];return t&&r.push(c("cyan",D)),r}const Ce=(e,t,r,i,n,l=!1)=>{let a=t,o=0;if(l)for(let s=i-1;s>=r;s--){const u=e[s];if(u&&(a-=u.length),o++,a<=n)break}else for(let s=r;s<i;s++){const u=e[s];if(u&&(a-=u.length),o++,a<=n)break}return{lineCount:a,removals:o}},gt=({cursor:e,options:t,style:r,output:i=process.stdout,maxItems:n=Number.POSITIVE_INFINITY,columnPadding:l=0,rowPadding:a=4})=>{const o=we(i)-l,s=ve(i),u=c("dim","..."),m=Math.max(s-a,0),h=Math.max(Math.min(n,m),5);let d=0;e>=h-3&&(d=Math.max(Math.min(e-h+3,t.length-h),0));let y=h<t.length&&d>0,f=h<t.length&&d+h<t.length;const b=Math.min(d+h,t.length),F=[];let T=0;y&&T++,f&&T++;const R=d+(y?1:0),L=b-(f?1:0);for(let v=R;v<L;v++){const S=t[v],x=S?r(S,v===e):"",E=K(x,o,{hard:!0,trim:!1}).split(`
-`);F.push(E),T+=E.length}if(T>m){let v=0,S=0,x=T;const E=e-R;let p=m;const _=()=>Ce(F,x,0,E,p),g=()=>Ce(F,x,E+1,F.length,p,!0);y?({lineCount:x,removals:v}=_(),x>p&&(f||(p-=1),{lineCount:x,removals:S}=g())):(f||(p-=1),{lineCount:x,removals:S}=g(),x>p&&(p-=1,{lineCount:x,removals:v}=_())),v>0&&(y=!0,F.splice(0,v)),S>0&&(f=!0,F.splice(F.length-S,S))}const k=[];y&&k.push(u);for(const v of F)for(const S of v)k.push(S);return f&&k.push(u),k};`${c("dim","\u2191/\u2193")}`,`${c("dim","Space:")}`,`${c("dim","Enter:")}`;const B={message:(e=[],{symbol:t=c("gray",I),secondarySymbol:r=c("gray",I),output:i=process.stdout,spacing:n=1,withGuide:l}={})=>{const a=[],o=l??N.withGuide,s=o?r:"",u=o?`${t}  `:"",m=o?`${r}  `:"";for(let d=0;d<n;d++)a.push(s);const h=Array.isArray(e)?e:e.split(`
-`);if(h.length>0){const[d,...y]=h;d.length>0?a.push(`${u}${d}`):a.push(o?t:"");for(const f of y)f.length>0?a.push(`${m}${f}`):a.push(o?r:"")}i.write(`${a.join(`
+`),n=Math.max(r.length,i.length),o=[];for(let l=0;l<n;l++)r[l]!==i[l]&&o.push(l);return{lines:o,numLinesBefore:r.length,numLinesAfter:i.length,numLines:n}}globalThis.process.platform.startsWith("win");const pe=Symbol("clack:cancel");function Y(e){return e===pe}function re(e,t){const r=e;r.isTTY&&r.setRawMode(t)}const ie=e=>"columns"in e&&typeof e.columns=="number"?e.columns:80,Te=e=>"rows"in e&&typeof e.rows=="number"?e.rows:20;function se(e,t,r,i=r,n=r,o){const l=ie(e??ye),a=W(r);return ee(t,l-a,{hard:!0,trim:!1}).split(`
+`).map((s,c,d)=>{const h=s;return c===0?`${i}${h}`:c===d.length-1?`${n}${h}`:`${r}${h}`}).join(`
+`)}function ht(e,t){if("~standard"in e){const r=e["~standard"].validate(t);return r instanceof Promise?r.then(i=>i.issues?.at(0)?.message):r.issues?.at(0)?.message}return e(t)}let Re=class{input;output;_abortSignal;rl;opts;_render;_track=!1;_prevFrame="";_subscribers=new Map;_cursor=0;state="initial";error="";value;userInput="";get accessible(){return ct(this.opts.accessible)}constructor(t,r=!0){const{input:i=Ue,output:n=ye,render:o,signal:l,...a}=t;this.opts=a,this.onKeypress=this.onKeypress.bind(this),this.close=this.close.bind(this),this.render=this.render.bind(this),this._render=o.bind(this),this._track=r,this._abortSignal=l,this.input=i,this.output=n}unsubscribe(){this._subscribers.clear()}setSubscriber(t,r){const i=this._subscribers.get(t)??[];i.push(r),this._subscribers.set(t,i)}on(t,r){this.setSubscriber(t,{cb:r})}once(t,r){this.setSubscriber(t,{cb:r,once:!0})}emit(t,...r){const i=this._subscribers.get(t)??[],n=[];for(const o of i)o.cb(...r),o.once&&n.push(()=>i.splice(i.indexOf(o),1));for(const o of n)o()}prompt(){return new Promise(t=>{if(this._abortSignal){if(this._abortSignal.aborted)return this.state="cancel",this.close(),t(pe);this._abortSignal.addEventListener("abort",()=>{this.state="cancel",this.close()},{once:!0})}this.rl=Ge.createInterface({input:this.input,tabSize:2,prompt:"",escapeCodeTimeout:50,terminal:!0}),this.rl.prompt(),this.opts.initialUserInput!==void 0&&this._setUserInput(this.opts.initialUserInput,!0),this.input.on("keypress",this.onKeypress),re(this.input,!0),this.output.on("resize",this.render),this.render(),this.once("submit",()=>{this.output.write(V.show),this.output.off("resize",this.render),re(this.input,!1),t(this.value)}),this.once("cancel",()=>{this.output.write(V.show),this.output.off("resize",this.render),re(this.input,!1),t(pe)})})}_isActionKey(t,r){return t==="	"}_shouldSubmit(t,r){return!0}_setValue(t){this.value=t,this.emit("value",this.value)}_setUserInput(t,r){this.userInput=t??"",this.emit("userInput",this.userInput),r&&this._track&&this.rl&&(this.rl.write(this.userInput),this._cursor=this.rl.cursor)}_clearUserInput(){this.rl?.write(null,{ctrl:!0,name:"u"}),this._setUserInput("")}async onKeypress(t,r){if(this.state!=="validating"){if(this._track&&r.name!=="return"&&(r.name&&this._isActionKey(t,r)&&this.rl?.write(null,{ctrl:!0,name:"h"}),this._cursor=this.rl?.cursor??0,this._setUserInput(this.rl?.line)),this.state==="error"&&(this.state="active"),r?.name&&(!this._track&&U.aliases.has(r.name)&&this.emit("cursor",U.aliases.get(r.name)),U.actions.has(r.name)&&this.emit("cursor",r.name)),t&&(t.toLowerCase()==="y"||t.toLowerCase()==="n")&&this.emit("confirm",t.toLowerCase()==="y"),this.emit("key",t,r),r?.name==="return"&&this._shouldSubmit(t,r)){if(this.opts.validate){const i=ht(this.opts.validate,this.value);let n;i instanceof Promise?(this.state="validating",this.render(),n=await i):n=i,n&&(this.error=n instanceof Error?n.message:n,this.state="error",this.rl?.write(this.userInput))}this.state!=="error"&&(this.state="submit")}ke([t,r?.name,r?.sequence],"cancel")&&(this.state="cancel"),(this.state==="submit"||this.state==="cancel")&&this.emit("finalize"),this.render(),(this.state==="submit"||this.state==="cancel")&&this.close()}}close(){this.input.unpipe(),this.input.removeListener("keypress",this.onKeypress),this.output.write(`
+`),re(this.input,!1),this.rl?.close(),this.rl=void 0,this.emit(`${this.state}`,this.value),this.unsubscribe()}restoreCursor(){const t=ee(this._prevFrame,ie(this.output),{hard:!0,trim:!1}).split(`
+`).length-1;this.output.write(V.move(-999,t*-1))}render(){const t=ee(this._render(this)??"",ie(this.output),{hard:!0,trim:!1});if(t!==this._prevFrame){if(this.state==="initial")this.output.write(V.hide);else{const r=ut(this._prevFrame,t),i=Te(this.output);if(this.restoreCursor(),r){const n=Math.max(0,r.numLinesAfter-i),o=Math.max(0,r.numLinesBefore-i);let l=r.lines.find(a=>a>=n);if(l===void 0){this._prevFrame=t;return}if(r.lines.length===1){this.output.write(V.move(0,l-o)),this.output.write(de.lines(1));const a=t.split(`
+`);this.output.write(a[l]),this._prevFrame=t,this.output.write(V.move(0,a.length-l-1));return}else if(r.lines.length>1){if(n<o)l=n;else{const s=l-o;s>0&&this.output.write(V.move(0,s))}this.output.write(de.down());const a=t.split(`
+`).slice(l);this.output.write(a.join(`
+`)),this._prevFrame=t;return}}this.output.write(de.down())}this.output.write(t),this.state==="initial"&&(this.state="active"),this._prevFrame=t}}},mt=class extends Re{options;cursor=0;get _selectedValue(){return this.options[this.cursor]}changeValue(){const t=this._selectedValue;this.value=t===void 0?void 0:t.value}constructor(t){super(t,!1),this.options=t.options;const r=this.options.findIndex(({value:n})=>n===t.initialValue),i=r===-1?0:r;this.cursor=this.options[i]?.disabled?te(i,1,this.options):i,this.changeValue(),this.on("cursor",n=>{switch(n){case"left":case"up":this.cursor=te(this.cursor,-1,this.options);break;case"down":case"right":this.cursor=te(this.cursor,1,this.options);break}this.changeValue()})}};class dt extends Re{get userInputWithCursor(){if(this.state==="submit")return this.userInput;const t=this.userInput;if(this.cursor>=t.length)return`${this.userInput}\u2588`;const r=t.slice(0,this.cursor),i=t.slice(this.cursor,this.cursor+1),n=t.slice(this.cursor+1);return`${r}${u("inverse",i)}${n}`}get cursor(){return this._cursor}constructor(t){super({...t,initialUserInput:t.initialUserInput??t.initialValue}),this.on("userInput",r=>{this._setValue(r)}),this.on("finalize",()=>{this.value||(this.value=t.defaultValue),this.value===void 0&&(this.value="")})}}function pt(){return L.platform!=="win32"?L.env.TERM!=="linux":!!L.env.CI||!!L.env.WT_SESSION||!!L.env.TERMINUS_SUBLIME||L.env.ConEmuTask==="{cmd::Cmder}"||L.env.TERM_PROGRAM==="Terminus-Sublime"||L.env.TERM_PROGRAM==="vscode"||L.env.TERM==="xterm-256color"||L.env.TERM==="alacritty"||L.env.TERMINAL_EMULATOR==="JetBrains-JediTerm"}const ft=pt(),P=(e,t)=>ft?e:t,je=P("\u25C6","*"),gt=P("\u25A0","x"),bt=P("\u25B2","x"),Ae=P("\u25C7","o"),E=P("\u2502","|"),G=P("\u2514","\u2014"),yt=P("\u25CF",">"),Oe=P("\u25CB"," "),$t=P("\u25CF","\u2022"),wt=P("\u25C6","*"),xt=P("\u25B2","!"),vt=P("\u25A0","x"),Pe=e=>{switch(e){case"initial":case"active":return u("cyan",je);case"cancel":return u("red",gt);case"error":return u("yellow",bt);case"submit":return u("green",Ae);case"validating":return u("dim",je)}},St=e=>{switch(e){case"initial":case"active":return u("cyan",E);case"cancel":return u("red",E);case"error":return u("yellow",E);case"submit":return u("green",E)}};function Et(e,t,r){const i=r?`${u("cyan",E)}  `:"",n=se(e,t.join(" \u2022 "),i).split(`
+`);return r&&n.push(u("cyan",G)),n}const Be=(e,t,r,i,n,o=!1)=>{let l=t,a=0;if(o)for(let s=i-1;s>=r;s--){const c=e[s];if(c&&(l-=c.length),a++,l<=n)break}else for(let s=r;s<i;s++){const c=e[s];if(c&&(l-=c.length),a++,l<=n)break}return{lineCount:l,removals:a}},_t=({cursor:e,options:t,style:r,output:i=process.stdout,maxItems:n=Number.POSITIVE_INFINITY,columnPadding:o=0,rowPadding:l=4})=>{const a=ie(i)-o,s=Te(i),c=u("dim","..."),d=Math.max(s-l,0),h=Math.max(Math.min(n,d),5);let m=0;e>=h-3&&(m=Math.max(Math.min(e-h+3,t.length-h),0));let f=h<t.length&&m>0,g=h<t.length&&m+h<t.length;const w=Math.min(m+h,t.length),_=[];let F=0;f&&F++,g&&F++;const j=m+(f?1:0),M=w-(g?1:0);for(let v=j;v<M;v++){const C=t[v],$=C!==void 0?r(C,v===e):"",I=ee($,a,{hard:!0,trim:!1}).split(`
+`);_.push(I),F+=I.length}if(F>d){let v=0,C=0,$=F;const I=e-j;let R=d;const D=()=>Be(_,$,0,I,R),A=()=>Be(_,$,I+1,_.length,R,!0);f?({lineCount:$,removals:v}=D(),$>R&&(g||(R-=1),{lineCount:$,removals:C}=A())):(g||(R-=1),{lineCount:$,removals:C}=A(),$>R&&(R-=1,{lineCount:$,removals:v}=D())),v>0&&(f=!0,_.splice(0,v)),C>0&&(g=!0,_.splice(_.length-C,C))}const O=[];f&&O.push(c);for(const v of _)for(const C of v)O.push(C);return g&&O.push(c),O};`${u("dim","\u2191/\u2193")}`,`${u("dim","Space:")}`,`${u("dim","Enter:")}`;const N={message:(e=[],{symbol:t=u("gray",E),secondarySymbol:r=u("gray",E),output:i=process.stdout,spacing:n=1,withGuide:o}={})=>{const l=[],a=o??U.withGuide,s=a?r:"",c=a?`${t}  `:"",d=a?`${r}  `:"";for(let m=0;m<n;m++)l.push(s);const h=Array.isArray(e)?e:e.split(`
+`);if(h.length>0){const[m,...f]=h;m.length>0?l.push(`${c}${m}`):l.push(a?t:"");for(const g of f)g.length>0?l.push(`${d}${g}`):l.push(a?r:"")}i.write(`${l.join(`
 `)}
-`)},info:(e,t)=>{B.message(e,{...t,symbol:c("blue",ut)})},success:(e,t)=>{B.message(e,{...t,symbol:c("green",ht)})},step:(e,t)=>{B.message(e,{...t,symbol:c("green",_e)})},warn:(e,t)=>{B.message(e,{...t,symbol:c("yellow",mt)})},warning:(e,t)=>{B.warn(e,t)},error:(e,t)=>{B.message(e,{...t,symbol:c("red",dt)})}},bt=(e="",t)=>{const r=process.stdout,i=`${c("gray",D)}  `;r.write(`${i}${c("red",e)}
+`)},info:(e,t)=>{N.message(e,{...t,symbol:u("blue",$t)})},success:(e,t)=>{N.message(e,{...t,symbol:u("green",wt)})},step:(e,t)=>{N.message(e,{...t,symbol:u("green",Ae)})},warn:(e,t)=>{N.message(e,{...t,symbol:u("yellow",xt)})},warning:(e,t)=>{N.warn(e,t)},error:(e,t)=>{N.message(e,{...t,symbol:u("red",vt)})}},It=(e="",t)=>{const r=process.stdout,i=`${u("gray",G)}  `;r.write(`${i}${u("red",e)}
 
-`)},yt=(e="",t)=>{const r=process.stdout,i=`${c("gray",I)}
-${c("gray",D)}  `;r.write(`${i}${e}
+`)},Ft=(e="",t)=>{const r=process.stdout,i=`${u("gray",E)}
+${u("gray",G)}  `;r.write(`${i}${e}
 
-`)},$t=[`${c("dim","\u2191/\u2193")} to navigate`,`${c("dim","Enter:")} confirm`],J=(e,t)=>e.includes(`
+`)},Ct=[`${u("dim","\u2191/\u2193")} to navigate`,`${u("dim","Enter:")} confirm`],ne=(e,t)=>e.includes(`
 `)?e.split(`
 `).map(r=>t(r)).join(`
-`):t(e),ne=e=>{const t=(i,n)=>{if(i===void 0)return"";const l=i.label??String(i.value);switch(n){case"disabled":return`${c("gray",Ie)} ${J(l,a=>c("gray",a))}${i.hint?` ${c("dim",`(${i.hint??"disabled"})`)}`:""}`;case"selected":return`${J(l,a=>c("dim",a))}`;case"active":return`${c("green",ct)} ${l}${i.hint?` ${c("dim",`(${i.hint})`)}`:""}`;case"cancelled":return`${J(l,a=>c(["strikethrough","dim"],a))}`;default:return`${c("dim",Ie)} ${J(l,a=>c("dim",a))}`}},r=e.showInstructions??!0;return new st({options:e.options,signal:e.signal,input:e.input,output:e.output,initialValue:e.initialValue,render(){const i=e.withGuide??N.withGuide,n=`${Fe(this.state)}  `,l=`${pt(this.state)}  `,a=ie(e.output,e.message,l,n),o=`${i?`${c("gray",I)}
-`:""}${a}
-`;switch(this.state){case"submit":{const s=i?`${c("gray",I)}  `:"",u=ie(e.output,t(this.options[this.cursor],"selected"),s);return`${o}${u}`}case"cancel":{const s=i?`${c("gray",I)}  `:"",u=ie(e.output,t(this.options[this.cursor],"cancelled"),s);return`${o}${u}${i?`
-${c("gray",I)}`:""}`}default:{const s=i?`${c("cyan",I)}  `:"",u=o.split(`
-`).length,m=r?ft($t,i):i?[c("cyan",D)]:[],h=m.join(`
-`),d=m.length+1;return`${o}${s}${gt({output:e.output,cursor:this.cursor,options:this.options,maxItems:e.maxItems,columnPadding:s.length,rowPadding:u+d,style:(y,f)=>t(y,y.disabled?"disabled":f?"active":"inactive")}).join(`
+`):t(e),fe=e=>{const t=(i,n)=>{if(i===void 0)return"";const o=i.label??String(i.value);switch(n){case"disabled":return`${u("gray",Oe)} ${ne(o,l=>u("gray",l))}${i.hint?` ${u("dim",`(${i.hint??"disabled"})`)}`:""}`;case"selected":return`${ne(o,l=>u("dim",l))}`;case"active":return`${u("green",yt)} ${o}${i.hint?` ${u("dim",`(${i.hint})`)}`:""}`;case"cancelled":return`${ne(o,l=>u(["strikethrough","dim"],l))}`;default:return`${u("dim",Oe)} ${ne(o,l=>u("dim",l))}`}},r=e.showInstructions??!0;return new mt({options:e.options,signal:e.signal,input:e.input,output:e.output,initialValue:e.initialValue,render(){const i=e.withGuide??U.withGuide,n=`${Pe(this.state)}  `,o=`${St(this.state)}  `,l=se(e.output,e.message,o,n),a=`${i?`${u("gray",E)}
+`:""}${l}
+`;switch(this.state){case"submit":{const s=i?`${u("gray",E)}  `:"",c=se(e.output,t(this.options[this.cursor],"selected"),s);return`${a}${c}`}case"cancel":{const s=i?`${u("gray",E)}  `:"",c=se(e.output,t(this.options[this.cursor],"cancelled"),s);return`${a}${c}${i?`
+${u("gray",E)}`:""}`}default:{const s=i?`${u("cyan",E)}  `:"",c=a.split(`
+`).length,d=r?Et(e.output,Ct,i):i?[u("cyan",G)]:[],h=d.join(`
+`),m=d.length+1;return`${a}${s}${_t({output:e.output,cursor:this.cursor,options:this.options,maxItems:e.maxItems,columnPadding:s.length,rowPadding:c+m,style:(f,g)=>t(f,f.disabled?"disabled":g?"active":"inactive")}).join(`
 ${s}`)}
 ${h}
-`}}}}).prompt()};`${c("gray",I)}`;const Te=e=>new it({validate:e.validate,placeholder:e.placeholder,defaultValue:e.defaultValue,initialValue:e.initialValue,output:e.output,signal:e.signal,input:e.input,render(){const t=e?.withGuide??N.withGuide,r=`${`${t?`${c("gray",I)}
-`:""}${Fe(this.state)}  `}${e.message}
-`,i=e.placeholder&&e.placeholder.length>0?c("inverse",e.placeholder[0])+c("dim",e.placeholder.slice(1)):c(["inverse","hidden"],"_"),n=this.userInput?this.userInputWithCursor:i,l=this.value??"";switch(this.state){case"validating":{const a=t?`${c("cyan",I)}  `:"",o=t?c("cyan",D):"",s=c("dim",n),u=c("dim","Validating...");return`${r}${a}${s}
-${o}  ${u}
-`}case"error":{const a=this.error?`  ${c("yellow",this.error)}`:"",o=t?`${c("yellow",I)}  `:"",s=t?c("yellow",D):"";return`${r.trim()}
-${o}${n}
-${s}${a}
-`}case"submit":{const a=l?`${t?"  ":""}${c("dim",l)}`:"",o=t?c("gray",I):"";return`${r}${o}${a}`}case"cancel":{const a=l?`  ${c(["strikethrough","dim"],l)}`:"",o=t?c("gray",I):"";return`${r}${o}${a}${l.trim()?`
-${o}`:""}`}default:{const a=t?`${c("cyan",I)}  `:"",o=t?c("cyan",D):"";return`${r}${a}${n}
-${o}
-`}}}}).prompt();function ae(e){return e==null?[]:Array.isArray(e)?e:[e]}function xt(e,t,r,i){var n,l=e[t],a=~i.string.indexOf(t)?r==null||r===!0?"":String(r):typeof r=="boolean"?r:~i.boolean.indexOf(t)?r==="false"?!1:r==="true"||(e._.push((n=+r,n*0===0?n:r)),!!r):(n=+r,n*0===0?n:r);e[t]=l==null?a:Array.isArray(l)?l.concat(a):[l,a]}function wt(e,t){e=e||[],t=t||{};var r,i,n,l,a,o={_:[]},s=0,u=0,m=0,h=e.length;const d=t.alias!==void 0,y=t.unknown!==void 0,f=t.default!==void 0;if(t.alias=t.alias||{},t.string=ae(t.string),t.boolean=ae(t.boolean),d)for(r in t.alias)for(i=t.alias[r]=ae(t.alias[r]),s=0;s<i.length;s++)(t.alias[i[s]]=i.concat(r)).splice(s,1);for(s=t.boolean.length;s-- >0;)for(i=t.alias[t.boolean[s]]||[],u=i.length;u-- >0;)t.boolean.push(i[u]);for(s=t.string.length;s-- >0;)for(i=t.alias[t.string[s]]||[],u=i.length;u-- >0;)t.string.push(i[u]);if(f){for(r in t.default)if(l=typeof t.default[r],i=t.alias[r]=t.alias[r]||[],t[l]!==void 0)for(t[l].push(r),s=0;s<i.length;s++)t[l].push(i[s])}const b=y?Object.keys(t.alias):[];for(s=0;s<h;s++){if(n=e[s],n==="--"){o._=o._.concat(e.slice(++s));break}for(u=0;u<n.length&&n.charCodeAt(u)===45;u++);if(u===0)o._.push(n);else if(n.substring(u,u+3)==="no-"){if(l=n.substring(u+3),y&&!~b.indexOf(l))return t.unknown(n);o[l]=!1}else{for(m=u+1;m<n.length&&n.charCodeAt(m)!==61;m++);for(l=n.substring(u,m),a=n.substring(++m)||s+1===h||(""+e[s+1]).charCodeAt(0)===45||e[++s],i=u===2?[l]:l,m=0;m<i.length;m++){if(l=i[m],y&&!~b.indexOf(l))return t.unknown("-".repeat(u)+l);xt(o,l,m+1<i.length||a,t)}}}if(f)for(r in t.default)o[r]===void 0&&(o[r]=t.default[r]);if(d)for(r in o)for(i=t.alias[r]||[];i.length>0;)o[i.shift()]=o[r];return o}var Y={exports:{}},Re;function vt(){if(Re)return Y.exports;Re=1;let e=process||{},t=e.argv||[],r=e.env||{},i=!(r.NO_COLOR||t.includes("--no-color"))&&(!!r.FORCE_COLOR||t.includes("--color")||e.platform==="win32"||(e.stdout||{}).isTTY&&r.TERM!=="dumb"||!!r.CI),n=(o,s,u=o)=>m=>{let h=""+m,d=h.indexOf(s,o.length);return~d?o+l(h,s,u,d)+s:o+h+s},l=(o,s,u,m)=>{let h="",d=0;do h+=o.substring(d,m)+u,d=m+s.length,m=o.indexOf(s,d);while(~m);return h+o.substring(d)},a=(o=i)=>{let s=o?n:()=>String;return{isColorSupported:o,reset:s("\x1B[0m","\x1B[0m"),bold:s("\x1B[1m","\x1B[22m","\x1B[22m\x1B[1m"),dim:s("\x1B[2m","\x1B[22m","\x1B[22m\x1B[2m"),italic:s("\x1B[3m","\x1B[23m"),underline:s("\x1B[4m","\x1B[24m"),inverse:s("\x1B[7m","\x1B[27m"),hidden:s("\x1B[8m","\x1B[28m"),strikethrough:s("\x1B[9m","\x1B[29m"),black:s("\x1B[30m","\x1B[39m"),red:s("\x1B[31m","\x1B[39m"),green:s("\x1B[32m","\x1B[39m"),yellow:s("\x1B[33m","\x1B[39m"),blue:s("\x1B[34m","\x1B[39m"),magenta:s("\x1B[35m","\x1B[39m"),cyan:s("\x1B[36m","\x1B[39m"),white:s("\x1B[37m","\x1B[39m"),gray:s("\x1B[90m","\x1B[39m"),bgBlack:s("\x1B[40m","\x1B[49m"),bgRed:s("\x1B[41m","\x1B[49m"),bgGreen:s("\x1B[42m","\x1B[49m"),bgYellow:s("\x1B[43m","\x1B[49m"),bgBlue:s("\x1B[44m","\x1B[49m"),bgMagenta:s("\x1B[45m","\x1B[49m"),bgCyan:s("\x1B[46m","\x1B[49m"),bgWhite:s("\x1B[47m","\x1B[49m"),blackBright:s("\x1B[90m","\x1B[39m"),redBright:s("\x1B[91m","\x1B[39m"),greenBright:s("\x1B[92m","\x1B[39m"),yellowBright:s("\x1B[93m","\x1B[39m"),blueBright:s("\x1B[94m","\x1B[39m"),magentaBright:s("\x1B[95m","\x1B[39m"),cyanBright:s("\x1B[96m","\x1B[39m"),whiteBright:s("\x1B[97m","\x1B[39m"),bgBlackBright:s("\x1B[100m","\x1B[49m"),bgRedBright:s("\x1B[101m","\x1B[49m"),bgGreenBright:s("\x1B[102m","\x1B[49m"),bgYellowBright:s("\x1B[103m","\x1B[49m"),bgBlueBright:s("\x1B[104m","\x1B[49m"),bgMagentaBright:s("\x1B[105m","\x1B[49m"),bgCyanBright:s("\x1B[106m","\x1B[49m"),bgWhiteBright:s("\x1B[107m","\x1B[49m")}};return Y.exports=a(),Y.exports.createColors=a,Y.exports}var St=vt();const Et=Xe(St),{cyan:_t,magenta:It,yellow:Ft}=Et,q=[{name:"engine",display:"Engine",description:"with the PlayCanvas Engine API directly",color:Ft},{name:"react",display:"React",description:"with @playcanvas/react",color:_t},{name:"web-components",display:"Web Components",description:"with @playcanvas/web-components",color:It}],Ct={physics:{engine:["assets"],react:["react"],"web-components":["assets"]}},W=[{name:"spinning-cube",display:"Spinning Cube",category:"Basics",description:"a rotating cube and a light"},{name:"interactive-sphere",display:"Interactive Sphere",category:"Basics",description:"orbit controls, a grid and pointer picking"},{name:"model-viewer",display:"Model Viewer",category:"Viewers",description:"a glTF model, orbit controls and a procedural sky"},{name:"splat-viewer",display:"Splat Viewer",category:"Viewers",description:"a Gaussian splat and orbit controls"},{name:"product-configurator",display:"Product Configurator",category:"Viewers",description:"product variants, materials and orbit controls"},{name:"physics-playground",display:"Physics Playground",category:"Games",description:"rigid bodies, collisions, spawning and reset",features:["physics"]},{name:"first-person-controller",display:"First-Person Controller",category:"Games",description:"first-person movement, mouse look and jumping",features:["physics"]},{name:"third-person-controller",display:"Third-Person Controller",category:"Games",description:"an animated character, follow camera and locomotion",features:["physics"]},{name:"sprite-game",display:"Sprite Game",category:"Games",description:"an orthographic camera, sprite animation and input"},{name:"web-lens",display:"Snapchat Web Lens",category:"Games",description:"a portrait game with Snapchat leaderboards, packaged for upload"},{name:"scene-editor",display:"Scene Editor",category:"Tools",description:"selection and translate, rotate and scale gizmos"},{name:"vr-starter",display:"VR Starter",category:"XR",description:"immersive VR, controllers and locomotion"},{name:"ar-placement",display:"AR Placement",category:"XR",description:"mobile AR, hit testing and object placement"}],Tt=async({argFormat:e,yes:t,cancel:r})=>{if(e&&q.some(n=>n.name===e))return e;if(e&&t)throw new Error(`Unknown format: ${e}. Choose from: ${q.map(n=>n.name).join(", ")}`);if(t)return q[0].name;const i=await ne({message:e?`"${e}" isn't a valid format. Please choose from below: `:"Select a format:",options:q.map(n=>({label:n.color(n.display),value:n.name,hint:n.description}))});return V(i)&&r(),i},Rt=async({argStarter:e,yes:t,cancel:r})=>{if(e&&W.some(n=>n.name===e))return e;if(t){if(!e)return W[0].name;throw new Error(`Unknown starter: ${e}. Choose from: ${W.map(n=>n.name).join(", ")}`)}const i=await ne({message:e?`"${e}" isn't a valid starter. Please choose from below: `:"Select a starter:",initialValue:W[0].name,options:W.map(n=>({label:n.display,value:n.name,hint:`${n.category} \xB7 ${n.description}`}))});return V(i)&&r(),i},Ae=e=>/^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(e),oe=e=>e.trim().toLowerCase().replace(/\s+/g,"-").replace(/^[._]/,"").replace(/[^a-z\d\-~]+/g,"-"),At=async({targetDir:e,yes:t,cancel:r})=>{let i=$.basename($.resolve(e));if(!Ae(i)){if(t)return oe(i);const n=await Te({message:"Package name:",defaultValue:oe(i),placeholder:oe(i),validate:l=>{if(!l||!Ae(l))return"Invalid package.json name"}});if(V(n))return r();i=n}return i},X=e=>e.trim().replace(/\/+$/g,""),kt=e=>{const t=w.readdirSync(e);return t.length===0||t.length===1&&t[0]===".git"},jt=e=>{if(w.existsSync(e))for(const t of w.readdirSync(e))t!==".git"&&w.rmSync($.resolve(e,t),{recursive:!0,force:!0})},Ot=async({argTargetDir:e,defaultTargetDir:t,yes:r,cancel:i})=>{let n=e?X(String(e)):void 0;if(!n&&r)return t;if(!n){const l=await Te({message:"Project name:",defaultValue:t,placeholder:t,validate:a=>{if(a&&!X(a))return"Invalid project name"}});V(l)&&i(),n=X(l)}return n},Lt=async({targetDir:e,argOverwrite:t,yes:r,cancel:i})=>{if(w.existsSync(e)&&!kt(e)){if(r&&!t)throw new Error(`Target directory "${e}" is not empty. Pass --overwrite to remove its contents.`);const n=t?"yes":await ne({message:(e==="."?"Current directory":`Target directory "${e}"`)+" is not empty. Please choose how to proceed:",options:[{label:"Cancel operation",value:"no"},{label:"Remove existing files and continue",value:"yes"},{label:"Ignore files and continue",value:"ignore"}]});if(V(n))return i();switch(n){case"yes":jt(e);break;case"no":i();return}}},Pt=["scripts","dependencies","devDependencies","peerDependencies","engines"],ke={"README.md":"## Prerequisites","AGENTS.md":"## Checking your work"},Bt="## Agent skills",Mt=["npm","pnpm","yarn","bun"],Nt=e=>e==="yarn"?{install:"yarn",run:"yarn"}:{install:`${e} install`,run:`${e} run`},Dt=e=>{const{cwd:t,targetDir:r,format:i,starter:n,packageName:l,skills:a,renameFiles:o}=e,s=$.resolve(t,r);w.mkdirSync(s,{recursive:!0});const u=process.env.npm_config_user_agent?.split("/")[0]??"npm",m=Mt.includes(u)?u:"npm",{install:h,run:d}=Nt(m);B.step(`Creating project in ${s}...`);const y=Le(import.meta.url),f=$.dirname(y),b=e.templatesDir??[$.resolve(f,"../templates"),$.resolve(f,"../../templates")].find(p=>w.existsSync($.join(p,i)));if(!b)throw new Error(`Format directory not found for: ${i}`);const F=W.find(p=>p.name===n);if(!F)throw new Error(`Starter not found: ${n}`);const T=$.join(b,"_shared",n),R=$.join(b,i,n);if(!w.existsSync(R))throw new Error(`Starter directory not found: ${i}/${n}`);const L=[$.join(b,"_common"),$.join(b,i,"base"),T,...(F.features??[]).flatMap(p=>Ct[p][i].map(_=>$.join(b,"_features",p,_))),R].filter(p=>w.existsSync(p)),k=Object.keys(ke).map(p=>$.join(T,p));for(const p of L){const _=$.join(p,"package.json");w.cpSync(p,s,{recursive:!0,filter:g=>g!==_&&!k.includes(g)})}for(const[p,_]of Object.entries(ke)){const g=$.join(s,p);if(!w.existsSync(g))continue;let C=w.readFileSync(g,"utf8");const U=$.join(T,p);if(w.existsSync(U)){const Z=`${w.readFileSync(U,"utf8").trimEnd()}
+`}}}}).prompt()};`${u("gray",E)}`;const Le=e=>new dt({validate:e.validate,placeholder:e.placeholder,defaultValue:e.defaultValue,initialValue:e.initialValue,output:e.output,signal:e.signal,input:e.input,render(){const t=e?.withGuide??U.withGuide,r=`${`${t?`${u("gray",E)}
+`:""}${Pe(this.state)}  `}${e.message}
+`,i=e.placeholder&&e.placeholder.length>0?u("inverse",e.placeholder[0])+u("dim",e.placeholder.slice(1)):u(["inverse","hidden"],"_"),n=this.userInput?this.userInputWithCursor:i,o=this.value??"";switch(this.state){case"validating":{const l=t?`${u("cyan",E)}  `:"",a=t?u("cyan",G):"",s=u("dim",n),c=u("dim","Validating...");return`${r}${l}${s}
+${a}  ${c}
+`}case"error":{const l=this.error?`  ${u("yellow",this.error)}`:"",a=t?`${u("yellow",E)}  `:"",s=t?u("yellow",G):"";return`${r.trim()}
+${a}${n}
+${s}${l}
+`}case"submit":{const l=o?`${t?"  ":""}${u("dim",o)}`:"",a=t?u("gray",E):"";return`${r}${a}${l}`}case"cancel":{const l=o?`  ${u(["strikethrough","dim"],o)}`:"",a=t?u("gray",E):"";return`${r}${a}${l}${o.trim()?`
+${a}`:""}`}default:{const l=t?`${u("cyan",E)}  `:"",a=t?u("cyan",G):"";return`${r}${l}${n}
+${a}
+`}}}}).prompt();function ge(e){return e==null?[]:Array.isArray(e)?e:[e]}function kt(e,t,r,i){var n,o=e[t],l=~i.string.indexOf(t)?r==null||r===!0?"":String(r):typeof r=="boolean"?r:~i.boolean.indexOf(t)?r==="false"?!1:r==="true"||(e._.push((n=+r,n*0===0?n:r)),!!r):(n=+r,n*0===0?n:r);e[t]=o==null?l:Array.isArray(o)?o.concat(l):[o,l]}function Tt(e,t){e=e||[],t=t||{};var r,i,n,o,l,a={_:[]},s=0,c=0,d=0,h=e.length;const m=t.alias!==void 0,f=t.unknown!==void 0,g=t.default!==void 0;if(t.alias=t.alias||{},t.string=ge(t.string),t.boolean=ge(t.boolean),m)for(r in t.alias)for(i=t.alias[r]=ge(t.alias[r]),s=0;s<i.length;s++)(t.alias[i[s]]=i.concat(r)).splice(s,1);for(s=t.boolean.length;s-- >0;)for(i=t.alias[t.boolean[s]]||[],c=i.length;c-- >0;)t.boolean.push(i[c]);for(s=t.string.length;s-- >0;)for(i=t.alias[t.string[s]]||[],c=i.length;c-- >0;)t.string.push(i[c]);if(g){for(r in t.default)if(o=typeof t.default[r],i=t.alias[r]=t.alias[r]||[],t[o]!==void 0)for(t[o].push(r),s=0;s<i.length;s++)t[o].push(i[s])}const w=f?Object.keys(t.alias):[];for(s=0;s<h;s++){if(n=e[s],n==="--"){a._=a._.concat(e.slice(++s));break}for(c=0;c<n.length&&n.charCodeAt(c)===45;c++);if(c===0)a._.push(n);else if(n.substring(c,c+3)==="no-"){if(o=n.substring(c+3),f&&!~w.indexOf(o))return t.unknown(n);a[o]=!1}else{for(d=c+1;d<n.length&&n.charCodeAt(d)!==61;d++);for(o=n.substring(c,d),l=n.substring(++d)||s+1===h||(""+e[s+1]).charCodeAt(0)===45||e[++s],i=c===2?[o]:o,d=0;d<i.length;d++){if(o=i[d],f&&!~w.indexOf(o))return t.unknown("-".repeat(c)+o);kt(a,o,d+1<i.length||l,t)}}}if(g)for(r in t.default)a[r]===void 0&&(a[r]=t.default[r]);if(m)for(r in a)for(i=t.alias[r]||[];i.length>0;)a[i.shift()]=a[r];return a}function Rt(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var ae={exports:{}},Me;function jt(){if(Me)return ae.exports;Me=1;let e=process||{},t=e.argv||[],r=e.env||{},i=!(r.NO_COLOR||t.includes("--no-color"))&&(!!r.FORCE_COLOR||t.includes("--color")||e.platform==="win32"||(e.stdout||{}).isTTY&&r.TERM!=="dumb"||!!r.CI),n=(a,s,c=a)=>d=>{let h=""+d,m=h.indexOf(s,a.length);return~m?a+o(h,s,c,m)+s:a+h+s},o=(a,s,c,d)=>{let h="",m=0;do h+=a.substring(m,d)+c,m=d+s.length,d=a.indexOf(s,m);while(~d);return h+a.substring(m)},l=(a=i)=>{let s=a?n:()=>String;return{isColorSupported:a,reset:s("\x1B[0m","\x1B[0m"),bold:s("\x1B[1m","\x1B[22m","\x1B[22m\x1B[1m"),dim:s("\x1B[2m","\x1B[22m","\x1B[22m\x1B[2m"),italic:s("\x1B[3m","\x1B[23m"),underline:s("\x1B[4m","\x1B[24m"),inverse:s("\x1B[7m","\x1B[27m"),hidden:s("\x1B[8m","\x1B[28m"),strikethrough:s("\x1B[9m","\x1B[29m"),black:s("\x1B[30m","\x1B[39m"),red:s("\x1B[31m","\x1B[39m"),green:s("\x1B[32m","\x1B[39m"),yellow:s("\x1B[33m","\x1B[39m"),blue:s("\x1B[34m","\x1B[39m"),magenta:s("\x1B[35m","\x1B[39m"),cyan:s("\x1B[36m","\x1B[39m"),white:s("\x1B[37m","\x1B[39m"),gray:s("\x1B[90m","\x1B[39m"),bgBlack:s("\x1B[40m","\x1B[49m"),bgRed:s("\x1B[41m","\x1B[49m"),bgGreen:s("\x1B[42m","\x1B[49m"),bgYellow:s("\x1B[43m","\x1B[49m"),bgBlue:s("\x1B[44m","\x1B[49m"),bgMagenta:s("\x1B[45m","\x1B[49m"),bgCyan:s("\x1B[46m","\x1B[49m"),bgWhite:s("\x1B[47m","\x1B[49m"),blackBright:s("\x1B[90m","\x1B[39m"),redBright:s("\x1B[91m","\x1B[39m"),greenBright:s("\x1B[92m","\x1B[39m"),yellowBright:s("\x1B[93m","\x1B[39m"),blueBright:s("\x1B[94m","\x1B[39m"),magentaBright:s("\x1B[95m","\x1B[39m"),cyanBright:s("\x1B[96m","\x1B[39m"),whiteBright:s("\x1B[97m","\x1B[39m"),bgBlackBright:s("\x1B[100m","\x1B[49m"),bgRedBright:s("\x1B[101m","\x1B[49m"),bgGreenBright:s("\x1B[102m","\x1B[49m"),bgYellowBright:s("\x1B[103m","\x1B[49m"),bgBlueBright:s("\x1B[104m","\x1B[49m"),bgMagentaBright:s("\x1B[105m","\x1B[49m"),bgCyanBright:s("\x1B[106m","\x1B[49m"),bgWhiteBright:s("\x1B[107m","\x1B[49m")}};return ae.exports=l(),ae.exports.createColors=l,ae.exports}var At=jt();const Ot=Rt(At),{cyan:Pt,magenta:Bt,yellow:Lt}=Ot,q=[{name:"engine",display:"Engine",description:"with the PlayCanvas Engine API directly",color:Lt},{name:"react",display:"React",description:"with @playcanvas/react",color:Pt},{name:"web-components",display:"Web Components",description:"with @playcanvas/web-components",color:Bt}],Mt={physics:{engine:["assets"],react:["react"],"web-components":["assets"]}},K=[{name:"spinning-cube",display:"Spinning Cube",category:"Basics",description:"a rotating cube and a light"},{name:"interactive-sphere",display:"Interactive Sphere",category:"Basics",description:"orbit controls, a grid and pointer picking"},{name:"model-viewer",display:"Model Viewer",category:"Viewers",description:"a glTF model, orbit controls and a procedural sky"},{name:"splat-viewer",display:"Splat Viewer",category:"Viewers",description:"a Gaussian splat and orbit controls"},{name:"product-configurator",display:"Product Configurator",category:"Viewers",description:"product variants, materials and orbit controls"},{name:"physics-playground",display:"Physics Playground",category:"Games",description:"rigid bodies, collisions, spawning and reset",features:["physics"]},{name:"first-person-controller",display:"First-Person Controller",category:"Games",description:"first-person movement, mouse look and jumping",features:["physics"]},{name:"third-person-controller",display:"Third-Person Controller",category:"Games",description:"an animated character, follow camera and locomotion",features:["physics"]},{name:"sprite-game",display:"Sprite Game",category:"Games",description:"an orthographic camera, sprite animation and input"},{name:"web-lens",display:"Snapchat Web Lens",category:"Games",description:"a portrait game with Snapchat leaderboards, packaged for upload",omit:["src/starter.css","src/assets"],outro:`To publish it to Snapchat, run:
 
-${_}`;C=C.replace(_,()=>Z)}a||(C=`${C.split(/^(?=## )/m).filter(Z=>!Z.startsWith(Bt)).join("").trimEnd()}
-`),m!=="npm"&&(C=C.replace(/\bnpm run ([^\s`]+) -- /g,`${d} $1 `).replace(/\bnpm run\b/g,d).replace(/\bnpm install\b/g,h)),w.writeFileSync(g,C)}for(const[p,_]of Object.entries(o)){const g=$.join(s,p);w.existsSync(g)&&w.renameSync(g,$.join(s,_))}const v=L.map(p=>$.join(p,"package.json")).filter(p=>w.existsSync(p)).map(p=>JSON.parse(w.readFileSync(p,"utf-8"))),S=Object.assign({},...v);for(const p of Pt){const _=Object.assign({},...v.map(C=>C[p])),g=Object.entries(_).sort(([C],[U])=>C>U?1:-1);g.length?S[p]=Object.fromEntries(g):delete S[p]}if(S.name=l,w.writeFileSync($.join(s,"package.json"),JSON.stringify(S,null,4)+`
-`),a){const p=[$.resolve(f,"../skills"),$.resolve(f,"../../skills")].find(g=>w.existsSync(g));if(!p)throw new Error("Skills directory not found");const _=w.readdirSync(p,{withFileTypes:!0}).filter(g=>g.isDirectory()).map(g=>g.name);for(const g of[".claude/skills",".agents/skills"])for(const C of _)w.cpSync($.join(p,C),$.join(s,g,C),{recursive:!0});B.step("Added PlayCanvas agent skills (opt out with --no-skills)")}let x=`Project created. Now run:
-`;const E=$.isAbsolute(r)?s:$.relative(t,s);s!==t&&(x+=`
-  cd ${E.includes(" ")?`"${E}"`:E}`),x+=`
-  ${h}`,x+=`
-  ${d} dev`,yt(x)},O=wt(process.argv.slice(2),{alias:{b:"boilerplate",f:"format",h:"help",s:"starter",t:"template",y:"yes"},boolean:["help","overwrite","yes"],string:["format","starter","template","boilerplate"]}),Wt=process.cwd(),Vt=`Usage: npm create playcanvas@latest [OPTION]...
+  npm run package
 
-Create a new PlayCanvas project with TypeScript.
+and upload the zip it writes to dist/ at https://my-lenses.snapchat.com/`},{name:"scene-editor",display:"Scene Editor",category:"Tools",description:"selection and translate, rotate and scale gizmos"},{name:"vr-starter",display:"VR Starter",category:"XR",description:"immersive VR, controllers and locomotion"},{name:"ar-placement",display:"AR Placement",category:"XR",description:"mobile AR, hit testing and object placement"}],Nt=async({argFormat:e,yes:t,cancel:r})=>{if(e&&q.some(n=>n.name===e))return e;if(e&&t)throw new Error(`Unknown format: ${e}. Choose from: ${q.map(n=>n.name).join(", ")}`);if(t)return q[0].name;const i=await fe({message:e?`"${e}" isn't a valid format. Please choose from below: `:"Select a format:",options:q.map(n=>({label:n.color(n.display),value:n.name,hint:n.description}))});return Y(i)&&r(),i},Dt=async({argStarter:e,yes:t,cancel:r})=>{if(e&&K.some(n=>n.name===e))return e;if(t){if(!e)return K[0].name;throw new Error(`Unknown starter: ${e}. Choose from: ${K.map(n=>n.name).join(", ")}`)}const i=await fe({message:e?`"${e}" isn't a valid starter. Please choose from below: `:"Select a starter:",initialValue:K[0].name,options:K.map(n=>({label:n.display,value:n.name,hint:`${n.category} \xB7 ${n.description}`}))});return Y(i)&&r(),i},Ne=e=>/^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(e),be=e=>e.trim().toLowerCase().replace(/\s+/g,"-").replace(/^[._]/,"").replace(/[^a-z\d\-~]+/g,"-"),Wt=async({targetDir:e,yes:t,cancel:r})=>{let i=b.basename(b.resolve(e));if(!Ne(i)){if(t)return be(i);const n=await Le({message:"Package name:",defaultValue:be(i),placeholder:be(i),validate:o=>{if(!o||!Ne(o))return"Invalid package.json name"}});if(Y(n))return r();i=n}return i},oe=e=>e.trim().replace(/\/+$/g,""),Vt=e=>{const t=y.readdirSync(e);return t.length===0||t.length===1&&t[0]===".git"},Ut=e=>{if(y.existsSync(e))for(const t of y.readdirSync(e))t!==".git"&&y.rmSync(b.resolve(e,t),{recursive:!0,force:!0})},Gt=async({argTargetDir:e,defaultTargetDir:t,yes:r,cancel:i})=>{let n=e?oe(String(e)):void 0;if(!n&&r)return t;if(!n){const o=await Le({message:"Project name:",defaultValue:t,placeholder:t,validate:l=>{if(l&&!oe(l))return"Invalid project name"}});Y(o)&&i(),n=oe(o)}return n},Kt=async({targetDir:e,argOverwrite:t,argKeep:r,yes:i,cancel:n})=>{if(t&&r)throw new Error("Pass --keep or --overwrite, not both.");if(!y.existsSync(e)||Vt(e))return!1;let o="no";if(t)o="yes";else if(r)o="keep";else{if(i)throw new Error(`Target directory "${e}" is not empty. Pass --keep to add the project to its files, or --overwrite to remove them.`);o=await fe({message:(e==="."?"Current directory":`Target directory "${e}"`)+" is not empty. Please choose how to proceed:",options:[{label:"Cancel operation",value:"no"},{label:"Remove existing files and continue",value:"yes"},{label:"Keep existing files and continue",value:"keep"}]})}if(Y(o))return n();switch(o){case"yes":return Ut(e),!1;case"keep":if(y.existsSync(b.join(e,"package.json")))throw new Error(`Target directory "${e}" already has a package.json, so it can't keep its files. Pass --overwrite to remove them.`);return!0;default:return n()}},Ht=["scripts","dependencies","devDependencies","peerDependencies","engines"],De={"README.md":"## Prerequisites","AGENTS.md":"## Checking your work"},zt="## Agent skills",Jt=["npm","pnpm","yarn","bun"],Yt=e=>e==="yarn"?{install:"yarn",run:"yarn"}:{install:`${e} install`,run:`${e} run`},qt=e=>{const{cwd:t,targetDir:r,format:i,starter:n,packageName:o,skills:l,keep:a,renameFiles:s}=e,c=b.resolve(t,r);y.mkdirSync(c,{recursive:!0});const d=process.env.npm_config_user_agent?.split("/")[0]??"npm",h=Jt.includes(d)?d:"npm",{install:m,run:f}=Yt(h),g=p=>h==="npm"?p:p.replace(/\bnpm run ([^\s`]+) -- /g,`${f} $1 `).replace(/\bnpm run\b/g,f).replace(/\bnpm install\b/g,m);N.step(`Creating project in ${c}...`);const w=He(import.meta.url),_=b.dirname(w),F=e.templatesDir??[b.resolve(_,"../templates"),b.resolve(_,"../../templates")].find(p=>y.existsSync(b.join(p,i)));if(!F)throw new Error(`Format directory not found for: ${i}`);const j=K.find(p=>p.name===n);if(!j)throw new Error(`Starter not found: ${n}`);const M=b.join(F,"_common"),O=b.join(F,i,"base"),v=b.join(F,"_shared",n),C=b.join(F,i,n);if(!y.existsSync(C))throw new Error(`Starter directory not found: ${i}/${n}`);const $=a?y.mkdtempSync(b.join(Ke.tmpdir(),"create-playcanvas-")):c,I=[M,O,v,...(j.features??[]).flatMap(p=>Mt[p][i].map(k=>b.join(F,"_features",p,k))),C].filter(p=>y.existsSync(p)),R=j.omit??[],D=R.flatMap(p=>[M,O].map(k=>b.join(k,p))),A=Object.keys(De).map(p=>b.join(v,p));for(const p of I){const k=b.join(p,"package.json");y.cpSync(p,$,{recursive:!0,filter:x=>x!==k&&!A.includes(x)&&!D.includes(x)})}for(const[p,k]of Object.entries(De)){const x=b.join($,p);if(!y.existsSync(x))continue;let T=y.readFileSync(x,"utf8");const Q=b.join(v,p);if(y.existsSync(Q)){const J=`${y.readFileSync(Q,"utf8").trimEnd()}
+
+${k}`;T=T.replace(k,()=>J)}l||(T=`${T.split(/^(?=## )/m).filter(J=>!J.startsWith(zt)).join("").trimEnd()}
+`),T=T.split(`
+`).filter(J=>!R.some(Ve=>J.startsWith(`- \`${Ve}\``))).join(`
+`),y.writeFileSync(x,g(T))}for(const[p,k]of Object.entries(s)){const x=b.join($,p);y.existsSync(x)&&y.renameSync(x,b.join($,k))}const H=I.map(p=>b.join(p,"package.json")).filter(p=>y.existsSync(p)).map(p=>JSON.parse(y.readFileSync(p,"utf-8"))),X=Object.assign({},...H);for(const p of Ht){const k=Object.assign({},...H.map(T=>T[p])),x=Object.entries(k).sort(([T],[Q])=>T>Q?1:-1);x.length?X[p]=Object.fromEntries(x):delete X[p]}if(X.name=o,y.writeFileSync(b.join($,"package.json"),JSON.stringify(X,null,4)+`
+`),l){const p=[b.resolve(_,"skills"),b.resolve(_,"../../node_modules/@playcanvas/skills/skills")].find(x=>y.existsSync(x));if(!p)throw new Error("Skills directory not found");const k=y.readdirSync(p,{withFileTypes:!0}).filter(x=>x.isDirectory()).map(x=>x.name);for(const x of[".claude/skills",".agents/skills"])for(const T of k)y.cpSync(b.join(p,T),b.join($,x,T),{recursive:!0});N.step("Added PlayCanvas agent skills (opt out with --no-skills)")}if(a){const p=[];try{for(const k of y.readdirSync($,{recursive:!0}).sort()){const x=b.join($,k);if(!y.statSync(x).isFile())continue;const T=b.join(c,k);y.existsSync(T)?p.push(k.split(b.sep).join("/")):(y.mkdirSync(b.dirname(T),{recursive:!0}),y.copyFileSync(x,T))}}finally{y.rmSync($,{recursive:!0,force:!0})}p.length&&N.warn(`Kept these existing files rather than the project's: ${p.join(", ")}`)}let z=`Project created. Now run:
+`;const le=b.isAbsolute(r)?c:b.relative(t,c);c!==t&&(z+=`
+  cd ${le.includes(" ")?`"${le}"`:le}`),z+=`
+  ${m}`,z+=`
+  ${f} dev`,j.outro&&(z+=`
+
+${g(j.outro)}`),Ft(z)},B=Tt(process.argv.slice(2),{alias:{b:"boilerplate",f:"format",h:"help",s:"starter",t:"template",y:"yes"},boolean:["help","overwrite","keep","yes"],string:["format","starter","template","boilerplate"]}),Xt=process.cwd(),We=e=>e.map((t,r)=>`  ${t.name.padEnd(27)}${t.description}${r?"":" (default)"}`).join(`
+`),Qt=`Usage: npm create playcanvas@latest [DIRECTORY] -- [OPTION]...
+
+Create a new PlayCanvas project with TypeScript in DIRECTORY.
 With no arguments, start the CLI in interactive mode.
+npm needs the -- before the options. pnpm, yarn and bun take them without it.
 
 Options:
   -f, --format NAME          use a specific format
   -s, --starter NAME         use a specific starter
       --overwrite            remove existing files from a non-empty target directory
+      --keep                 add the project to a non-empty target directory, replacing no files
       --no-skills            omit the PlayCanvas agent skills
   -y, --yes                  skip the prompts and take the defaults
   -h, --help                 show help
 
+Formats:
+${We(q)}
+
+Starters:
+${We(K)}
+
 Without a terminal, as when an AI agent or CI runs it, the CLI takes the
 defaults for any option not passed, as --yes does.
-`,Ut={_gitignore:".gitignore",_npmrc:".npmrc"},Gt="playcanvas-project",Kt=async()=>{const e=O._[0]?X(String(O._[0])):void 0,t=O.format??O.template,r=O.starter??O.boilerplate,i=O.overwrite,n=!!(process.stdin.isTTY&&process.stdout.isTTY),l=O.yes||!n;if(O.help){console.log(Vt);return}!n&&!O.yes&&B.info("Not running in a terminal, so using the defaults for any option not passed");const a=()=>{bt("Operation cancelled"),process.exit(0)},o=await Ot({argTargetDir:e,defaultTargetDir:Gt,yes:l,cancel:a});await Lt({targetDir:o,argOverwrite:i,yes:l,cancel:a});const s=await At({targetDir:o,yes:l,cancel:a}),u=await Tt({argFormat:t,yes:l,cancel:a}),m=await Rt({argStarter:r,yes:l,cancel:a}),h=O.skills??!0;Dt({cwd:Wt,targetDir:o,format:u,starter:m,packageName:s,skills:h,renameFiles:Ut})};Kt().catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});
+`,Zt={_gitignore:".gitignore",_npmrc:".npmrc"},er="playcanvas-project",tr=async()=>{const e=B._[0]?oe(String(B._[0])):void 0,t=B.format??B.template,r=B.starter??B.boilerplate,i=B.overwrite,n=B.keep,o=!!(process.stdin.isTTY&&process.stdout.isTTY),l=B.yes||!o;if(B.help){console.log(Qt);return}!o&&!B.yes&&N.info("Not running in a terminal, so using the defaults for any option not passed");const a=()=>{It("Operation cancelled"),process.exit(0)},s=await Gt({argTargetDir:e,defaultTargetDir:er,yes:l,cancel:a}),c=await Kt({targetDir:s,argOverwrite:i,argKeep:n,yes:l,cancel:a}),d=await Wt({targetDir:s,yes:l,cancel:a}),h=await Nt({argFormat:t,yes:l,cancel:a}),m=await Dt({argStarter:r,yes:l,cancel:a}),f=B.skills??!0;qt({cwd:Xt,targetDir:s,format:h,starter:m,packageName:d,skills:f,keep:c,renameFiles:Zt})};tr().catch(e=>{console.error(e instanceof Error?e.message:e),process.exitCode=1});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-playcanvas",
-    "version": "0.14.0",
+    "version": "0.15.0",
     "description": "Scaffold a PlayCanvas project",
     "keywords": [
         "playcanvas",
@@ -28,7 +28,6 @@
         "create-playcanvas": "dist/index.mjs"
     },
     "files": [
-        "skills",
         "templates",
         "dist"
     ],
@@ -43,15 +42,16 @@
         "typecheck": "tsc --noEmit"
     },
     "devDependencies": {
-        "@clack/prompts": "^1.8.1",
+        "@clack/prompts": "^1.9.0",
         "@playcanvas/eslint-config": "3.0.0",
+        "@playcanvas/skills": "github:playcanvas/skills#v0.7.0",
         "@types/node": "22.20.5",
         "eslint": "^9.39.5",
         "mri": "^1.2.0",
         "picocolors": "^1.1.1",
-        "prettier": "^3.9.10",
+        "prettier": "^3.10.0",
         "unbuild": "^3.6.1",
-        "vite": "^8.3.5",
+        "vite": "^8.3.8",
         "vitest": "^5.1.0"
     },
     "engines": {

package/templates/_shared/web-lens/AGENTS.md

@@ -2,12 +2,13 @@
 
 This project is a Snapchat Web Lens: Snapchat runs it in a sandbox, from an uploaded zip.
 
-- Run `npm run package` after a change. It builds into `dist/lens/`, checks the build against the Web Lens upload rules and writes the zip to `dist/`, or reports why it wrote none.
+- Run `npm run package` after a change. It builds into `dist/lens/`, checks the build against the Web Lens upload rules and writes the zip, named for the `package.json` version, to `dist/`, or reports why it wrote none.
 - A Lens can't reach the network. Bundle every asset into the build, and load nothing from another host, such as a script from a CDN, a web font or a remote model.
+- Use `.mp3` for audio and `.mp4` for video. Snapchat serves other media formats as generic binary data, which `<audio>` and `<video>` elements may not play.
 - The zip must stay under 8 MB and `index.html` under 1 MB.
 - Snapchat disables the camera and microphone for Web Lenses. Keep `getUserMedia`, `getDisplayMedia` and `ImageCapture` out of the build entirely.
 - Motion sensors, geolocation, payments, MIDI, USB and WebRTC are off too, so design for pointer input.
 - `localStorage` and IndexedDB start empty every time the Lens opens. To keep data between launches, use the Web Lens API's [storage](https://developers.snap.com/web-lenses/storage), `snapchat.storage`: check `snapchat.isSupported('storage')` after `init()` resolves, write nothing until the first read answers, and chain writes through one promise. Each value can be up to 32 KiB, and the whole store 100 KiB. `src/lens.ts` keeps the best score this way.
 - `npm run start` serves the build under the Lens sandbox's rules, so a request that would fail in Snapchat also fails in the browser console.
-- `src/lens.ts` is the only code that talks to Snapchat. Outside Snapchat, the Web Lens API answers from a stub with canned data, so the game runs in any browser. Call `recordScore(score)` when a run ends.
-- Keep the layout portrait and the HUD inside the safe area, using the `--inset-*` properties from `src/lens.css`.
+- `src/lens.ts` is the only code that talks to Snapchat. Outside Snapchat, the Web Lens API answers from a stub with canned data, so the game runs in any browser. Call `recordScore(score)` when a run ends, or `recordScore(score, 'ascending')` every time if a lower score wins.
+- `src/lens.css` styles the page and the HUD. Keep the layout portrait and the HUD inside the safe area, using its `--inset-*` properties.

package/templates/_shared/web-lens/README.md

@@ -12,7 +12,7 @@ Drag left and right to steer the ball around the falling blocks. Tap to start, a
 npm run package
 ```
 
-This builds the game into `dist/lens/`, checks it against the [Web Lens upload rules](https://developers.snap.com/web-lenses/requirements) and writes a zip to `dist/` to upload through [My Lenses](https://my-lenses.snapchat.com/). It writes no zip if:
+This builds the game into `dist/lens/`, checks it against the [Web Lens upload rules](https://developers.snap.com/web-lenses/requirements) and writes a zip to `dist/` to upload through [My Lenses](https://my-lenses.snapchat.com/). The zip is named for the project and its version, such as `my-lens-v0.0.0.zip`, as Snap recommends, so bump `version` in `package.json` before each upload. It writes no zip if:
 
 - the zip is over 8 MB, or `index.html` is over 1 MB
 - the build refers to one of its own files by an absolute path, such as `/assets/game.js`
@@ -20,7 +20,7 @@ This builds the game into `dist/lens/`, checks it against the [Web Lens upload r
 - the build uses something the Lens sandbox blocks, such as an `<iframe>` or a web app manifest
 - the build's code asks for the camera, microphone or screen (`getUserMedia`, `getDisplayMedia` or `ImageCapture`), which Snapchat disables for Web Lenses
 
-It warns about any other host your scripts mention, since a Lens can't reach the network. It also warns about code that uses something Snapchat [turns off for Web Lenses](https://developers.snap.com/web-lenses/capabilities): motion sensors, geolocation, payments, MIDI, USB and WebRTC, and `localStorage` or IndexedDB, which start empty every time the Lens opens, so keep data between launches with the Web Lens API's [storage](https://developers.snap.com/web-lenses/storage) instead. To check the build itself, `npm run start` serves it under the same rules, so a request for anything outside the zip, or for a device such as the camera, fails in the browser console as it would in Snapchat.
+It warns about any other host your scripts mention, since a Lens can't reach the network. It also warns about code that uses something Snapchat [turns off for Web Lenses](https://developers.snap.com/web-lenses/capabilities): motion sensors, geolocation, payments, MIDI, USB and WebRTC, and `localStorage` or IndexedDB, which start empty every time the Lens opens, so keep data between launches with the Web Lens API's [storage](https://developers.snap.com/web-lenses/storage) instead. And it warns about audio or video in any format but `.mp3` or `.mp4`, which Snapchat serves as generic binary data that an `<audio>` or `<video>` element may not play. To check the build itself, `npm run start` serves it under the same rules, so a request for anything outside the zip, or for a device such as the camera, fails in the browser console as it would in Snapchat.
 
 ### How it fits together
 
@@ -35,9 +35,10 @@ The game is the only part that's specific to Dodge, so replace it and keep the r
 
 - **Replace** `src/dodge-game.ts` with your game. The HUD follows its `game:state` app event and shows the text in its `CARDS`, so fire the same event from your game, or rework the HUD in `index.html` and `src/main.ts` (`src/App.tsx` in React). Rename Dodge in the page `<title>` too.
 - **Keep** `src/lens.ts`, `src/lens.css`, `vite.config.ts` and `scripts/package-lens.mjs`. None of them depends on the game.
-- **Report each run to Snapchat** by calling `recordScore(score)` from `src/lens.ts` when it ends. That submits the score to the leaderboard, saves a new best to Snapchat storage and resolves the best score. Call `showLeaderboard()` from a button, and `loadBest()` and `loadAvatar()` at startup for the saved best and the player's Bitmoji.
+- **Report each run to Snapchat** by calling `recordScore(score)` from `src/lens.ts` when it ends. That submits the score to the leaderboard, saves a new best to Snapchat storage and resolves the best score. If a lower score wins, as in a time trial, call `recordScore(score, 'ascending')` every time, so both rank it that way. Call `showLeaderboard()` from a button, and `loadBest()` and `loadAvatar()` at startup for the saved best and the player's Bitmoji.
+- **Expect no leaderboard** until the Lens is set up with one: inside Snapchat, `hasLeaderboard()` is false for a Lens without one, so the Leaderboard button stays hidden. The stub outside Snapchat always has one.
 - **Stick to what a Lens needs:** a portrait layout, a HUD kept inside the safe area with the `--inset-*` properties from `src/lens.css`, a pause when the page is hidden, audio that starts from a tap, and every asset bundled into the build, since a Lens can't reach the network.
 
-Lenses run on phones, in portrait. To try the game on yours, run `npm run dev -- --host` and open the network URL it prints.
+Lenses run on phones, in portrait. To try the game on yours, run `npm run dev -- --host` and open the network URL it prints. To try the build Snapchat would run, under the Lens rules, run `npm run build`, then `npm run start -- --host`. Only `npm run dev` marks the room Snapchat's controls take, so check the layout there.
 
-When you're ready to publish, follow Snap's [publishing guide](https://developers.snap.com/web-lenses/publishing): you'll also need a 512 × 512 PNG icon and a 5-second, 720 × 1280 preview video.
+When you're ready to publish, follow Snap's [publishing guide](https://developers.snap.com/web-lenses/publishing): you'll also need a 512 × 512 PNG icon and a 5-second, 720 × 1280 preview video. Snapchat can't open a Lens until it passes review, so try each change in the browser and on your phone first, and save changes up into fewer uploads.

package/templates/_shared/web-lens/package.json

@@ -4,6 +4,6 @@
         "package": "vite build && node scripts/package-lens.mjs dist/lens"
     },
     "dependencies": {
-        "@snap/web-lens-api": "^0.1.2"
+        "@snap/web-lens-api": "^0.1.3"
     }
 }

package/templates/_shared/web-lens/scripts/package-lens.mjs

@@ -23,6 +23,10 @@ const TEXT_HOSTS = ['www.w3.org', 'github.com', 'react.dev', 'api.playcanvas.com
 const CAPTURE_APIS =
     /\b(?:mediaDevices|getUserMedia|webkitGetUserMedia|mozGetUserMedia|getDisplayMedia|ImageCapture)\b/g;
 
+// Snapchat picks each file's media type from its extension, and serves audio and video in any
+// format but .mp3 and .mp4 as generic binary data, which <audio> and <video> elements may refuse
+const UNTYPED_MEDIA = /\.(?:aac|flac|m4a|m4v|mov|oga|ogg|ogv|opus|wav|weba|webm)$/i;
+
 // other features Snapchat turns off for Web Lenses: code that relies on them gets nothing, so it's
 // worth a look rather than a failure
 const UNAVAILABLE_APIS = [
@@ -46,8 +50,9 @@ const UNAVAILABLE_APIS = [
 ];
 
 const buildDir = path.resolve(process.argv[2] ?? 'dist/lens');
-const { name = 'web-lens' } = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-const zipFile = path.join(path.dirname(buildDir), `${name.replace(/^@/, '').replace('/', '-')}.zip`);
+// named for the version as well, as Snap recommends, so each upload can be told apart
+const { name = 'web-lens', version = '0.0.0' } = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+const zipFile = path.join(path.dirname(buildDir), `${name.replace(/^@/, '').replace('/', '-')}-v${version}.zip`);
 
 if (!fs.existsSync(buildDir)) {
     console.error(`No build found at ${path.relative('.', buildDir)}. Run npm run package to build and package.`);
@@ -90,6 +95,13 @@ for (const file of files.filter((f) => f.startsWith('__snap/'))) {
     errors.push(`${file}: __snap/ is reserved for Snapchat, so rename the folder`);
 }
 
+const media = files.filter((f) => UNTYPED_MEDIA.test(f));
+if (media.length) {
+    warnings.push(
+        `${media.join(', ')}: Snapchat serves audio and video as generic binary data unless it's .mp3 or .mp4, so an <audio> or <video> element may not play it. Use .mp3 for audio and .mp4 for video`
+    );
+}
+
 // URLs in markup and styles: anything on another host is blocked, and a root-absolute path
 // resolves against Snapchat's origin rather than the Lens, so the game loads a blank screen
 const checkUrl = (file, url) => {
@@ -281,3 +293,4 @@ console.log(`  files       ${files.length}`);
 console.log('\nLargest files, before compression:');
 for (const { file, size } of largest) console.log(`  ${file.padEnd(width)}  ${formatSize(size)}`);
 console.log('\nUpload the zip at https://my-lenses.snapchat.com/');
+console.log('Bump the version in package.json before the next upload, so its zip gets a new name.');

package/templates/_shared/web-lens/src/dodge-game.ts

@@ -5,8 +5,11 @@
 import type { CameraComponent } from 'playcanvas';
 import { Color, Entity, Script, StandardMaterial, math } from 'playcanvas';
 
-/** Where a run is: waiting for the first tap, in play, held while the Lens is hidden, or crashed. */
-export type GameState = 'ready' | 'playing' | 'paused' | 'over';
+/**
+ * Where a run is: loading, waiting for the first tap, in play, held while the Lens is hidden, or
+ * crashed. The page starts at `loading`, and the game moves to `ready` on its first frame.
+ */
+export type GameState = 'loading' | 'ready' | 'playing' | 'paused' | 'over';
 
 /** The app event the game fires whenever its state or score changes, for the HUD to follow. */
 export type GameEvents = {
@@ -15,6 +18,8 @@ export type GameEvents = {
 
 /** What the HUD card says in each state. `null` hides the card. */
 export const CARDS: Record<GameState, { title: string; hint: string } | null> = {
+    // so the first tap isn't asked for before anything can answer it
+    loading: { title: 'Dodge', hint: 'Loading…' },
     ready: { title: 'Dodge', hint: 'Drag to steer. Tap to play' },
     playing: null,
     paused: { title: 'Paused', hint: 'Tap to resume' },
@@ -56,7 +61,7 @@ const createMaterial = (color: Color, glow: number) => {
 class DodgeGame extends Script {
     static scriptName = 'dodgeGame';
 
-    state: GameState = 'ready';
+    state: GameState = 'loading';
     score = 0;
 
     elapsed = 0;
@@ -122,8 +127,6 @@ class DodgeGame extends Script {
             document.removeEventListener('visibilitychange', this.onVisibilityChange);
             for (const material of [...blockMaterials, playerMaterial, starMaterial]) material.destroy();
         });
-
-        this.setState('ready');
     }
 
     onPointerDown = (event: PointerEvent) => {
@@ -213,6 +216,10 @@ class DodgeGame extends Script {
     }
 
     update(dt: number) {
+        // say so from the first frame rather than from initialize(), where the page may not be
+        // listening yet: React subscribes to the app event only after it creates the script
+        if (this.state === 'loading') this.setState('ready');
+
         this.fitField();
 
         // blocks fall faster the longer a run lasts

package/templates/_shared/web-lens/src/lens.ts

@@ -7,7 +7,7 @@ import snapchat from '@snap/web-lens-api';
 const BEST_KEY = 'best';
 
 let ready: Promise<void> | undefined;
-let best: Promise<number> | undefined;
+let best: Promise<number | undefined> | undefined;
 let avatar: Promise<string | undefined> | undefined;
 let saving = Promise.resolve();
 let submitting = Promise.resolve();
@@ -29,41 +29,46 @@ export const initLens = () => (ready ??= snapchat.init().then(() => undefined, w
 export const hasLeaderboard = () => snapchat.isSupported('leaderboards');
 
 /**
- * Resolves the player's best score. Snapchat storage keeps it between launches, where
- * `localStorage` starts empty every time the Lens opens.
+ * Resolves the player's best score, or `undefined` until they finish a run. Snapchat storage keeps
+ * it between launches, where `localStorage` starts empty every time the Lens opens.
  */
 export const loadBest = () =>
     (best ??= initLens().then(async () => {
-        if (!snapchat.isSupported('storage')) return 0;
+        if (!snapchat.isSupported('storage')) return undefined;
 
         try {
             // the first read opens the store, which can take seconds on a cold start
             const result = await snapchat.storage.get(BEST_KEY);
             loaded = true;
-            return result.found && typeof result.value === 'number' ? result.value : 0;
+            return result.found && typeof result.value === 'number' ? result.value : undefined;
         } catch (err) {
             warn('storage')(err as Error);
-            return 0;
+            return undefined;
         }
     }));
 
-/** Submits a finished run to the leaderboard and keeps the player's best. Resolves the best score. */
-export const recordScore = (score: number) => {
+/**
+ * Submits a finished run to the leaderboard and keeps the player's best. Resolves the best score.
+ * Pass `'ascending'` for a game where a lower score wins, such as a time trial, every time.
+ */
+export const recordScore = (score: number, ordering: 'ascending' | 'descending' = 'descending') => {
+    // the leaderboard takes whole numbers, so keep the best the same way
+    const value = Math.round(score);
+
     submitting = initLens().then(() => {
         if (!snapchat.isSupported('leaderboards')) return;
-        return snapchat.leaderboards
-            .submitScore({ score: Math.round(score) })
-            .then(() => undefined, warn('leaderboard'));
+        return snapchat.leaderboards.submitScore({ score: value, ordering }).then(() => undefined, warn('leaderboard'));
     });
 
     // each run waits for the first read and for the runs before it, so two runs that end while the
     // read is still loading can't both compare against the same old best
     best = loadBest().then((previous) => {
-        if (score <= previous) return previous;
+        const beaten = previous === undefined || (ordering === 'ascending' ? value < previous : value > previous);
+        if (!beaten) return previous;
 
         // keep one write in flight at a time, and the chain going after a failed save
-        if (loaded) saving = saving.then(() => snapchat.storage.set(BEST_KEY, score)).catch(warn('storage'));
-        return score;
+        if (loaded) saving = saving.then(() => snapchat.storage.set(BEST_KEY, value)).catch(warn('storage'));
+        return value;
     });
     return best;
 };

package/templates/engine/base/package.json

@@ -21,9 +21,9 @@
         "@playcanvas/eslint-config": "3.0.0",
         "@playcanvas/inspector": "^0.5.0",
         "eslint": "^9.39.5",
-        "prettier": "^3.9.10",
+        "prettier": "^3.10.0",
         "typescript": "~6.0.3",
-        "vite": "^8.3.5"
+        "vite": "^8.3.8"
     },
     "engines": {
         "node": ">=22.23.2"

package/templates/engine/web-lens/index.html

@@ -12,12 +12,12 @@
                 <header class="lens-bar">
                     <img class="lens-avatar" alt="Your Bitmoji" hidden />
                     <span class="lens-score">0</span>
-                    <span class="lens-best">Best 0</span>
+                    <span class="lens-best"></span>
                 </header>
                 <section class="lens-card">
                     <h1 class="lens-title">Dodge</h1>
                     <button class="lens-leaderboard" hidden>Leaderboard</button>
-                    <p class="lens-hint">Drag to steer. Tap to play</p>
+                    <p class="lens-hint">Loading…</p>
                 </section>
             </div>
         </main>

package/templates/engine/web-lens/src/main.ts

@@ -59,8 +59,9 @@ const hud = {
     hint: document.querySelector('.lens-hint')!,
     leaderboard: document.querySelector<HTMLButtonElement>('.lens-leaderboard')!
 };
-const showBest = (best: number) => {
-    hud.best.textContent = `Best ${best}`;
+// there's no best until the player finishes a run
+const showBest = (best: number | undefined) => {
+    hud.best.textContent = best === undefined ? '' : `Best ${best}`;
 };
 
 app.on('game:state', (state: GameState, score: number) => {

package/templates/index.ts

@@ -31,7 +31,9 @@ export const FEATURES: Record<string, Record<string, string[]>> = {
     }
 };
 
-// every format holds a base plus one directory per starter; the first starter is the default
+// every format holds a base plus one directory per starter; the first starter is the default. A
+// starter's `omit` lists files and folders every project gets that it has no use for, and its
+// `outro` follows the commands in the closing message
 export const STARTERS = [
     {
         name: 'spinning-cube',
@@ -94,7 +96,10 @@ export const STARTERS = [
         name: 'web-lens',
         display: 'Snapchat Web Lens',
         category: 'Games',
-        description: 'a portrait game with Snapchat leaderboards, packaged for upload'
+        description: 'a portrait game with Snapchat leaderboards, packaged for upload',
+        // lens.css styles the page, and a Lens has no favicon
+        omit: ['src/starter.css', 'src/assets'],
+        outro: 'To publish it to Snapchat, run:\n\n  npm run package\n\nand upload the zip it writes to dist/ at https://my-lenses.snapchat.com/'
     },
     {
         name: 'scene-editor',

package/templates/react/base/package.json

@@ -25,11 +25,11 @@
         "@playcanvas/inspector": "^0.5.0",
         "@types/react": "^19.3.0",
         "@types/react-dom": "^19.3.0",
-        "@vitejs/plugin-react": "^6.2.1",
+        "@vitejs/plugin-react": "^6.3.0",
         "eslint": "^9.39.5",
-        "prettier": "^3.9.10",
+        "prettier": "^3.10.0",
         "typescript": "~6.0.3",
-        "vite": "^8.3.5"
+        "vite": "^8.3.8"
     },
     "engines": {
         "node": ">=22.23.2"

package/templates/react/web-lens/src/App.tsx

@@ -35,9 +35,9 @@ function Scene({ onState }: { onState: GameEvents['game:state'] }) {
 }
 
 function App() {
-    const [state, setState] = useState<GameState>('ready');
+    const [state, setState] = useState<GameState>('loading');
     const [score, setScore] = useState(0);
-    const [best, setBest] = useState(0);
+    const [best, setBest] = useState<number>();
     const [avatar, setAvatar] = useState<string>();
 
     useEffect(() => {
@@ -64,7 +64,8 @@ function App() {
                 <header className="lens-bar">
                     {avatar && <img className="lens-avatar" src={avatar} alt="Your Bitmoji" />}
                     <span className="lens-score">{score}</span>
-                    <span className="lens-best">Best {best}</span>
+                    {/* there's no best until the player finishes a run */}
+                    {best !== undefined && <span className="lens-best">Best {best}</span>}
                 </header>
                 {card && (
                     <section className="lens-card">

package/templates/web-components/base/package.json

@@ -15,16 +15,16 @@
         "typecheck": "tsc --noEmit"
     },
     "dependencies": {
-        "@playcanvas/web-components": "^0.29.0",
+        "@playcanvas/web-components": "^0.30.0",
         "playcanvas": "^2.24.0"
     },
     "devDependencies": {
         "@playcanvas/eslint-config": "3.0.0",
         "@playcanvas/inspector": "^0.5.0",
         "eslint": "^9.39.5",
-        "prettier": "^3.9.10",
+        "prettier": "^3.10.0",
         "typescript": "~6.0.3",
-        "vite": "^8.3.5"
+        "vite": "^8.3.8"
     },
     "engines": {
         "node": ">=22.23.2"

package/templates/web-components/web-lens/index.html

@@ -22,12 +22,12 @@
                 <header class="lens-bar">
                     <img class="lens-avatar" alt="Your Bitmoji" hidden />
                     <span class="lens-score">0</span>
-                    <span class="lens-best">Best 0</span>
+                    <span class="lens-best"></span>
                 </header>
                 <section class="lens-card">
                     <h1 class="lens-title">Dodge</h1>
                     <button class="lens-leaderboard" hidden>Leaderboard</button>
-                    <p class="lens-hint">Drag to steer. Tap to play</p>
+                    <p class="lens-hint">Loading…</p>
                 </section>
             </div>
         </main>

package/templates/web-components/web-lens/src/main.ts

@@ -16,8 +16,9 @@ const hud = {
     hint: document.querySelector('.lens-hint')!,
     leaderboard: document.querySelector<HTMLButtonElement>('.lens-leaderboard')!
 };
-const showBest = (best: number) => {
-    hud.best.textContent = `Best ${best}`;
+// there's no best until the player finishes a run
+const showBest = (best: number | undefined) => {
+    hud.best.textContent = best === undefined ? '' : `Best ${best}`;
 };
 
 const { app } = await whenReady('pc-app');