create-playcanvas 0.3.0 → 0.5.0

package/README.md

@@ -9,51 +9,68 @@
 
 | [Engine Manual](https://developer.playcanvas.com/user-manual/engine/) | [React Manual](https://developer.playcanvas.com/user-manual/react/) | [Examples](https://playcanvas.github.io/) | [Forum](https://forum.playcanvas.com/) |
 
-Scaffold a Vite-powered PlayCanvas project with TypeScript. Choose the PlayCanvas Engine directly or build with [`@playcanvas/react`](https://github.com/playcanvas/react).
+Scaffold a Vite-powered PlayCanvas project with TypeScript. Choose the PlayCanvas Engine directly, [`@playcanvas/react`](https://github.com/playcanvas/react) or [`@playcanvas/web-components`](https://github.com/playcanvas/web-components).
 
 ## Getting Started
 
-Requires Node.js 22.23.2 or later.
-
 ```bash
+# npm
 npm create playcanvas@latest
-cd playcanvas-project
-npm install
-npm run dev
-```
-
-The interactive setup asks for a project name, handles an existing target directory, sets the package name and lets you choose a template.
-
-You can also use another package manager:
-
-```bash
+# pnpm
 pnpm create playcanvas@latest
+# yarn
 yarn create playcanvas
+# bun
 bun x create-playcanvas@latest
 ```
 
+Then follow the prompts. Requires Node.js 22.23.2 or later.
+
 ## Templates
 
-| Template     | Description                         |
-| ------------ | ----------------------------------- |
-| `vanilla-ts` | TypeScript with PlayCanvas Engine   |
-| `react-ts`   | TypeScript with `@playcanvas/react` |
+| Template         | Description                                  |
+| ---------------- | -------------------------------------------- |
+| `engine`         | The PlayCanvas Engine API directly           |
+| `react`          | `@playcanvas/react` components               |
+| `web-components` | `@playcanvas/web-components` custom elements |
 
-Both templates include Vite, hot module replacement, ESLint, Prettier and a production build.
+Every template is TypeScript, and includes Vite, ESLint, Prettier and a production build.
+
+## Boilerplates
+
+Each template offers a choice of starting scene. `spinning-cube` is the default.
+
+| Boilerplate          | Description                                    |
+| -------------------- | ---------------------------------------------- |
+| `spinning-cube`      | A rotating cube and a light                    |
+| `interactive-sphere` | Orbit controls, a grid and pointer picking     |
+| `model-viewer`       | A glTF model, orbit controls, a procedural sky |
+| `splat-viewer`       | A Gaussian splat and orbit controls            |
+
+A template is a `base` directory of shared tooling plus one directory per boilerplate, which is copied over the top. Assets a boilerplate needs in every template live once in `templates/_shared/<boilerplate>` and are seeded in first.
 
 ## CLI Options
 
-Pass a project name and template to skip the prompts:
+Pass a project name, template and boilerplate to skip the prompts:
 
 ```bash
-npm create playcanvas@latest my-game -- --template react-ts
+npm create playcanvas@latest my-game -- --template react --boilerplate spinning-cube
 ```
 
-| Option              | Shorthand | Description                                             |
-| ------------------- | --------- | ------------------------------------------------------- |
-| `--template <name>` | `-t`      | Use a template from the list above                      |
-| `--overwrite`       |           | Remove existing files from a non-empty target directory |
-| `--help`            | `-h`      | Show command help                                       |
+| Option                 | Shorthand | Description                                             |
+| ---------------------- | --------- | ------------------------------------------------------- |
+| `--template <name>`    | `-t`      | Use a template from the list above                      |
+| `--boilerplate <name>` | `-b`      | Use a boilerplate from the list above                   |
+| `--overwrite`          |           | Remove existing files from 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                                       |
+
+`--yes` takes `playcanvas-project`, the `engine` template and the `spinning-cube` boilerplate for anything you don't pass. It never deletes files, so a non-empty target directory still needs `--overwrite`.
+
+## Agent skills
+
+Every project includes [`@playcanvas/skills`](https://github.com/playcanvas/skills) so AI coding agents such as Claude Code, Codex and Cursor pick up PlayCanvas-specific workflows automatically, with no install step. They are copied into `.claude/skills/` and `.agents/skills/`. Pass `--no-skills` to leave them out.
 
 ## Development
 

package/dist/index.mjs

@@ -1,59 +1,62 @@
 #!/usr/bin/env node
-import{styleText as c}from"node:util";import C,{stdin as Tt,stdout as rt}from"node:process";import Ct from"node:readline";import"node:tty";import R from"node:fs";import F from"node:path";import{fileURLToPath as Rt}from"node:url";const At=(()=>{const t=/[\uD800-\uDBFF][\uDC00-\uDFFF]/g;return e=>{let r=0;for(t.lastIndex=0;t.test(e);)r+=1;return e.length-r}})(),Lt=t=>t===12288||t>=65281&&t<=65376||t>=65504&&t<=65510,kt=t=>t===8987||t===9001||t>=12272&&t<=12287||t>=12289&&t<=12350||t>=12441&&t<=12543||t>=12549&&t<=12591||t>=12593&&t<=12686||t>=12688&&t<=12771||t>=12783&&t<=12830||t>=12832&&t<=12871||t>=12880&&t<=19903||t>=65040&&t<=65049||t>=65072&&t<=65106||t>=65108&&t<=65126||t>=65128&&t<=65131||t>=127488&&t<=127490||t>=127504&&t<=127547||t>=127552&&t<=127560||t>=131072&&t<=196605||t>=196608&&t<=262141,Ot=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y,Bt=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y,it=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu,Mt=/\t{1,1000}/y,st=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"),Nt=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y,Pt=new RegExp("\\p{M}+","gu"),Dt={limit:1/0,ellipsis:""},nt=(t,e={},r={})=>{const i=e.limit??1/0,o=e.ellipsis??"",l=e?.ellipsisWidth??(o?nt(o,Dt,r).width:0),n=0,a=r.controlWidth??0,s=r.tabWidth??8,u=r.emojiWidth??2,m=2,h=r.regularWidth??1,d=r.wideWidth??m,p=[[Nt,h],[Ot,n],[Bt,a],[Mt,s],[st,u],[it,d]];let f=0,g=0,b=t.length,_=0,I=!1,O=b,L=Math.max(0,i-l),w=0,v=0,x=0,y=0;t:for(;;){if(v>w||g>=b&&g>f){const E=t.slice(w,v)||t.slice(f,g);_=0;for(const B of E.replaceAll(Pt,"")){const S=B.codePointAt(0)||0;if(Lt(S)?y=m:kt(S)?y=d:y=h,x+y>L&&(O=Math.min(O,Math.max(w,f)+_)),x+y>i){I=!0;break t}_+=B.length,x+=y}w=v=0}if(g>=b)break t;for(let E=0,B=p.length;E<B;E++){const[S,et]=p[E];if(S.lastIndex=g,S.test(t)){if(_=S===it?At(t.slice(g,S.lastIndex)):S===st?1:S.lastIndex-g,y=_*et,x+y>L&&(O=Math.min(O,g+Math.floor((L-x)/et))),x+y>i){I=!0;break t}x+=y,w=f,v=g,g=f=S.lastIndex;continue t}}g+=1}return{width:I?L:x,index:I?O:b,truncated:I,ellipsed:I&&i>=l}},jt={limit:1/0,ellipsis:"",ellipsisWidth:0},k=(t,e={})=>nt(t,jt,e).width,j="\x1B",at="\x9B",Wt=39,z="\x07",ot="[",Vt="]",lt="m",J=`${Vt}8;;`,ct=new RegExp(`(?:\\${ot}(?<code>\\d+)m|\\${J}(?<uri>.*)${z})`,"y"),ut=t=>{if(t>=30&&t<=37||t>=90&&t<=97)return 39;if(t>=40&&t<=47||t>=100&&t<=107)return 49;if(t===1||t===2)return 22;if(t===3)return 23;if(t===4)return 24;if(t===7)return 27;if(t===8)return 28;if(t===9)return 29;if(t===0)return 0},ht=t=>`${j}${ot}${t}${lt}`,mt=t=>`${j}${J}${t}${z}`,q=(t,e,r)=>{const i=e[Symbol.iterator]();let o=!1,l=!1,n=t.at(-1),a=n===void 0?0:k(n),s=i.next(),u=i.next(),m=0;for(;!s.done;){const h=s.value,d=k(h);a+d<=r?t[t.length-1]+=h:(t.push(h),a=0),(h===j||h===at)&&(o=!0,l=e.startsWith(J,m+1)),o?l?h===z&&(o=!1,l=!1):h===lt&&(o=!1):(a+=d,a===r&&!u.done&&(t.push(""),a=0)),s=u,u=i.next(),m+=h.length}n=t.at(-1),!a&&n!==void 0&&n.length&&t.length>1&&(t[t.length-2]+=t.pop())},Ut=t=>{const e=t.split(" ");let r=e.length;for(;r&&!k(e[r-1]);)r--;return r===e.length?t:e.slice(0,r).join(" ")+e.slice(r).join("")},Gt=(t,e,r={})=>{if(r.trim!==!1&&t.trim()==="")return"";let i="",o,l;const n=t.split(" ");let a=[""],s=0;for(let h=0;h<n.length;h++){const d=n[h];if(r.trim!==!1){const f=a.at(-1)??"",g=f.trimStart();f.length!==g.length&&(a[a.length-1]=g,s=k(g))}h!==0&&(s>=e&&(r.wordWrap===!1||r.trim===!1)&&(a.push(""),s=0),(s||r.trim===!1)&&(a[a.length-1]+=" ",s++));const p=k(d);if(r.hard&&p>e){const f=e-s,g=1+Math.floor((p-f-1)/e);Math.floor((p-1)/e)<g&&a.push(""),q(a,d,e),s=k(a.at(-1)??"");continue}if(s+p>e&&s&&p){if(r.wordWrap===!1&&s<e){q(a,d,e),s=k(a.at(-1)??"");continue}a.push(""),s=0}if(s+p>e&&r.wordWrap===!1){q(a,d,e),s=k(a.at(-1)??"");continue}a[a.length-1]+=d,s+=p}r.trim!==!1&&(a=a.map(h=>Ut(h)));const u=a.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===j||d===at){ct.lastIndex=h+1;const f=ct.exec(u)?.groups;if(f?.code!==void 0){const g=Number.parseFloat(f.code);o=g===Wt?void 0:g}else f?.uri!==void 0&&(l=f.uri.length===0?void 0:f.uri)}if(u[h+1]===`
-`){l&&(i+=mt(""));const p=o?ut(o):void 0;o&&p&&(i+=ht(p))}else d===`
-`&&(o&&ut(o)&&(i+=ht(o)),l&&(i+=mt(l)))}return i},Kt=/\r?\n/;function W(t,e,r){return String(t).normalize().split(Kt).map(i=>Gt(i,e,r)).join(`
-`)}function Ht(t){return t&&t.__esModule&&Object.prototype.hasOwnProperty.call(t,"default")?t.default:t}var Y,dt;function zt(){if(dt)return Y;dt=1;const t="\x1B",e=`${t}[`,r="\x07",i={to(n,a){return a?`${e}${a+1};${n+1}H`:`${e}${n+1}G`},move(n,a){let s="";return n<0?s+=`${e}${-n}D`:n>0&&(s+=`${e}${n}C`),a<0?s+=`${e}${-a}A`:a>0&&(s+=`${e}${a}B`),s},up:(n=1)=>`${e}${n}A`,down:(n=1)=>`${e}${n}B`,forward:(n=1)=>`${e}${n}C`,backward:(n=1)=>`${e}${n}D`,nextLine:(n=1)=>`${e}E`.repeat(n),prevLine:(n=1)=>`${e}F`.repeat(n),left:`${e}G`,hide:`${e}?25l`,show:`${e}?25h`,save:`${t}7`,restore:`${t}8`},o={up:(n=1)=>`${e}S`.repeat(n),down:(n=1)=>`${e}T`.repeat(n)},l={screen:`${e}2J`,up:(n=1)=>`${e}1J`.repeat(n),down:(n=1)=>`${e}J`.repeat(n),line:`${e}2K`,lineEnd:`${e}K`,lineStart:`${e}1K`,lines(n){let a="";for(let s=0;s<n;s++)a+=this.line+(s<n-1?i.up():"");return n&&(a+=i.left),a}};return Y={cursor:i,scroll:o,erase:l,beep:r},Y}var A=zt();function V(t,e,r){if(!r.some(n=>!n.disabled))return t;const i=t+e,o=Math.max(r.length-1,0),l=i<0?o:i>o?0:i;return r[l]?.disabled?V(l,e<0?-1:1,r):l}const Jt=["up","down","left","right","space","enter","cancel"],M={actions:new Set(Jt),aliases:new Map([["k","up"],["j","down"],["h","left"],["l","right"],["","cancel"],["escape","cancel"]]),withGuide:!0};function ft(t,e){if(typeof t=="string")return M.aliases.get(t)===e;for(const r of t)if(r!==void 0&&ft(r,e))return!0;return!1}function qt(t,e){if(t===e)return;const r=t.split(`
-`),i=e.split(`
-`),o=Math.max(r.length,i.length),l=[];for(let n=0;n<o;n++)r[n]!==i[n]&&l.push(n);return{lines:l,numLinesBefore:r.length,numLinesAfter:i.length,numLines:o}}globalThis.process.platform.startsWith("win");const X=Symbol("clack:cancel");function U(t){return t===X}function G(t,e){const r=t;r.isTTY&&r.setRawMode(e)}const pt=t=>"columns"in t&&typeof t.columns=="number"?t.columns:80,gt=t=>"rows"in t&&typeof t.rows=="number"?t.rows:20;function Z(t,e,r,i=r,o=r,l){const n=pt(t??rt);return W(e,n-r.length,{hard:!0,trim:!1}).split(`
-`).map((a,s,u)=>{const m=a;return s===0?`${i}${m}`:s===u.length-1?`${o}${m}`:`${r}${m}`}).join(`
-`)}function Yt(t,e){if("~standard"in t){const r=t["~standard"].validate(e);if(r instanceof Promise)throw new TypeError("Schema validation must be synchronous. Update `validate()` and remove any asynchronous logic.");return r.issues?.at(0)?.message}return t(e)}class bt{input;output;_abortSignal;rl;opts;_render;_track=!1;_prevFrame="";_subscribers=new Map;_cursor=0;state="initial";error="";value;userInput="";constructor(e,r=!0){const{input:i=Tt,output:o=rt,render:l,signal:n,...a}=e;this.opts=a,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=n,this.input=i,this.output=o}unsubscribe(){this._subscribers.clear()}setSubscriber(e,r){const i=this._subscribers.get(e)??[];i.push(r),this._subscribers.set(e,i)}on(e,r){this.setSubscriber(e,{cb:r})}once(e,r){this.setSubscriber(e,{cb:r,once:!0})}emit(e,...r){const i=this._subscribers.get(e)??[],o=[];for(const l of i)l.cb(...r),l.once&&o.push(()=>i.splice(i.indexOf(l),1));for(const l of o)l()}prompt(){return new Promise(e=>{if(this._abortSignal){if(this._abortSignal.aborted)return this.state="cancel",this.close(),e(X);this._abortSignal.addEventListener("abort",()=>{this.state="cancel",this.close()},{once:!0})}this.rl=Ct.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),G(this.input,!0),this.output.on("resize",this.render),this.render(),this.once("submit",()=>{this.output.write(A.cursor.show),this.output.off("resize",this.render),G(this.input,!1),e(this.value)}),this.once("cancel",()=>{this.output.write(A.cursor.show),this.output.off("resize",this.render),G(this.input,!1),e(X)})})}_isActionKey(e,r){return e==="	"}_shouldSubmit(e,r){return!0}_setValue(e){this.value=e,this.emit("value",this.value)}_setUserInput(e,r){this.userInput=e??"",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("")}onKeypress(e,r){if(this._track&&r.name!=="return"&&(r.name&&this._isActionKey(e,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&&M.aliases.has(r.name)&&this.emit("cursor",M.aliases.get(r.name)),M.actions.has(r.name)&&this.emit("cursor",r.name)),e&&(e.toLowerCase()==="y"||e.toLowerCase()==="n")&&this.emit("confirm",e.toLowerCase()==="y"),this.emit("key",e,r),r?.name==="return"&&this._shouldSubmit(e,r)){if(this.opts.validate){const i=Yt(this.opts.validate,this.value);i&&(this.error=i instanceof Error?i.message:i,this.state="error",this.rl?.write(this.userInput))}this.state!=="error"&&(this.state="submit")}ft([e,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(`
-`),G(this.input,!1),this.rl?.close(),this.rl=void 0,this.emit(`${this.state}`,this.value),this.unsubscribe()}restoreCursor(){const e=W(this._prevFrame,process.stdout.columns,{hard:!0,trim:!1}).split(`
-`).length-1;this.output.write(A.cursor.move(-999,e*-1))}render(){const e=W(this._render(this)??"",process.stdout.columns,{hard:!0,trim:!1});if(e!==this._prevFrame){if(this.state==="initial")this.output.write(A.cursor.hide);else{const r=qt(this._prevFrame,e),i=gt(this.output);if(this.restoreCursor(),r){const o=Math.max(0,r.numLinesAfter-i),l=Math.max(0,r.numLinesBefore-i);let n=r.lines.find(a=>a>=o);if(n===void 0){this._prevFrame=e;return}if(r.lines.length===1){this.output.write(A.cursor.move(0,n-l)),this.output.write(A.erase.lines(1));const a=e.split(`
-`);this.output.write(a[n]),this._prevFrame=e,this.output.write(A.cursor.move(0,a.length-n-1));return}else if(r.lines.length>1){if(o<l)n=o;else{const s=n-l;s>0&&this.output.write(A.cursor.move(0,s))}this.output.write(A.erase.down());const a=e.split(`
-`).slice(n);this.output.write(a.join(`
-`)),this._prevFrame=e;return}}this.output.write(A.erase.down())}this.output.write(e),this.state==="initial"&&(this.state="active"),this._prevFrame=e}}}let Xt=class extends bt{options;cursor=0;get _selectedValue(){return this.options[this.cursor]}changeValue(){const e=this._selectedValue;this.value=e===void 0?void 0:e.value}constructor(e){super(e,!1),this.options=e.options;const r=this.options.findIndex(({value:o})=>o===e.initialValue),i=r===-1?0:r;this.cursor=this.options[i]?.disabled?V(i,1,this.options):i,this.changeValue(),this.on("cursor",o=>{switch(o){case"left":case"up":this.cursor=V(this.cursor,-1,this.options);break;case"down":case"right":this.cursor=V(this.cursor,1,this.options);break}this.changeValue()})}};class Zt extends bt{get userInputWithCursor(){if(this.state==="submit")return this.userInput;const e=this.userInput;if(this.cursor>=e.length)return`${this.userInput}\u2588`;const r=e.slice(0,this.cursor),i=e.slice(this.cursor,this.cursor+1),o=e.slice(this.cursor+1);return`${r}${c("inverse",i)}${o}`}get cursor(){return this._cursor}constructor(e){super({...e,initialUserInput:e.initialUserInput??e.initialValue}),this.on("userInput",r=>{this._setValue(r)}),this.on("finalize",()=>{this.value||(this.value=e.defaultValue),this.value===void 0&&(this.value="")})}}function Qt(){return C.platform!=="win32"?C.env.TERM!=="linux":!!C.env.CI||!!C.env.WT_SESSION||!!C.env.TERMINUS_SUBLIME||C.env.ConEmuTask==="{cmd::Cmder}"||C.env.TERM_PROGRAM==="Terminus-Sublime"||C.env.TERM_PROGRAM==="vscode"||C.env.TERM==="xterm-256color"||C.env.TERM==="alacritty"||C.env.TERMINAL_EMULATOR==="JetBrains-JediTerm"}const te=Qt(),T=(t,e)=>te?t:e,ee=T("\u25C6","*"),re=T("\u25A0","x"),ie=T("\u25B2","x"),xt=T("\u25C7","o"),$=T("\u2502","|"),P=T("\u2514","\u2014"),se=T("\u25CF",">"),$t=T("\u25CB"," "),ne=T("\u25CF","\u2022"),ae=T("\u25C6","*"),oe=T("\u25B2","!"),le=T("\u25A0","x"),wt=t=>{switch(t){case"initial":case"active":return c("cyan",ee);case"cancel":return c("red",re);case"error":return c("yellow",ie);case"submit":return c("green",xt)}},ce=t=>{switch(t){case"initial":case"active":return c("cyan",$);case"cancel":return c("red",$);case"error":return c("yellow",$);case"submit":return c("green",$)}};function ue(t,e){const r=[`${e?`${c("cyan",$)}  `:""}${t.join(" \u2022 ")}`];return e&&r.push(c("cyan",P)),r}const _t=(t,e,r,i,o,l=!1)=>{let n=e,a=0;if(l)for(let s=i-1;s>=r;s--){const u=t[s];if(u&&(n-=u.length),a++,n<=o)break}else for(let s=r;s<i;s++){const u=t[s];if(u&&(n-=u.length),a++,n<=o)break}return{lineCount:n,removals:a}},he=({cursor:t,options:e,style:r,output:i=process.stdout,maxItems:o=Number.POSITIVE_INFINITY,columnPadding:l=0,rowPadding:n=4})=>{const a=pt(i)-l,s=gt(i),u=c("dim","..."),m=Math.max(s-n,0),h=Math.max(Math.min(o,m),5);let d=0;t>=h-3&&(d=Math.max(Math.min(t-h+3,e.length-h),0));let p=h<e.length&&d>0,f=h<e.length&&d+h<e.length;const g=Math.min(d+h,e.length),b=[];let _=0;p&&_++,f&&_++;const I=d+(p?1:0),O=g-(f?1:0);for(let w=I;w<O;w++){const v=e[w],x=v?r(v,w===t):"",y=W(x,a,{hard:!0,trim:!1}).split(`
-`);b.push(y),_+=y.length}if(_>m){let w=0,v=0,x=_;const y=t-I;let E=m;const B=()=>_t(b,x,0,y,E),S=()=>_t(b,x,y+1,b.length,E,!0);p?({lineCount:x,removals:w}=B(),x>E&&(f||(E-=1),{lineCount:x,removals:v}=S())):(f||(E-=1),{lineCount:x,removals:v}=S(),x>E&&(E-=1,{lineCount:x,removals:w}=B())),w>0&&(p=!0,b.splice(0,w)),v>0&&(f=!0,b.splice(b.length-v,v))}const L=[];p&&L.push(u);for(const w of b)for(const v of w)L.push(v);return f&&L.push(u),L};`${c("dim","\u2191/\u2193")}`,`${c("dim","Space:")}`,`${c("dim","Enter:")}`;const N={message:(t=[],{symbol:e=c("gray",$),secondarySymbol:r=c("gray",$),output:i=process.stdout,spacing:o=1,withGuide:l}={})=>{const n=[],a=l??M.withGuide,s=a?r:"",u=a?`${e}  `:"",m=a?`${r}  `:"";for(let d=0;d<o;d++)n.push(s);const h=Array.isArray(t)?t:t.split(`
-`);if(h.length>0){const[d,...p]=h;d.length>0?n.push(`${u}${d}`):n.push(a?e:"");for(const f of p)f.length>0?n.push(`${m}${f}`):n.push(a?r:"")}i.write(`${n.join(`
+import{styleText as u}from"node:util";import A,{stdin as Ce,stdout as ae}from"node:process";import Re from"node:readline";import"node:tty";import _ from"node:fs";import y from"node:path";import{fileURLToPath as ke}from"node:url";const Ae=(()=>{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,Le=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,Oe=/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y,Me=/[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y,oe=/(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu,Ne=/\t{1,1000}/y,le=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"),Pe=/(?:[\x20-\x7E\xA0-\xFF](?!\uFE0F)){1,1000}/y,je=new RegExp("\\p{M}+","gu"),De={limit:1/0,ellipsis:""},ce=(e,t={},r={})=>{const s=t.limit??1/0,n=t.ellipsis??"",l=t?.ellipsisWidth??(n?ce(n,De,r).width:0),a=0,o=r.controlWidth??0,i=r.tabWidth??8,c=r.emojiWidth??2,d=2,h=r.regularWidth??1,m=r.wideWidth??d,f=[[Pe,h],[Oe,a],[Me,o],[Ne,i],[le,c],[oe,m]];let p=0,g=0,S=e.length,w=0,T=!1,v=S,I=Math.max(0,s-l),b=0,E=0,x=0,F=0;e:for(;;){if(E>b||g>=S&&g>p){const C=e.slice(b,E)||e.slice(p,g);w=0;for(const N of C.replaceAll(je,"")){const R=N.codePointAt(0)||0;if(Be(R)?F=d:Le(R)?F=m:F=h,x+F>I&&(v=Math.min(v,Math.max(b,p)+w)),x+F>s){T=!0;break e}w+=N.length,x+=F}b=E=0}if(g>=S)break e;for(let C=0,N=f.length;C<N;C++){const[R,ne]=f[C];if(R.lastIndex=g,R.test(e)){if(w=R===oe?Ae(e.slice(g,R.lastIndex)):R===le?1:R.lastIndex-g,F=w*ne,x+F>I&&(v=Math.min(v,g+Math.floor((I-x)/ne))),x+F>s){T=!0;break e}x+=F,b=p,E=g,g=p=R.lastIndex;continue e}}g+=1}return{width:T?I:x,index:T?v:S,truncated:T,ellipsed:T&&s>=l}},We={limit:1/0,ellipsis:"",ellipsisWidth:0},L=(e,t={})=>ce(e,We,t).width,V="\x1B",ue="\x9B",Ve=39,Y="\x07",he="[",Ue="]",me="m",q=`${Ue}8;;`,de=new RegExp(`(?:\\${he}(?<code>\\d+)m|\\${q}(?<uri>.*)${Y})`,"y"),pe=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=>`${V}${he}${e}${me}`,ge=e=>`${V}${q}${e}${Y}`,X=(e,t,r)=>{const s=t[Symbol.iterator]();let n=!1,l=!1,a=e.at(-1),o=a===void 0?0:L(a),i=s.next(),c=s.next(),d=0;for(;!i.done;){const h=i.value,m=L(h);o+m<=r?e[e.length-1]+=h:(e.push(h),o=0),(h===V||h===ue)&&(n=!0,l=t.startsWith(q,d+1)),n?l?h===Y&&(n=!1,l=!1):h===me&&(n=!1):(o+=m,o===r&&!c.done&&(e.push(""),o=0)),i=c,c=s.next(),d+=h.length}a=e.at(-1),!o&&a!==void 0&&a.length&&e.length>1&&(e[e.length-2]+=e.pop())},Ge=e=>{const t=e.split(" ");let r=t.length;for(;r&&!L(t[r-1]);)r--;return r===t.length?e:t.slice(0,r).join(" ")+t.slice(r).join("")},Ke=(e,t,r={})=>{if(r.trim!==!1&&e.trim()==="")return"";let s="",n,l;const a=e.split(" ");let o=[""],i=0;for(let h=0;h<a.length;h++){const m=a[h];if(r.trim!==!1){const p=o.at(-1)??"",g=p.trimStart();p.length!==g.length&&(o[o.length-1]=g,i=L(g))}h!==0&&(i>=t&&(r.wordWrap===!1||r.trim===!1)&&(o.push(""),i=0),(i||r.trim===!1)&&(o[o.length-1]+=" ",i++));const f=L(m);if(r.hard&&f>t){const p=t-i,g=1+Math.floor((f-p-1)/t);Math.floor((f-1)/t)<g&&o.push(""),X(o,m,t),i=L(o.at(-1)??"");continue}if(i+f>t&&i&&f){if(r.wordWrap===!1&&i<t){X(o,m,t),i=L(o.at(-1)??"");continue}o.push(""),i=0}if(i+f>t&&r.wordWrap===!1){X(o,m,t),i=L(o.at(-1)??"");continue}o[o.length-1]+=m,i+=f}r.trim!==!1&&(o=o.map(h=>Ge(h)));const c=o.join(`
+`);let d=!1;for(let h=0;h<c.length;h++){const m=c[h];if(s+=m,d)d=!1;else if(d=m>="\uD800"&&m<="\uDBFF",d)continue;if(m===V||m===ue){de.lastIndex=h+1;const p=de.exec(c)?.groups;if(p?.code!==void 0){const g=Number.parseFloat(p.code);n=g===Ve?void 0:g}else p?.uri!==void 0&&(l=p.uri.length===0?void 0:p.uri)}if(c[h+1]===`
+`){l&&(s+=ge(""));const f=n?pe(n):void 0;n&&f&&(s+=fe(f))}else m===`
+`&&(n&&pe(n)&&(s+=fe(n)),l&&(s+=ge(l)))}return s},He=/\r?\n/;function U(e,t,r){return String(e).normalize().split(He).map(s=>Ke(s,t,r)).join(`
+`)}function ze(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}var Z,be;function Je(){if(be)return Z;be=1;const e="\x1B",t=`${e}[`,r="\x07",s={to(a,o){return o?`${t}${o+1};${a+1}H`:`${t}${a+1}G`},move(a,o){let i="";return a<0?i+=`${t}${-a}D`:a>0&&(i+=`${t}${a}C`),o<0?i+=`${t}${-o}A`:o>0&&(i+=`${t}${o}B`),i},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 i=0;i<a;i++)o+=this.line+(i<a-1?s.up():"");return a&&(o+=s.left),o}};return Z={cursor:s,scroll:n,erase:l,beep:r},Z}var B=Je();function G(e,t,r){if(!r.some(a=>!a.disabled))return e;const s=e+t,n=Math.max(r.length-1,0),l=s<0?n:s>n?0:s;return r[l]?.disabled?G(l,t<0?-1:1,r):l}const Ye=["up","down","left","right","space","enter","cancel"],P={actions:new Set(Ye),aliases:new Map([["k","up"],["j","down"],["h","left"],["l","right"],["","cancel"],["escape","cancel"]]),withGuide:!0};function ye(e,t){if(typeof e=="string")return P.aliases.get(e)===t;for(const r of e)if(r!==void 0&&ye(r,t))return!0;return!1}function qe(e,t){if(e===t)return;const r=e.split(`
+`),s=t.split(`
+`),n=Math.max(r.length,s.length),l=[];for(let a=0;a<n;a++)r[a]!==s[a]&&l.push(a);return{lines:l,numLinesBefore:r.length,numLinesAfter:s.length,numLines:n}}globalThis.process.platform.startsWith("win");const Q=Symbol("clack:cancel");function D(e){return e===Q}function K(e,t){const r=e;r.isTTY&&r.setRawMode(t)}const xe=e=>"columns"in e&&typeof e.columns=="number"?e.columns:80,$e=e=>"rows"in e&&typeof e.rows=="number"?e.rows:20;function ee(e,t,r,s=r,n=r,l){const a=xe(e??ae);return U(t,a-r.length,{hard:!0,trim:!1}).split(`
+`).map((o,i,c)=>{const d=o;return i===0?`${s}${d}`:i===c.length-1?`${n}${d}`:`${r}${d}`}).join(`
+`)}function Xe(e,t){if("~standard"in e){const r=e["~standard"].validate(t);if(r instanceof Promise)throw new TypeError("Schema validation must be synchronous. Update `validate()` and remove any asynchronous logic.");return r.issues?.at(0)?.message}return e(t)}class we{input;output;_abortSignal;rl;opts;_render;_track=!1;_prevFrame="";_subscribers=new Map;_cursor=0;state="initial";error="";value;userInput="";constructor(t,r=!0){const{input:s=Ce,output:n=ae,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=s,this.output=n}unsubscribe(){this._subscribers.clear()}setSubscriber(t,r){const s=this._subscribers.get(t)??[];s.push(r),this._subscribers.set(t,s)}on(t,r){this.setSubscriber(t,{cb:r})}once(t,r){this.setSubscriber(t,{cb:r,once:!0})}emit(t,...r){const s=this._subscribers.get(t)??[],n=[];for(const l of s)l.cb(...r),l.once&&n.push(()=>s.splice(s.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(Q);this._abortSignal.addEventListener("abort",()=>{this.state="cancel",this.close()},{once:!0})}this.rl=Re.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),K(this.input,!0),this.output.on("resize",this.render),this.render(),this.once("submit",()=>{this.output.write(B.cursor.show),this.output.off("resize",this.render),K(this.input,!1),t(this.value)}),this.once("cancel",()=>{this.output.write(B.cursor.show),this.output.off("resize",this.render),K(this.input,!1),t(Q)})})}_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("")}onKeypress(t,r){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&&P.aliases.has(r.name)&&this.emit("cursor",P.aliases.get(r.name)),P.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 s=Xe(this.opts.validate,this.value);s&&(this.error=s instanceof Error?s.message:s,this.state="error",this.rl?.write(this.userInput))}this.state!=="error"&&(this.state="submit")}ye([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(`
+`),K(this.input,!1),this.rl?.close(),this.rl=void 0,this.emit(`${this.state}`,this.value),this.unsubscribe()}restoreCursor(){const t=U(this._prevFrame,process.stdout.columns,{hard:!0,trim:!1}).split(`
+`).length-1;this.output.write(B.cursor.move(-999,t*-1))}render(){const t=U(this._render(this)??"",process.stdout.columns,{hard:!0,trim:!1});if(t!==this._prevFrame){if(this.state==="initial")this.output.write(B.cursor.hide);else{const r=qe(this._prevFrame,t),s=$e(this.output);if(this.restoreCursor(),r){const n=Math.max(0,r.numLinesAfter-s),l=Math.max(0,r.numLinesBefore-s);let a=r.lines.find(o=>o>=n);if(a===void 0){this._prevFrame=t;return}if(r.lines.length===1){this.output.write(B.cursor.move(0,a-l)),this.output.write(B.erase.lines(1));const o=t.split(`
+`);this.output.write(o[a]),this._prevFrame=t,this.output.write(B.cursor.move(0,o.length-a-1));return}else if(r.lines.length>1){if(n<l)a=n;else{const i=a-l;i>0&&this.output.write(B.cursor.move(0,i))}this.output.write(B.erase.down());const o=t.split(`
+`).slice(a);this.output.write(o.join(`
+`)),this._prevFrame=t;return}}this.output.write(B.erase.down())}this.output.write(t),this.state==="initial"&&(this.state="active"),this._prevFrame=t}}}let Ze=class extends we{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),s=r===-1?0:r;this.cursor=this.options[s]?.disabled?G(s,1,this.options):s,this.changeValue(),this.on("cursor",n=>{switch(n){case"left":case"up":this.cursor=G(this.cursor,-1,this.options);break;case"down":case"right":this.cursor=G(this.cursor,1,this.options);break}this.changeValue()})}},Qe=class extends we{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),s=t.slice(this.cursor,this.cursor+1),n=t.slice(this.cursor+1);return`${r}${u("inverse",s)}${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 et(){return A.platform!=="win32"?A.env.TERM!=="linux":!!A.env.CI||!!A.env.WT_SESSION||!!A.env.TERMINUS_SUBLIME||A.env.ConEmuTask==="{cmd::Cmder}"||A.env.TERM_PROGRAM==="Terminus-Sublime"||A.env.TERM_PROGRAM==="vscode"||A.env.TERM==="xterm-256color"||A.env.TERM==="alacritty"||A.env.TERMINAL_EMULATOR==="JetBrains-JediTerm"}const tt=et(),k=(e,t)=>tt?e:t,rt=k("\u25C6","*"),it=k("\u25A0","x"),st=k("\u25B2","x"),ve=k("\u25C7","o"),$=k("\u2502","|"),j=k("\u2514","\u2014"),nt=k("\u25CF",">"),Ee=k("\u25CB"," "),at=k("\u25CF","\u2022"),ot=k("\u25C6","*"),lt=k("\u25B2","!"),ct=k("\u25A0","x"),_e=e=>{switch(e){case"initial":case"active":return u("cyan",rt);case"cancel":return u("red",it);case"error":return u("yellow",st);case"submit":return u("green",ve)}},ut=e=>{switch(e){case"initial":case"active":return u("cyan",$);case"cancel":return u("red",$);case"error":return u("yellow",$);case"submit":return u("green",$)}};function ht(e,t){const r=[`${t?`${u("cyan",$)}  `:""}${e.join(" \u2022 ")}`];return t&&r.push(u("cyan",j)),r}const Se=(e,t,r,s,n,l=!1)=>{let a=t,o=0;if(l)for(let i=s-1;i>=r;i--){const c=e[i];if(c&&(a-=c.length),o++,a<=n)break}else for(let i=r;i<s;i++){const c=e[i];if(c&&(a-=c.length),o++,a<=n)break}return{lineCount:a,removals:o}},mt=({cursor:e,options:t,style:r,output:s=process.stdout,maxItems:n=Number.POSITIVE_INFINITY,columnPadding:l=0,rowPadding:a=4})=>{const o=xe(s)-l,i=$e(s),c=u("dim","..."),d=Math.max(i-a,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,p=h<t.length&&m+h<t.length;const g=Math.min(m+h,t.length),S=[];let w=0;f&&w++,p&&w++;const T=m+(f?1:0),v=g-(p?1:0);for(let b=T;b<v;b++){const E=t[b],x=E?r(E,b===e):"",F=U(x,o,{hard:!0,trim:!1}).split(`
+`);S.push(F),w+=F.length}if(w>d){let b=0,E=0,x=w;const F=e-T;let C=d;const N=()=>Se(S,x,0,F,C),R=()=>Se(S,x,F+1,S.length,C,!0);f?({lineCount:x,removals:b}=N(),x>C&&(p||(C-=1),{lineCount:x,removals:E}=R())):(p||(C-=1),{lineCount:x,removals:E}=R(),x>C&&(C-=1,{lineCount:x,removals:b}=N())),b>0&&(f=!0,S.splice(0,b)),E>0&&(p=!0,S.splice(S.length-E,E))}const I=[];f&&I.push(c);for(const b of S)for(const E of b)I.push(E);return p&&I.push(c),I};`${u("dim","\u2191/\u2193")}`,`${u("dim","Space:")}`,`${u("dim","Enter:")}`;const O={message:(e=[],{symbol:t=u("gray",$),secondarySymbol:r=u("gray",$),output:s=process.stdout,spacing:n=1,withGuide:l}={})=>{const a=[],o=l??P.withGuide,i=o?r:"",c=o?`${t}  `:"",d=o?`${r}  `:"";for(let m=0;m<n;m++)a.push(i);const h=Array.isArray(e)?e:e.split(`
+`);if(h.length>0){const[m,...f]=h;m.length>0?a.push(`${c}${m}`):a.push(o?t:"");for(const p of f)p.length>0?a.push(`${d}${p}`):a.push(o?r:"")}s.write(`${a.join(`
 `)}
-`)},info:(t,e)=>{N.message(t,{...e,symbol:c("blue",ne)})},success:(t,e)=>{N.message(t,{...e,symbol:c("green",ae)})},step:(t,e)=>{N.message(t,{...e,symbol:c("green",xt)})},warn:(t,e)=>{N.message(t,{...e,symbol:c("yellow",oe)})},warning:(t,e)=>{N.warn(t,e)},error:(t,e)=>{N.message(t,{...e,symbol:c("red",le)})}},me=(t="",e)=>{const r=process.stdout,i=`${c("gray",P)}  `;r.write(`${i}${c("red",t)}
+`)},info:(e,t)=>{O.message(e,{...t,symbol:u("blue",at)})},success:(e,t)=>{O.message(e,{...t,symbol:u("green",ot)})},step:(e,t)=>{O.message(e,{...t,symbol:u("green",ve)})},warn:(e,t)=>{O.message(e,{...t,symbol:u("yellow",lt)})},warning:(e,t)=>{O.warn(e,t)},error:(e,t)=>{O.message(e,{...t,symbol:u("red",ct)})}},dt=(e="",t)=>{const r=process.stdout,s=`${u("gray",j)}  `;r.write(`${s}${u("red",e)}
 
-`)},de=(t="",e)=>{const r=process.stdout,i=`${c("gray",$)}
-${c("gray",P)}  `;r.write(`${i}${t}
+`)},pt=(e="",t)=>{const r=process.stdout,s=`${u("gray",$)}
+${u("gray",j)}  `;r.write(`${s}${e}
 
-`)},fe=[`${c("dim","\u2191/\u2193")} to navigate`,`${c("dim","Enter:")} confirm`],K=(t,e)=>t.includes(`
-`)?t.split(`
-`).map(r=>e(r)).join(`
-`):e(t),yt=t=>{const e=(i,o)=>{if(i===void 0)return"";const l=i.label??String(i.value);switch(o){case"disabled":return`${c("gray",$t)} ${K(l,n=>c("gray",n))}${i.hint?` ${c("dim",`(${i.hint??"disabled"})`)}`:""}`;case"selected":return`${K(l,n=>c("dim",n))}`;case"active":return`${c("green",se)} ${l}${i.hint?` ${c("dim",`(${i.hint})`)}`:""}`;case"cancelled":return`${K(l,n=>c(["strikethrough","dim"],n))}`;default:return`${c("dim",$t)} ${K(l,n=>c("dim",n))}`}},r=t.showInstructions??!0;return new Xt({options:t.options,signal:t.signal,input:t.input,output:t.output,initialValue:t.initialValue,render(){const i=t.withGuide??M.withGuide,o=`${wt(this.state)}  `,l=`${ce(this.state)}  `,n=Z(t.output,t.message,l,o),a=`${i?`${c("gray",$)}
-`:""}${n}
-`;switch(this.state){case"submit":{const s=i?`${c("gray",$)}  `:"",u=Z(t.output,e(this.options[this.cursor],"selected"),s);return`${a}${u}`}case"cancel":{const s=i?`${c("gray",$)}  `:"",u=Z(t.output,e(this.options[this.cursor],"cancelled"),s);return`${a}${u}${i?`
-${c("gray",$)}`:""}`}default:{const s=i?`${c("cyan",$)}  `:"",u=a.split(`
-`).length,m=r?ue(fe,i):i?[c("cyan",P)]:[],h=m.join(`
-`),d=m.length+1;return`${a}${s}${he({output:t.output,cursor:this.cursor,options:this.options,maxItems:t.maxItems,columnPadding:s.length,rowPadding:u+d,style:(p,f)=>e(p,p.disabled?"disabled":f?"active":"inactive")}).join(`
-${s}`)}
+`)},ft=[`${u("dim","\u2191/\u2193")} to navigate`,`${u("dim","Enter:")} confirm`],H=(e,t)=>e.includes(`
+`)?e.split(`
+`).map(r=>t(r)).join(`
+`):t(e),te=e=>{const t=(s,n)=>{if(s===void 0)return"";const l=s.label??String(s.value);switch(n){case"disabled":return`${u("gray",Ee)} ${H(l,a=>u("gray",a))}${s.hint?` ${u("dim",`(${s.hint??"disabled"})`)}`:""}`;case"selected":return`${H(l,a=>u("dim",a))}`;case"active":return`${u("green",nt)} ${l}${s.hint?` ${u("dim",`(${s.hint})`)}`:""}`;case"cancelled":return`${H(l,a=>u(["strikethrough","dim"],a))}`;default:return`${u("dim",Ee)} ${H(l,a=>u("dim",a))}`}},r=e.showInstructions??!0;return new Ze({options:e.options,signal:e.signal,input:e.input,output:e.output,initialValue:e.initialValue,render(){const s=e.withGuide??P.withGuide,n=`${_e(this.state)}  `,l=`${ut(this.state)}  `,a=ee(e.output,e.message,l,n),o=`${s?`${u("gray",$)}
+`:""}${a}
+`;switch(this.state){case"submit":{const i=s?`${u("gray",$)}  `:"",c=ee(e.output,t(this.options[this.cursor],"selected"),i);return`${o}${c}`}case"cancel":{const i=s?`${u("gray",$)}  `:"",c=ee(e.output,t(this.options[this.cursor],"cancelled"),i);return`${o}${c}${s?`
+${u("gray",$)}`:""}`}default:{const i=s?`${u("cyan",$)}  `:"",c=o.split(`
+`).length,d=r?ht(ft,s):s?[u("cyan",j)]:[],h=d.join(`
+`),m=d.length+1;return`${o}${i}${mt({output:e.output,cursor:this.cursor,options:this.options,maxItems:e.maxItems,columnPadding:i.length,rowPadding:c+m,style:(f,p)=>t(f,f.disabled?"disabled":p?"active":"inactive")}).join(`
+${i}`)}
 ${h}
-`}}}}).prompt()};`${c("gray",$)}`;const vt=t=>new Zt({validate:t.validate,placeholder:t.placeholder,defaultValue:t.defaultValue,initialValue:t.initialValue,output:t.output,signal:t.signal,input:t.input,render(){const e=t?.withGuide??M.withGuide,r=`${`${e?`${c("gray",$)}
-`:""}${wt(this.state)}  `}${t.message}
-`,i=t.placeholder&&t.placeholder.length>0?c("inverse",t.placeholder[0])+c("dim",t.placeholder.slice(1)):c(["inverse","hidden"],"_"),o=this.userInput?this.userInputWithCursor:i,l=this.value??"";switch(this.state){case"error":{const n=this.error?`  ${c("yellow",this.error)}`:"",a=e?`${c("yellow",$)}  `:"",s=e?c("yellow",P):"";return`${r.trim()}
-${a}${o}
-${s}${n}
-`}case"submit":{const n=l?`  ${c("dim",l)}`:"",a=e?c("gray",$):"";return`${r}${a}${n}`}case"cancel":{const n=l?`  ${c(["strikethrough","dim"],l)}`:"",a=e?c("gray",$):"";return`${r}${a}${n}${l.trim()?`
-${a}`:""}`}default:{const n=e?`${c("cyan",$)}  `:"",a=e?c("cyan",P):"";return`${r}${n}${o}
-${a}
-`}}}}).prompt();function Q(t){return t==null?[]:Array.isArray(t)?t:[t]}function pe(t,e,r,i){var o,l=t[e],n=~i.string.indexOf(e)?r==null||r===!0?"":String(r):typeof r=="boolean"?r:~i.boolean.indexOf(e)?r==="false"?!1:r==="true"||(t._.push((o=+r,o*0===0?o:r)),!!r):(o=+r,o*0===0?o:r);t[e]=l==null?n:Array.isArray(l)?l.concat(n):[l,n]}function ge(t,e){t=t||[],e=e||{};var r,i,o,l,n,a={_:[]},s=0,u=0,m=0,h=t.length;const d=e.alias!==void 0,p=e.unknown!==void 0,f=e.default!==void 0;if(e.alias=e.alias||{},e.string=Q(e.string),e.boolean=Q(e.boolean),d)for(r in e.alias)for(i=e.alias[r]=Q(e.alias[r]),s=0;s<i.length;s++)(e.alias[i[s]]=i.concat(r)).splice(s,1);for(s=e.boolean.length;s-- >0;)for(i=e.alias[e.boolean[s]]||[],u=i.length;u-- >0;)e.boolean.push(i[u]);for(s=e.string.length;s-- >0;)for(i=e.alias[e.string[s]]||[],u=i.length;u-- >0;)e.string.push(i[u]);if(f){for(r in e.default)if(l=typeof e.default[r],i=e.alias[r]=e.alias[r]||[],e[l]!==void 0)for(e[l].push(r),s=0;s<i.length;s++)e[l].push(i[s])}const g=p?Object.keys(e.alias):[];for(s=0;s<h;s++){if(o=t[s],o==="--"){a._=a._.concat(t.slice(++s));break}for(u=0;u<o.length&&o.charCodeAt(u)===45;u++);if(u===0)a._.push(o);else if(o.substring(u,u+3)==="no-"){if(l=o.substring(u+3),p&&!~g.indexOf(l))return e.unknown(o);a[l]=!1}else{for(m=u+1;m<o.length&&o.charCodeAt(m)!==61;m++);for(l=o.substring(u,m),n=o.substring(++m)||s+1===h||(""+t[s+1]).charCodeAt(0)===45||t[++s],i=u===2?[l]:l,m=0;m<i.length;m++){if(l=i[m],p&&!~g.indexOf(l))return e.unknown("-".repeat(u)+l);pe(a,l,m+1<i.length||n,e)}}}if(f)for(r in e.default)a[r]===void 0&&(a[r]=e.default[r]);if(d)for(r in a)for(i=e.alias[r]||[];i.length>0;)a[i.shift()]=a[r];return a}var H={exports:{}},Et;function be(){if(Et)return H.exports;Et=1;let t=process||{},e=t.argv||[],r=t.env||{},i=!(r.NO_COLOR||e.includes("--no-color"))&&(!!r.FORCE_COLOR||e.includes("--color")||t.platform==="win32"||(t.stdout||{}).isTTY&&r.TERM!=="dumb"||!!r.CI),o=(a,s,u=a)=>m=>{let h=""+m,d=h.indexOf(s,a.length);return~d?a+l(h,s,u,d)+s:a+h+s},l=(a,s,u,m)=>{let h="",d=0;do h+=a.substring(d,m)+u,d=m+s.length,m=a.indexOf(s,d);while(~m);return h+a.substring(d)},n=(a=i)=>{let s=a?o:()=>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 H.exports=n(),H.exports.createColors=n,H.exports}var xe=be();const $e=Ht(xe),{cyan:we,yellow:_e}=$e,St=[{name:"vanilla-ts",display:"Vanilla",description:"with PlayCanvas Engine",color:_e},{name:"react-ts",display:"React",description:"with @playcanvas/react",color:we}],ye=async({argTemplate:t,cancel:e})=>{if(t&&St.some(i=>i.name===t))return t;const r=await yt({message:t?`"${t}" isn't a valid template. Please choose from below: `:"Select a template:",options:St.map(i=>({label:i.color(i.display),value:i.name,hint:i.description}))});return U(r)&&e(),r},It=t=>/^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(t),Ft=t=>t.trim().toLowerCase().replace(/\s+/g,"-").replace(/^[._]/,"").replace(/[^a-z\d\-~]+/g,"-"),ve=async({targetDir:t,cancel:e})=>{let r=F.basename(F.resolve(t));if(!It(r)){const i=await vt({message:"Package name:",defaultValue:Ft(r),placeholder:Ft(r),validate:o=>{if(!o||!It(o))return"Invalid package.json name"}});if(U(i))return e();r=i}return r},tt=t=>t.trim().replace(/\/+$/g,""),Ee=t=>{const e=R.readdirSync(t);return e.length===0||e.length===1&&e[0]===".git"},Se=t=>{if(R.existsSync(t))for(const e of R.readdirSync(t))e!==".git"&&R.rmSync(F.resolve(t,e),{recursive:!0,force:!0})},Ie=async({argTargetDir:t,defaultTargetDir:e,cancel:r})=>{let i=t?tt(String(t)):void 0;if(!i){const o=await vt({message:"Project name:",defaultValue:e,placeholder:e});U(o)&&r(),i=tt(o)}return i},Fe=async({targetDir:t,argOverwrite:e,cancel:r})=>{if(R.existsSync(t)&&!Ee(t)){const i=e?"yes":await yt({message:(t==="."?"Current directory":`Target directory "${t}"`)+" 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(U(i))return r();switch(i){case"yes":Se(t);break;case"no":r();return}}},Te=t=>{const{cwd:e,targetDir:r,template:i,packageName:o,renameFiles:l}=t,n=F.resolve(e,r);R.mkdirSync(n,{recursive:!0});const a=process.env.npm_config_user_agent?.split("/")[0]??"npm";N.step(`Creating project in ${n}...`);const s=Rt(import.meta.url),u=F.dirname(s),m=[F.resolve(u,"../templates",i),F.resolve(u,"../../templates",i)].find(b=>R.existsSync(b));if(!m)throw new Error(`Template directory not found for: ${i}`);const h=(b,_)=>{const I=F.join(n,l[b]??b);_!==void 0?R.writeFileSync(I,_):R.cpSync(F.join(m,b),I,{recursive:!0})},d=R.readdirSync(m);for(const b of d.filter(_=>_!=="package.json"))h(b);const p=JSON.parse(R.readFileSync(F.join(m,"package.json"),"utf-8"));p.name=o,h("package.json",JSON.stringify(p,null,4)+`
-`);let f=`Project created. Now run:
-`;const g=F.isAbsolute(r)?n:F.relative(e,n);switch(n!==e&&(f+=`
-  cd ${g.includes(" ")?`"${g}"`:g}`),a){case"yarn":f+=`
-  yarn`,f+=`
-  yarn dev`;break;default:f+=`
-  ${a} install`,f+=`
-  ${a} run dev`;break}de(f)},D=ge(process.argv.slice(2),{alias:{h:"help",t:"template"},boolean:["help","overwrite"],string:["template"]}),Ce=process.cwd(),Re=`Usage: npm create playcanvas@latest [OPTION]...
+`}}}}).prompt()};`${u("gray",$)}`;const Ie=e=>new Qe({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??P.withGuide,r=`${`${t?`${u("gray",$)}
+`:""}${_e(this.state)}  `}${e.message}
+`,s=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:s,l=this.value??"";switch(this.state){case"error":{const a=this.error?`  ${u("yellow",this.error)}`:"",o=t?`${u("yellow",$)}  `:"",i=t?u("yellow",j):"";return`${r.trim()}
+${o}${n}
+${i}${a}
+`}case"submit":{const a=l?`  ${u("dim",l)}`:"",o=t?u("gray",$):"";return`${r}${o}${a}`}case"cancel":{const a=l?`  ${u(["strikethrough","dim"],l)}`:"",o=t?u("gray",$):"";return`${r}${o}${a}${l.trim()?`
+${o}`:""}`}default:{const a=t?`${u("cyan",$)}  `:"",o=t?u("cyan",j):"";return`${r}${a}${n}
+${o}
+`}}}}).prompt();function re(e){return e==null?[]:Array.isArray(e)?e:[e]}function gt(e,t,r,s){var n,l=e[t],a=~s.string.indexOf(t)?r==null||r===!0?"":String(r):typeof r=="boolean"?r:~s.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 bt(e,t){e=e||[],t=t||{};var r,s,n,l,a,o={_:[]},i=0,c=0,d=0,h=e.length;const m=t.alias!==void 0,f=t.unknown!==void 0,p=t.default!==void 0;if(t.alias=t.alias||{},t.string=re(t.string),t.boolean=re(t.boolean),m)for(r in t.alias)for(s=t.alias[r]=re(t.alias[r]),i=0;i<s.length;i++)(t.alias[s[i]]=s.concat(r)).splice(i,1);for(i=t.boolean.length;i-- >0;)for(s=t.alias[t.boolean[i]]||[],c=s.length;c-- >0;)t.boolean.push(s[c]);for(i=t.string.length;i-- >0;)for(s=t.alias[t.string[i]]||[],c=s.length;c-- >0;)t.string.push(s[c]);if(p){for(r in t.default)if(l=typeof t.default[r],s=t.alias[r]=t.alias[r]||[],t[l]!==void 0)for(t[l].push(r),i=0;i<s.length;i++)t[l].push(s[i])}const g=f?Object.keys(t.alias):[];for(i=0;i<h;i++){if(n=e[i],n==="--"){o._=o._.concat(e.slice(++i));break}for(c=0;c<n.length&&n.charCodeAt(c)===45;c++);if(c===0)o._.push(n);else if(n.substring(c,c+3)==="no-"){if(l=n.substring(c+3),f&&!~g.indexOf(l))return t.unknown(n);o[l]=!1}else{for(d=c+1;d<n.length&&n.charCodeAt(d)!==61;d++);for(l=n.substring(c,d),a=n.substring(++d)||i+1===h||(""+e[i+1]).charCodeAt(0)===45||e[++i],s=c===2?[l]:l,d=0;d<s.length;d++){if(l=s[d],f&&!~g.indexOf(l))return t.unknown("-".repeat(c)+l);gt(o,l,d+1<s.length||a,t)}}}if(p)for(r in t.default)o[r]===void 0&&(o[r]=t.default[r]);if(m)for(r in o)for(s=t.alias[r]||[];s.length>0;)o[s.shift()]=o[r];return o}var z={exports:{}},Fe;function yt(){if(Fe)return z.exports;Fe=1;let e=process||{},t=e.argv||[],r=e.env||{},s=!(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,i,c=o)=>d=>{let h=""+d,m=h.indexOf(i,o.length);return~m?o+l(h,i,c,m)+i:o+h+i},l=(o,i,c,d)=>{let h="",m=0;do h+=o.substring(m,d)+c,m=d+i.length,d=o.indexOf(i,m);while(~d);return h+o.substring(m)},a=(o=s)=>{let i=o?n:()=>String;return{isColorSupported:o,reset:i("\x1B[0m","\x1B[0m"),bold:i("\x1B[1m","\x1B[22m","\x1B[22m\x1B[1m"),dim:i("\x1B[2m","\x1B[22m","\x1B[22m\x1B[2m"),italic:i("\x1B[3m","\x1B[23m"),underline:i("\x1B[4m","\x1B[24m"),inverse:i("\x1B[7m","\x1B[27m"),hidden:i("\x1B[8m","\x1B[28m"),strikethrough:i("\x1B[9m","\x1B[29m"),black:i("\x1B[30m","\x1B[39m"),red:i("\x1B[31m","\x1B[39m"),green:i("\x1B[32m","\x1B[39m"),yellow:i("\x1B[33m","\x1B[39m"),blue:i("\x1B[34m","\x1B[39m"),magenta:i("\x1B[35m","\x1B[39m"),cyan:i("\x1B[36m","\x1B[39m"),white:i("\x1B[37m","\x1B[39m"),gray:i("\x1B[90m","\x1B[39m"),bgBlack:i("\x1B[40m","\x1B[49m"),bgRed:i("\x1B[41m","\x1B[49m"),bgGreen:i("\x1B[42m","\x1B[49m"),bgYellow:i("\x1B[43m","\x1B[49m"),bgBlue:i("\x1B[44m","\x1B[49m"),bgMagenta:i("\x1B[45m","\x1B[49m"),bgCyan:i("\x1B[46m","\x1B[49m"),bgWhite:i("\x1B[47m","\x1B[49m"),blackBright:i("\x1B[90m","\x1B[39m"),redBright:i("\x1B[91m","\x1B[39m"),greenBright:i("\x1B[92m","\x1B[39m"),yellowBright:i("\x1B[93m","\x1B[39m"),blueBright:i("\x1B[94m","\x1B[39m"),magentaBright:i("\x1B[95m","\x1B[39m"),cyanBright:i("\x1B[96m","\x1B[39m"),whiteBright:i("\x1B[97m","\x1B[39m"),bgBlackBright:i("\x1B[100m","\x1B[49m"),bgRedBright:i("\x1B[101m","\x1B[49m"),bgGreenBright:i("\x1B[102m","\x1B[49m"),bgYellowBright:i("\x1B[103m","\x1B[49m"),bgBlueBright:i("\x1B[104m","\x1B[49m"),bgMagentaBright:i("\x1B[105m","\x1B[49m"),bgCyanBright:i("\x1B[106m","\x1B[49m"),bgWhiteBright:i("\x1B[107m","\x1B[49m")}};return z.exports=a(),z.exports.createColors=a,z.exports}var xt=yt();const $t=ze(xt),{cyan:wt,magenta:vt,yellow:Et}=$t,J=[{name:"engine",display:"Engine",description:"with the PlayCanvas Engine API directly",color:Et},{name:"react",display:"React",description:"with @playcanvas/react",color:wt},{name:"web-components",display:"Web Components",description:"with @playcanvas/web-components",color:vt}],W=[{name:"spinning-cube",display:"Spinning Cube",description:"a rotating cube and a light"},{name:"interactive-sphere",display:"Interactive Sphere",description:"orbit controls, a grid and pointer picking"},{name:"model-viewer",display:"Model Viewer",description:"a glTF model, orbit controls and a procedural sky"},{name:"splat-viewer",display:"Splat Viewer",description:"a Gaussian splat and orbit controls"}],_t=async({argBoilerplate:e,yes:t,cancel:r})=>{if(e&&W.some(n=>n.name===e))return e;if(!process.stdout.isTTY||t){if(!e)return W[0].name;throw new Error(`Unknown boilerplate: ${e}. Choose from: ${W.map(n=>n.name).join(", ")}`)}const s=await te({message:e?`"${e}" isn't a valid boilerplate. Please choose from below: `:"Select a boilerplate:",initialValue:W[0].name,options:W.map(n=>({label:n.display,value:n.name,hint:n.description}))});return D(s)&&r(),s},St=async({argTemplate:e,yes:t,cancel:r})=>{if(e&&J.some(n=>n.name===e))return e;if(e&&(!process.stdout.isTTY||t))throw new Error(`Unknown template: ${e}. Choose from: ${J.map(n=>n.name).join(", ")}`);if(t)return J[0].name;const s=await te({message:e?`"${e}" isn't a valid template. Please choose from below: `:"Select a template:",options:J.map(n=>({label:n.color(n.display),value:n.name,hint:n.description}))});return D(s)&&r(),s},Te=e=>/^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(e),ie=e=>e.trim().toLowerCase().replace(/\s+/g,"-").replace(/^[._]/,"").replace(/[^a-z\d\-~]+/g,"-"),It=async({targetDir:e,yes:t,cancel:r})=>{let s=y.basename(y.resolve(e));if(!Te(s)){if(t)return ie(s);const n=await Ie({message:"Package name:",defaultValue:ie(s),placeholder:ie(s),validate:l=>{if(!l||!Te(l))return"Invalid package.json name"}});if(D(n))return r();s=n}return s},se=e=>e.trim().replace(/\/+$/g,""),Ft=e=>{const t=_.readdirSync(e);return t.length===0||t.length===1&&t[0]===".git"},Tt=e=>{if(_.existsSync(e))for(const t of _.readdirSync(e))t!==".git"&&_.rmSync(y.resolve(e,t),{recursive:!0,force:!0})},Ct=async({argTargetDir:e,defaultTargetDir:t,yes:r,cancel:s})=>{let n=e?se(String(e)):void 0;if(!n&&r)return t;if(!n){const l=await Ie({message:"Project name:",defaultValue:t,placeholder:t});D(l)&&s(),n=se(l)}return n},Rt=async({targetDir:e,argOverwrite:t,yes:r,cancel:s})=>{if(_.existsSync(e)&&!Ft(e)){if(r&&!t)throw new Error(`Target directory "${e}" is not empty. Pass --overwrite to remove its contents.`);const n=t?"yes":await te({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(D(n))return s();switch(n){case"yes":Tt(e);break;case"no":s();return}}},kt=e=>{const{cwd:t,targetDir:r,template:s,boilerplate:n,packageName:l,skills:a,renameFiles:o}=e,i=y.resolve(t,r);_.mkdirSync(i,{recursive:!0});const c=process.env.npm_config_user_agent?.split("/")[0]??"npm";O.step(`Creating project in ${i}...`);const d=ke(import.meta.url),h=y.dirname(d),m=[y.resolve(h,"../templates"),y.resolve(h,"../../templates")].find(v=>_.existsSync(y.join(v,s)));if(!m)throw new Error(`Template directory not found for: ${s}`);const f=y.join(m,s),p=y.join(m,"_shared",n);_.existsSync(p)&&_.cpSync(p,i,{recursive:!0});for(const v of["base",n]){const I=y.join(f,v);if(!_.existsSync(I))throw new Error(`Boilerplate directory not found: ${s}/${v}`);_.cpSync(I,i,{recursive:!0})}for(const[v,I]of Object.entries(o)){const b=y.join(i,v);_.existsSync(b)&&_.renameSync(b,y.join(i,I))}const g=y.join(i,"package.json"),S=JSON.parse(_.readFileSync(g,"utf-8"));if(S.name=l,_.writeFileSync(g,JSON.stringify(S,null,4)+`
+`),a){const v=[y.resolve(h,"../skills"),y.resolve(h,"../../skills")].find(b=>_.existsSync(b));if(!v)throw new Error("Skills directory not found");const I=_.readdirSync(v,{withFileTypes:!0}).filter(b=>b.isDirectory()).map(b=>b.name);for(const b of[".claude/skills",".agents/skills"])for(const E of I)_.cpSync(y.join(v,E),y.join(i,b,E),{recursive:!0});O.step("Added PlayCanvas agent skills (opt out with --no-skills)")}let w=`Project created. Now run:
+`;const T=y.isAbsolute(r)?i:y.relative(t,i);switch(i!==t&&(w+=`
+  cd ${T.includes(" ")?`"${T}"`:T}`),c){case"yarn":w+=`
+  yarn`,w+=`
+  yarn dev`;break;default:w+=`
+  ${c} install`,w+=`
+  ${c} run dev`;break}pt(w)},M=bt(process.argv.slice(2),{alias:{h:"help",t:"template",b:"boilerplate",y:"yes"},boolean:["help","overwrite","yes"],string:["template","boilerplate"]}),At=process.cwd(),Bt=`Usage: npm create playcanvas@latest [OPTION]...
 
 Create a new PlayCanvas project with TypeScript.
 With no arguments, start the CLI in interactive mode.
 
 Options:
   -t, --template NAME        use a specific template
+  -b, --boilerplate NAME     use a specific boilerplate
       --overwrite            remove existing files from a non-empty target directory
+      --no-skills            omit the PlayCanvas agent skills
+  -y, --yes                  skip the prompts and take the defaults
   -h, --help                 show help
-`,Ae={_gitignore:".gitignore"},Le="playcanvas-project",ke=async()=>{const t=D._[0]?tt(String(D._[0])):void 0,e=D.template,r=D.overwrite;if(D.help){console.log(Re);return}const i=()=>{me("Operation cancelled"),process.exit(0)},o=await Ie({argTargetDir:t,defaultTargetDir:Le,cancel:i});await Fe({targetDir:o,argOverwrite:r,cancel:i});const l=await ve({targetDir:o,cancel:i}),n=await ye({argTemplate:e,cancel:i});await Te({cwd:Ce,targetDir:o,template:n,packageName:l,renameFiles:Ae})};ke().catch(t=>{console.error(t),process.exitCode=1});
+`,Lt={_gitignore:".gitignore"},Ot="playcanvas-project",Mt=async()=>{const e=M._[0]?se(String(M._[0])):void 0,t=M.template,r=M.boilerplate,s=M.overwrite,n=M.yes;if(M.help){console.log(Bt);return}const l=()=>{dt("Operation cancelled"),process.exit(0)},a=await Ct({argTargetDir:e,defaultTargetDir:Ot,yes:n,cancel:l});await Rt({targetDir:a,argOverwrite:s,yes:n,cancel:l});const o=await It({targetDir:a,yes:n,cancel:l}),i=await St({argTemplate:t,yes:n,cancel:l}),c=await _t({argBoilerplate:r,yes:n,cancel:l}),d=M.skills??!0;kt({cwd:At,targetDir:a,template:i,boilerplate:c,packageName:o,skills:d,renameFiles:Lt})};Mt().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.3.0",
+    "version": "0.5.0",
     "description": "Scaffold a PlayCanvas project",
     "keywords": [
         "playcanvas",
@@ -9,6 +9,7 @@
         "template",
         "vite",
         "react",
+        "web-components",
         "typescript",
         "webgl",
         "webgpu",
@@ -27,6 +28,7 @@
         "create-playcanvas": "dist/index.mjs"
     },
     "files": [
+        "skills",
         "templates",
         "dist"
     ],

package/skills/add-effects/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: add-effects
+description: Use when adding transient visual effects or trails to a PlayCanvas app to select an Engine-native implementation, place and layer it correctly, manage its lifecycle, and verify the rendered result.
+---
+
+# Effects and game feel
+
+Add transient effects as short-lived, self-owning entities triggered by application events, not as
+permanent scene fixtures.
+
+Reuse before authoring. Adapt the closest official particle example with `find-examples`, prefer the
+Engine's built-in particle component over a hand-written system, and discover any shipped trail or
+effect script with `reuse-scripts`.
+
+Copy particle curve construction from the installed example exactly. `CurveSet` takes one key array
+per channel, such as `new CurveSet([0, x0, 1, x1], [0, y0, 1, y1], [0, z0, 1,
+z1])`; do not flatten three channels into one array. A malformed curve can type-check and then fail
+inside the particle texture upload. Create one emitter, render a frame, and require empty runtime
+and console diagnostics before reusing the helper for smoke, spray, or splashes.
+
+For a polished wake, smoke, or spray requirement, do not stop at scaled planes, crossed billboards,
+or generic render primitives. Use the built-in particle component for smoke and spray; reserve a
+custom mesh and material for a continuously sampled wake ribbon. Verify tint and blending against
+the actual scene lighting and surface.
+
+## Place and layer
+
+- Spawn an effect at the emitter's world mount point, either parent it there or copy the world
+  transform once, and let it destroy itself when finished. Never leak emitters.
+- Keep additive or transparent effects above the surface they sit on and biased toward the camera so
+  they do not z-fight. Inspect soft transparency at grazing angles for hard edges, black quads, or
+  dropout.
+- Size and orient effects from the emitter's calibrated bounds, not a guessed constant.
+
+## Moving trails
+
+- Treat built-in render primitives as blocking geometry for soft effects. Follow the closest
+  official example to choose particles, a custom mesh, textures, materials, and blending for the
+  intended visual behavior.
+- Match every custom mesh's vertex streams to its material. A lit `StandardMaterial` needs normals;
+  calculate and set them before `mesh.update()`, or deliberately use an unlit material. Treat a
+  missing vertex-attribute diagnostic as a rendering failure even when some frames still appear.
+  For a dynamic horizontal ribbon created with `setVertexStream`, allocate a normal array alongside
+  positions, fill every vertex with `(0, 1, 0)`, and upload it as `SEMANTIC_NORMAL` before the first
+  `update()`. Recheck this whenever changing the ribbon's material type.
+- Never attach an empty dynamic mesh to an enabled render component. Upload a valid initial vertex
+  and index set before creating its `MeshInstance`, or keep the render entity disabled until the
+  first complete update. On reset, disable it or restore valid seed geometry; do not call
+  `mesh.clear()` while an enabled renderer still references it. Reflection and refraction cameras
+  render the same mesh and can expose this lifecycle bug before the gameplay camera does.
+- Judge a trail from its intended cameras. If it reads as a flat decal, use the reference example to
+  add the minimum depth cue needed rather than stacking arbitrary geometry.
+- Sample the trail continuously. Append segments on a small time- or distance-step and interpolate
+  between them; coarse per-distance chunks make the trail stutter and break into visible dashes as
+  the object speeds up.
+- Anchor it to the mover's contact or exhaust point, scale emission rate and length with speed, and
+  fade the tail so it dissolves instead of cutting off with a hard edge.
+
+## Camera shake and hit feedback
+
+- Drive camera shake as a decaying offset on a camera parent or an additive layer; never write it
+  into the smoothed chase position, or it fights the follow. Keep shake and follow separate, as the
+  orbit-camera rule in `apply-conventions` requires.
+- Stagger the parts of a compound effect over a few frames — flash, then smoke, then splash — so an
+  event reads as a sequence rather than a single pop.
+- Keep the readable peak long enough for the gameplay camera to see the layers together. A flash can
+  be brief, but the longer-lived layers should overlap for several frames rather than leaving the
+  primary action frame visually identical to the idle state.
+- For side-mounted emitters, derive every spawn point and direction from calibrated world-space
+  mounts on the mover. Confirm the effect starts outside the source geometry from both sides; an
+  active cooldown with only a tiny flash elsewhere in the frame is failed feedback.
+
+## Prove it fires
+
+Trigger each effect through real gameplay input and confirm with a screenshot captured at its peak,
+not a saved filepath. Confirm the effect is visible from the gameplay camera and from a grazing
+angle, that emitters are gone after their lifetime (query the entity count), and that nothing leaves
+a black quad or a hard edge over the surface.
+
+Choose the authoring surface with the `build-app` skill; create effects through its entity and
+component primitives and own their lifecycle in the surface that spawned them.

package/skills/apply-conventions/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: apply-conventions
+description: Use when writing or reviewing PlayCanvas Engine code involving entity transforms, cameras, physics, materials, model orientation, bounds, or imports to apply the Engine's coordinate and API conventions.
+---
+
+# Engine conventions
+
+Read `package.json` and the installed `playcanvas` source before relying on version-sensitive API
+details. Apply these stable conventions throughout the project.
+
+## Coordinates and angles
+
+- Use the right-handed coordinate system: +Y is up and the gameplay ground plane is XZ.
+- Treat `entity.forward` and the camera viewing direction as -Z; `entity.right` is +X and
+  `entity.up` is +Y. `lookAt` points -Z at the target.
+- Expect glTF models authored toward +Z to need a yaw correction. Inspect and calibrate each
+  directional model instead of applying one global correction.
+- Pass degrees in XYZ order to high-level angle APIs.
+- Keep pitch, yaw, and roll as application state. Do not repeatedly read `getEulerAngles()` and
+  feed its decomposition back into `setEulerAngles()`.
+- Interpolate periodic angles with `math.lerpAngle()` or rotations with `Quat.slerp()`, not scalar
+  lerp across the 0/360 seam.
+
+## Transforms and units
+
+- Use `setPosition`, `setRotation`, and `setEulerAngles` for world transforms.
+- Use the `setLocal*` variants below a parent.
+- Treat units as metres. Physics gravity defaults to `(0, -9.81, 0)`.
+- Keep gameplay transforms on a semantic root and asset-authoring corrections on a child.
+- Do not scale rigid-body roots or skinned bones.
+
+## Cameras, materials, and bounds
+
+- Perspective camera FOV is vertical and defaults to 45 degrees.
+- Smooth an orbit camera's focus, yaw, pitch, and distance, then derive its position. Do not
+  `Vec3.lerp()` between orbit positions on opposite sides of the focus; the chord crosses the subject.
+- Before writing custom camera input, inspect the installed controller script and its matching
+  Engine example. Preserve their gesture mapping and damping unless the product explicitly asks
+  for different behavior; do not derive signs from memory.
+- Define the input contract in screen space, then verify positive and negative movement on both axes
+  with real input after a rendered frame. Judge the camera basis or a projected fixed landmark, not
+  world-space camera coordinates or internal angle signs; both can approve inverted behavior.
+- Materials cull back faces by default; counter-clockwise winding defines the front face.
+- Clone a material before per-instance tinting or edits, and assign the clone; never mutate one
+  shared by other instances, including default and asset-imported materials.
+- Entities do not have an `aabb`. Union descendant `meshInstance.aabb` values after transforms have
+  synchronized.
+- Let `Mesh.update()` calculate local bounds. If passing `false` for `updateBoundingBox`, assign an
+  explicit `mesh.aabb` before the mesh can be culled.
+- Expand custom-mesh bounds by the maximum vertex-shader displacement; CPU bounds do not observe
+  shader deformation.
+- Treat offline skinned-mesh bounds as bind-pose estimates and confirm animated poses at runtime.
+
+## Imports
+
+Use named ESM imports from `playcanvas`. Import production scripts only from
+`playcanvas/scripts/esm/**`; legacy sibling script directories depend on a global Engine namespace.
+
+## Runtime confirmation
+
+Offline measurements cannot prove facing, animated poses, or final placement. Confirm each one in the
+running application:
+
+- Start the project's own dev server or build; do not construct a separate harness.
+- Log the value from inside the Engine, using `getPosition()`, `getEulerAngles()`, a
+  `meshInstance.aabb`, or an anim component's active state, from a `Script` or an update callback.
+- For large or vertex-displaced meshes, inspect their runtime AABB and `visibleThisFrame` after a
+  rendered frame from at least two representative camera angles.
+- Confirm a directional model's visible front aligns with its semantic root's `forward`; a stored
+  yaw or runtime transform alone cannot prove mesh facing.
+- Read that logged value from the browser console. Screenshots judge composition and orientation;
+  numeric claims require logged values.
+- Record the confirmed value in application state or an asset tuning record, then remove the logging.