@php-wasm/compile-extension 3.1.30 → 3.1.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +27 -6
  2. package/cli.js.map +1 -1
  3. package/manifest.d.ts +15 -0
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -44,6 +44,27 @@ npx @php-wasm/compile-extension \
44
44
  Empty directories are recorded as `type: "directory"` nodes so the loader
45
45
  creates them before PHP starts.
46
46
 
47
+ If an extension needs startup settings, add them to the manifest:
48
+
49
+ ```json
50
+ {
51
+ "name": "spx",
52
+ "version": "0.1.0",
53
+ "artifacts": [
54
+ {
55
+ "phpVersion": "8.4",
56
+ "sourcePath": "spx-php8.4-jspi.so"
57
+ }
58
+ ],
59
+ "iniEntries": {
60
+ "spx.http_enabled": "1"
61
+ },
62
+ "env": {
63
+ "SPX_DATA_DIR": "/internal/shared/spx/data"
64
+ }
65
+ }
66
+ ```
67
+
47
68
  The supported `--php-versions` are `7.4` and `8.0` through `8.5`.
48
69
 
49
70
  Docker is required. The CLI lazily fetches the small PHP.wasm Docker asset set
@@ -60,14 +81,14 @@ The package only needs Docker and Node. It does not require a checkout of
60
81
 
61
82
  - uses: actions/setup-node@v4
62
83
  with:
63
- node-version: '24'
84
+ node-version: '24'
64
85
 
65
86
  - run: |
66
- npx --yes @php-wasm/compile-extension \
67
- --source ./my-extension \
68
- --name my_extension \
69
- --php-versions 8.0,8.1,8.2,8.3,8.4,8.5 \
70
- --out ./dist/my-extension
87
+ npx --yes @php-wasm/compile-extension \
88
+ --source ./my-extension \
89
+ --name my_extension \
90
+ --php-versions 8.0,8.1,8.2,8.3,8.4,8.5 \
91
+ --out ./dist/my-extension
71
92
  ```
72
93
 
73
94
  In a matrix workflow, set `strategy.max-parallel: 1` on the WASM job —
package/cli.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"mappings":";s4CAMaA,EACZ,wDAEYC,EAAmB,CAC/B,gCACA,0CACA,gCACA,6CACA,yBACA,0CACA,8CACD,EAEMC,GAA6BD,EAAiB,IAClDE,GAAiB,qBAAqBA,CAAY,EACpD,EAcA,eAAsBC,GAAmB,CACxC,cAAAC,EACA,YAAAC,EACA,UAAAC,EAAYC,GAAA,EACZ,kBAAmBC,CACpB,EAA+C,CAC9C,MAAMC,EAAMC,GAAuB,CAAE,cAAAN,EAAe,YAAAC,EAAa,EAC3DM,EAAcC,EAAK,KAAKN,EAAWO,EAAWJ,CAAG,EAAG,UAAU,EAEpE,GAAIK,EAAuBH,CAAW,EACrC,OAAOA,EAGR,QAAQ,IACP,uEAAuEF,CAAG,KAE3E,MAAMM,EAAqB,MAC1BP,GAA2BQ,IAC1B,CAAE,IAAAP,EAAK,UAAAH,EAAW,EACpB,GAAI,CAACQ,EAAuBC,CAAkB,EAC7C,MAAM,IAAI,MACT,uCAAuCN,CAAG,kCAG5C,OAAOM,CACR,CAEA,eAAsBC,GAAkB,CACvC,IAAAP,EACA,UAAAH,CACD,EAA8C,CAC7C,MAAMW,EAAWL,EAAK,KAAKN,EAAWO,EAAWJ,CAAG,CAAC,EAC/CE,EAAcC,EAAK,KAAKK,EAAU,UAAU,EAC5CC,EAAU,GAAGD,CAAQ,IAAI,QAAQ,GAAG,IAAI,KAAK,KAAK,OAClDE,EAAkBP,EAAK,KAAKM,EAAS,UAAU,EAErD,MAAME,EAAGF,EAAS,CAAE,UAAW,GAAM,MAAO,GAAM,EAClD,MAAMG,EAAMF,EAAiB,CAAE,UAAW,GAAM,EAEhD,GAAI,CACH,KAAM,CAAE,oBAAAG,CAAA,EAAwB,MAAAC,EAAA,oCAAAD,GAAA,KAAM,QAAO,0CAAuB,6BAAAA,CAAA,OAC9DE,EAAe,MAAMF,EAAoB,CAC9C,QAASvB,EACT,IAAAU,EACA,MAAOR,GACP,OAAQiB,EACR,QAASN,EAAK,KAAKM,EAAS,WAAW,EACvC,EAED,UAAWO,KAAeD,EAAc,CACvC,MAAMtB,EAAewB,GAAuBD,CAAW,EACjDE,EAASf,EAAK,KACnBM,EACA,oBACAhB,CAAA,EAEK0B,EAAchB,EAAK,KAAKO,EAAiBjB,CAAY,EAC3D,MAAMmB,EAAMT,EAAK,QAAQgB,CAAW,EAAG,CAAE,UAAW,GAAM,EAC1D,MAAMC,EAAOF,EAAQC,CAAW,CACjC,CAEA,MAAME,EACLlB,EAAK,KAAKO,EAAiB,aAAa,EACxC,GAAG,KAAK,UAAU,CAAE,WAAYpB,EAAyB,IAAAU,CAAA,EAAO,KAAM,CAAC,CAAC;AAAA,GAEzE,MAAMW,EAAGR,EAAK,KAAKM,EAAS,WAAW,EAAG,CACzC,UAAW,GACX,MAAO,GACP,EACD,MAAME,EAAGR,EAAK,KAAKM,EAAS,UAAU,EAAG,CACxC,UAAW,GACX,MAAO,GACP,EAED,MAAMa,GAA2B,CAChC,QAAAb,EACA,SAAAD,EACA,YAAAN,CAAA,CACA,CACF,OAASqB,EAAO,CACf,YAAMZ,EAAGF,EAAS,CAAE,UAAW,GAAM,MAAO,GAAM,EAC5Cc,CACP,CAEA,OAAOrB,CACR,CAEO,SAASG,EAAuBH,EAA8B,CACpE,OAAOX,EAAiB,MAAOE,GACzBA,EAAa,SAAS,GAAG,EAGvB+B,GAAuBtB,EAAaT,CAAY,EAAE,OAAS,EAF1DgC,EAAWtB,EAAK,KAAKD,EAAaT,CAAY,CAAC,CAGvD,CACF,CAEA,eAAsB6B,GAA2B,CAChD,QAAAb,EACA,SAAAD,EACA,YAAAN,CACD,EAIkB,CACjB,MAAMU,EAAMT,EAAK,QAAQK,CAAQ,EAAG,CAAE,UAAW,GAAM,EACvD,GAAI,CACH,MAAMY,EAAOX,EAASD,CAAQ,CAC/B,OAASe,EAAO,CACf,GAAIG,GAAoBH,CAAK,GAAKlB,EAAuBH,CAAW,EAAG,CACtE,MAAMS,EAAGF,EAAS,CAAE,UAAW,GAAM,MAAO,GAAM,EAClD,MACD,CACA,MAAMc,CACP,CACD,CAEO,SAAStB,GAAuB,CACtC,cAAAN,EACA,YAAAC,CACD,EAGW,CACV,GAAI+B,GAAsBhC,CAAa,EACtC,MAAO,QAGR,MAAMiC,EADcC,GAAgBjC,CAAW,EACnB,QAC5B,GAAI,CAACgC,EACJ,MAAM,IAAI,MACT,8DAA8DhC,CAAW,KAG3E,MAAO,IAAIgC,CAAO,EACnB,CAEO,SAASD,GAAsBhC,EAAgC,CACrE,OACC8B,EAAWtB,EAAK,KAAKR,EAAe,SAAS,CAAC,GAC9C8B,EACCtB,EAAK,KACJR,EACA,mDACD,CAGH,CAEO,SAASG,IAAmC,CAClD,MAAMgC,EACL,YAAY,qCACb,GAAIA,EACH,OAAOA,EAER,MAAMC,EAAe,YAAY,eACjC,GAAIA,EACH,OAAO5B,EAAK,KACX4B,EACA,4CAGF,MAAMC,EAAOC,EAAG,UAChB,OAAID,EACI7B,EAAK,KAAK6B,EAAM,iDAAiD,EAElE7B,EAAK,KAAK8B,EAAG,SAAU,0CAA0C,CACzE,CAEA,SAASJ,GAAgBjC,EAA2C,CACnE,MAAMsC,EAAkB/B,EAAK,KAAKP,EAAa,cAAc,EAC7D,OAAK6B,EAAWS,CAAe,EAGxB,KAAK,MAGXC,EAAaD,EAAiB,MAAM,GAL7B,EAOT,CAYA,SAAS9B,EAAWgC,EAAuB,CAC1C,OAAOC,EAAW,QAAQ,EAAE,OAAOD,CAAK,EAAE,OAAO,KAAK,EAAE,MAAM,EAAG,EAAE,CACpE,CAEA,SAASnB,GAAuBD,EAA6B,CAC5D,MAAMsB,EAAS,qBACf,GAAI,CAACtB,EAAY,WAAWsB,CAAM,EACjC,MAAM,IAAI,MAAM,yCAAyCtB,CAAW,EAAE,EAEvE,OAAOA,EAAY,MAAMsB,EAAO,MAAM,CACvC,CAEA,SAASd,GACRe,EACAC,EACW,CACX,MAAMC,EAAYtC,EAAK,KAAKoC,EAAMpC,EAAK,QAAQqC,CAAmB,CAAC,EAC7DE,EAAkBvC,EAAK,SAASqC,CAAmB,EACzD,OAAKf,EAAWgB,CAAS,EAGlBE,EAAYF,EAAW,CAAE,cAAe,GAAM,EACnD,OACCG,GACAA,EAAM,UACNC,GAA0BD,EAAM,KAAMF,CAAe,GAEtD,IAAKE,GACLzC,EACE,KAAKA,EAAK,QAAQqC,CAAmB,EAAGI,EAAM,IAAI,EAClD,MAAMzC,EAAK,GAAG,EACd,KAAK,GAAG,GAEV,OAdM,EAeT,CAEA,SAAS0C,GAA0BC,EAAiBC,EAA0B,CAC7E,OAAKA,EAAQ,SAAS,GAAG,EAGlB,IAAI,OACV,IAAIA,EACF,MAAM,GAAG,EACT,IAAIC,EAAY,EAChB,KAAK,IAAI,CAAC,KACX,KAAKF,CAAO,EAPNA,IAAYC,CAQrB,CAEA,SAASC,GAAaZ,EAAuB,CAC5C,OAAOA,EAAM,QAAQ,sBAAuB,MAAM,CACnD,CAMA,SAASV,GAAoBH,EAAyB,CACrD,OACC,OAAOA,GAAU,UACjBA,IAAU,MACV,SAAUA,GACV,CAAC,SAAU,YAAa,OAAO,EAAE,SAAS,OAAOA,EAAM,IAAI,CAAC,CAE9D,CCvPA,eAAsB0B,EACrBtD,EACAuD,EAAsC,GACR,CAC9B,MAAMC,EAAuBhD,EAAK,KAAKR,EAAe,mBAAmB,EACzE,GAAIU,EAAuB8C,CAAoB,EAC9C,OAAOC,EAAczD,EAAewD,CAAoB,EAGzD,MAAMvD,EAAcsD,EAAQ,aAAeG,GAAA,EACrCC,EAAqBnD,EAAK,KAAKP,EAAa,UAAU,EAC5D,GAAIS,EAAuBiD,CAAkB,EAC5C,OAAOF,EAAczD,EAAe2D,CAAkB,EAGvD,MAAMhD,EAAqB,MAAMZ,GAAmB,CACnD,cAAAC,EACA,YAAAC,EACA,UAAWsD,EAAQ,UACnB,kBAAmBA,EAAQ,kBAC3B,EACD,OAAOE,EAAczD,EAAeW,CAAkB,CACvD,CAEA,SAAS8C,EACRzD,EACAO,EACqB,CACrB,MAAO,CACN,cAAAP,EACA,YAAAO,EACA,YAAaC,EAAK,KAAKD,EAAa,SAAS,EAC7C,qBAAsBC,EAAK,KAAKD,EAAa,mBAAmB,EAElE,CAEA,SAASmD,IAA0B,CAClC,IAAIZ,EAAYtC,EAAK,QAAQoD,EAAc,YAAY,GAAG,CAAC,EAC3D,KAAOd,IAActC,EAAK,QAAQsC,CAAS,GAAG,CAC7C,GAAIhB,EAAWtB,EAAK,KAAKsC,EAAW,cAAc,CAAC,EAClD,OAAOA,EAERA,EAAYtC,EAAK,QAAQsC,CAAS,CACnC,CACA,OAAOtC,EAAK,QAAQoD,EAAc,YAAY,GAAG,CAAC,CACnD,CAEA,eAAsBC,GAAyC,CAC9D,GAAI,CACH,MAAMC,EAAW,SAAU,CAAC,WAAW,EAAG,CACzC,MAAO,SACP,CACF,OAASlC,EAAO,CACf,MAAM,IAAI,MACT,2FACA,CAAE,MAAOA,CAAA,CAAM,CAEjB,CACD,CAEA,eAAsBmC,EAAeC,EAA6B,CACjE,MAAMF,EACL,SACA,CACC,QACA,KACA,eACA,IACA,iCACA,oBAED,CACC,IAAKtD,EAAK,KAAKwD,EAAQ,YAAa,YAAY,EACjD,CAEF,CAEA,eAAsBC,EACrBV,EACkB,CAClB,MAAMW,EAAWC,EAAqBZ,CAAO,EAC7C,aAAMO,EACL,SACA,CACC,QACA,KACA,0CACA,IACA,SAASI,CAAQ,GACjB,mBACA,cACA,eAAeX,EAAQ,UAAU,GACjC,cACA,YAED,CACC,IAAKA,EAAQ,YACd,EAEMW,CACR,CAEA,eAAsBE,GAAkBb,EAA2B,CAClE,MAAMW,EAAWC,EAAqBZ,CAAO,EACvCc,EAAU,CACf,MACA,OACA,KACA,GAAGd,EAAQ,SAAS,WACpB,KACA,GAAGA,EAAQ,MAAM,QACjB,KACA,GAAGA,EAAQ,WAAW,wBACtB,QACA,kBAAkBA,EAAQ,IAAI,GAC9B,QACA,qBAAqBA,EAAQ,UAAU,GACvC,QACA,cAAcA,EAAQ,SAAS,GAC/B,QACA,qBAAqBA,EAAQ,YAAY,GACzC,QACA,YAAYA,EAAQ,QAAQ,GAC5B,QACA,qBAAqBA,EAAQ,WAAW,MAAM,IAG3CA,EAAQ,aACXc,EAAQ,KAAK,QAAS,gBAAgBd,EAAQ,WAAW,EAAE,EAExDA,EAAQ,cACXc,EAAQ,KAAK,QAAS,iBAAiBd,EAAQ,YAAY,EAAE,EAG9DA,EAAQ,WAAW,QAAQ,CAACe,EAAKC,IAAU,CAC1CF,EAAQ,KAAK,QAAS,cAAcE,CAAK,IAAID,CAAG,EAAE,CACnD,CAAC,EAEDD,EAAQ,KAAKH,CAAQ,EAErB,MAAMJ,EAAW,SAAUO,EAAS,CACnC,IAAKd,EAAQ,cACb,CACF,CAEA,SAASY,EACRZ,EACC,CAED,MAAO,4CADYA,EAAQ,WAAW,WAAW,IAAK,GAAG,CACI,IAAIA,EAAQ,SAAS,EACnF,CAOA,eAAeO,EACdU,EACAC,EACAlB,EAA6B,GACb,CAChB,QAAQ,IAAI,WAAWiB,CAAO,IAAIC,EAAK,KAAK,GAAG,CAAC,EAAE,EAClD,MAAM,IAAI,QAAc,CAACC,EAASC,IAAW,CAC5C,MAAMC,EAAQC,EAAML,EAASC,EAAM,CAClC,IAAKlB,EAAQ,IACb,MAAOA,EAAQ,OAAS,UACxB,IAAK,YACL,EACDqB,EAAM,GAAG,QAASD,CAAM,EACxBC,EAAM,GAAG,QAAUE,GAAS,CAC3B,GAAIA,IAAS,EAAG,CACfJ,EAAA,EACA,MACD,CACAC,EAAO,IAAI,MAAM,GAAGH,CAAO,qBAAqBM,CAAI,EAAE,CAAC,CACxD,CAAC,CACF,CAAC,CACF,CCzNO,MAAMC,EAAqB,OA+ClC,eAAsBC,GAAezB,EAKN,CAC9B,MAAM0B,EAA8B,CACnC,KAAM1B,EAAQ,KACd,QAASA,EAAQ,QACjB,UAAWA,EAAQ,UAAU,IAAK2B,IAAc,CAC/C,WAAYA,EAAS,WACrB,WAAYA,EAAS,YACpB,GAEH,OAAI3B,EAAQ,aACX0B,EAAS,WAAa1B,EAAQ,YAExB0B,CACR,CAEA,eAAsBE,GAAc5B,EAGhB,CACnB,MAAMtC,EAAMsC,EAAQ,OAAQ,CAAE,UAAW,GAAM,EAC/C,MAAM6B,EAAe5E,EAAK,KAAK+C,EAAQ,OAAQ,eAAe,EAC9D,aAAM7B,EACL0D,EACA,GAAG,KAAK,UAAU7B,EAAQ,SAAU,KAAM,CAAC,CAAC;AAAA,GAEtC6B,CACR,CC/DO,MAAMC,GAAgC,CAC5C,MACA,MACA,MACA,MACA,MACA,MACA,KACD,EAEMC,GAA+C,CACpD,MAAO,QACP,MAAO,SACP,MAAO,SACP,MAAO,SACP,MAAO,SACP,MAAO,SACP,MAAO,QACR,EAuBA,eAAsBC,GACrBhC,EACC,CACD,MAAMM,EAAA,EAEN,MAAMG,EAAU,MAAMV,EAAoBC,EAAQ,aAAa,EACzDiC,EACLjC,EAAQ,YAAY,IAAKkC,IAAgB,CACxC,WAAAA,EACA,UAAWV,CAAA,EACV,EAEH,aAAMhB,EAAeC,CAAO,EAgBrB,CAAE,OAdM,MAAM0B,EACpBF,EACAG,EAAkBpC,EAAQ,KAAMiC,EAAO,MAAM,EAC7C,MAAO,CAAE,WAAAC,EAAY,UAAAG,KAAgB,CACpC,MAAM1B,EAAW,MAAMD,EAAoB,CAC1C,GAAGD,EACH,WAAAyB,EACA,WAAYI,EAAkBJ,CAAU,EACxC,UAAAG,CAAA,CACA,EACD,MAAO,CAAE,WAAAH,EAAY,UAAAG,EAAW,SAAA1B,CAAA,CACjC,EAGQ,CACV,CAEA,eAAsB4B,GAAuBvC,EAAkC,CAC9E,MAAMwC,EAASvF,EAAK,QAAQ+C,EAAQ,cAAeA,EAAQ,MAAM,EAC3DyC,EAAYxF,EAAK,QAAQ+C,EAAQ,cAAeA,EAAQ,SAAS,EACvE,MAAMM,EAAA,EAEN,MAAMG,EAAU,MAAMV,EAAoBC,EAAQ,aAAa,EACzDtB,EAAU,MAAMgE,GAAsBD,CAAS,EAC/CR,EACLjC,EAAQ,YAAY,IAAKkC,IAAgB,CACxC,WAAAA,EACA,UAAWV,CAAA,EACX,EAEF,MAAM9D,EAAM8E,EAAQ,CAAE,UAAW,GAAM,EACvC,MAAMhC,EAAeC,CAAO,EAE5B,MAAMkC,EAAY,MAAMR,EACvBF,EACAG,EAAkBpC,EAAQ,KAAMiC,EAAO,MAAM,EAC7C,MAAO,CAAE,WAAAC,EAAY,UAAAG,KAAgB,CACpC,MAAMO,EAAaN,EAAkBJ,CAAU,EACzCW,EAAe,GAAG7C,EAAQ,IAAI,OAAOkC,CAAU,IAAIG,CAAS,MAClE,aAAM3B,EAAoB,CACzB,GAAGD,EACH,WAAAyB,EACA,WAAAU,EACA,UAAAP,CAAA,CACA,EACD,MAAMxB,GAAkB,CACvB,GAAGJ,EACH,UAAAgC,EACA,OAAAD,EACA,KAAMxC,EAAQ,KACd,WAAAkC,EAEA,UAAAG,EACA,aAAAQ,EACA,SAAU7C,EAAQ,SAClB,YAAaA,EAAQ,YACrB,aAAcA,EAAQ,aACtB,WAAYA,EAAQ,WACpB,EACM,CACN,WAAAkC,EACA,WAAYW,EACZ,KAAM5F,EAAK,KAAKuF,EAAQK,CAAY,EAEtC,GAGKnB,EAAW,MAAMD,GAAe,CACrC,KAAMzB,EAAQ,KACd,QAAAtB,EACA,UAAAiE,EACA,WAAY3C,EAAQ,WACpB,EAED,MAAO,CAAE,aADY,MAAM4B,GAAc,CAAE,OAAAY,EAAQ,SAAAd,EAAU,EACtC,UAAAiB,EAAW,SAAAjB,CAAA,CACnC,CAEO,SAASY,EAAkBJ,EAA4B,CAC7D,OAAOH,GAAqBG,CAAU,GAAKA,CAC5C,CAEA,eAAeQ,GAAsBD,EAAoC,CACxE,GAAI,CACH,MAAMK,EAAc,KAAK,MACxB,MAAMC,EAAS9F,EAAK,KAAKwF,EAAW,cAAc,EAAG,MAAM,GAE5D,GAAI,OAAOK,EAAY,SAAY,SAClC,OAAOA,EAAY,OAErB,MAAQ,CAER,CACA,MAAO,OACR,CAEA,eAAeX,EACda,EACAC,EACAC,EACe,CACf,MAAMC,EAAe,IAAI,MAAMH,EAAM,MAAM,EAC3C,IAAII,EAAY,EAChB,MAAMC,EAAU,MAAM,KACrB,CAAE,OAAQ,KAAK,IAAIJ,EAAOD,EAAM,MAAM,GACtC,SAAY,CACX,KAAOI,EAAYJ,EAAM,QAAQ,CAChC,MAAMhC,EAAQoC,IACdD,EAAQnC,CAAK,EAAI,MAAMkC,EAAOF,EAAMhC,CAAK,CAAC,CAC3C,CACD,GAED,aAAM,QAAQ,IAAIqC,CAAO,EAClBF,CACR,CAEA,SAASf,EACRkB,EACAC,EACS,CACT,OAAIA,IAAc,EACV,EAEJD,GAAQA,EAAO,EACX,KAAK,IAAIA,EAAMC,CAAS,EAEzB,KAAK,IAAIxE,EAAG,0BAA4BA,EAAG,OAAO,OAAQwE,CAAS,CAC3E,CCpMA,MAAMC,GAA0B,CAC/B,8CACA,4CACA,gDACD,EAEA,eAAsBC,GAAoBhB,EAAoC,CAC7E,MAAMiB,EAAazG,EAAK,KAAKwF,EAAW,WAAW,EACnD,IAAIkB,EACJ,GAAI,CACHA,EAAS,MAAMZ,EAASW,EAAY,MAAM,CAC3C,OAASrF,EAAO,CACf,MAAM,IAAI,MACT,kBAAkBqF,CAAU,6CAC5B,CAAE,MAAOrF,CAAA,CAAM,CAEjB,CAEA,MAAMuF,EAAWC,GAA8BF,CAAM,EACrD,GAAI,CAACC,EACJ,MAAM,IAAI,MACT,4CAA4CF,CAAU,6BAGxD,OAAOE,CACR,CAEO,SAASC,GAA8BF,EAA+B,CAC5E,UAAW9D,KAAW2D,GAAyB,CAC9C,MAAMM,EAAQjE,EAAQ,KAAK8D,CAAM,EACjC,GAAIG,IAAQ,CAAC,EACZ,OAAOA,EAAM,CAAC,CAEhB,CACA,OAAO,IACR,CCvBO,SAASC,GAAoBC,EAGlC,CACD,MAAMC,EAAYD,EAAK,YAAY,GAAG,EACtC,GAAIC,EAAY,EACf,MAAM,IAAI,MACT,+BAA+B,KAAK,UACnCD,CAAA,CACA,qCAGH,MAAME,EAAUF,EAAK,MAAM,EAAGC,CAAS,EACjCE,EAAUH,EAAK,MAAMC,EAAY,CAAC,EACxC,GAAI,CAACC,GAAW,CAACC,EAChB,MAAM,IAAI,MACT,+BAA+B,KAAK,UACnCH,CAAA,CACA,qCAGH,GAAI,CAACG,EAAQ,WAAW,GAAG,EAC1B,MAAM,IAAI,MACT,gEAAgE,KAAK,UACpEA,CAAA,CACA,KAGH,MAAO,CAAE,QAAAD,EAAS,QAAAC,CAAA,CACnB,CAYA,eAAsBC,GACrBC,EACA7B,EACA/F,EACmD,CACnD,GAAI,CAAC4H,EAAM,OACV,OAED,MAAMF,EAAUE,EAAM,CAAC,EAAE,QACzB,UAAWL,KAAQK,EAClB,GAAIL,EAAK,UAAYG,EACpB,MAAM,IAAI,MACT,mEACC,KAAK,UAAUE,EAAM,IAAK3E,GAAUA,EAAM,OAAO,CAAC,GAKtD,MAAM4E,EAAsC,GACtCC,MAAsB,IACtBC,MAA0B,IAChC,UAAWR,KAAQK,EAAO,CACzB,MAAMI,EAAkBxH,EAAK,QAAQR,EAAeuH,EAAK,OAAO,EAC1DU,EAAezH,EAAK,SAASwH,CAAe,EAC5CE,EAAiB1H,EAAK,KAAKuF,EAAQkC,CAAY,EACrD,GAAIF,EAAoB,IAAIG,CAAc,EACzC,MAAM,IAAI,MACT,+CAA+CA,CAAc,qFAI/DH,EAAoB,IAAIG,CAAc,EACtC,MAAMjH,EAAMT,EAAK,QAAQ0H,CAAc,EAAG,CAAE,UAAW,GAAM,EAC7D,MAAMC,EAAGH,EAAiBE,EAAgB,CAAE,UAAW,GAAM,EAE7D,MAAME,EAAKF,EAAgB,MAAOG,EAAWC,IAAgB,CAC5D,MAAMC,EAAoB/H,EACxB,SAAS0H,EAAgBG,CAAS,EAClC,MAAM7H,EAAK,GAAG,EACd,KAAK,GAAG,EACV,GAAI,CAAC+H,EACJ,OAED,MAAMC,EAAa,GAAGP,CAAY,IAAIM,CAAiB,GACvD,GAAID,EAAa,CAEhB,GAAI,GADW,MAAMG,EAAQJ,CAAS,GAAG,SAAW,GAEnD,OAED,GAAIP,EAAgB,IAAIS,CAAiB,EACxC,MAAM,IAAI,MACT,gDAAgDA,CAAiB,KAGnET,EAAgB,IAAIS,CAAiB,EACrCV,EAAM,KAAK,CACV,QAASU,EACT,KAAM,YACN,EACD,MACD,CACA,GAAIT,EAAgB,IAAIS,CAAiB,EACxC,MAAM,IAAI,MACT,gDAAgDA,CAAiB,KAGnET,EAAgB,IAAIS,CAAiB,EACrCV,EAAM,KAAK,CACV,QAASU,EACT,WAAAC,CAAA,CACA,CACF,CAAC,CACF,CAGA,OAAAX,EAAM,KAAK,CAACa,EAAGC,IACdD,EAAE,QAAUC,EAAE,QAAU,GAAKD,EAAE,QAAUC,EAAE,QAAU,EAAI,GAGnD,CACN,QAAAjB,EACA,MAAAG,CAAA,CAEF,CAEA,eAAeO,EACdQ,EACAC,EACgB,CAChB,UAAW5F,KAAS,MAAMwF,EAAQG,CAAG,EAAG,CACvC,MAAMP,EAAY7H,EAAK,KAAKoI,EAAK3F,CAAK,EAChC6F,EAAY,MAAMC,EAAKV,CAAS,EACtC,MAAMQ,EAAQR,EAAWS,EAAU,aAAa,EAC5CA,EAAU,eACb,MAAMV,EAAKC,EAAWQ,CAAO,CAE/B,CACD,CCzIA,MAAMG,OAAoC,IAAI,CAC7C,gBACA,iBACA,iBACD,CAAC,EAED,eAAsBC,GAAKxE,EAAOyE,EAAQ,QAAQ,IAAI,EAAG,CACxD,MAAMC,EAAO,MAAMC,GAAa3E,CAAI,EAC9BzE,EAAgBqJ,GAAkB,QAAQ,KAAK,EAC/CC,EAAcC,GACnBJ,EAAK,cAAc,EACnB,gBAGD,GAAIA,EAAK,eAAe,EAAG,CAC1B,MAAMK,EAAS,MAAMjE,GAA4B,CAChD,cAAAvF,EACA,YAAAsJ,EACA,KAAMH,EAAK,IAAM,CACjB,EACD,QAAQ,IACP,YAAYK,EAAO,OAAO,MAAM,qCAEjC,UAAWC,KAASD,EAAO,OAC1B,QAAQ,IAAIC,EAAM,QAAQ,EAE3B,MACD,CAEA,MAAMlI,EAAS4H,EAAK,OACdnD,EAAYxF,EAAK,QAAQR,EAAeuB,CAAM,EAC9CmI,EACJP,EAAK,MACL,MAAMnC,GAAoBhB,CAAS,EAC/B2D,EAAaC,GAAiBT,EAAK,aAAa,GAAgB,EAAE,EAClEU,EAAmBV,EAAK,aAAa,EAAe,IACzD7B,EAAA,EAEKvB,EAASvF,EAAK,QAAQR,EAAemJ,EAAK,GAAgB,EAC1DW,EAAa,MAAMnC,GACxBkC,EACA9D,EACA/F,CAAA,EAGKwJ,EAAS,MAAM1D,GAAuB,CAC3C,cAAA9F,EACA,UAAAgG,EACA,OAAQmD,EAAK,IACb,KAAAO,EACA,YAAAJ,EACA,YAAaH,EAAK,cAAc,EAChC,aAAcA,EAAK,eAAe,EAClC,WAAAQ,EACA,SAAUR,EAAK,SACf,KAAMA,EAAK,KACX,WAAAW,CAAA,CACA,EAED,QAAQ,IAAI,SAASN,EAAO,UAAU,MAAM,aAAa,EACzD,QAAQ,IAAI,SAASA,EAAO,YAAY,GAAG,CAC5C,CAEA,eAAsBJ,GAAa3E,EAAgB,CAClD,OAAO,MAAMsF,EAAMC,GAAkCvF,CAAI,CAAC,EACxD,WAAW,6BAA6B,EACxC,MAAM,wDAAwD,EAC9D,QAAQ,CACR,OAAQ,CACP,KAAM,SACN,YAAa,mDAEd,gBAAiB,CAChB,KAAM,UACN,YACC,oHAEF,KAAM,CACL,KAAM,SACN,YAAa,kDAEd,eAAgB,CACf,KAAM,SACN,QAASY,GAA8B,KAAK,GAAG,EAC/C,YAAa,6CAEd,IAAK,CACJ,KAAM,SACN,QAAS,SACT,YAAa,qBAEd,eAAgB,CACf,KAAM,SACN,YAAa,mDAEd,gBAAiB,CAChB,KAAM,SACN,YAAa,oDAEd,cAAe,CACd,KAAM,SACN,QAAS,GACT,YACC,uDAEF,SAAU,CACT,KAAM,SACN,QAAS,IACT,YAAa,2CAEd,KAAM,CACL,KAAM,SACN,YAAa,qCAEd,cAAe,CACd,KAAM,SACN,MAAO,GACP,QAAS,GACT,YACC,oJACF,CACA,EACA,UAAU,SAAU,eAAe,EACnC,MAAM4E,EAAe,EACrB,YAAY,EAAK,EACjB,SACA,OACA,OACH,CAEIC,GAAgB,YAAY,GAAG,GAClCjB,GAAA,EAAO,MAAOrH,GAAU,CACvB,QAAQ,MAAMA,aAAiB,MAAQA,EAAM,QAAUA,CAAK,EAC5D,QAAQ,KAAK,CAAC,CACf,CAAC,EAGK,SAASoI,GAAkCvF,EAA0B,CAC3E,MAAM0F,EAAuB,GAC7B,QAASC,EAAI,EAAGA,EAAI3F,EAAK,OAAQ2F,IAAK,CACrC,MAAM9F,EAAMG,EAAK2F,CAAC,EAClB,GACCpB,GAA8B,IAAI1E,CAAG,GACrC8F,EAAI,EAAI3F,EAAK,QACb,CAACA,EAAK2F,EAAI,CAAC,EAAE,WAAW,GAAG9F,CAAG,GAAG,EAChC,CACD6F,EAAW,KAAK,GAAG7F,CAAG,IAAIG,EAAK2F,EAAI,CAAC,CAAC,EAAE,EACvCA,IACA,QACD,CACAD,EAAW,KAAK7F,CAAG,CACpB,CACA,OAAO6F,CACR,CAEO,SAASF,GAAgBd,EAKvB,CACR,GAAIA,EAAK,KACR,MAAO,GAER,MAAMkB,EAAY,OAAOlB,EAAK,QAAW,UAAYA,EAAK,OAAO,OAAS,EACpEmB,EAAe,GAAQnB,EAAK,eAAe,GAAKA,EAAK,cAE3D,GAAIkB,GAAaC,EAChB,MAAM,IAAI,MAAM,uDAAuD,EAExE,GAAI,CAACD,GAAa,CAACC,EAClB,MAAM,IAAI,MAAM,qDAAqD,EAGtE,MAAO,EACR,CAEA,SAASf,GAAS9G,EAAeiH,EAAwB,CACxD,MAAMa,EAAS9H,EACb,MAAM,GAAG,EACT,IAAKQ,GAAUA,EAAM,MAAM,EAC3B,OAAO,OAAO,EAChB,GAAIsH,EAAO,SAAW,EACrB,MAAM,IAAI,MAAM,KAAKb,CAAI,mCAAmC,EAE7D,OAAOa,CACR,CAEO,SAASX,GAAgBnH,EAAyB,CACxD,MAAM+H,EAAkB,GACxB,IAAIC,EAAU,GACVC,EAA0B,KAC1BC,EAAW,GAEf,UAAWC,KAAanI,EAAO,CAC9B,GAAIkI,EAAU,CACbF,GAAWG,EACXD,EAAW,GACX,QACD,CACA,GAAIC,IAAc,KAAM,CACvBD,EAAW,GACX,QACD,CACA,GAAID,EAAO,CACNE,IAAcF,EACjBA,EAAQ,KAERD,GAAWG,EAEZ,QACD,CACA,GAAIA,IAAc,KAAOA,IAAc,IAAK,CAC3CF,EAAQE,EACR,QACD,CACA,GAAI,KAAK,KAAKA,CAAS,EAAG,CACrBH,EAAQ,OAAS,IACpBD,EAAM,KAAKC,CAAO,EAClBA,EAAU,IAEX,QACD,CACAA,GAAWG,CACZ,CAKA,GAHID,IACHF,GAAW,MAERC,EACH,MAAM,IAAI,MAAM,sCAAsC,EAEvD,OAAID,EAAQ,OAAS,GACpBD,EAAM,KAAKC,CAAO,EAEZD,CACR,CAEA,SAASnB,GAAkBwB,EAAgC,CAC1D,IAAI/H,EAAYtC,EAAK,QAAQqK,CAAc,EAC3C,KAAO/H,IAActC,EAAK,QAAQsC,CAAS,GAAG,CAC7C,GACChB,EACCtB,EAAK,KACJsC,EACA,mDACD,GAEDhB,EAAWtB,EAAK,KAAKsC,EAAW,SAAS,CAAC,EAE1C,OAAOA,EAERA,EAAYtC,EAAK,QAAQsC,CAAS,CACnC,CACA,OAAO,QAAQ,KAChB,CAEA,SAASoH,GAAgBY,EAA0B,CAClD,MAAMC,EAAa,QAAQ,KAAK,CAAC,EACjC,GAAI,CAACA,EACJ,MAAO,GAER,GAAI,CACH,OACCC,EAAaD,CAAU,IAAMC,EAAapH,EAAckH,CAAO,CAAC,CAElE,MAAQ,CACP,OAAOtK,EAAK,QAAQuK,CAAU,IAAMnH,EAAckH,CAAO,CAC1D,CACD","names":["PlaygroundRepositoryUrl","DockerAssetPaths","PlaygroundDockerAssetPaths","relativePath","ensureDockerAssets","workspaceRoot","packageRoot","cacheRoot","getDockerAssetsCacheRoot","fetchDockerAssetsOption","ref","resolveDockerAssetsRef","phpWasmRoot","path","stableHash","isPhpWasmDockerContext","fetchedPhpWasmRoot","fetchDockerAssets","cacheDir","tempDir","tempPhpWasmRoot","rm","mkdir","sparseCheckoutFiles","__vitePreload","fetchedPaths","fetchedPath","stripPhpWasmPathPrefix","source","destination","rename","writeFile","publishFetchedDockerAssets","error","findMatchingLocalFiles","existsSync","isExistingPathError","isPlaygroundWorkspace","version","readPackageJson","configuredCacheDir","xdgCacheHome","home","os","packageJsonPath","readFileSync","value","createHash","prefix","root","relativePathPattern","directory","basenamePattern","readdirSync","entry","pathSegmentMatchesPattern","segment","pattern","escapeRegExp","createDockerContext","options","workspacePhpWasmRoot","createContext","findPackageRoot","packagePhpWasmRoot","fileURLToPath","assertDockerIsAvailable","runCommand","buildBaseImage","context","buildExtensionImage","imageTag","getExtensionImageTag","runExtensionBuild","runArgs","arg","index","command","args","resolve","reject","child","spawn","code","ExtensionAsyncMode","createManifest","manifest","artifact","writeManifest","manifestPath","SupportedExtensionPHPVersions","PHP_RELEASE_BY_MINOR","prepareExtensionBuildImages","matrix","phpVersion","mapLimit","normalizeJobCount","asyncMode","resolvePHPRelease","compileExtensionMatrix","outDir","sourceDir","detectManifestVersion","artifacts","phpRelease","artifactFile","packageJson","readFile","items","limit","worker","results","nextIndex","workers","jobs","taskCount","EXTENSION_NAME_PATTERNS","detectExtensionName","configPath","config","detected","detectExtensionNameFromConfig","match","parseExtraFilesSpec","spec","separator","hostDir","vfsRoot","stageExtraFilesIntoOutDir","specs","nodes","claimedVfsPaths","claimedDestinations","absoluteHostDir","targetSubdir","destinationDir","cp","walk","entryPath","isDirectory","relativeUnderRoot","sourcePath","readdir","a","b","dir","visitor","entryStat","stat","OptionsWithDashPrefixedValues","main","hideBin","argv","parseCliArgs","findWorkspaceRoot","phpVersions","parseCsv","result","image","name","configArgs","splitShellWords","extraFilesSpecs","extraFiles","yargs","normalizeDashPrefixedOptionValues","validateCliMode","isCliEntrypoint","normalized","i","hasSource","prepareImage","values","words","current","quote","escaping","character","startDirectory","metaUrl","entrypoint","realpathSync"],"ignoreList":[],"sources":["../../../../packages/php-wasm/compile-extension/src/docker-assets.ts","../../../../packages/php-wasm/compile-extension/src/docker.ts","../../../../packages/php-wasm/compile-extension/src/manifest.ts","../../../../packages/php-wasm/compile-extension/src/compile.ts","../../../../packages/php-wasm/compile-extension/src/detect.ts","../../../../packages/php-wasm/compile-extension/src/extra-files.ts","../../../../packages/php-wasm/compile-extension/src/cli.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport const PlaygroundRepositoryUrl =\n\t'https://github.com/WordPress/wordpress-playground.git';\n\nexport const DockerAssetPaths = [\n\t'compile/base-image/Dockerfile',\n\t'compile/base-image/emcc-for-php-wasm.sh',\n\t'compile/base-image/replace.sh',\n\t'compile/base-image/replace-across-lines.sh',\n\t'compile/php/php*.patch',\n\t'compile-extension/docker/Dockerfile.ext',\n\t'compile-extension/scripts/build-in-docker.sh',\n];\n\nconst PlaygroundDockerAssetPaths = DockerAssetPaths.map(\n\t(relativePath) => `packages/php-wasm/${relativePath}`\n);\n\nexport interface EnsureDockerAssetsOptions {\n\tworkspaceRoot: string;\n\tpackageRoot: string;\n\tcacheRoot?: string;\n\tfetchDockerAssets?: typeof fetchDockerAssets;\n}\n\nexport interface FetchDockerAssetsOptions {\n\tref: string;\n\tcacheRoot: string;\n}\n\nexport async function ensureDockerAssets({\n\tworkspaceRoot,\n\tpackageRoot,\n\tcacheRoot = getDockerAssetsCacheRoot(),\n\tfetchDockerAssets: fetchDockerAssetsOption,\n}: EnsureDockerAssetsOptions): Promise<string> {\n\tconst ref = resolveDockerAssetsRef({ workspaceRoot, packageRoot });\n\tconst phpWasmRoot = path.join(cacheRoot, stableHash(ref), 'php-wasm');\n\n\tif (isPhpWasmDockerContext(phpWasmRoot)) {\n\t\treturn phpWasmRoot;\n\t}\n\n\tconsole.log(\n\t\t`Fetching PHP.wasm Docker assets from WordPress/wordpress-playground ${ref}.`\n\t);\n\tconst fetchedPhpWasmRoot = await (\n\t\tfetchDockerAssetsOption ?? fetchDockerAssets\n\t)({ ref, cacheRoot });\n\tif (!isPhpWasmDockerContext(fetchedPhpWasmRoot)) {\n\t\tthrow new Error(\n\t\t\t`Fetched PHP.wasm Docker assets from ${ref}, but the cache is incomplete.`\n\t\t);\n\t}\n\treturn fetchedPhpWasmRoot;\n}\n\nexport async function fetchDockerAssets({\n\tref,\n\tcacheRoot,\n}: FetchDockerAssetsOptions): Promise<string> {\n\tconst cacheDir = path.join(cacheRoot, stableHash(ref));\n\tconst phpWasmRoot = path.join(cacheDir, 'php-wasm');\n\tconst tempDir = `${cacheDir}-${process.pid}-${Date.now()}.tmp`;\n\tconst tempPhpWasmRoot = path.join(tempDir, 'php-wasm');\n\n\tawait rm(tempDir, { recursive: true, force: true });\n\tawait mkdir(tempPhpWasmRoot, { recursive: true });\n\n\ttry {\n\t\tconst { sparseCheckoutFiles } = await import('./git-sparse-checkout');\n\t\tconst fetchedPaths = await sparseCheckoutFiles({\n\t\t\trepoUrl: PlaygroundRepositoryUrl,\n\t\t\tref,\n\t\t\tpaths: PlaygroundDockerAssetPaths,\n\t\t\toutDir: tempDir,\n\t\t\tworkDir: path.join(tempDir, '.git-work'),\n\t\t});\n\n\t\tfor (const fetchedPath of fetchedPaths) {\n\t\t\tconst relativePath = stripPhpWasmPathPrefix(fetchedPath);\n\t\t\tconst source = path.join(\n\t\t\t\ttempDir,\n\t\t\t\t'packages/php-wasm',\n\t\t\t\trelativePath\n\t\t\t);\n\t\t\tconst destination = path.join(tempPhpWasmRoot, relativePath);\n\t\t\tawait mkdir(path.dirname(destination), { recursive: true });\n\t\t\tawait rename(source, destination);\n\t\t}\n\n\t\tawait writeFile(\n\t\t\tpath.join(tempPhpWasmRoot, 'source.json'),\n\t\t\t`${JSON.stringify({ repository: PlaygroundRepositoryUrl, ref }, null, 2)}\\n`\n\t\t);\n\t\tawait rm(path.join(tempDir, '.git-work'), {\n\t\t\trecursive: true,\n\t\t\tforce: true,\n\t\t});\n\t\tawait rm(path.join(tempDir, 'packages'), {\n\t\t\trecursive: true,\n\t\t\tforce: true,\n\t\t});\n\n\t\tawait publishFetchedDockerAssets({\n\t\t\ttempDir,\n\t\t\tcacheDir,\n\t\t\tphpWasmRoot,\n\t\t});\n\t} catch (error) {\n\t\tawait rm(tempDir, { recursive: true, force: true });\n\t\tthrow error;\n\t}\n\n\treturn phpWasmRoot;\n}\n\nexport function isPhpWasmDockerContext(phpWasmRoot: string): boolean {\n\treturn DockerAssetPaths.every((relativePath) => {\n\t\tif (!relativePath.includes('*')) {\n\t\t\treturn existsSync(path.join(phpWasmRoot, relativePath));\n\t\t}\n\t\treturn findMatchingLocalFiles(phpWasmRoot, relativePath).length > 0;\n\t});\n}\n\nexport async function publishFetchedDockerAssets({\n\ttempDir,\n\tcacheDir,\n\tphpWasmRoot,\n}: {\n\ttempDir: string;\n\tcacheDir: string;\n\tphpWasmRoot: string;\n}): Promise<void> {\n\tawait mkdir(path.dirname(cacheDir), { recursive: true });\n\ttry {\n\t\tawait rename(tempDir, cacheDir);\n\t} catch (error) {\n\t\tif (isExistingPathError(error) && isPhpWasmDockerContext(phpWasmRoot)) {\n\t\t\tawait rm(tempDir, { recursive: true, force: true });\n\t\t\treturn;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nexport function resolveDockerAssetsRef({\n\tworkspaceRoot,\n\tpackageRoot,\n}: {\n\tworkspaceRoot: string;\n\tpackageRoot: string;\n}): string {\n\tif (isPlaygroundWorkspace(workspaceRoot)) {\n\t\treturn 'trunk';\n\t}\n\tconst packageJson = readPackageJson(packageRoot);\n\tconst version = packageJson.version;\n\tif (!version) {\n\t\tthrow new Error(\n\t\t\t`Could not resolve @php-wasm/compile-extension version from ${packageRoot}.`\n\t\t);\n\t}\n\treturn `v${version}`;\n}\n\nexport function isPlaygroundWorkspace(workspaceRoot: string): boolean {\n\treturn (\n\t\texistsSync(path.join(workspaceRoot, 'nx.json')) &&\n\t\texistsSync(\n\t\t\tpath.join(\n\t\t\t\tworkspaceRoot,\n\t\t\t\t'packages/php-wasm/compile-extension/package.json'\n\t\t\t)\n\t\t)\n\t);\n}\n\nexport function getDockerAssetsCacheRoot(): string {\n\tconst configuredCacheDir =\n\t\tprocess.env['PHP_WASM_COMPILE_EXTENSION_CACHE_DIR'];\n\tif (configuredCacheDir) {\n\t\treturn configuredCacheDir;\n\t}\n\tconst xdgCacheHome = process.env['XDG_CACHE_HOME'];\n\tif (xdgCacheHome) {\n\t\treturn path.join(\n\t\t\txdgCacheHome,\n\t\t\t'php-wasm/compile-extension/docker-assets'\n\t\t);\n\t}\n\tconst home = os.homedir();\n\tif (home) {\n\t\treturn path.join(home, '.cache/php-wasm/compile-extension/docker-assets');\n\t}\n\treturn path.join(os.tmpdir(), 'php-wasm/compile-extension/docker-assets');\n}\n\nfunction readPackageJson(packageRoot: string): { version?: string } {\n\tconst packageJsonPath = path.join(packageRoot, 'package.json');\n\tif (!existsSync(packageJsonPath)) {\n\t\treturn {};\n\t}\n\treturn JSON.parse(\n\t\t// This file is tiny and read synchronously while resolving CLI startup\n\t\t// paths; keeping the API sync avoids threading async through ref helpers.\n\t\treadFileSync(packageJsonPath, 'utf8')\n\t) as { version?: string };\n}\n\nexport async function readDockerAssetSource(\n\tphpWasmRoot: string\n): Promise<{ repository: string; ref: string } | undefined> {\n\tconst sourceFile = path.join(phpWasmRoot, 'source.json');\n\tif (!existsSync(sourceFile)) {\n\t\treturn undefined;\n\t}\n\treturn readJsonFile(sourceFile);\n}\n\nfunction stableHash(value: string): string {\n\treturn createHash('sha256').update(value).digest('hex').slice(0, 16);\n}\n\nfunction stripPhpWasmPathPrefix(fetchedPath: string): string {\n\tconst prefix = 'packages/php-wasm/';\n\tif (!fetchedPath.startsWith(prefix)) {\n\t\tthrow new Error(`Unexpected fetched Docker asset path: ${fetchedPath}`);\n\t}\n\treturn fetchedPath.slice(prefix.length);\n}\n\nfunction findMatchingLocalFiles(\n\troot: string,\n\trelativePathPattern: string\n): string[] {\n\tconst directory = path.join(root, path.dirname(relativePathPattern));\n\tconst basenamePattern = path.basename(relativePathPattern);\n\tif (!existsSync(directory)) {\n\t\treturn [];\n\t}\n\treturn readdirSync(directory, { withFileTypes: true })\n\t\t.filter(\n\t\t\t(entry) =>\n\t\t\t\tentry.isFile() &&\n\t\t\t\tpathSegmentMatchesPattern(entry.name, basenamePattern)\n\t\t)\n\t\t.map((entry) =>\n\t\t\tpath\n\t\t\t\t.join(path.dirname(relativePathPattern), entry.name)\n\t\t\t\t.split(path.sep)\n\t\t\t\t.join('/')\n\t\t)\n\t\t.sort();\n}\n\nfunction pathSegmentMatchesPattern(segment: string, pattern: string): boolean {\n\tif (!pattern.includes('*')) {\n\t\treturn segment === pattern;\n\t}\n\treturn new RegExp(\n\t\t`^${pattern\n\t\t\t.split('*')\n\t\t\t.map(escapeRegExp)\n\t\t\t.join('.*')}$`\n\t).test(segment);\n}\n\nfunction escapeRegExp(value: string): string {\n\treturn value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nasync function readJsonFile<T>(filename: string): Promise<T> {\n\treturn JSON.parse(await readFile(filename, 'utf8')) as T;\n}\n\nfunction isExistingPathError(error: unknown): boolean {\n\treturn (\n\t\ttypeof error === 'object' &&\n\t\terror !== null &&\n\t\t'code' in error &&\n\t\t['EEXIST', 'ENOTEMPTY', 'EPERM'].includes(String(error.code))\n\t);\n}\n","import { spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport {\n\tensureDockerAssets,\n\tisPhpWasmDockerContext,\n\ttype EnsureDockerAssetsOptions,\n} from './docker-assets';\nimport type { AsyncMode } from './manifest';\n\nexport interface DockerBuildContext {\n\tworkspaceRoot: string;\n\tphpWasmRoot: string;\n\tcompileRoot: string;\n\tcompileExtensionRoot: string;\n}\n\nexport interface DockerImageOptions extends DockerBuildContext {\n\tphpVersion: string;\n\tphpRelease: string;\n\tasyncMode: AsyncMode;\n}\n\nexport interface DockerRunOptions extends DockerImageOptions {\n\tsourceDir: string;\n\toutDir: string;\n\tname: string;\n\tartifactFile: string;\n\toptimize: string;\n\textraCflags?: string;\n\textraLdflags?: string;\n\tconfigArgs: string[];\n}\n\nexport interface CreateDockerContextOptions {\n\tpackageRoot?: string;\n\tcacheRoot?: string;\n\tfetchDockerAssets?: EnsureDockerAssetsOptions['fetchDockerAssets'];\n}\n\nexport async function createDockerContext(\n\tworkspaceRoot: string,\n\toptions: CreateDockerContextOptions = {}\n): Promise<DockerBuildContext> {\n\tconst workspacePhpWasmRoot = path.join(workspaceRoot, 'packages/php-wasm');\n\tif (isPhpWasmDockerContext(workspacePhpWasmRoot)) {\n\t\treturn createContext(workspaceRoot, workspacePhpWasmRoot);\n\t}\n\n\tconst packageRoot = options.packageRoot ?? findPackageRoot();\n\tconst packagePhpWasmRoot = path.join(packageRoot, 'php-wasm');\n\tif (isPhpWasmDockerContext(packagePhpWasmRoot)) {\n\t\treturn createContext(workspaceRoot, packagePhpWasmRoot);\n\t}\n\n\tconst fetchedPhpWasmRoot = await ensureDockerAssets({\n\t\tworkspaceRoot,\n\t\tpackageRoot,\n\t\tcacheRoot: options.cacheRoot,\n\t\tfetchDockerAssets: options.fetchDockerAssets,\n\t});\n\treturn createContext(workspaceRoot, fetchedPhpWasmRoot);\n}\n\nfunction createContext(\n\tworkspaceRoot: string,\n\tphpWasmRoot: string\n): DockerBuildContext {\n\treturn {\n\t\tworkspaceRoot,\n\t\tphpWasmRoot,\n\t\tcompileRoot: path.join(phpWasmRoot, 'compile'),\n\t\tcompileExtensionRoot: path.join(phpWasmRoot, 'compile-extension'),\n\t};\n}\n\nfunction findPackageRoot(): string {\n\tlet directory = path.dirname(fileURLToPath(import.meta.url));\n\twhile (directory !== path.dirname(directory)) {\n\t\tif (existsSync(path.join(directory, 'package.json'))) {\n\t\t\treturn directory;\n\t\t}\n\t\tdirectory = path.dirname(directory);\n\t}\n\treturn path.dirname(fileURLToPath(import.meta.url));\n}\n\nexport async function assertDockerIsAvailable(): Promise<void> {\n\ttry {\n\t\tawait runCommand('docker', ['--version'], {\n\t\t\tstdio: 'ignore',\n\t\t});\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'Docker is required to compile PHP.wasm extensions, but the docker command was not found.',\n\t\t\t{ cause: error }\n\t\t);\n\t}\n}\n\nexport async function buildBaseImage(context: DockerBuildContext) {\n\tawait runCommand(\n\t\t'docker',\n\t\t[\n\t\t\t'build',\n\t\t\t'-f',\n\t\t\t'./Dockerfile',\n\t\t\t'.',\n\t\t\t'--tag=playground-php-wasm:base',\n\t\t\t'--progress=plain',\n\t\t],\n\t\t{\n\t\t\tcwd: path.join(context.compileRoot, 'base-image'),\n\t\t}\n\t);\n}\n\nexport async function buildExtensionImage(\n\toptions: DockerImageOptions\n): Promise<string> {\n\tconst imageTag = getExtensionImageTag(options);\n\tawait runCommand(\n\t\t'docker',\n\t\t[\n\t\t\t'build',\n\t\t\t'-f',\n\t\t\t'compile-extension/docker/Dockerfile.ext',\n\t\t\t'.',\n\t\t\t`--tag=${imageTag}`,\n\t\t\t'--progress=plain',\n\t\t\t'--build-arg',\n\t\t\t`PHP_VERSION=${options.phpRelease}`,\n\t\t\t'--build-arg',\n\t\t\t'JSPI=yes',\n\t\t],\n\t\t{\n\t\t\tcwd: options.phpWasmRoot,\n\t\t}\n\t);\n\treturn imageTag;\n}\n\nexport async function runExtensionBuild(options: DockerRunOptions) {\n\tconst imageTag = getExtensionImageTag(options);\n\tconst runArgs = [\n\t\t'run',\n\t\t'--rm',\n\t\t'-v',\n\t\t`${options.sourceDir}:/src:ro`,\n\t\t'-v',\n\t\t`${options.outDir}:/out`,\n\t\t'-v',\n\t\t`${options.compileRoot}:/php-wasm-compile:ro`,\n\t\t'--env',\n\t\t`EXTENSION_NAME=${options.name}`,\n\t\t'--env',\n\t\t`PHP_VERSION_SHORT=${options.phpVersion}`,\n\t\t'--env',\n\t\t`ASYNC_MODE=${options.asyncMode}`,\n\t\t'--env',\n\t\t`ARTIFACT_FILENAME=${options.artifactFile}`,\n\t\t'--env',\n\t\t`OPTIMIZE=${options.optimize}`,\n\t\t'--env',\n\t\t`CONFIG_ARGS_COUNT=${options.configArgs.length}`,\n\t];\n\n\tif (options.extraCflags) {\n\t\trunArgs.push('--env', `EXTRA_CFLAGS=${options.extraCflags}`);\n\t}\n\tif (options.extraLdflags) {\n\t\trunArgs.push('--env', `EXTRA_LDFLAGS=${options.extraLdflags}`);\n\t}\n\n\toptions.configArgs.forEach((arg, index) => {\n\t\trunArgs.push('--env', `CONFIG_ARG_${index}=${arg}`);\n\t});\n\n\trunArgs.push(imageTag);\n\n\tawait runCommand('docker', runArgs, {\n\t\tcwd: options.workspaceRoot,\n\t});\n}\n\nfunction getExtensionImageTag(\n\toptions: Pick<DockerImageOptions, 'phpVersion' | 'asyncMode'>\n) {\n\tconst phpVersion = options.phpVersion.replaceAll('.', '-');\n\treturn `playground-php-wasm:compile-extension-php${phpVersion}-${options.asyncMode}`;\n}\n\ninterface RunCommandOptions {\n\tcwd?: string;\n\tstdio?: 'inherit' | 'ignore';\n}\n\nasync function runCommand(\n\tcommand: string,\n\targs: string[],\n\toptions: RunCommandOptions = {}\n): Promise<void> {\n\tconsole.log(`Running ${command} ${args.join(' ')}`);\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, {\n\t\t\tcwd: options.cwd,\n\t\t\tstdio: options.stdio ?? 'inherit',\n\t\t\tenv: process.env,\n\t\t});\n\t\tchild.on('error', reject);\n\t\tchild.on('close', (code) => {\n\t\t\tif (code === 0) {\n\t\t\t\tresolve();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\treject(new Error(`${command} exited with code ${code}`));\n\t\t});\n\t});\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nexport const ExtensionAsyncMode = 'jspi';\nexport type AsyncMode = typeof ExtensionAsyncMode;\n\n/**\n * One sidecar file or empty directory staged alongside an artifact.\n *\n * Mirrors `PHPExtensionManifestExtraFile` in `@php-wasm/universal`.\n */\nexport interface ExtensionManifestExtraFile {\n\t/** Joined with the group's `vfsRoot` to form the final VFS path. */\n\tvfsPath: string;\n\t/** Defaults to \"file\". Only file nodes need a `sourcePath`. */\n\ttype?: 'file' | 'directory';\n\t/** Relative to the manifest URL/base URL, or an absolute URL. */\n\tsourcePath?: string;\n}\n\nexport interface ExtensionManifestExtraFiles {\n\t/** Absolute VFS prefix joined with each node's `vfsPath`. */\n\tvfsRoot?: string;\n\tnodes?: ExtensionManifestExtraFile[];\n}\n\nexport interface ExtensionArtifact {\n\tphpVersion: string;\n\t/** Path to the `.so` file, relative to the manifest URL or absolute. */\n\tsourcePath: string;\n\t/** URL-backed files needed only by this artifact. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface ExtensionManifest {\n\tname: string;\n\tversion: string;\n\tartifacts: ExtensionArtifact[];\n\t/** URL-backed files shared by every artifact in this manifest. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface BuiltArtifact {\n\tphpVersion: string;\n\t/** Path to the `.so` file, relative to the manifest URL. */\n\tsourcePath: string;\n\t/** Absolute path on disk where the `.so` was written. */\n\tpath: string;\n}\n\nexport async function createManifest(options: {\n\tname: string;\n\tversion: string;\n\tartifacts: BuiltArtifact[];\n\textraFiles?: ExtensionManifestExtraFiles;\n}): Promise<ExtensionManifest> {\n\tconst manifest: ExtensionManifest = {\n\t\tname: options.name,\n\t\tversion: options.version,\n\t\tartifacts: options.artifacts.map((artifact) => ({\n\t\t\tphpVersion: artifact.phpVersion,\n\t\t\tsourcePath: artifact.sourcePath,\n\t\t})),\n\t};\n\tif (options.extraFiles) {\n\t\tmanifest.extraFiles = options.extraFiles;\n\t}\n\treturn manifest;\n}\n\nexport async function writeManifest(options: {\n\toutDir: string;\n\tmanifest: ExtensionManifest;\n}): Promise<string> {\n\tawait mkdir(options.outDir, { recursive: true });\n\tconst manifestPath = path.join(options.outDir, 'manifest.json');\n\tawait writeFile(\n\t\tmanifestPath,\n\t\t`${JSON.stringify(options.manifest, null, 2)}\\n`\n\t);\n\treturn manifestPath;\n}\n\nexport function findExtensionArtifact(\n\tmanifest: ExtensionManifest,\n\tphpVersion: string\n): ExtensionArtifact | undefined {\n\treturn manifest.artifacts.find(\n\t\t(artifact) => artifact.phpVersion === phpVersion\n\t);\n}\n","import { mkdir, readFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport {\n\tassertDockerIsAvailable,\n\tbuildBaseImage,\n\tbuildExtensionImage,\n\tcreateDockerContext,\n\trunExtensionBuild,\n} from './docker';\nimport type {\n\tAsyncMode,\n\tBuiltArtifact,\n\tExtensionManifestExtraFiles,\n} from './manifest';\nimport { createManifest, ExtensionAsyncMode, writeManifest } from './manifest';\n\nexport const SupportedExtensionPHPVersions = [\n\t'8.5',\n\t'8.4',\n\t'8.3',\n\t'8.2',\n\t'8.1',\n\t'8.0',\n\t'7.4',\n] as const;\n\nconst PHP_RELEASE_BY_MINOR: Record<string, string> = {\n\t'8.5': '8.5.5',\n\t'8.4': '8.4.20',\n\t'8.3': '8.3.30',\n\t'8.2': '8.2.30',\n\t'8.1': '8.1.34',\n\t'8.0': '8.0.30',\n\t'7.4': '7.4.33',\n};\n\nexport interface CompileExtensionOptions {\n\tworkspaceRoot: string;\n\tsourceDir: string;\n\toutDir: string;\n\tname: string;\n\tphpVersions: string[];\n\textraCflags?: string;\n\textraLdflags?: string;\n\tconfigArgs: string[];\n\toptimize: string;\n\tjobs?: number;\n\t/** Sidecar files to record at the manifest level. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface PrepareExtensionBuildImagesOptions {\n\tworkspaceRoot: string;\n\tphpVersions: string[];\n\tjobs?: number;\n}\n\nexport async function prepareExtensionBuildImages(\n\toptions: PrepareExtensionBuildImagesOptions\n) {\n\tawait assertDockerIsAvailable();\n\n\tconst context = await createDockerContext(options.workspaceRoot);\n\tconst matrix: Array<{ phpVersion: string; asyncMode: AsyncMode }> =\n\t\toptions.phpVersions.map((phpVersion) => ({\n\t\t\tphpVersion,\n\t\t\tasyncMode: ExtensionAsyncMode,\n\t\t}));\n\n\tawait buildBaseImage(context);\n\n\tconst images = await mapLimit(\n\t\tmatrix,\n\t\tnormalizeJobCount(options.jobs, matrix.length),\n\t\tasync ({ phpVersion, asyncMode }) => {\n\t\t\tconst imageTag = await buildExtensionImage({\n\t\t\t\t...context,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease: resolvePHPRelease(phpVersion),\n\t\t\t\tasyncMode,\n\t\t\t});\n\t\t\treturn { phpVersion, asyncMode, imageTag };\n\t\t}\n\t);\n\n\treturn { images };\n}\n\nexport async function compileExtensionMatrix(options: CompileExtensionOptions) {\n\tconst outDir = path.resolve(options.workspaceRoot, options.outDir);\n\tconst sourceDir = path.resolve(options.workspaceRoot, options.sourceDir);\n\tawait assertDockerIsAvailable();\n\n\tconst context = await createDockerContext(options.workspaceRoot);\n\tconst version = await detectManifestVersion(sourceDir);\n\tconst matrix: Array<{ phpVersion: string; asyncMode: AsyncMode }> =\n\t\toptions.phpVersions.map((phpVersion) => ({\n\t\t\tphpVersion,\n\t\t\tasyncMode: ExtensionAsyncMode,\n\t}));\n\n\tawait mkdir(outDir, { recursive: true });\n\tawait buildBaseImage(context);\n\n\tconst artifacts = await mapLimit(\n\t\tmatrix,\n\t\tnormalizeJobCount(options.jobs, matrix.length),\n\t\tasync ({ phpVersion, asyncMode }) => {\n\t\t\tconst phpRelease = resolvePHPRelease(phpVersion);\n\t\t\tconst artifactFile = `${options.name}-php${phpVersion}-${asyncMode}.so`;\n\t\t\tawait buildExtensionImage({\n\t\t\t\t...context,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease,\n\t\t\t\tasyncMode,\n\t\t\t});\n\t\t\tawait runExtensionBuild({\n\t\t\t\t...context,\n\t\t\t\tsourceDir,\n\t\t\t\toutDir,\n\t\t\t\tname: options.name,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease,\n\t\t\t\tasyncMode,\n\t\t\t\tartifactFile,\n\t\t\t\toptimize: options.optimize,\n\t\t\t\textraCflags: options.extraCflags,\n\t\t\t\textraLdflags: options.extraLdflags,\n\t\t\t\tconfigArgs: options.configArgs,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tphpVersion,\n\t\t\t\tsourcePath: artifactFile,\n\t\t\t\tpath: path.join(outDir, artifactFile),\n\t\t\t} satisfies BuiltArtifact;\n\t\t}\n\t);\n\n\tconst manifest = await createManifest({\n\t\tname: options.name,\n\t\tversion,\n\t\tartifacts,\n\t\textraFiles: options.extraFiles,\n\t});\n\tconst manifestPath = await writeManifest({ outDir, manifest });\n\treturn { manifestPath, artifacts, manifest };\n}\n\nexport function resolvePHPRelease(phpVersion: string): string {\n\treturn PHP_RELEASE_BY_MINOR[phpVersion] ?? phpVersion;\n}\n\nasync function detectManifestVersion(sourceDir: string): Promise<string> {\n\ttry {\n\t\tconst packageJson = JSON.parse(\n\t\t\tawait readFile(path.join(sourceDir, 'package.json'), 'utf8')\n\t\t) as { version?: unknown };\n\t\tif (typeof packageJson.version === 'string') {\n\t\t\treturn packageJson.version;\n\t\t}\n\t} catch {\n\t\t// Native PHP extension sources usually do not contain package.json.\n\t}\n\treturn '0.0.0';\n}\n\nasync function mapLimit<T, R>(\n\titems: T[],\n\tlimit: number,\n\tworker: (item: T) => Promise<R>\n): Promise<R[]> {\n\tconst results: R[] = new Array(items.length) as R[];\n\tlet nextIndex = 0;\n\tconst workers = Array.from(\n\t\t{ length: Math.min(limit, items.length) },\n\t\tasync () => {\n\t\t\twhile (nextIndex < items.length) {\n\t\t\t\tconst index = nextIndex++;\n\t\t\t\tresults[index] = await worker(items[index]);\n\t\t\t}\n\t\t}\n\t);\n\tawait Promise.all(workers);\n\treturn results;\n}\n\nfunction normalizeJobCount(\n\tjobs: number | undefined,\n\ttaskCount: number\n): number {\n\tif (taskCount === 0) {\n\t\treturn 1;\n\t}\n\tif (jobs && jobs > 0) {\n\t\treturn Math.min(jobs, taskCount);\n\t}\n\treturn Math.min(os.availableParallelism?.() ?? os.cpus().length, taskCount);\n}\n","import { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nconst EXTENSION_NAME_PATTERNS = [\n\t/\\bPHP_ARG_ENABLE\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n\t/\\bPHP_ARG_WITH\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n\t/\\bPHP_NEW_EXTENSION\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n];\n\nexport async function detectExtensionName(sourceDir: string): Promise<string> {\n\tconst configPath = path.join(sourceDir, 'config.m4');\n\tlet config: string;\n\ttry {\n\t\tconfig = await readFile(configPath, 'utf8');\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Could not read ${configPath}. Pass --name or provide a config.m4 file.`,\n\t\t\t{ cause: error }\n\t\t);\n\t}\n\n\tconst detected = detectExtensionNameFromConfig(config);\n\tif (!detected) {\n\t\tthrow new Error(\n\t\t\t`Could not detect the extension name from ${configPath}. Pass --name explicitly.`\n\t\t);\n\t}\n\treturn detected;\n}\n\nexport function detectExtensionNameFromConfig(config: string): string | null {\n\tfor (const pattern of EXTENSION_NAME_PATTERNS) {\n\t\tconst match = pattern.exec(config);\n\t\tif (match?.[1]) {\n\t\t\treturn match[1];\n\t\t}\n\t}\n\treturn null;\n}\n","import { cp, mkdir, readdir, stat } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type {\n\tExtensionManifestExtraFile,\n\tExtensionManifestExtraFiles,\n} from './manifest';\n\n/**\n * Parses a `--extra-files` CLI argument of the form `<hostDir>:<vfsRoot>`.\n *\n * `vfsRoot` must be an absolute VFS path so the loader can stage files\n * without making up a default root. Splitting on the *last* colon lets\n * Windows host paths like `C:\\dir:/internal/root` round-trip cleanly.\n */\nexport function parseExtraFilesSpec(spec: string): {\n\thostDir: string;\n\tvfsRoot: string;\n} {\n\tconst separator = spec.lastIndexOf(':');\n\tif (separator < 0) {\n\t\tthrow new Error(\n\t\t\t`Invalid --extra-files value ${JSON.stringify(\n\t\t\t\tspec\n\t\t\t)}. Expected \"<hostDir>:<vfsRoot>\".`\n\t\t);\n\t}\n\tconst hostDir = spec.slice(0, separator);\n\tconst vfsRoot = spec.slice(separator + 1);\n\tif (!hostDir || !vfsRoot) {\n\t\tthrow new Error(\n\t\t\t`Invalid --extra-files value ${JSON.stringify(\n\t\t\t\tspec\n\t\t\t)}. Expected \"<hostDir>:<vfsRoot>\".`\n\t\t);\n\t}\n\tif (!vfsRoot.startsWith('/')) {\n\t\tthrow new Error(\n\t\t\t`--extra-files vfsRoot must be an absolute VFS path. Received ${JSON.stringify(\n\t\t\t\tvfsRoot\n\t\t\t)}.`\n\t\t);\n\t}\n\treturn { hostDir, vfsRoot };\n}\n\n/**\n * Copies one or more host directories into `outDir` and returns a manifest\n * `extraFiles` group whose `sourcePath` entries are relative to `outDir`.\n *\n * Each spec is `<hostDir>:<vfsRoot>`. All specs must agree on `vfsRoot`\n * because the manifest format only stores a single `vfsRoot` per group.\n *\n * Files keep their relative path under `vfsRoot`. Empty directories are\n * recorded as `type: 'directory'` nodes so the loader creates them.\n */\nexport async function stageExtraFilesIntoOutDir(\n\tspecs: Array<{ hostDir: string; vfsRoot: string }>,\n\toutDir: string,\n\tworkspaceRoot: string\n): Promise<ExtensionManifestExtraFiles | undefined> {\n\tif (!specs.length) {\n\t\treturn undefined;\n\t}\n\tconst vfsRoot = specs[0].vfsRoot;\n\tfor (const spec of specs) {\n\t\tif (spec.vfsRoot !== vfsRoot) {\n\t\t\tthrow new Error(\n\t\t\t\t'All --extra-files entries must share the same vfsRoot. Received ' +\n\t\t\t\t\tJSON.stringify(specs.map((entry) => entry.vfsRoot))\n\t\t\t);\n\t\t}\n\t}\n\n\tconst nodes: ExtensionManifestExtraFile[] = [];\n\tconst claimedVfsPaths = new Set<string>();\n\tconst claimedDestinations = new Set<string>();\n\tfor (const spec of specs) {\n\t\tconst absoluteHostDir = path.resolve(workspaceRoot, spec.hostDir);\n\t\tconst targetSubdir = path.basename(absoluteHostDir);\n\t\tconst destinationDir = path.join(outDir, targetSubdir);\n\t\tif (claimedDestinations.has(destinationDir)) {\n\t\t\tthrow new Error(\n\t\t\t\t`--extra-files destination collides on disk: ${destinationDir}. ` +\n\t\t\t\t\t`Two host directories share the same basename, so one would overwrite the other.`\n\t\t\t);\n\t\t}\n\t\tclaimedDestinations.add(destinationDir);\n\t\tawait mkdir(path.dirname(destinationDir), { recursive: true });\n\t\tawait cp(absoluteHostDir, destinationDir, { recursive: true });\n\n\t\tawait walk(destinationDir, async (entryPath, isDirectory) => {\n\t\t\tconst relativeUnderRoot = path\n\t\t\t\t.relative(destinationDir, entryPath)\n\t\t\t\t.split(path.sep)\n\t\t\t\t.join('/');\n\t\t\tif (!relativeUnderRoot) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst sourcePath = `${targetSubdir}/${relativeUnderRoot}`;\n\t\t\tif (isDirectory) {\n\t\t\t\tconst empty = (await readdir(entryPath)).length === 0;\n\t\t\t\tif (!empty) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (claimedVfsPaths.has(relativeUnderRoot)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`--extra-files vfsPath collides across specs: ${relativeUnderRoot}.`\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tclaimedVfsPaths.add(relativeUnderRoot);\n\t\t\t\tnodes.push({\n\t\t\t\t\tvfsPath: relativeUnderRoot,\n\t\t\t\t\ttype: 'directory',\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (claimedVfsPaths.has(relativeUnderRoot)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`--extra-files vfsPath collides across specs: ${relativeUnderRoot}.`\n\t\t\t\t);\n\t\t\t}\n\t\t\tclaimedVfsPaths.add(relativeUnderRoot);\n\t\t\tnodes.push({\n\t\t\t\tvfsPath: relativeUnderRoot,\n\t\t\t\tsourcePath,\n\t\t\t});\n\t\t});\n\t}\n\t// Sort with a locale-independent comparator so the manifest is byte-stable\n\t// across machines (`localeCompare` honors the host locale).\n\tnodes.sort((a, b) =>\n\t\ta.vfsPath < b.vfsPath ? -1 : a.vfsPath > b.vfsPath ? 1 : 0\n\t);\n\n\treturn {\n\t\tvfsRoot,\n\t\tnodes,\n\t};\n}\n\nasync function walk(\n\tdir: string,\n\tvisitor: (entryPath: string, isDirectory: boolean) => Promise<void>\n): Promise<void> {\n\tfor (const entry of await readdir(dir)) {\n\t\tconst entryPath = path.join(dir, entry);\n\t\tconst entryStat = await stat(entryPath);\n\t\tawait visitor(entryPath, entryStat.isDirectory());\n\t\tif (entryStat.isDirectory()) {\n\t\t\tawait walk(entryPath, visitor);\n\t\t}\n\t}\n}\n","#!/usr/bin/env node\nimport { existsSync, realpathSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport {\n\tcompileExtensionMatrix,\n\tprepareExtensionBuildImages,\n\tSupportedExtensionPHPVersions,\n} from './compile';\nimport { detectExtensionName } from './detect';\nimport { parseExtraFilesSpec, stageExtraFilesIntoOutDir } from './extra-files';\n\nconst OptionsWithDashPrefixedValues = new Set([\n\t'--config-args',\n\t'--extra-cflags',\n\t'--extra-ldflags',\n]);\n\nexport async function main(args = hideBin(process.argv)) {\n\tconst argv = await parseCliArgs(args);\n\tconst workspaceRoot = findWorkspaceRoot(process.cwd());\n\tconst phpVersions = parseCsv(\n\t\targv['php-versions'] as string,\n\t\t'php-versions'\n\t);\n\n\tif (argv['prepare-image']) {\n\t\tconst result = await prepareExtensionBuildImages({\n\t\t\tworkspaceRoot,\n\t\t\tphpVersions,\n\t\t\tjobs: argv['jobs'] as number | undefined,\n\t\t});\n\t\tconsole.log(\n\t\t\t`Prepared ${result.images.length} PHP.wasm extension build images.`\n\t\t);\n\t\tfor (const image of result.images) {\n\t\t\tconsole.log(image.imageTag);\n\t\t}\n\t\treturn;\n\t}\n\n\tconst source = argv['source'] as string;\n\tconst sourceDir = path.resolve(workspaceRoot, source);\n\tconst name =\n\t\t(argv['name'] as string | undefined) ??\n\t\t(await detectExtensionName(sourceDir));\n\tconst configArgs = splitShellWords((argv['config-args'] as string) || '');\n\tconst extraFilesSpecs = (argv['extra-files'] as string[]).map(\n\t\tparseExtraFilesSpec\n\t);\n\tconst outDir = path.resolve(workspaceRoot, argv['out'] as string);\n\tconst extraFiles = await stageExtraFilesIntoOutDir(\n\t\textraFilesSpecs,\n\t\toutDir,\n\t\tworkspaceRoot\n\t);\n\n\tconst result = await compileExtensionMatrix({\n\t\tworkspaceRoot,\n\t\tsourceDir,\n\t\toutDir: argv['out'] as string,\n\t\tname,\n\t\tphpVersions,\n\t\textraCflags: argv['extra-cflags'] as string | undefined,\n\t\textraLdflags: argv['extra-ldflags'] as string | undefined,\n\t\tconfigArgs,\n\t\toptimize: argv['optimize'] as string,\n\t\tjobs: argv['jobs'] as number | undefined,\n\t\textraFiles,\n\t});\n\n\tconsole.log(`Wrote ${result.artifacts.length} artifacts.`);\n\tconsole.log(`Wrote ${result.manifestPath}.`);\n}\n\nexport async function parseCliArgs(args: string[]) {\n\treturn await yargs(normalizeDashPrefixedOptionValues(args))\n\t\t.scriptName('@php-wasm/compile-extension')\n\t\t.usage('Usage: $0 [--source <dir> | --prepare-image] [options]')\n\t\t.options({\n\t\t\tsource: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extension source directory containing config.m4',\n\t\t\t},\n\t\t\t'prepare-image': {\n\t\t\t\ttype: 'boolean',\n\t\t\t\tdescription:\n\t\t\t\t\t'Build the Docker images for the requested PHP versions and exit without compiling an extension source directory.',\n\t\t\t},\n\t\t\tname: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extension name. Defaults to parsing config.m4.',\n\t\t\t},\n\t\t\t'php-versions': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: SupportedExtensionPHPVersions.join(','),\n\t\t\t\tdescription: 'Comma-separated PHP major.minor versions.',\n\t\t\t},\n\t\t\tout: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: './dist',\n\t\t\t\tdescription: 'Output directory.',\n\t\t\t},\n\t\t\t'extra-cflags': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extra CFLAGS appended to the side-module build.',\n\t\t\t},\n\t\t\t'extra-ldflags': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extra LDFLAGS appended to the side-module build.',\n\t\t\t},\n\t\t\t'config-args': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: '',\n\t\t\t\tdescription:\n\t\t\t\t\t'Extra ./configure arguments, parsed as shell words.',\n\t\t\t},\n\t\t\toptimize: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: '2',\n\t\t\t\tdescription: 'Optimization level passed as -O<level>.',\n\t\t\t},\n\t\t\tjobs: {\n\t\t\t\ttype: 'number',\n\t\t\t\tdescription: 'Maximum concurrent docker builds.',\n\t\t\t},\n\t\t\t'extra-files': {\n\t\t\t\ttype: 'string',\n\t\t\t\tarray: true,\n\t\t\t\tdefault: [] as string[],\n\t\t\t\tdescription:\n\t\t\t\t\t'Stage a host directory under an absolute VFS root. Format: <hostDir>:<vfsRoot>. Files are copied next to the manifest and recorded in extraFiles.',\n\t\t\t},\n\t\t})\n\t\t.conflicts('source', 'prepare-image')\n\t\t.check(validateCliMode)\n\t\t.exitProcess(false)\n\t\t.strict()\n\t\t.help()\n\t\t.parse();\n}\n\nif (isCliEntrypoint(import.meta.url)) {\n\tmain().catch((error) => {\n\t\tconsole.error(error instanceof Error ? error.message : error);\n\t\tprocess.exit(1);\n\t});\n}\n\nexport function normalizeDashPrefixedOptionValues(args: string[]): string[] {\n\tconst normalized: string[] = [];\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\t\tif (\n\t\t\tOptionsWithDashPrefixedValues.has(arg) &&\n\t\t\ti + 1 < args.length &&\n\t\t\t!args[i + 1].startsWith(`${arg}=`)\n\t\t) {\n\t\t\tnormalized.push(`${arg}=${args[i + 1]}`);\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tnormalized.push(arg);\n\t}\n\treturn normalized;\n}\n\nexport function validateCliMode(argv: {\n\tsource?: unknown;\n\t'prepare-image'?: unknown;\n\tprepareImage?: unknown;\n\thelp?: unknown;\n}): true {\n\tif (argv.help) {\n\t\treturn true;\n\t}\n\tconst hasSource = typeof argv.source === 'string' && argv.source.length > 0;\n\tconst prepareImage = Boolean(argv['prepare-image'] ?? argv.prepareImage);\n\n\tif (hasSource && prepareImage) {\n\t\tthrow new Error('--source and --prepare-image cannot be used together.');\n\t}\n\tif (!hasSource && !prepareImage) {\n\t\tthrow new Error('--source is required unless --prepare-image is set.');\n\t}\n\n\treturn true;\n}\n\nfunction parseCsv(value: string, name: string): string[] {\n\tconst values = value\n\t\t.split(',')\n\t\t.map((entry) => entry.trim())\n\t\t.filter(Boolean);\n\tif (values.length === 0) {\n\t\tthrow new Error(`--${name} must contain at least one value.`);\n\t}\n\treturn values;\n}\n\nexport function splitShellWords(value: string): string[] {\n\tconst words: string[] = [];\n\tlet current = '';\n\tlet quote: '\"' | \"'\" | null = null;\n\tlet escaping = false;\n\n\tfor (const character of value) {\n\t\tif (escaping) {\n\t\t\tcurrent += character;\n\t\t\tescaping = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\\\\') {\n\t\t\tescaping = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (quote) {\n\t\t\tif (character === quote) {\n\t\t\t\tquote = null;\n\t\t\t} else {\n\t\t\t\tcurrent += character;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\"' || character === \"'\") {\n\t\t\tquote = character;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(character)) {\n\t\t\tif (current.length > 0) {\n\t\t\t\twords.push(current);\n\t\t\t\tcurrent = '';\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tcurrent += character;\n\t}\n\n\tif (escaping) {\n\t\tcurrent += '\\\\';\n\t}\n\tif (quote) {\n\t\tthrow new Error('Unterminated quote in --config-args.');\n\t}\n\tif (current.length > 0) {\n\t\twords.push(current);\n\t}\n\treturn words;\n}\n\nfunction findWorkspaceRoot(startDirectory: string): string {\n\tlet directory = path.resolve(startDirectory);\n\twhile (directory !== path.dirname(directory)) {\n\t\tif (\n\t\t\texistsSync(\n\t\t\t\tpath.join(\n\t\t\t\t\tdirectory,\n\t\t\t\t\t'packages/php-wasm/compile-extension/package.json'\n\t\t\t\t)\n\t\t\t) &&\n\t\t\texistsSync(path.join(directory, 'nx.json'))\n\t\t) {\n\t\t\treturn directory;\n\t\t}\n\t\tdirectory = path.dirname(directory);\n\t}\n\treturn process.cwd();\n}\n\nfunction isCliEntrypoint(metaUrl: string): boolean {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn (\n\t\t\trealpathSync(entrypoint) === realpathSync(fileURLToPath(metaUrl))\n\t\t);\n\t} catch {\n\t\treturn path.resolve(entrypoint) === fileURLToPath(metaUrl);\n\t}\n}\n"],"file":"cli.js"}
1
+ {"version":3,"mappings":"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","names":["PlaygroundRepositoryUrl","DockerAssetPaths","PlaygroundDockerAssetPaths","relativePath","ensureDockerAssets","workspaceRoot","packageRoot","cacheRoot","getDockerAssetsCacheRoot","fetchDockerAssetsOption","ref","resolveDockerAssetsRef","phpWasmRoot","path","stableHash","isPhpWasmDockerContext","fetchedPhpWasmRoot","fetchDockerAssets","cacheDir","tempDir","tempPhpWasmRoot","rm","mkdir","sparseCheckoutFiles","__vitePreload","fetchedPaths","fetchedPath","stripPhpWasmPathPrefix","source","destination","rename","writeFile","publishFetchedDockerAssets","error","findMatchingLocalFiles","existsSync","isExistingPathError","isPlaygroundWorkspace","version","readPackageJson","configuredCacheDir","xdgCacheHome","home","os","packageJsonPath","readFileSync","value","createHash","prefix","root","relativePathPattern","directory","basenamePattern","readdirSync","entry","pathSegmentMatchesPattern","segment","pattern","escapeRegExp","createDockerContext","options","workspacePhpWasmRoot","createContext","findPackageRoot","packagePhpWasmRoot","fileURLToPath","assertDockerIsAvailable","runCommand","buildBaseImage","context","buildExtensionImage","imageTag","getExtensionImageTag","runExtensionBuild","runArgs","arg","index","command","args","resolve","reject","child","spawn","code","ExtensionAsyncMode","createManifest","manifest","artifact","writeManifest","manifestPath","SupportedExtensionPHPVersions","PHP_RELEASE_BY_MINOR","prepareExtensionBuildImages","matrix","phpVersion","mapLimit","normalizeJobCount","asyncMode","resolvePHPRelease","compileExtensionMatrix","outDir","sourceDir","detectManifestVersion","artifacts","phpRelease","artifactFile","packageJson","readFile","items","limit","worker","results","nextIndex","workers","jobs","taskCount","EXTENSION_NAME_PATTERNS","detectExtensionName","configPath","config","detected","detectExtensionNameFromConfig","match","parseExtraFilesSpec","spec","separator","hostDir","vfsRoot","stageExtraFilesIntoOutDir","specs","nodes","claimedVfsPaths","claimedDestinations","absoluteHostDir","targetSubdir","destinationDir","cp","walk","entryPath","isDirectory","relativeUnderRoot","sourcePath","readdir","a","b","dir","visitor","entryStat","stat","OptionsWithDashPrefixedValues","main","hideBin","argv","parseCliArgs","findWorkspaceRoot","phpVersions","parseCsv","result","image","name","configArgs","splitShellWords","extraFilesSpecs","extraFiles","yargs","normalizeDashPrefixedOptionValues","validateCliMode","isCliEntrypoint","normalized","i","hasSource","prepareImage","values","words","current","quote","escaping","character","startDirectory","metaUrl","entrypoint","realpathSync"],"ignoreList":[],"sources":["../../../../packages/php-wasm/compile-extension/src/docker-assets.ts","../../../../packages/php-wasm/compile-extension/src/docker.ts","../../../../packages/php-wasm/compile-extension/src/manifest.ts","../../../../packages/php-wasm/compile-extension/src/compile.ts","../../../../packages/php-wasm/compile-extension/src/detect.ts","../../../../packages/php-wasm/compile-extension/src/extra-files.ts","../../../../packages/php-wasm/compile-extension/src/cli.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { existsSync, readFileSync, readdirSync } from 'node:fs';\nimport { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nexport const PlaygroundRepositoryUrl =\n\t'https://github.com/WordPress/wordpress-playground.git';\n\nexport const DockerAssetPaths = [\n\t'compile/base-image/Dockerfile',\n\t'compile/base-image/emcc-for-php-wasm.sh',\n\t'compile/base-image/replace.sh',\n\t'compile/base-image/replace-across-lines.sh',\n\t'compile/php/php*.patch',\n\t'compile-extension/docker/Dockerfile.ext',\n\t'compile-extension/scripts/build-in-docker.sh',\n];\n\nconst PlaygroundDockerAssetPaths = DockerAssetPaths.map(\n\t(relativePath) => `packages/php-wasm/${relativePath}`\n);\n\nexport interface EnsureDockerAssetsOptions {\n\tworkspaceRoot: string;\n\tpackageRoot: string;\n\tcacheRoot?: string;\n\tfetchDockerAssets?: typeof fetchDockerAssets;\n}\n\nexport interface FetchDockerAssetsOptions {\n\tref: string;\n\tcacheRoot: string;\n}\n\nexport async function ensureDockerAssets({\n\tworkspaceRoot,\n\tpackageRoot,\n\tcacheRoot = getDockerAssetsCacheRoot(),\n\tfetchDockerAssets: fetchDockerAssetsOption,\n}: EnsureDockerAssetsOptions): Promise<string> {\n\tconst ref = resolveDockerAssetsRef({ workspaceRoot, packageRoot });\n\tconst phpWasmRoot = path.join(cacheRoot, stableHash(ref), 'php-wasm');\n\n\tif (isPhpWasmDockerContext(phpWasmRoot)) {\n\t\treturn phpWasmRoot;\n\t}\n\n\tconsole.log(\n\t\t`Fetching PHP.wasm Docker assets from WordPress/wordpress-playground ${ref}.`\n\t);\n\tconst fetchedPhpWasmRoot = await (\n\t\tfetchDockerAssetsOption ?? fetchDockerAssets\n\t)({ ref, cacheRoot });\n\tif (!isPhpWasmDockerContext(fetchedPhpWasmRoot)) {\n\t\tthrow new Error(\n\t\t\t`Fetched PHP.wasm Docker assets from ${ref}, but the cache is incomplete.`\n\t\t);\n\t}\n\treturn fetchedPhpWasmRoot;\n}\n\nexport async function fetchDockerAssets({\n\tref,\n\tcacheRoot,\n}: FetchDockerAssetsOptions): Promise<string> {\n\tconst cacheDir = path.join(cacheRoot, stableHash(ref));\n\tconst phpWasmRoot = path.join(cacheDir, 'php-wasm');\n\tconst tempDir = `${cacheDir}-${process.pid}-${Date.now()}.tmp`;\n\tconst tempPhpWasmRoot = path.join(tempDir, 'php-wasm');\n\n\tawait rm(tempDir, { recursive: true, force: true });\n\tawait mkdir(tempPhpWasmRoot, { recursive: true });\n\n\ttry {\n\t\tconst { sparseCheckoutFiles } = await import('./git-sparse-checkout');\n\t\tconst fetchedPaths = await sparseCheckoutFiles({\n\t\t\trepoUrl: PlaygroundRepositoryUrl,\n\t\t\tref,\n\t\t\tpaths: PlaygroundDockerAssetPaths,\n\t\t\toutDir: tempDir,\n\t\t\tworkDir: path.join(tempDir, '.git-work'),\n\t\t});\n\n\t\tfor (const fetchedPath of fetchedPaths) {\n\t\t\tconst relativePath = stripPhpWasmPathPrefix(fetchedPath);\n\t\t\tconst source = path.join(\n\t\t\t\ttempDir,\n\t\t\t\t'packages/php-wasm',\n\t\t\t\trelativePath\n\t\t\t);\n\t\t\tconst destination = path.join(tempPhpWasmRoot, relativePath);\n\t\t\tawait mkdir(path.dirname(destination), { recursive: true });\n\t\t\tawait rename(source, destination);\n\t\t}\n\n\t\tawait writeFile(\n\t\t\tpath.join(tempPhpWasmRoot, 'source.json'),\n\t\t\t`${JSON.stringify({ repository: PlaygroundRepositoryUrl, ref }, null, 2)}\\n`\n\t\t);\n\t\tawait rm(path.join(tempDir, '.git-work'), {\n\t\t\trecursive: true,\n\t\t\tforce: true,\n\t\t});\n\t\tawait rm(path.join(tempDir, 'packages'), {\n\t\t\trecursive: true,\n\t\t\tforce: true,\n\t\t});\n\n\t\tawait publishFetchedDockerAssets({\n\t\t\ttempDir,\n\t\t\tcacheDir,\n\t\t\tphpWasmRoot,\n\t\t});\n\t} catch (error) {\n\t\tawait rm(tempDir, { recursive: true, force: true });\n\t\tthrow error;\n\t}\n\n\treturn phpWasmRoot;\n}\n\nexport function isPhpWasmDockerContext(phpWasmRoot: string): boolean {\n\treturn DockerAssetPaths.every((relativePath) => {\n\t\tif (!relativePath.includes('*')) {\n\t\t\treturn existsSync(path.join(phpWasmRoot, relativePath));\n\t\t}\n\t\treturn findMatchingLocalFiles(phpWasmRoot, relativePath).length > 0;\n\t});\n}\n\nexport async function publishFetchedDockerAssets({\n\ttempDir,\n\tcacheDir,\n\tphpWasmRoot,\n}: {\n\ttempDir: string;\n\tcacheDir: string;\n\tphpWasmRoot: string;\n}): Promise<void> {\n\tawait mkdir(path.dirname(cacheDir), { recursive: true });\n\ttry {\n\t\tawait rename(tempDir, cacheDir);\n\t} catch (error) {\n\t\tif (isExistingPathError(error) && isPhpWasmDockerContext(phpWasmRoot)) {\n\t\t\tawait rm(tempDir, { recursive: true, force: true });\n\t\t\treturn;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nexport function resolveDockerAssetsRef({\n\tworkspaceRoot,\n\tpackageRoot,\n}: {\n\tworkspaceRoot: string;\n\tpackageRoot: string;\n}): string {\n\tif (isPlaygroundWorkspace(workspaceRoot)) {\n\t\treturn 'trunk';\n\t}\n\tconst packageJson = readPackageJson(packageRoot);\n\tconst version = packageJson.version;\n\tif (!version) {\n\t\tthrow new Error(\n\t\t\t`Could not resolve @php-wasm/compile-extension version from ${packageRoot}.`\n\t\t);\n\t}\n\treturn `v${version}`;\n}\n\nexport function isPlaygroundWorkspace(workspaceRoot: string): boolean {\n\treturn (\n\t\texistsSync(path.join(workspaceRoot, 'nx.json')) &&\n\t\texistsSync(\n\t\t\tpath.join(\n\t\t\t\tworkspaceRoot,\n\t\t\t\t'packages/php-wasm/compile-extension/package.json'\n\t\t\t)\n\t\t)\n\t);\n}\n\nexport function getDockerAssetsCacheRoot(): string {\n\tconst configuredCacheDir =\n\t\tprocess.env['PHP_WASM_COMPILE_EXTENSION_CACHE_DIR'];\n\tif (configuredCacheDir) {\n\t\treturn configuredCacheDir;\n\t}\n\tconst xdgCacheHome = process.env['XDG_CACHE_HOME'];\n\tif (xdgCacheHome) {\n\t\treturn path.join(\n\t\t\txdgCacheHome,\n\t\t\t'php-wasm/compile-extension/docker-assets'\n\t\t);\n\t}\n\tconst home = os.homedir();\n\tif (home) {\n\t\treturn path.join(home, '.cache/php-wasm/compile-extension/docker-assets');\n\t}\n\treturn path.join(os.tmpdir(), 'php-wasm/compile-extension/docker-assets');\n}\n\nfunction readPackageJson(packageRoot: string): { version?: string } {\n\tconst packageJsonPath = path.join(packageRoot, 'package.json');\n\tif (!existsSync(packageJsonPath)) {\n\t\treturn {};\n\t}\n\treturn JSON.parse(\n\t\t// This file is tiny and read synchronously while resolving CLI startup\n\t\t// paths; keeping the API sync avoids threading async through ref helpers.\n\t\treadFileSync(packageJsonPath, 'utf8')\n\t) as { version?: string };\n}\n\nexport async function readDockerAssetSource(\n\tphpWasmRoot: string\n): Promise<{ repository: string; ref: string } | undefined> {\n\tconst sourceFile = path.join(phpWasmRoot, 'source.json');\n\tif (!existsSync(sourceFile)) {\n\t\treturn undefined;\n\t}\n\treturn readJsonFile(sourceFile);\n}\n\nfunction stableHash(value: string): string {\n\treturn createHash('sha256').update(value).digest('hex').slice(0, 16);\n}\n\nfunction stripPhpWasmPathPrefix(fetchedPath: string): string {\n\tconst prefix = 'packages/php-wasm/';\n\tif (!fetchedPath.startsWith(prefix)) {\n\t\tthrow new Error(`Unexpected fetched Docker asset path: ${fetchedPath}`);\n\t}\n\treturn fetchedPath.slice(prefix.length);\n}\n\nfunction findMatchingLocalFiles(\n\troot: string,\n\trelativePathPattern: string\n): string[] {\n\tconst directory = path.join(root, path.dirname(relativePathPattern));\n\tconst basenamePattern = path.basename(relativePathPattern);\n\tif (!existsSync(directory)) {\n\t\treturn [];\n\t}\n\treturn readdirSync(directory, { withFileTypes: true })\n\t\t.filter(\n\t\t\t(entry) =>\n\t\t\t\tentry.isFile() &&\n\t\t\t\tpathSegmentMatchesPattern(entry.name, basenamePattern)\n\t\t)\n\t\t.map((entry) =>\n\t\t\tpath\n\t\t\t\t.join(path.dirname(relativePathPattern), entry.name)\n\t\t\t\t.split(path.sep)\n\t\t\t\t.join('/')\n\t\t)\n\t\t.sort();\n}\n\nfunction pathSegmentMatchesPattern(segment: string, pattern: string): boolean {\n\tif (!pattern.includes('*')) {\n\t\treturn segment === pattern;\n\t}\n\treturn new RegExp(\n\t\t`^${pattern\n\t\t\t.split('*')\n\t\t\t.map(escapeRegExp)\n\t\t\t.join('.*')}$`\n\t).test(segment);\n}\n\nfunction escapeRegExp(value: string): string {\n\treturn value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\nasync function readJsonFile<T>(filename: string): Promise<T> {\n\treturn JSON.parse(await readFile(filename, 'utf8')) as T;\n}\n\nfunction isExistingPathError(error: unknown): boolean {\n\treturn (\n\t\ttypeof error === 'object' &&\n\t\terror !== null &&\n\t\t'code' in error &&\n\t\t['EEXIST', 'ENOTEMPTY', 'EPERM'].includes(String(error.code))\n\t);\n}\n","import { spawn } from 'node:child_process';\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport {\n\tensureDockerAssets,\n\tisPhpWasmDockerContext,\n\ttype EnsureDockerAssetsOptions,\n} from './docker-assets';\nimport type { AsyncMode } from './manifest';\n\nexport interface DockerBuildContext {\n\tworkspaceRoot: string;\n\tphpWasmRoot: string;\n\tcompileRoot: string;\n\tcompileExtensionRoot: string;\n}\n\nexport interface DockerImageOptions extends DockerBuildContext {\n\tphpVersion: string;\n\tphpRelease: string;\n\tasyncMode: AsyncMode;\n}\n\nexport interface DockerRunOptions extends DockerImageOptions {\n\tsourceDir: string;\n\toutDir: string;\n\tname: string;\n\tartifactFile: string;\n\toptimize: string;\n\textraCflags?: string;\n\textraLdflags?: string;\n\tconfigArgs: string[];\n}\n\nexport interface CreateDockerContextOptions {\n\tpackageRoot?: string;\n\tcacheRoot?: string;\n\tfetchDockerAssets?: EnsureDockerAssetsOptions['fetchDockerAssets'];\n}\n\nexport async function createDockerContext(\n\tworkspaceRoot: string,\n\toptions: CreateDockerContextOptions = {}\n): Promise<DockerBuildContext> {\n\tconst workspacePhpWasmRoot = path.join(workspaceRoot, 'packages/php-wasm');\n\tif (isPhpWasmDockerContext(workspacePhpWasmRoot)) {\n\t\treturn createContext(workspaceRoot, workspacePhpWasmRoot);\n\t}\n\n\tconst packageRoot = options.packageRoot ?? findPackageRoot();\n\tconst packagePhpWasmRoot = path.join(packageRoot, 'php-wasm');\n\tif (isPhpWasmDockerContext(packagePhpWasmRoot)) {\n\t\treturn createContext(workspaceRoot, packagePhpWasmRoot);\n\t}\n\n\tconst fetchedPhpWasmRoot = await ensureDockerAssets({\n\t\tworkspaceRoot,\n\t\tpackageRoot,\n\t\tcacheRoot: options.cacheRoot,\n\t\tfetchDockerAssets: options.fetchDockerAssets,\n\t});\n\treturn createContext(workspaceRoot, fetchedPhpWasmRoot);\n}\n\nfunction createContext(\n\tworkspaceRoot: string,\n\tphpWasmRoot: string\n): DockerBuildContext {\n\treturn {\n\t\tworkspaceRoot,\n\t\tphpWasmRoot,\n\t\tcompileRoot: path.join(phpWasmRoot, 'compile'),\n\t\tcompileExtensionRoot: path.join(phpWasmRoot, 'compile-extension'),\n\t};\n}\n\nfunction findPackageRoot(): string {\n\tlet directory = path.dirname(fileURLToPath(import.meta.url));\n\twhile (directory !== path.dirname(directory)) {\n\t\tif (existsSync(path.join(directory, 'package.json'))) {\n\t\t\treturn directory;\n\t\t}\n\t\tdirectory = path.dirname(directory);\n\t}\n\treturn path.dirname(fileURLToPath(import.meta.url));\n}\n\nexport async function assertDockerIsAvailable(): Promise<void> {\n\ttry {\n\t\tawait runCommand('docker', ['--version'], {\n\t\t\tstdio: 'ignore',\n\t\t});\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t'Docker is required to compile PHP.wasm extensions, but the docker command was not found.',\n\t\t\t{ cause: error }\n\t\t);\n\t}\n}\n\nexport async function buildBaseImage(context: DockerBuildContext) {\n\tawait runCommand(\n\t\t'docker',\n\t\t[\n\t\t\t'build',\n\t\t\t'-f',\n\t\t\t'./Dockerfile',\n\t\t\t'.',\n\t\t\t'--tag=playground-php-wasm:base',\n\t\t\t'--progress=plain',\n\t\t],\n\t\t{\n\t\t\tcwd: path.join(context.compileRoot, 'base-image'),\n\t\t}\n\t);\n}\n\nexport async function buildExtensionImage(\n\toptions: DockerImageOptions\n): Promise<string> {\n\tconst imageTag = getExtensionImageTag(options);\n\tawait runCommand(\n\t\t'docker',\n\t\t[\n\t\t\t'build',\n\t\t\t'-f',\n\t\t\t'compile-extension/docker/Dockerfile.ext',\n\t\t\t'.',\n\t\t\t`--tag=${imageTag}`,\n\t\t\t'--progress=plain',\n\t\t\t'--build-arg',\n\t\t\t`PHP_VERSION=${options.phpRelease}`,\n\t\t\t'--build-arg',\n\t\t\t'JSPI=yes',\n\t\t],\n\t\t{\n\t\t\tcwd: options.phpWasmRoot,\n\t\t}\n\t);\n\treturn imageTag;\n}\n\nexport async function runExtensionBuild(options: DockerRunOptions) {\n\tconst imageTag = getExtensionImageTag(options);\n\tconst runArgs = [\n\t\t'run',\n\t\t'--rm',\n\t\t'-v',\n\t\t`${options.sourceDir}:/src:ro`,\n\t\t'-v',\n\t\t`${options.outDir}:/out`,\n\t\t'-v',\n\t\t`${options.compileRoot}:/php-wasm-compile:ro`,\n\t\t'--env',\n\t\t`EXTENSION_NAME=${options.name}`,\n\t\t'--env',\n\t\t`PHP_VERSION_SHORT=${options.phpVersion}`,\n\t\t'--env',\n\t\t`ASYNC_MODE=${options.asyncMode}`,\n\t\t'--env',\n\t\t`ARTIFACT_FILENAME=${options.artifactFile}`,\n\t\t'--env',\n\t\t`OPTIMIZE=${options.optimize}`,\n\t\t'--env',\n\t\t`CONFIG_ARGS_COUNT=${options.configArgs.length}`,\n\t];\n\n\tif (options.extraCflags) {\n\t\trunArgs.push('--env', `EXTRA_CFLAGS=${options.extraCflags}`);\n\t}\n\tif (options.extraLdflags) {\n\t\trunArgs.push('--env', `EXTRA_LDFLAGS=${options.extraLdflags}`);\n\t}\n\n\toptions.configArgs.forEach((arg, index) => {\n\t\trunArgs.push('--env', `CONFIG_ARG_${index}=${arg}`);\n\t});\n\n\trunArgs.push(imageTag);\n\n\tawait runCommand('docker', runArgs, {\n\t\tcwd: options.workspaceRoot,\n\t});\n}\n\nfunction getExtensionImageTag(\n\toptions: Pick<DockerImageOptions, 'phpVersion' | 'asyncMode'>\n) {\n\tconst phpVersion = options.phpVersion.replaceAll('.', '-');\n\treturn `playground-php-wasm:compile-extension-php${phpVersion}-${options.asyncMode}`;\n}\n\ninterface RunCommandOptions {\n\tcwd?: string;\n\tstdio?: 'inherit' | 'ignore';\n}\n\nasync function runCommand(\n\tcommand: string,\n\targs: string[],\n\toptions: RunCommandOptions = {}\n): Promise<void> {\n\tconsole.log(`Running ${command} ${args.join(' ')}`);\n\tawait new Promise<void>((resolve, reject) => {\n\t\tconst child = spawn(command, args, {\n\t\t\tcwd: options.cwd,\n\t\t\tstdio: options.stdio ?? 'inherit',\n\t\t\tenv: process.env,\n\t\t});\n\t\tchild.on('error', reject);\n\t\tchild.on('close', (code) => {\n\t\t\tif (code === 0) {\n\t\t\t\tresolve();\n\t\t\t\treturn;\n\t\t\t}\n\t\t\treject(new Error(`${command} exited with code ${code}`));\n\t\t});\n\t});\n}\n","import { mkdir, writeFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nexport const ExtensionAsyncMode = 'jspi';\nexport type AsyncMode = typeof ExtensionAsyncMode;\n\n/**\n * One sidecar file or empty directory staged alongside an artifact.\n *\n * Mirrors `PHPExtensionManifestExtraFile` in `@php-wasm/universal`.\n */\nexport interface ExtensionManifestExtraFile {\n\t/** Joined with the group's `vfsRoot` to form the final VFS path. */\n\tvfsPath: string;\n\t/** Defaults to \"file\". Only file nodes need a `sourcePath`. */\n\ttype?: 'file' | 'directory';\n\t/** Relative to the manifest URL/base URL, or an absolute URL. */\n\tsourcePath?: string;\n}\n\nexport interface ExtensionManifestExtraFiles {\n\t/** Absolute VFS prefix joined with each node's `vfsPath`. */\n\tvfsRoot?: string;\n\tnodes?: ExtensionManifestExtraFile[];\n}\n\nexport interface ExtensionArtifact {\n\tphpVersion: string;\n\t/** Path to the `.so` file, relative to the manifest URL or absolute. */\n\tsourcePath: string;\n\t/** URL-backed files needed only by this artifact. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface ExtensionManifest {\n\tname: string;\n\tversion: string;\n\t/**\n\t * The first directive of the generated startup `.ini` file. Defaults to\n\t * `extension`; use `zend_extension` for Zend extensions like Xdebug.\n\t * Use `false` to stage the `.so` without registering it in php.ini.\n\t */\n\tloadWithIniDirective?: 'extension' | 'zend_extension' | false;\n\t/** Additional `key=value` lines for the generated startup `.ini` file. */\n\tiniEntries?: Record<string, string>;\n\t/** Environment variables added before the extension is loaded. */\n\tenv?: Record<string, string>;\n\t/**\n\t * VFS directory where PHP.wasm writes the extension `.so` file and its\n\t * per-extension ini file.\n\t */\n\textensionDir?: string;\n\tartifacts: ExtensionArtifact[];\n\t/** URL-backed files shared by every artifact in this manifest. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface BuiltArtifact {\n\tphpVersion: string;\n\t/** Path to the `.so` file, relative to the manifest URL. */\n\tsourcePath: string;\n\t/** Absolute path on disk where the `.so` was written. */\n\tpath: string;\n}\n\nexport async function createManifest(options: {\n\tname: string;\n\tversion: string;\n\tartifacts: BuiltArtifact[];\n\textraFiles?: ExtensionManifestExtraFiles;\n}): Promise<ExtensionManifest> {\n\tconst manifest: ExtensionManifest = {\n\t\tname: options.name,\n\t\tversion: options.version,\n\t\tartifacts: options.artifacts.map((artifact) => ({\n\t\t\tphpVersion: artifact.phpVersion,\n\t\t\tsourcePath: artifact.sourcePath,\n\t\t})),\n\t};\n\tif (options.extraFiles) {\n\t\tmanifest.extraFiles = options.extraFiles;\n\t}\n\treturn manifest;\n}\n\nexport async function writeManifest(options: {\n\toutDir: string;\n\tmanifest: ExtensionManifest;\n}): Promise<string> {\n\tawait mkdir(options.outDir, { recursive: true });\n\tconst manifestPath = path.join(options.outDir, 'manifest.json');\n\tawait writeFile(\n\t\tmanifestPath,\n\t\t`${JSON.stringify(options.manifest, null, 2)}\\n`\n\t);\n\treturn manifestPath;\n}\n\nexport function findExtensionArtifact(\n\tmanifest: ExtensionManifest,\n\tphpVersion: string\n): ExtensionArtifact | undefined {\n\treturn manifest.artifacts.find(\n\t\t(artifact) => artifact.phpVersion === phpVersion\n\t);\n}\n","import { mkdir, readFile } from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport {\n\tassertDockerIsAvailable,\n\tbuildBaseImage,\n\tbuildExtensionImage,\n\tcreateDockerContext,\n\trunExtensionBuild,\n} from './docker';\nimport type {\n\tAsyncMode,\n\tBuiltArtifact,\n\tExtensionManifestExtraFiles,\n} from './manifest';\nimport { createManifest, ExtensionAsyncMode, writeManifest } from './manifest';\n\nexport const SupportedExtensionPHPVersions = [\n\t'8.5',\n\t'8.4',\n\t'8.3',\n\t'8.2',\n\t'8.1',\n\t'8.0',\n\t'7.4',\n] as const;\n\nconst PHP_RELEASE_BY_MINOR: Record<string, string> = {\n\t'8.5': '8.5.5',\n\t'8.4': '8.4.20',\n\t'8.3': '8.3.30',\n\t'8.2': '8.2.30',\n\t'8.1': '8.1.34',\n\t'8.0': '8.0.30',\n\t'7.4': '7.4.33',\n};\n\nexport interface CompileExtensionOptions {\n\tworkspaceRoot: string;\n\tsourceDir: string;\n\toutDir: string;\n\tname: string;\n\tphpVersions: string[];\n\textraCflags?: string;\n\textraLdflags?: string;\n\tconfigArgs: string[];\n\toptimize: string;\n\tjobs?: number;\n\t/** Sidecar files to record at the manifest level. */\n\textraFiles?: ExtensionManifestExtraFiles;\n}\n\nexport interface PrepareExtensionBuildImagesOptions {\n\tworkspaceRoot: string;\n\tphpVersions: string[];\n\tjobs?: number;\n}\n\nexport async function prepareExtensionBuildImages(\n\toptions: PrepareExtensionBuildImagesOptions\n) {\n\tawait assertDockerIsAvailable();\n\n\tconst context = await createDockerContext(options.workspaceRoot);\n\tconst matrix: Array<{ phpVersion: string; asyncMode: AsyncMode }> =\n\t\toptions.phpVersions.map((phpVersion) => ({\n\t\t\tphpVersion,\n\t\t\tasyncMode: ExtensionAsyncMode,\n\t\t}));\n\n\tawait buildBaseImage(context);\n\n\tconst images = await mapLimit(\n\t\tmatrix,\n\t\tnormalizeJobCount(options.jobs, matrix.length),\n\t\tasync ({ phpVersion, asyncMode }) => {\n\t\t\tconst imageTag = await buildExtensionImage({\n\t\t\t\t...context,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease: resolvePHPRelease(phpVersion),\n\t\t\t\tasyncMode,\n\t\t\t});\n\t\t\treturn { phpVersion, asyncMode, imageTag };\n\t\t}\n\t);\n\n\treturn { images };\n}\n\nexport async function compileExtensionMatrix(options: CompileExtensionOptions) {\n\tconst outDir = path.resolve(options.workspaceRoot, options.outDir);\n\tconst sourceDir = path.resolve(options.workspaceRoot, options.sourceDir);\n\tawait assertDockerIsAvailable();\n\n\tconst context = await createDockerContext(options.workspaceRoot);\n\tconst version = await detectManifestVersion(sourceDir);\n\tconst matrix: Array<{ phpVersion: string; asyncMode: AsyncMode }> =\n\t\toptions.phpVersions.map((phpVersion) => ({\n\t\t\tphpVersion,\n\t\t\tasyncMode: ExtensionAsyncMode,\n\t}));\n\n\tawait mkdir(outDir, { recursive: true });\n\tawait buildBaseImage(context);\n\n\tconst artifacts = await mapLimit(\n\t\tmatrix,\n\t\tnormalizeJobCount(options.jobs, matrix.length),\n\t\tasync ({ phpVersion, asyncMode }) => {\n\t\t\tconst phpRelease = resolvePHPRelease(phpVersion);\n\t\t\tconst artifactFile = `${options.name}-php${phpVersion}-${asyncMode}.so`;\n\t\t\tawait buildExtensionImage({\n\t\t\t\t...context,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease,\n\t\t\t\tasyncMode,\n\t\t\t});\n\t\t\tawait runExtensionBuild({\n\t\t\t\t...context,\n\t\t\t\tsourceDir,\n\t\t\t\toutDir,\n\t\t\t\tname: options.name,\n\t\t\t\tphpVersion,\n\t\t\t\tphpRelease,\n\t\t\t\tasyncMode,\n\t\t\t\tartifactFile,\n\t\t\t\toptimize: options.optimize,\n\t\t\t\textraCflags: options.extraCflags,\n\t\t\t\textraLdflags: options.extraLdflags,\n\t\t\t\tconfigArgs: options.configArgs,\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tphpVersion,\n\t\t\t\tsourcePath: artifactFile,\n\t\t\t\tpath: path.join(outDir, artifactFile),\n\t\t\t} satisfies BuiltArtifact;\n\t\t}\n\t);\n\n\tconst manifest = await createManifest({\n\t\tname: options.name,\n\t\tversion,\n\t\tartifacts,\n\t\textraFiles: options.extraFiles,\n\t});\n\tconst manifestPath = await writeManifest({ outDir, manifest });\n\treturn { manifestPath, artifacts, manifest };\n}\n\nexport function resolvePHPRelease(phpVersion: string): string {\n\treturn PHP_RELEASE_BY_MINOR[phpVersion] ?? phpVersion;\n}\n\nasync function detectManifestVersion(sourceDir: string): Promise<string> {\n\ttry {\n\t\tconst packageJson = JSON.parse(\n\t\t\tawait readFile(path.join(sourceDir, 'package.json'), 'utf8')\n\t\t) as { version?: unknown };\n\t\tif (typeof packageJson.version === 'string') {\n\t\t\treturn packageJson.version;\n\t\t}\n\t} catch {\n\t\t// Native PHP extension sources usually do not contain package.json.\n\t}\n\treturn '0.0.0';\n}\n\nasync function mapLimit<T, R>(\n\titems: T[],\n\tlimit: number,\n\tworker: (item: T) => Promise<R>\n): Promise<R[]> {\n\tconst results: R[] = new Array(items.length) as R[];\n\tlet nextIndex = 0;\n\tconst workers = Array.from(\n\t\t{ length: Math.min(limit, items.length) },\n\t\tasync () => {\n\t\t\twhile (nextIndex < items.length) {\n\t\t\t\tconst index = nextIndex++;\n\t\t\t\tresults[index] = await worker(items[index]);\n\t\t\t}\n\t\t}\n\t);\n\tawait Promise.all(workers);\n\treturn results;\n}\n\nfunction normalizeJobCount(\n\tjobs: number | undefined,\n\ttaskCount: number\n): number {\n\tif (taskCount === 0) {\n\t\treturn 1;\n\t}\n\tif (jobs && jobs > 0) {\n\t\treturn Math.min(jobs, taskCount);\n\t}\n\treturn Math.min(os.availableParallelism?.() ?? os.cpus().length, taskCount);\n}\n","import { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nconst EXTENSION_NAME_PATTERNS = [\n\t/\\bPHP_ARG_ENABLE\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n\t/\\bPHP_ARG_WITH\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n\t/\\bPHP_NEW_EXTENSION\\(\\s*\\[?([A-Za-z0-9_]+)\\]?/m,\n];\n\nexport async function detectExtensionName(sourceDir: string): Promise<string> {\n\tconst configPath = path.join(sourceDir, 'config.m4');\n\tlet config: string;\n\ttry {\n\t\tconfig = await readFile(configPath, 'utf8');\n\t} catch (error) {\n\t\tthrow new Error(\n\t\t\t`Could not read ${configPath}. Pass --name or provide a config.m4 file.`,\n\t\t\t{ cause: error }\n\t\t);\n\t}\n\n\tconst detected = detectExtensionNameFromConfig(config);\n\tif (!detected) {\n\t\tthrow new Error(\n\t\t\t`Could not detect the extension name from ${configPath}. Pass --name explicitly.`\n\t\t);\n\t}\n\treturn detected;\n}\n\nexport function detectExtensionNameFromConfig(config: string): string | null {\n\tfor (const pattern of EXTENSION_NAME_PATTERNS) {\n\t\tconst match = pattern.exec(config);\n\t\tif (match?.[1]) {\n\t\t\treturn match[1];\n\t\t}\n\t}\n\treturn null;\n}\n","import { cp, mkdir, readdir, stat } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport type {\n\tExtensionManifestExtraFile,\n\tExtensionManifestExtraFiles,\n} from './manifest';\n\n/**\n * Parses a `--extra-files` CLI argument of the form `<hostDir>:<vfsRoot>`.\n *\n * `vfsRoot` must be an absolute VFS path so the loader can stage files\n * without making up a default root. Splitting on the *last* colon lets\n * Windows host paths like `C:\\dir:/internal/root` round-trip cleanly.\n */\nexport function parseExtraFilesSpec(spec: string): {\n\thostDir: string;\n\tvfsRoot: string;\n} {\n\tconst separator = spec.lastIndexOf(':');\n\tif (separator < 0) {\n\t\tthrow new Error(\n\t\t\t`Invalid --extra-files value ${JSON.stringify(\n\t\t\t\tspec\n\t\t\t)}. Expected \"<hostDir>:<vfsRoot>\".`\n\t\t);\n\t}\n\tconst hostDir = spec.slice(0, separator);\n\tconst vfsRoot = spec.slice(separator + 1);\n\tif (!hostDir || !vfsRoot) {\n\t\tthrow new Error(\n\t\t\t`Invalid --extra-files value ${JSON.stringify(\n\t\t\t\tspec\n\t\t\t)}. Expected \"<hostDir>:<vfsRoot>\".`\n\t\t);\n\t}\n\tif (!vfsRoot.startsWith('/')) {\n\t\tthrow new Error(\n\t\t\t`--extra-files vfsRoot must be an absolute VFS path. Received ${JSON.stringify(\n\t\t\t\tvfsRoot\n\t\t\t)}.`\n\t\t);\n\t}\n\treturn { hostDir, vfsRoot };\n}\n\n/**\n * Copies one or more host directories into `outDir` and returns a manifest\n * `extraFiles` group whose `sourcePath` entries are relative to `outDir`.\n *\n * Each spec is `<hostDir>:<vfsRoot>`. All specs must agree on `vfsRoot`\n * because the manifest format only stores a single `vfsRoot` per group.\n *\n * Files keep their relative path under `vfsRoot`. Empty directories are\n * recorded as `type: 'directory'` nodes so the loader creates them.\n */\nexport async function stageExtraFilesIntoOutDir(\n\tspecs: Array<{ hostDir: string; vfsRoot: string }>,\n\toutDir: string,\n\tworkspaceRoot: string\n): Promise<ExtensionManifestExtraFiles | undefined> {\n\tif (!specs.length) {\n\t\treturn undefined;\n\t}\n\tconst vfsRoot = specs[0].vfsRoot;\n\tfor (const spec of specs) {\n\t\tif (spec.vfsRoot !== vfsRoot) {\n\t\t\tthrow new Error(\n\t\t\t\t'All --extra-files entries must share the same vfsRoot. Received ' +\n\t\t\t\t\tJSON.stringify(specs.map((entry) => entry.vfsRoot))\n\t\t\t);\n\t\t}\n\t}\n\n\tconst nodes: ExtensionManifestExtraFile[] = [];\n\tconst claimedVfsPaths = new Set<string>();\n\tconst claimedDestinations = new Set<string>();\n\tfor (const spec of specs) {\n\t\tconst absoluteHostDir = path.resolve(workspaceRoot, spec.hostDir);\n\t\tconst targetSubdir = path.basename(absoluteHostDir);\n\t\tconst destinationDir = path.join(outDir, targetSubdir);\n\t\tif (claimedDestinations.has(destinationDir)) {\n\t\t\tthrow new Error(\n\t\t\t\t`--extra-files destination collides on disk: ${destinationDir}. ` +\n\t\t\t\t\t`Two host directories share the same basename, so one would overwrite the other.`\n\t\t\t);\n\t\t}\n\t\tclaimedDestinations.add(destinationDir);\n\t\tawait mkdir(path.dirname(destinationDir), { recursive: true });\n\t\tawait cp(absoluteHostDir, destinationDir, { recursive: true });\n\n\t\tawait walk(destinationDir, async (entryPath, isDirectory) => {\n\t\t\tconst relativeUnderRoot = path\n\t\t\t\t.relative(destinationDir, entryPath)\n\t\t\t\t.split(path.sep)\n\t\t\t\t.join('/');\n\t\t\tif (!relativeUnderRoot) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst sourcePath = `${targetSubdir}/${relativeUnderRoot}`;\n\t\t\tif (isDirectory) {\n\t\t\t\tconst empty = (await readdir(entryPath)).length === 0;\n\t\t\t\tif (!empty) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (claimedVfsPaths.has(relativeUnderRoot)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`--extra-files vfsPath collides across specs: ${relativeUnderRoot}.`\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tclaimedVfsPaths.add(relativeUnderRoot);\n\t\t\t\tnodes.push({\n\t\t\t\t\tvfsPath: relativeUnderRoot,\n\t\t\t\t\ttype: 'directory',\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tif (claimedVfsPaths.has(relativeUnderRoot)) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`--extra-files vfsPath collides across specs: ${relativeUnderRoot}.`\n\t\t\t\t);\n\t\t\t}\n\t\t\tclaimedVfsPaths.add(relativeUnderRoot);\n\t\t\tnodes.push({\n\t\t\t\tvfsPath: relativeUnderRoot,\n\t\t\t\tsourcePath,\n\t\t\t});\n\t\t});\n\t}\n\t// Sort with a locale-independent comparator so the manifest is byte-stable\n\t// across machines (`localeCompare` honors the host locale).\n\tnodes.sort((a, b) =>\n\t\ta.vfsPath < b.vfsPath ? -1 : a.vfsPath > b.vfsPath ? 1 : 0\n\t);\n\n\treturn {\n\t\tvfsRoot,\n\t\tnodes,\n\t};\n}\n\nasync function walk(\n\tdir: string,\n\tvisitor: (entryPath: string, isDirectory: boolean) => Promise<void>\n): Promise<void> {\n\tfor (const entry of await readdir(dir)) {\n\t\tconst entryPath = path.join(dir, entry);\n\t\tconst entryStat = await stat(entryPath);\n\t\tawait visitor(entryPath, entryStat.isDirectory());\n\t\tif (entryStat.isDirectory()) {\n\t\t\tawait walk(entryPath, visitor);\n\t\t}\n\t}\n}\n","#!/usr/bin/env node\nimport { existsSync, realpathSync } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\n\nimport {\n\tcompileExtensionMatrix,\n\tprepareExtensionBuildImages,\n\tSupportedExtensionPHPVersions,\n} from './compile';\nimport { detectExtensionName } from './detect';\nimport { parseExtraFilesSpec, stageExtraFilesIntoOutDir } from './extra-files';\n\nconst OptionsWithDashPrefixedValues = new Set([\n\t'--config-args',\n\t'--extra-cflags',\n\t'--extra-ldflags',\n]);\n\nexport async function main(args = hideBin(process.argv)) {\n\tconst argv = await parseCliArgs(args);\n\tconst workspaceRoot = findWorkspaceRoot(process.cwd());\n\tconst phpVersions = parseCsv(\n\t\targv['php-versions'] as string,\n\t\t'php-versions'\n\t);\n\n\tif (argv['prepare-image']) {\n\t\tconst result = await prepareExtensionBuildImages({\n\t\t\tworkspaceRoot,\n\t\t\tphpVersions,\n\t\t\tjobs: argv['jobs'] as number | undefined,\n\t\t});\n\t\tconsole.log(\n\t\t\t`Prepared ${result.images.length} PHP.wasm extension build images.`\n\t\t);\n\t\tfor (const image of result.images) {\n\t\t\tconsole.log(image.imageTag);\n\t\t}\n\t\treturn;\n\t}\n\n\tconst source = argv['source'] as string;\n\tconst sourceDir = path.resolve(workspaceRoot, source);\n\tconst name =\n\t\t(argv['name'] as string | undefined) ??\n\t\t(await detectExtensionName(sourceDir));\n\tconst configArgs = splitShellWords((argv['config-args'] as string) || '');\n\tconst extraFilesSpecs = (argv['extra-files'] as string[]).map(\n\t\tparseExtraFilesSpec\n\t);\n\tconst outDir = path.resolve(workspaceRoot, argv['out'] as string);\n\tconst extraFiles = await stageExtraFilesIntoOutDir(\n\t\textraFilesSpecs,\n\t\toutDir,\n\t\tworkspaceRoot\n\t);\n\n\tconst result = await compileExtensionMatrix({\n\t\tworkspaceRoot,\n\t\tsourceDir,\n\t\toutDir: argv['out'] as string,\n\t\tname,\n\t\tphpVersions,\n\t\textraCflags: argv['extra-cflags'] as string | undefined,\n\t\textraLdflags: argv['extra-ldflags'] as string | undefined,\n\t\tconfigArgs,\n\t\toptimize: argv['optimize'] as string,\n\t\tjobs: argv['jobs'] as number | undefined,\n\t\textraFiles,\n\t});\n\n\tconsole.log(`Wrote ${result.artifacts.length} artifacts.`);\n\tconsole.log(`Wrote ${result.manifestPath}.`);\n}\n\nexport async function parseCliArgs(args: string[]) {\n\treturn await yargs(normalizeDashPrefixedOptionValues(args))\n\t\t.scriptName('@php-wasm/compile-extension')\n\t\t.usage('Usage: $0 [--source <dir> | --prepare-image] [options]')\n\t\t.options({\n\t\t\tsource: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extension source directory containing config.m4',\n\t\t\t},\n\t\t\t'prepare-image': {\n\t\t\t\ttype: 'boolean',\n\t\t\t\tdescription:\n\t\t\t\t\t'Build the Docker images for the requested PHP versions and exit without compiling an extension source directory.',\n\t\t\t},\n\t\t\tname: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extension name. Defaults to parsing config.m4.',\n\t\t\t},\n\t\t\t'php-versions': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: SupportedExtensionPHPVersions.join(','),\n\t\t\t\tdescription: 'Comma-separated PHP major.minor versions.',\n\t\t\t},\n\t\t\tout: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: './dist',\n\t\t\t\tdescription: 'Output directory.',\n\t\t\t},\n\t\t\t'extra-cflags': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extra CFLAGS appended to the side-module build.',\n\t\t\t},\n\t\t\t'extra-ldflags': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdescription: 'Extra LDFLAGS appended to the side-module build.',\n\t\t\t},\n\t\t\t'config-args': {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: '',\n\t\t\t\tdescription:\n\t\t\t\t\t'Extra ./configure arguments, parsed as shell words.',\n\t\t\t},\n\t\t\toptimize: {\n\t\t\t\ttype: 'string',\n\t\t\t\tdefault: '2',\n\t\t\t\tdescription: 'Optimization level passed as -O<level>.',\n\t\t\t},\n\t\t\tjobs: {\n\t\t\t\ttype: 'number',\n\t\t\t\tdescription: 'Maximum concurrent docker builds.',\n\t\t\t},\n\t\t\t'extra-files': {\n\t\t\t\ttype: 'string',\n\t\t\t\tarray: true,\n\t\t\t\tdefault: [] as string[],\n\t\t\t\tdescription:\n\t\t\t\t\t'Stage a host directory under an absolute VFS root. Format: <hostDir>:<vfsRoot>. Files are copied next to the manifest and recorded in extraFiles.',\n\t\t\t},\n\t\t})\n\t\t.conflicts('source', 'prepare-image')\n\t\t.check(validateCliMode)\n\t\t.exitProcess(false)\n\t\t.strict()\n\t\t.help()\n\t\t.parse();\n}\n\nif (isCliEntrypoint(import.meta.url)) {\n\tmain().catch((error) => {\n\t\tconsole.error(error instanceof Error ? error.message : error);\n\t\tprocess.exit(1);\n\t});\n}\n\nexport function normalizeDashPrefixedOptionValues(args: string[]): string[] {\n\tconst normalized: string[] = [];\n\tfor (let i = 0; i < args.length; i++) {\n\t\tconst arg = args[i];\n\t\tif (\n\t\t\tOptionsWithDashPrefixedValues.has(arg) &&\n\t\t\ti + 1 < args.length &&\n\t\t\t!args[i + 1].startsWith(`${arg}=`)\n\t\t) {\n\t\t\tnormalized.push(`${arg}=${args[i + 1]}`);\n\t\t\ti++;\n\t\t\tcontinue;\n\t\t}\n\t\tnormalized.push(arg);\n\t}\n\treturn normalized;\n}\n\nexport function validateCliMode(argv: {\n\tsource?: unknown;\n\t'prepare-image'?: unknown;\n\tprepareImage?: unknown;\n\thelp?: unknown;\n}): true {\n\tif (argv.help) {\n\t\treturn true;\n\t}\n\tconst hasSource = typeof argv.source === 'string' && argv.source.length > 0;\n\tconst prepareImage = Boolean(argv['prepare-image'] ?? argv.prepareImage);\n\n\tif (hasSource && prepareImage) {\n\t\tthrow new Error('--source and --prepare-image cannot be used together.');\n\t}\n\tif (!hasSource && !prepareImage) {\n\t\tthrow new Error('--source is required unless --prepare-image is set.');\n\t}\n\n\treturn true;\n}\n\nfunction parseCsv(value: string, name: string): string[] {\n\tconst values = value\n\t\t.split(',')\n\t\t.map((entry) => entry.trim())\n\t\t.filter(Boolean);\n\tif (values.length === 0) {\n\t\tthrow new Error(`--${name} must contain at least one value.`);\n\t}\n\treturn values;\n}\n\nexport function splitShellWords(value: string): string[] {\n\tconst words: string[] = [];\n\tlet current = '';\n\tlet quote: '\"' | \"'\" | null = null;\n\tlet escaping = false;\n\n\tfor (const character of value) {\n\t\tif (escaping) {\n\t\t\tcurrent += character;\n\t\t\tescaping = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\\\\') {\n\t\t\tescaping = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (quote) {\n\t\t\tif (character === quote) {\n\t\t\t\tquote = null;\n\t\t\t} else {\n\t\t\t\tcurrent += character;\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tif (character === '\"' || character === \"'\") {\n\t\t\tquote = character;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(character)) {\n\t\t\tif (current.length > 0) {\n\t\t\t\twords.push(current);\n\t\t\t\tcurrent = '';\n\t\t\t}\n\t\t\tcontinue;\n\t\t}\n\t\tcurrent += character;\n\t}\n\n\tif (escaping) {\n\t\tcurrent += '\\\\';\n\t}\n\tif (quote) {\n\t\tthrow new Error('Unterminated quote in --config-args.');\n\t}\n\tif (current.length > 0) {\n\t\twords.push(current);\n\t}\n\treturn words;\n}\n\nfunction findWorkspaceRoot(startDirectory: string): string {\n\tlet directory = path.resolve(startDirectory);\n\twhile (directory !== path.dirname(directory)) {\n\t\tif (\n\t\t\texistsSync(\n\t\t\t\tpath.join(\n\t\t\t\t\tdirectory,\n\t\t\t\t\t'packages/php-wasm/compile-extension/package.json'\n\t\t\t\t)\n\t\t\t) &&\n\t\t\texistsSync(path.join(directory, 'nx.json'))\n\t\t) {\n\t\t\treturn directory;\n\t\t}\n\t\tdirectory = path.dirname(directory);\n\t}\n\treturn process.cwd();\n}\n\nfunction isCliEntrypoint(metaUrl: string): boolean {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) {\n\t\treturn false;\n\t}\n\ttry {\n\t\treturn (\n\t\t\trealpathSync(entrypoint) === realpathSync(fileURLToPath(metaUrl))\n\t\t);\n\t} catch {\n\t\treturn path.resolve(entrypoint) === fileURLToPath(metaUrl);\n\t}\n}\n"],"file":"cli.js"}
package/manifest.d.ts CHANGED
@@ -28,6 +28,21 @@ export interface ExtensionArtifact {
28
28
  export interface ExtensionManifest {
29
29
  name: string;
30
30
  version: string;
31
+ /**
32
+ * The first directive of the generated startup `.ini` file. Defaults to
33
+ * `extension`; use `zend_extension` for Zend extensions like Xdebug.
34
+ * Use `false` to stage the `.so` without registering it in php.ini.
35
+ */
36
+ loadWithIniDirective?: 'extension' | 'zend_extension' | false;
37
+ /** Additional `key=value` lines for the generated startup `.ini` file. */
38
+ iniEntries?: Record<string, string>;
39
+ /** Environment variables added before the extension is loaded. */
40
+ env?: Record<string, string>;
41
+ /**
42
+ * VFS directory where PHP.wasm writes the extension `.so` file and its
43
+ * per-extension ini file.
44
+ */
45
+ extensionDir?: string;
31
46
  artifacts: ExtensionArtifact[];
32
47
  /** URL-backed files shared by every artifact in this manifest. */
33
48
  extraFiles?: ExtensionManifestExtraFiles;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@php-wasm/compile-extension",
3
- "version": "3.1.30",
3
+ "version": "3.1.31",
4
4
  "description": "Build PHP.wasm extension side modules across PHP versions",
5
5
  "repository": {
6
6
  "type": "git",
@@ -28,7 +28,7 @@
28
28
  "node": ">=20.10.0",
29
29
  "npm": ">=10.2.3"
30
30
  },
31
- "gitHead": "1034030cf2893113dfc0d3a3ff79b1c60906cabe",
31
+ "gitHead": "d84feb0c0a69675bd502b8c5f51b24ee52822c8c",
32
32
  "packageManager": "npm@10.9.2",
33
33
  "overrides": {
34
34
  "rollup": "^4.34.6",