@powerhousedao/shared 6.2.3-dev.7 → 6.2.3-dev.70
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/analytics/index.d.ts +4 -4
- package/dist/analytics/index.d.ts.map +1 -1
- package/dist/analytics/index.js +25 -24
- package/dist/analytics/index.js.map +1 -1
- package/dist/clis/args/{access-token-To5LaIfL.mjs → access-token-3Hqv_U8I.mjs} +2 -2
- package/dist/clis/args/{access-token-To5LaIfL.mjs.map → access-token-3Hqv_U8I.mjs.map} +1 -1
- package/dist/clis/args/access-token-C5sKsH2O.d.mts +16 -0
- package/dist/clis/args/access-token-C5sKsH2O.d.mts.map +1 -0
- package/dist/clis/args/access-token.d.mts +3 -2
- package/dist/clis/args/access-token.mjs +1 -1
- package/dist/clis/args/{common-CcYbXrBx.mjs → common-BXabdhiO.mjs} +30 -7
- package/dist/clis/args/common-BXabdhiO.mjs.map +1 -0
- package/dist/clis/args/common-Bnm859xU.d.mts +186 -0
- package/dist/clis/args/common-Bnm859xU.d.mts.map +1 -0
- package/dist/clis/args/common.d.mts +3 -2
- package/dist/clis/args/common.mjs +1 -1
- package/dist/clis/args/{connect-BVVvCmL9.mjs → connect-BG3HkYBk.mjs} +8 -3
- package/dist/clis/args/connect-BG3HkYBk.mjs.map +1 -0
- package/dist/clis/args/connect-DjeiqXus.d.mts +450 -0
- package/dist/clis/args/connect-DjeiqXus.d.mts.map +1 -0
- package/dist/clis/args/connect.d.mts +3 -2
- package/dist/clis/args/connect.mjs +1 -1
- package/dist/clis/args/dist-CorQTQL-.mjs +1533 -0
- package/dist/clis/args/dist-CorQTQL-.mjs.map +1 -0
- package/dist/clis/args/{generate-CA916Fvj.mjs → generate-BOItUNvP.mjs} +40 -2
- package/dist/clis/args/generate-BOItUNvP.mjs.map +1 -0
- package/dist/clis/args/generate-BPBBLeUD.d.mts +103 -0
- package/dist/clis/args/generate-BPBBLeUD.d.mts.map +1 -0
- package/dist/clis/args/generate.d.mts +3 -2
- package/dist/clis/args/generate.mjs +1 -1
- package/dist/clis/args/{help-Bqbgbalu.mjs → help-BfAqpYvC.mjs} +43 -16
- package/dist/clis/args/help-BfAqpYvC.mjs.map +1 -0
- package/dist/clis/args/help-KuqI-EEG.d.mts +203 -0
- package/dist/clis/args/help-KuqI-EEG.d.mts.map +1 -0
- package/dist/clis/args/help.d.mts +3 -2
- package/dist/clis/args/help.mjs +1 -1
- package/dist/clis/args/index.d.mts +20 -19
- package/dist/clis/args/index.mjs +18 -18
- package/dist/clis/args/init-CTaK80wE.d.mts +55 -0
- package/dist/clis/args/init-CTaK80wE.d.mts.map +1 -0
- package/dist/clis/args/{init-rz9Ei7nq.mjs → init-xlCNZ8Oe.mjs} +7 -2
- package/dist/clis/args/{init-rz9Ei7nq.mjs.map → init-xlCNZ8Oe.mjs.map} +1 -1
- package/dist/clis/args/init.d.mts +3 -2
- package/dist/clis/args/init.mjs +1 -1
- package/dist/clis/args/inspect-BjRmtB86.d.mts +13 -0
- package/dist/clis/args/inspect-BjRmtB86.d.mts.map +1 -0
- package/dist/clis/args/{inspect-tckH8mSw.mjs → inspect-UNQgtuR0.mjs} +2 -2
- package/dist/clis/args/{inspect-tckH8mSw.mjs.map → inspect-UNQgtuR0.mjs.map} +1 -1
- package/dist/clis/args/inspect.d.mts +3 -2
- package/dist/clis/args/inspect.mjs +1 -1
- package/dist/clis/args/install-B0tMyUMw.d.mts +37 -0
- package/dist/clis/args/install-B0tMyUMw.d.mts.map +1 -0
- package/dist/clis/args/{install-Sz2DlCHh.mjs → install-F-27kF6m.mjs} +2 -2
- package/dist/clis/args/{install-Sz2DlCHh.mjs.map → install-F-27kF6m.mjs.map} +1 -1
- package/dist/clis/args/install.d.mts +3 -2
- package/dist/clis/args/install.mjs +1 -1
- package/dist/clis/args/{list-DM2d6f1m.mjs → list-Bkfn8Yuo.mjs} +2 -2
- package/dist/clis/args/{list-DM2d6f1m.mjs.map → list-Bkfn8Yuo.mjs.map} +1 -1
- package/dist/clis/args/list-DrbxA7JJ.d.mts +10 -0
- package/dist/clis/args/list-DrbxA7JJ.d.mts.map +1 -0
- package/dist/clis/args/list.d.mts +3 -2
- package/dist/clis/args/list.mjs +1 -1
- package/dist/clis/args/{login-DiKT5Jfu.mjs → login-CIFkQExi.mjs} +2 -2
- package/dist/clis/args/{login-DiKT5Jfu.mjs.map → login-CIFkQExi.mjs.map} +1 -1
- package/dist/clis/args/login-CXRJXg71.d.mts +25 -0
- package/dist/clis/args/login-CXRJXg71.d.mts.map +1 -0
- package/dist/clis/args/login.d.mts +3 -2
- package/dist/clis/args/login.mjs +1 -1
- package/dist/clis/args/migrate-DkCQRL2D.d.mts +19 -0
- package/dist/clis/args/migrate-DkCQRL2D.d.mts.map +1 -0
- package/dist/clis/args/{migrate-CG_gWc4k.mjs → migrate-DwJGhc2d.mjs} +2 -2
- package/dist/clis/args/{migrate-CG_gWc4k.mjs.map → migrate-DwJGhc2d.mjs.map} +1 -1
- package/dist/clis/args/migrate.d.mts +3 -2
- package/dist/clis/args/migrate.mjs +1 -1
- package/dist/clis/args/publish-CeW4bOrl.d.mts +16 -0
- package/dist/clis/args/publish-CeW4bOrl.d.mts.map +1 -0
- package/dist/clis/args/{publish-DDZYsUfV.mjs → publish-DHqlGWmL.mjs} +2 -2
- package/dist/clis/args/{publish-DDZYsUfV.mjs.map → publish-DHqlGWmL.mjs.map} +1 -1
- package/dist/clis/args/publish.d.mts +3 -2
- package/dist/clis/args/publish.mjs +1 -1
- package/dist/clis/args/{registry-C_OVFQmI.mjs → registry-DIwES3l2.mjs} +2 -2
- package/dist/clis/args/{registry-C_OVFQmI.mjs.map → registry-DIwES3l2.mjs.map} +1 -1
- package/dist/clis/args/registry-DNH8xuaE.d.mts +17 -0
- package/dist/clis/args/registry-DNH8xuaE.d.mts.map +1 -0
- package/dist/clis/args/registry.d.mts +3 -2
- package/dist/clis/args/registry.mjs +1 -1
- package/dist/clis/args/run-CYp5t1xU.mjs +28 -0
- package/dist/clis/args/run-CYp5t1xU.mjs.map +1 -0
- package/dist/clis/args/run.d.mts +18 -0
- package/dist/clis/args/run.d.mts.map +1 -0
- package/dist/clis/args/run.mjs +2 -0
- package/dist/clis/args/service-CHjY5epu.d.mts +27 -0
- package/dist/clis/args/service-CHjY5epu.d.mts.map +1 -0
- package/dist/clis/args/{service-CHOOr0Gg.mjs → service-Cpjlyeu5.mjs} +2 -2
- package/dist/clis/args/{service-CHOOr0Gg.mjs.map → service-Cpjlyeu5.mjs.map} +1 -1
- package/dist/clis/args/service.d.mts +3 -2
- package/dist/clis/args/service.mjs +1 -1
- package/dist/clis/args/{switchboard-Dsp7nosi.mjs → switchboard-CCaAtU56.mjs} +2 -2
- package/dist/clis/args/{switchboard-Dsp7nosi.mjs.map → switchboard-CCaAtU56.mjs.map} +1 -1
- package/dist/clis/args/switchboard-RrNb1fUH.d.mts +70 -0
- package/dist/clis/args/switchboard-RrNb1fUH.d.mts.map +1 -0
- package/dist/clis/args/switchboard.d.mts +3 -2
- package/dist/clis/args/switchboard.mjs +1 -1
- package/dist/clis/args/{uninstall-CTwTX0u_.mjs → uninstall-3U0B8g5c.mjs} +2 -2
- package/dist/clis/args/{uninstall-CTwTX0u_.mjs.map → uninstall-3U0B8g5c.mjs.map} +1 -1
- package/dist/clis/args/uninstall-CDx7lwxn.d.mts +28 -0
- package/dist/clis/args/uninstall-CDx7lwxn.d.mts.map +1 -0
- package/dist/clis/args/uninstall.d.mts +3 -2
- package/dist/clis/args/uninstall.mjs +1 -1
- package/dist/clis/args/unpublish-CEDsk6uv.d.mts +22 -0
- package/dist/clis/args/unpublish-CEDsk6uv.d.mts.map +1 -0
- package/dist/clis/args/{unpublish-BPMkGEg5.mjs → unpublish-s9zUh6Gw.mjs} +2 -2
- package/dist/clis/args/{unpublish-BPMkGEg5.mjs.map → unpublish-s9zUh6Gw.mjs.map} +1 -1
- package/dist/clis/args/unpublish.d.mts +3 -2
- package/dist/clis/args/unpublish.mjs +1 -1
- package/dist/clis/args/{vetra-b4KUu1Ax.mjs → vetra-BUNlAAPp.mjs} +2 -2
- package/dist/clis/args/{vetra-b4KUu1Ax.mjs.map → vetra-BUNlAAPp.mjs.map} +1 -1
- package/dist/clis/args/vetra-DkDaWFPi.d.mts +111 -0
- package/dist/clis/args/vetra-DkDaWFPi.d.mts.map +1 -0
- package/dist/clis/args/vetra-ports.test.d.mts +2 -1
- package/dist/clis/args/vetra-ports.test.mjs +7366 -5728
- package/dist/clis/args/vetra-ports.test.mjs.map +1 -1
- package/dist/clis/args/vetra.d.mts +3 -2
- package/dist/clis/args/vetra.mjs +1 -1
- package/dist/clis/build-config-DwRi23zQ.mjs +262 -0
- package/dist/clis/build-config-DwRi23zQ.mjs.map +1 -0
- package/dist/clis/build-config.d.mts +55 -10616
- package/dist/clis/build-config.d.mts.map +1 -1
- package/dist/clis/build-config.mjs +2 -88
- package/dist/clis/build-pieces.d.mts +160 -0
- package/dist/clis/build-pieces.d.mts.map +1 -0
- package/dist/clis/build-pieces.mjs +549 -0
- package/dist/clis/build-pieces.mjs.map +1 -0
- package/dist/clis/command-names.d.mts +2 -2
- package/dist/clis/command-names.d.mts.map +1 -1
- package/dist/clis/command-names.mjs +1 -0
- package/dist/clis/command-names.mjs.map +1 -1
- package/dist/clis/constants.d.mts +3 -462
- package/dist/clis/constants.mjs +45 -13
- package/dist/clis/constants.mjs.map +1 -1
- package/dist/clis/feature-flags.d.mts +17 -0
- package/dist/clis/feature-flags.d.mts.map +1 -0
- package/dist/clis/feature-flags.mjs +21 -0
- package/dist/clis/feature-flags.mjs.map +1 -0
- package/dist/clis/index-DnZYG-8g.d.mts +11154 -0
- package/dist/clis/index-DnZYG-8g.d.mts.map +1 -0
- package/dist/clis/index.d.mts +1483 -1226
- package/dist/clis/index.d.mts.map +1 -1
- package/dist/clis/index.mjs +705 -353
- package/dist/clis/index.mjs.map +1 -1
- package/dist/clis/package-style.d.mts +32 -0
- package/dist/clis/package-style.d.mts.map +1 -0
- package/dist/clis/package-style.mjs +102 -0
- package/dist/clis/package-style.mjs.map +1 -0
- package/dist/clis/ph-dir.d.mts +26 -0
- package/dist/clis/ph-dir.d.mts.map +1 -0
- package/dist/clis/ph-dir.mjs +37 -0
- package/dist/clis/ph-dir.mjs.map +1 -0
- package/dist/clis/project-env.d.mts +4 -4
- package/dist/clis/project-env.d.mts.map +1 -1
- package/dist/clis/project-env.mjs.map +1 -1
- package/dist/clis/project-ports.d.mts +5 -5
- package/dist/clis/project-ports.d.mts.map +1 -1
- package/dist/clis/project-ports.mjs +1 -1
- package/dist/clis/project-ports.mjs.map +1 -1
- package/dist/clis/services/telemetry.d.mts +7 -7
- package/dist/clis/services/telemetry.d.mts.map +1 -1
- package/dist/clis/services/telemetry.mjs.map +1 -1
- package/dist/clis/types-BxOUzRvH.d.mts +588 -0
- package/dist/clis/types-BxOUzRvH.d.mts.map +1 -0
- package/dist/clis/utils.d.mts +4 -4
- package/dist/clis/utils.d.mts.map +1 -1
- package/dist/clis/utils.mjs.map +1 -1
- package/dist/{config-loader-B845Hidf.js → config-loader-DBJolZd0.js} +43 -9
- package/dist/config-loader-DBJolZd0.js.map +1 -0
- package/dist/connect/config-loader.d.ts +21 -8
- package/dist/connect/config-loader.d.ts.map +1 -1
- package/dist/connect/config-loader.js +2 -2
- package/dist/connect/index.d.ts +215 -57
- package/dist/connect/index.d.ts.map +1 -1
- package/dist/connect/index.js +341 -31
- package/dist/connect/index.js.map +1 -1
- package/dist/connect/json-adapter.d.ts +3 -4
- package/dist/connect/json-adapter.d.ts.map +1 -1
- package/dist/connect/json-adapter.js.map +1 -1
- package/dist/constants-CcaK3k1D.d.ts +9 -0
- package/dist/constants-CcaK3k1D.d.ts.map +1 -0
- package/dist/constants.d.ts +3 -2
- package/dist/constants.js +15 -5
- package/dist/constants.js.map +1 -1
- package/dist/document-drive/index.d.ts +103 -101
- package/dist/document-drive/index.d.ts.map +1 -1
- package/dist/document-drive/index.js +39 -19
- package/dist/document-drive/index.js.map +1 -1
- package/dist/document-model/errors.d.ts +3 -0
- package/dist/document-model/errors.js +152 -0
- package/dist/document-model/errors.js.map +1 -0
- package/dist/document-model/index.d.ts +5 -4
- package/dist/document-model/index.js +298 -391
- package/dist/document-model/index.js.map +1 -1
- package/dist/document-model/mock.d.ts +2 -3
- package/dist/document-model/mock.d.ts.map +1 -1
- package/dist/document-model/mock.js +2 -1
- package/dist/document-model/mock.js.map +1 -1
- package/dist/document-model/utils.d.ts +3 -2
- package/dist/document-model/utils.js +1 -1
- package/dist/document-model/version.d.ts +3 -0
- package/dist/document-model/version.js +8 -0
- package/dist/document-model/version.js.map +1 -0
- package/dist/index-DeEVCeve.d.ts +36 -0
- package/dist/index-DeEVCeve.d.ts.map +1 -0
- package/dist/index.d.ts +7 -6
- package/dist/index.js.map +1 -1
- package/dist/processors/index.d.ts +3 -2
- package/dist/processors/index.js +63 -4
- package/dist/processors/index.js.map +1 -1
- package/dist/purge-v06m_oGz.js +381 -0
- package/dist/purge-v06m_oGz.js.map +1 -0
- package/dist/registry/index.d.ts +15 -15
- package/dist/registry/index.d.ts.map +1 -1
- package/dist/registry/index.js +24 -6
- package/dist/registry/index.js.map +1 -1
- package/dist/registry/manifest-slim.d.ts +4 -3
- package/dist/registry/manifest-slim.d.ts.map +1 -1
- package/dist/registry/manifest-slim.js +21 -0
- package/dist/registry/manifest-slim.js.map +1 -1
- package/dist/registry/updates.d.ts +3 -3
- package/dist/registry/updates.d.ts.map +1 -1
- package/dist/registry/updates.js.map +1 -1
- package/dist/registry/urls.d.ts +2 -2
- package/dist/registry/urls.d.ts.map +1 -1
- package/dist/registry/urls.js.map +1 -1
- package/dist/{types-C1in4fl3.d.ts → types-Bsp8VL2y.d.ts} +2 -2
- package/dist/types-Bsp8VL2y.d.ts.map +1 -0
- package/dist/{types-CpnWmiFY.d.ts → types-PM0i4vns.d.ts} +2063 -824
- package/dist/types-PM0i4vns.d.ts.map +1 -0
- package/dist/{types-YqLqb0Zb.d.ts → types-f_wMStgZ.d.ts} +39 -43
- package/dist/types-f_wMStgZ.d.ts.map +1 -0
- package/dist/{utils-DP122OSS.d.ts → utils-BrKxCmKx.d.ts} +2 -2
- package/dist/utils-BrKxCmKx.d.ts.map +1 -0
- package/dist/{utils-aaTmfxFW.js → utils-CSF716ux.js} +10 -3
- package/dist/utils-CSF716ux.js.map +1 -0
- package/dist/version-BxLITo9P.d.ts +6 -0
- package/dist/version-BxLITo9P.d.ts.map +1 -0
- package/package.json +24 -7
- package/dist/clis/args/access-token--9H57y8J.d.mts +0 -18
- package/dist/clis/args/access-token--9H57y8J.d.mts.map +0 -1
- package/dist/clis/args/common-CcYbXrBx.mjs.map +0 -1
- package/dist/clis/args/common-zPBoTNJF.d.mts +0 -183
- package/dist/clis/args/common-zPBoTNJF.d.mts.map +0 -1
- package/dist/clis/args/connect-BVVvCmL9.mjs.map +0 -1
- package/dist/clis/args/connect-BtU0MTTc.d.mts +0 -443
- package/dist/clis/args/connect-BtU0MTTc.d.mts.map +0 -1
- package/dist/clis/args/generate-CA916Fvj.mjs.map +0 -1
- package/dist/clis/args/generate-DnV-bfXt.d.mts +0 -87
- package/dist/clis/args/generate-DnV-bfXt.d.mts.map +0 -1
- package/dist/clis/args/help-Bqbgbalu.mjs.map +0 -1
- package/dist/clis/args/help-CjAsudUn.d.mts +0 -193
- package/dist/clis/args/help-CjAsudUn.d.mts.map +0 -1
- package/dist/clis/args/init-CUXyfquF.d.mts +0 -55
- package/dist/clis/args/init-CUXyfquF.d.mts.map +0 -1
- package/dist/clis/args/inspect-DtZeoA5c.d.mts +0 -15
- package/dist/clis/args/inspect-DtZeoA5c.d.mts.map +0 -1
- package/dist/clis/args/install-CkP8zcHb.d.mts +0 -40
- package/dist/clis/args/install-CkP8zcHb.d.mts.map +0 -1
- package/dist/clis/args/list-BGf8s_gj.d.mts +0 -12
- package/dist/clis/args/list-BGf8s_gj.d.mts.map +0 -1
- package/dist/clis/args/login-DNsHwvqk.d.mts +0 -27
- package/dist/clis/args/login-DNsHwvqk.d.mts.map +0 -1
- package/dist/clis/args/magic-string.es-h_0HDQBQ.mjs +0 -1013
- package/dist/clis/args/magic-string.es-h_0HDQBQ.mjs.map +0 -1
- package/dist/clis/args/migrate-sixkWhxm.d.mts +0 -21
- package/dist/clis/args/migrate-sixkWhxm.d.mts.map +0 -1
- package/dist/clis/args/publish-Dqe5DUst.d.mts +0 -18
- package/dist/clis/args/publish-Dqe5DUst.d.mts.map +0 -1
- package/dist/clis/args/registry-C_RfTsKB.d.mts +0 -19
- package/dist/clis/args/registry-C_RfTsKB.d.mts.map +0 -1
- package/dist/clis/args/service-DhIkf8-O.d.mts +0 -22
- package/dist/clis/args/service-DhIkf8-O.d.mts.map +0 -1
- package/dist/clis/args/switchboard-BlPaq2at.d.mts +0 -72
- package/dist/clis/args/switchboard-BlPaq2at.d.mts.map +0 -1
- package/dist/clis/args/uninstall-BpA3YYbw.d.mts +0 -31
- package/dist/clis/args/uninstall-BpA3YYbw.d.mts.map +0 -1
- package/dist/clis/args/unpublish-CvwaIimG.d.mts +0 -24
- package/dist/clis/args/unpublish-CvwaIimG.d.mts.map +0 -1
- package/dist/clis/args/vetra-CoMvTJK7.d.mts +0 -113
- package/dist/clis/args/vetra-CoMvTJK7.d.mts.map +0 -1
- package/dist/clis/build-config.mjs.map +0 -1
- package/dist/clis/constants.d.mts.map +0 -1
- package/dist/config-loader-B845Hidf.js.map +0 -1
- package/dist/constants-BP_gjn8g.d.ts +0 -8
- package/dist/constants-BP_gjn8g.d.ts.map +0 -1
- package/dist/index-C_iVZe7f.d.ts +0 -7
- package/dist/index-C_iVZe7f.d.ts.map +0 -1
- package/dist/index-DyYIJtVy.d.ts +0 -836
- package/dist/index-DyYIJtVy.d.ts.map +0 -1
- package/dist/types-C1in4fl3.d.ts.map +0 -1
- package/dist/types-CpnWmiFY.d.ts.map +0 -1
- package/dist/types-YqLqb0Zb.d.ts.map +0 -1
- package/dist/utils-DP122OSS.d.ts.map +0 -1
- package/dist/utils-aaTmfxFW.js.map +0 -1
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
//#region clis/package-style.d.ts
|
|
2
|
+
/** The imports at the top of a project's style.css, which `ph migrate` keeps current. */
|
|
3
|
+
export declare const STYLE_IMPORT_LINES: string[];
|
|
4
|
+
/** The empty @theme block the style.css template used to end with. */
|
|
5
|
+
export declare const LEGACY_THEME_LINES: string[];
|
|
6
|
+
/** The default host's stylesheet, beside hosts/connect/routes. */
|
|
7
|
+
export declare const HOST_STYLESHEET = "hosts/connect/style.css";
|
|
8
|
+
export declare const TAILWIND_IMPORT: RegExp;
|
|
9
|
+
export declare function projectStyle(current: string, localPackages?: readonly string[]): {
|
|
10
|
+
tailwind: string | undefined;
|
|
11
|
+
rest: string;
|
|
12
|
+
};
|
|
13
|
+
export type PackageStyleOptions = {
|
|
14
|
+
/** The package's browser build, relative to the project. */
|
|
15
|
+
browserDir: string;
|
|
16
|
+
/** The project's local packages, whose old style.css imports are dropped. */
|
|
17
|
+
localPackages?: readonly string[];
|
|
18
|
+
/** The theme the classes build against, by reference: Connect's by default. */
|
|
19
|
+
references?: readonly string[];
|
|
20
|
+
};
|
|
21
|
+
/** What `ph build` compiles to a package's stylesheet: the classes in the
|
|
22
|
+
* package's browser build, and the project's own tokens and rules, with
|
|
23
|
+
* Tailwind's and Connect's theme by reference, so not emitted. */
|
|
24
|
+
export declare function packageStyleEntry(current: string | undefined, { browserDir, localPackages, references }: PackageStyleOptions): string;
|
|
25
|
+
/** The compiled entry in the external-packages layer, between Connect's
|
|
26
|
+
* components and utilities, whichever of Connect's stylesheets loads first. */
|
|
27
|
+
export declare function packageStylesheet(compiled: string): string;
|
|
28
|
+
/** The project's `provider: "local"` packages, from powerhouse.config.json. */
|
|
29
|
+
export declare function localPackageNames(projectDir: string): string[];
|
|
30
|
+
//#endregion
|
|
31
|
+
export {};
|
|
32
|
+
//# sourceMappingURL=package-style.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"package-style.d.mts","names":[],"sources":["../../clis/package-style.ts"],"mappings":";;qBAOa;;qBASA;;qBAWA;qBAYA,iBAAe;wBAqBZ,aACd,iBACA;;;;YAiCU;;EAEV;;EAEA;;EAEA;;;;;wBAMc,kBACd,+BAEE,YACA,eACA,cACC;;;wBAmBW,kBAAkB;;wBAMlB,kBAAkB"}
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import { join } from "node:path";
|
|
2
|
+
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
+
//#region connect/layers.ts
|
|
4
|
+
/** Connect's cascade layers, Tailwind's `properties` first: package CSS goes in
|
|
5
|
+
* external-packages, above Connect's reset and below its utilities. */
|
|
6
|
+
const CONNECT_LAYER_ORDER = "@layer properties, theme, base, components, external-packages, utilities;";
|
|
7
|
+
//#endregion
|
|
8
|
+
//#region clis/package-style.ts
|
|
9
|
+
/** The imports at the top of a project's style.css, which `ph migrate` keeps current. */
|
|
10
|
+
const STYLE_IMPORT_LINES = [
|
|
11
|
+
"/* Package CSS goes in external-packages, between Connect's components and utilities. */",
|
|
12
|
+
CONNECT_LAYER_ORDER,
|
|
13
|
+
"@import \"tailwindcss\";",
|
|
14
|
+
"/* Connect's tokens, rules and classes, generated in this one build. */",
|
|
15
|
+
"@import \"@powerhousedao/connect/tailwind.css\";"
|
|
16
|
+
];
|
|
17
|
+
/** The empty @theme block the style.css template used to end with. */
|
|
18
|
+
const LEGACY_THEME_LINES = [
|
|
19
|
+
"@theme {",
|
|
20
|
+
"/* You can customize the theme by overriding the theme variables here */",
|
|
21
|
+
"/* See https://tailwindcss.com/docs/theme#using-a-custom-theme for details */",
|
|
22
|
+
"/* If you would prefer to use plain css, add your styles below this @theme tag as you normally would */",
|
|
23
|
+
"/* A sensible CSS reset is applied by default. If you would prefer to use a different reset or none at all, uncomment the following line */",
|
|
24
|
+
"/* --*: initial; */",
|
|
25
|
+
"}"
|
|
26
|
+
];
|
|
27
|
+
/** The default host's stylesheet, beside hosts/connect/routes. */
|
|
28
|
+
const HOST_STYLESHEET = "hosts/connect/style.css";
|
|
29
|
+
const MANAGED_LINES = [
|
|
30
|
+
/^@layer (properties, )?theme, base, components\b.*;$/,
|
|
31
|
+
/^@import ["']@powerhousedao\/design-system\/(theme|style)\.css["'];$/,
|
|
32
|
+
/^@import ["']@powerhousedao\/connect\/(style|tailwind)\.css["'];$/,
|
|
33
|
+
/^@custom-variant dark \(&:where\(\.dark, \.dark \*\)\);$/
|
|
34
|
+
];
|
|
35
|
+
const PACKAGE_BUILD_IMPORT = /^@import ["']\.\/node_modules\/(.+)\/dist\/style\.css["'];$/;
|
|
36
|
+
const TAILWIND_IMPORT = /^@import ["']tailwindcss["'].*;$/;
|
|
37
|
+
const TEMPLATE_LINES = new Set(STYLE_IMPORT_LINES);
|
|
38
|
+
function withoutLegacyTheme(kept) {
|
|
39
|
+
const filled = kept.flatMap((line, i) => line.trim() ? [i] : []);
|
|
40
|
+
for (let start = 0; start + LEGACY_THEME_LINES.length <= filled.length; start++) {
|
|
41
|
+
const block = filled.slice(start, start + LEGACY_THEME_LINES.length);
|
|
42
|
+
if (block.every((i, n) => kept[i].trim() === LEGACY_THEME_LINES[n])) return [...kept.slice(0, block[0]), ...kept.slice(block.at(-1) + 1)];
|
|
43
|
+
}
|
|
44
|
+
return kept;
|
|
45
|
+
}
|
|
46
|
+
function projectStyle(current, localPackages = []) {
|
|
47
|
+
let tailwind;
|
|
48
|
+
const kept = current.split("\n").filter((line) => {
|
|
49
|
+
const trimmed = line.trim();
|
|
50
|
+
if (TAILWIND_IMPORT.test(trimmed)) {
|
|
51
|
+
tailwind ??= trimmed;
|
|
52
|
+
return false;
|
|
53
|
+
}
|
|
54
|
+
const packageBuild = PACKAGE_BUILD_IMPORT.exec(trimmed)?.[1];
|
|
55
|
+
return !TEMPLATE_LINES.has(trimmed) && !MANAGED_LINES.some((pattern) => pattern.test(trimmed)) && !(packageBuild && localPackages.includes(packageBuild));
|
|
56
|
+
});
|
|
57
|
+
return {
|
|
58
|
+
tailwind,
|
|
59
|
+
rest: withoutLegacyTheme(kept).join("\n").trim()
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
function tailwindOptions(tailwind) {
|
|
63
|
+
if (!tailwind) return "";
|
|
64
|
+
const options = tailwind.replace(/^@import ["']tailwindcss["']/, "").replace(/;$/, "").replace(/\b(source|theme)\([^)]*\)/g, "").trim().replace(/\s+/g, " ");
|
|
65
|
+
return options ? ` ${options}` : "";
|
|
66
|
+
}
|
|
67
|
+
/** What `ph build` compiles to a package's stylesheet: the classes in the
|
|
68
|
+
* package's browser build, and the project's own tokens and rules, with
|
|
69
|
+
* Tailwind's and Connect's theme by reference, so not emitted. */
|
|
70
|
+
function packageStyleEntry(current, { browserDir, localPackages, references = ["@powerhousedao/connect/theme.css"] }) {
|
|
71
|
+
const { tailwind, rest } = projectStyle(current ?? "", localPackages);
|
|
72
|
+
const options = tailwindOptions(tailwind);
|
|
73
|
+
return `${[
|
|
74
|
+
`@import "tailwindcss/theme.css" theme(reference)${options};`,
|
|
75
|
+
...references.map((file) => `@reference ${JSON.stringify(file)};`),
|
|
76
|
+
`@import "tailwindcss/utilities.css" source(none)${options};`,
|
|
77
|
+
`@source ${JSON.stringify(browserDir)};`,
|
|
78
|
+
`@source not ${JSON.stringify(`${browserDir}/**/*.map`)};`,
|
|
79
|
+
rest
|
|
80
|
+
].join("\n")}\n`;
|
|
81
|
+
}
|
|
82
|
+
const BANNER = /^\/\*! tailwindcss v[^*]*\*\/\s*/;
|
|
83
|
+
/** The compiled entry in the external-packages layer, between Connect's
|
|
84
|
+
* components and utilities, whichever of Connect's stylesheets loads first. */
|
|
85
|
+
function packageStylesheet(compiled) {
|
|
86
|
+
const css = compiled.replace(BANNER, "").trim();
|
|
87
|
+
return `${CONNECT_LAYER_ORDER}\n@layer external-packages{${css}}\n`;
|
|
88
|
+
}
|
|
89
|
+
/** The project's `provider: "local"` packages, from powerhouse.config.json. */
|
|
90
|
+
function localPackageNames(projectDir) {
|
|
91
|
+
const file = join(projectDir, "powerhouse.config.json");
|
|
92
|
+
if (!existsSync(file)) return [];
|
|
93
|
+
try {
|
|
94
|
+
return (JSON.parse(readFileSync(file, "utf8")).packages ?? []).flatMap((p) => p.provider === "local" && typeof p.packageName === "string" ? [p.packageName] : []);
|
|
95
|
+
} catch {
|
|
96
|
+
return [];
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
//#endregion
|
|
100
|
+
export { HOST_STYLESHEET, LEGACY_THEME_LINES, STYLE_IMPORT_LINES, TAILWIND_IMPORT, localPackageNames, packageStyleEntry, packageStylesheet, projectStyle };
|
|
101
|
+
|
|
102
|
+
//# sourceMappingURL=package-style.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"package-style.mjs","names":[],"sources":["../../connect/layers.ts","../../clis/package-style.ts"],"sourcesContent":["/** Connect's cascade layers, Tailwind's `properties` first: package CSS goes in\n * external-packages, above Connect's reset and below its utilities. */\nexport const CONNECT_LAYER_ORDER =\n \"@layer properties, theme, base, components, external-packages, utilities;\";\n","// style.css's managed lines, and the package stylesheet `ph build` compiles from\n// it. Kept light: ph build imports this, and ph migrate (codegen) shares it.\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { CONNECT_LAYER_ORDER } from \"../connect/layers.js\";\n\n/** The imports at the top of a project's style.css, which `ph migrate` keeps current. */\nexport const STYLE_IMPORT_LINES = [\n \"/* Package CSS goes in external-packages, between Connect's components and utilities. */\",\n CONNECT_LAYER_ORDER,\n '@import \"tailwindcss\";',\n \"/* Connect's tokens, rules and classes, generated in this one build. */\",\n '@import \"@powerhousedao/connect/tailwind.css\";',\n];\n\n/** The empty @theme block the style.css template used to end with. */\nexport const LEGACY_THEME_LINES = [\n \"@theme {\",\n \"/* You can customize the theme by overriding the theme variables here */\",\n \"/* See https://tailwindcss.com/docs/theme#using-a-custom-theme for details */\",\n \"/* If you would prefer to use plain css, add your styles below this @theme tag as you normally would */\",\n \"/* A sensible CSS reset is applied by default. If you would prefer to use a different reset or none at all, uncomment the following line */\",\n \"/* --*: initial; */\",\n \"}\",\n];\n\n/** The default host's stylesheet, beside hosts/connect/routes. */\nexport const HOST_STYLESHEET = \"hosts/connect/style.css\";\n\n// Connect's stylesheet imports, current and past; the template's own lines too.\nconst MANAGED_LINES = [\n /^@layer (properties, )?theme, base, components\\b.*;$/,\n /^@import [\"']@powerhousedao\\/design-system\\/(theme|style)\\.css[\"'];$/,\n /^@import [\"']@powerhousedao\\/connect\\/(style|tailwind)\\.css[\"'];$/,\n /^@custom-variant dark \\(&:where\\(\\.dark, \\.dark \\*\\)\\);$/,\n];\n// A package's full build, which `ph install --local` used to add.\nconst PACKAGE_BUILD_IMPORT =\n /^@import [\"']\\.\\/node_modules\\/(.+)\\/dist\\/style\\.css[\"'];$/;\nexport const TAILWIND_IMPORT = /^@import [\"']tailwindcss[\"'].*;$/;\nconst TEMPLATE_LINES = new Set(STYLE_IMPORT_LINES);\n\n// `kept` without the old template's empty @theme block, matched line by line.\nfunction withoutLegacyTheme(kept: string[]) {\n const filled = kept.flatMap((line, i) => (line.trim() ? [i] : []));\n for (\n let start = 0;\n start + LEGACY_THEME_LINES.length <= filled.length;\n start++\n ) {\n const block = filled.slice(start, start + LEGACY_THEME_LINES.length);\n if (block.every((i, n) => kept[i].trim() === LEGACY_THEME_LINES[n])) {\n return [...kept.slice(0, block[0]), ...kept.slice(block.at(-1)! + 1)];\n }\n }\n return kept;\n}\n\n// The project's own lines, and its tailwindcss import if it has one. Imports of\n// its local packages' builds go; other node_modules CSS stays.\nexport function projectStyle(\n current: string,\n localPackages: readonly string[] = [],\n) {\n let tailwind: string | undefined;\n const kept = current.split(\"\\n\").filter((line) => {\n const trimmed = line.trim();\n if (TAILWIND_IMPORT.test(trimmed)) {\n // A project's `source(...)` or `prefix(...)` options stay.\n tailwind ??= trimmed;\n return false;\n }\n const packageBuild = PACKAGE_BUILD_IMPORT.exec(trimmed)?.[1];\n return (\n !TEMPLATE_LINES.has(trimmed) &&\n !MANAGED_LINES.some((pattern) => pattern.test(trimmed)) &&\n !(packageBuild && localPackages.includes(packageBuild))\n );\n });\n return { tailwind, rest: withoutLegacyTheme(kept).join(\"\\n\").trim() };\n}\n\n// Options of the project's `@import \"tailwindcss\"` that the package build keeps:\n// not source(), which it replaces, nor theme(), which clashes with theme(reference).\nfunction tailwindOptions(tailwind: string | undefined) {\n if (!tailwind) return \"\";\n const options = tailwind\n .replace(/^@import [\"']tailwindcss[\"']/, \"\")\n .replace(/;$/, \"\")\n .replace(/\\b(source|theme)\\([^)]*\\)/g, \"\")\n .trim()\n .replace(/\\s+/g, \" \");\n return options ? ` ${options}` : \"\";\n}\n\nexport type PackageStyleOptions = {\n /** The package's browser build, relative to the project. */\n browserDir: string;\n /** The project's local packages, whose old style.css imports are dropped. */\n localPackages?: readonly string[];\n /** The theme the classes build against, by reference: Connect's by default. */\n references?: readonly string[];\n};\n\n/** What `ph build` compiles to a package's stylesheet: the classes in the\n * package's browser build, and the project's own tokens and rules, with\n * Tailwind's and Connect's theme by reference, so not emitted. */\nexport function packageStyleEntry(\n current: string | undefined,\n {\n browserDir,\n localPackages,\n references = [\"@powerhousedao/connect/theme.css\"],\n }: PackageStyleOptions,\n): string {\n const { tailwind, rest } = projectStyle(current ?? \"\", localPackages);\n const options = tailwindOptions(tailwind);\n return `${[\n `@import \"tailwindcss/theme.css\" theme(reference)${options};`,\n ...references.map((file) => `@reference ${JSON.stringify(file)};`),\n `@import \"tailwindcss/utilities.css\" source(none)${options};`,\n `@source ${JSON.stringify(browserDir)};`,\n // Source maps carry the sources the bundle left out.\n `@source not ${JSON.stringify(`${browserDir}/**/*.map`)};`,\n rest,\n ].join(\"\\n\")}\\n`;\n}\n\nconst BANNER = /^\\/\\*! tailwindcss v[^*]*\\*\\/\\s*/;\n\n/** The compiled entry in the external-packages layer, between Connect's\n * components and utilities, whichever of Connect's stylesheets loads first. */\nexport function packageStylesheet(compiled: string): string {\n const css = compiled.replace(BANNER, \"\").trim();\n return `${CONNECT_LAYER_ORDER}\\n@layer external-packages{${css}}\\n`;\n}\n\n/** The project's `provider: \"local\"` packages, from powerhouse.config.json. */\nexport function localPackageNames(projectDir: string): string[] {\n const file = join(projectDir, \"powerhouse.config.json\");\n if (!existsSync(file)) return [];\n try {\n const config = JSON.parse(readFileSync(file, \"utf8\")) as {\n packages?: { packageName?: unknown; provider?: unknown }[];\n };\n return (config.packages ?? []).flatMap((p) =>\n p.provider === \"local\" && typeof p.packageName === \"string\"\n ? [p.packageName]\n : [],\n );\n } catch {\n return [];\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
//#region clis/ph-dir.d.ts
|
|
2
|
+
/**
|
|
3
|
+
* The project's `.ph` tree — stores, identity, run records, registry cache.
|
|
4
|
+
*
|
|
5
|
+
* Classically `<cwd>/.ph` (every classic command resolves it exactly so). A
|
|
6
|
+
* desktop shell relocates the WHOLE tree under the user's profile by setting
|
|
7
|
+
* `PH_USER_DATA_DIR`: the tree is then `${userData}/.ph`, the same names
|
|
8
|
+
* under a different root, and nothing of the user's lands in the install
|
|
9
|
+
* dir. One resolver replaces the former `.ph/...` literals; it adds no path
|
|
10
|
+
* names and no layout of its own.
|
|
11
|
+
*/
|
|
12
|
+
export declare function resolvePhDir(base?: string, env?: Record<string, string | undefined>): string;
|
|
13
|
+
/**
|
|
14
|
+
* The two PGlite store dirs the switchboard defaults to, for the server and
|
|
15
|
+
* for `ph switchboard --reset` (which must touch the same paths). Without a
|
|
16
|
+
* user-data root these are the classic literals, verbatim — byte-identical
|
|
17
|
+
* to every classic boot log and reset prompt. Under PH_USER_DATA_DIR they
|
|
18
|
+
* are the same names inside `${userData}/.ph`.
|
|
19
|
+
*/
|
|
20
|
+
export declare function defaultStoreDirs(env?: Record<string, string | undefined>, phDir?: string): {
|
|
21
|
+
reactor: string;
|
|
22
|
+
readModel: string;
|
|
23
|
+
};
|
|
24
|
+
//#endregion
|
|
25
|
+
export {};
|
|
26
|
+
//# sourceMappingURL=ph-dir.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ph-dir.d.mts","names":[],"sources":["../../clis/ph-dir.ts"],"mappings":";;;;;;;;;;;wBAYgB,aACd,eACA,MAAK;;;;;;;;wBAYS,iBACd,MAAK,oCACL;EACG;EAAiB"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import path from "node:path";
|
|
2
|
+
//#region clis/ph-dir.ts
|
|
3
|
+
/**
|
|
4
|
+
* The project's `.ph` tree — stores, identity, run records, registry cache.
|
|
5
|
+
*
|
|
6
|
+
* Classically `<cwd>/.ph` (every classic command resolves it exactly so). A
|
|
7
|
+
* desktop shell relocates the WHOLE tree under the user's profile by setting
|
|
8
|
+
* `PH_USER_DATA_DIR`: the tree is then `${userData}/.ph`, the same names
|
|
9
|
+
* under a different root, and nothing of the user's lands in the install
|
|
10
|
+
* dir. One resolver replaces the former `.ph/...` literals; it adds no path
|
|
11
|
+
* names and no layout of its own.
|
|
12
|
+
*/
|
|
13
|
+
function resolvePhDir(base = process.cwd(), env = process.env) {
|
|
14
|
+
return path.join(env.PH_USER_DATA_DIR ?? base, ".ph");
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* The two PGlite store dirs the switchboard defaults to, for the server and
|
|
18
|
+
* for `ph switchboard --reset` (which must touch the same paths). Without a
|
|
19
|
+
* user-data root these are the classic literals, verbatim — byte-identical
|
|
20
|
+
* to every classic boot log and reset prompt. Under PH_USER_DATA_DIR they
|
|
21
|
+
* are the same names inside `${userData}/.ph`.
|
|
22
|
+
*/
|
|
23
|
+
function defaultStoreDirs(env = process.env, phDir) {
|
|
24
|
+
const root = phDir ?? (env.PH_USER_DATA_DIR ? resolvePhDir(void 0, env) : void 0);
|
|
25
|
+
if (root === void 0) return {
|
|
26
|
+
reactor: "./.ph/reactor-storage",
|
|
27
|
+
readModel: ".ph/read-storage"
|
|
28
|
+
};
|
|
29
|
+
return {
|
|
30
|
+
reactor: path.join(root, "reactor-storage"),
|
|
31
|
+
readModel: path.join(root, "read-storage")
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
//#endregion
|
|
35
|
+
export { defaultStoreDirs, resolvePhDir };
|
|
36
|
+
|
|
37
|
+
//# sourceMappingURL=ph-dir.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ph-dir.mjs","names":[],"sources":["../../clis/ph-dir.ts"],"sourcesContent":["import path from \"node:path\";\n\n/**\n * The project's `.ph` tree — stores, identity, run records, registry cache.\n *\n * Classically `<cwd>/.ph` (every classic command resolves it exactly so). A\n * desktop shell relocates the WHOLE tree under the user's profile by setting\n * `PH_USER_DATA_DIR`: the tree is then `${userData}/.ph`, the same names\n * under a different root, and nothing of the user's lands in the install\n * dir. One resolver replaces the former `.ph/...` literals; it adds no path\n * names and no layout of its own.\n */\nexport function resolvePhDir(\n base: string = process.cwd(),\n env: Record<string, string | undefined> = process.env,\n): string {\n return path.join(env.PH_USER_DATA_DIR ?? base, \".ph\");\n}\n\n/**\n * The two PGlite store dirs the switchboard defaults to, for the server and\n * for `ph switchboard --reset` (which must touch the same paths). Without a\n * user-data root these are the classic literals, verbatim — byte-identical\n * to every classic boot log and reset prompt. Under PH_USER_DATA_DIR they\n * are the same names inside `${userData}/.ph`.\n */\nexport function defaultStoreDirs(\n env: Record<string, string | undefined> = process.env,\n phDir?: string,\n): { reactor: string; readModel: string } {\n const root =\n phDir ?? (env.PH_USER_DATA_DIR ? resolvePhDir(undefined, env) : undefined);\n if (root === undefined) {\n return { reactor: \"./.ph/reactor-storage\", readModel: \".ph/read-storage\" };\n }\n return {\n reactor: path.join(root, \"reactor-storage\"),\n readModel: path.join(root, \"read-storage\"),\n };\n}\n"],"mappings":";;;;;;;;;;;;AAYA,SAAgB,aACd,OAAe,QAAQ,IAAI,GAC3B,MAA0C,QAAQ,KAC1C;CACR,OAAO,KAAK,KAAK,IAAI,oBAAoB,MAAM,KAAK;AACtD;;;;;;;;AASA,SAAgB,iBACd,MAA0C,QAAQ,KAClD,OACwC;CACxC,MAAM,OACJ,UAAU,IAAI,mBAAmB,aAAa,KAAA,GAAW,GAAG,IAAI,KAAA;CAClE,IAAI,SAAS,KAAA,GACX,OAAO;EAAE,SAAS;EAAyB,WAAW;CAAmB;CAE3E,OAAO;EACL,SAAS,KAAK,KAAK,MAAM,iBAAiB;EAC1C,WAAW,KAAK,KAAK,MAAM,cAAc;CAC3C;AACF"}
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
* Idempotent per directory — CLI argument defaults call it lazily and may
|
|
12
12
|
* call it more than once per process.
|
|
13
13
|
*/
|
|
14
|
-
declare function loadProjectEnv(cwd?: string): void;
|
|
14
|
+
export declare function loadProjectEnv(cwd?: string): void;
|
|
15
15
|
/** Test seam: forget which directory has already been loaded. */
|
|
16
|
-
declare function resetProjectEnvForTests(): void;
|
|
16
|
+
export declare function resetProjectEnvForTests(): void;
|
|
17
17
|
/**
|
|
18
18
|
* Read an environment variable as a TCP port.
|
|
19
19
|
*
|
|
@@ -21,7 +21,7 @@ declare function resetProjectEnvForTests(): void;
|
|
|
21
21
|
* throwing: a typo in `.env` should fall through to the next source in the
|
|
22
22
|
* precedence chain, not break the CLI.
|
|
23
23
|
*/
|
|
24
|
-
declare function readPortEnv(name: string): number | undefined;
|
|
24
|
+
export declare function readPortEnv(name: string): number | undefined;
|
|
25
25
|
//#endregion
|
|
26
|
-
export {
|
|
26
|
+
export {};
|
|
27
27
|
//# sourceMappingURL=project-env.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-env.d.mts","names":[],"sources":["../../clis/project-env.ts"],"mappings":"
|
|
1
|
+
{"version":3,"file":"project-env.d.mts","names":[],"sources":["../../clis/project-env.ts"],"mappings":";;;;;;;;;;;;;wBAiBgB,eAAe;;wBAUf;;;;;;;;wBAWA,YAAY"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-env.mjs","names":[],"sources":["../../clis/project-env.ts"],"sourcesContent":["import dotenv from \"dotenv\";\nimport { join } from \"node:path\";\n\nlet loadedFor: string | undefined;\n\n/**\n * Load the project's `.env.local` and `.env` into `process.env`.\n *\n * `dotenv` never overwrites a variable that is already set, so loading\n * `.env.local` first and `.env` second produces the precedence the CLI\n * documents: a real `process.env` value beats `.env.local`, which beats\n * `.env`. One `process.env` lookup afterwards therefore covers all three\n * sources.\n *\n * Idempotent per directory — CLI argument defaults call it lazily and may\n * call it more than once per process.\n */\nexport function loadProjectEnv(cwd: string = process.cwd()): void {\n if (loadedFor === cwd) return;\n loadedFor = cwd;\n // dotenv 16 logs nothing for a missing file, so no suppression option is\n // needed here (and none exists before dotenv 17).\n dotenv.config({ path: join(cwd, \".env.local\") });\n dotenv.config({ path: join(cwd, \".env\") });\n}\n\n/** Test seam: forget which directory has already been loaded. */\nexport function resetProjectEnvForTests(): void {\n loadedFor = undefined;\n}\n\n/**\n * Read an environment variable as a TCP port.\n *\n * Anything that is not a plain integer in 1-65535 is ignored rather than\n * throwing: a typo in `.env` should fall through to the next source in the\n * precedence chain, not break the CLI.\n */\nexport function readPortEnv(name: string): number | undefined {\n const raw = process.env[name]?.trim();\n if (!raw || !/^\\d+$/.test(raw)) return undefined;\n const port = Number(raw);\n if (port < 1 || port > 65535) return undefined;\n return port;\n}\n"],"mappings":";;;AAGA,IAAI;;;;;;;;;;;;;AAcJ,SAAgB,eAAe,MAAc,QAAQ,
|
|
1
|
+
{"version":3,"file":"project-env.mjs","names":[],"sources":["../../clis/project-env.ts"],"sourcesContent":["import dotenv from \"dotenv\";\nimport { join } from \"node:path\";\n\nlet loadedFor: string | undefined;\n\n/**\n * Load the project's `.env.local` and `.env` into `process.env`.\n *\n * `dotenv` never overwrites a variable that is already set, so loading\n * `.env.local` first and `.env` second produces the precedence the CLI\n * documents: a real `process.env` value beats `.env.local`, which beats\n * `.env`. One `process.env` lookup afterwards therefore covers all three\n * sources.\n *\n * Idempotent per directory — CLI argument defaults call it lazily and may\n * call it more than once per process.\n */\nexport function loadProjectEnv(cwd: string = process.cwd()): void {\n if (loadedFor === cwd) return;\n loadedFor = cwd;\n // dotenv 16 logs nothing for a missing file, so no suppression option is\n // needed here (and none exists before dotenv 17).\n dotenv.config({ path: join(cwd, \".env.local\") });\n dotenv.config({ path: join(cwd, \".env\") });\n}\n\n/** Test seam: forget which directory has already been loaded. */\nexport function resetProjectEnvForTests(): void {\n loadedFor = undefined;\n}\n\n/**\n * Read an environment variable as a TCP port.\n *\n * Anything that is not a plain integer in 1-65535 is ignored rather than\n * throwing: a typo in `.env` should fall through to the next source in the\n * precedence chain, not break the CLI.\n */\nexport function readPortEnv(name: string): number | undefined {\n const raw = process.env[name]?.trim();\n if (!raw || !/^\\d+$/.test(raw)) return undefined;\n const port = Number(raw);\n if (port < 1 || port > 65535) return undefined;\n return port;\n}\n"],"mappings":";;;AAGA,IAAI;;;;;;;;;;;;;AAcJ,SAAgB,eAAe,MAAc,QAAQ,IAAI,GAAS;CAChE,IAAI,cAAc,KAAK;CACvB,YAAY;CAGZ,OAAO,OAAO,EAAE,MAAM,KAAK,KAAK,YAAY,EAAE,CAAC;CAC/C,OAAO,OAAO,EAAE,MAAM,KAAK,KAAK,MAAM,EAAE,CAAC;AAC3C;;AAGA,SAAgB,0BAAgC;CAC9C,YAAY,KAAA;AACd;;;;;;;;AASA,SAAgB,YAAY,MAAkC;CAC5D,MAAM,MAAM,QAAQ,IAAI,KAAK,EAAE,KAAK;CACpC,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,GAAG,GAAG,OAAO,KAAA;CACvC,MAAM,OAAO,OAAO,GAAG;CACvB,IAAI,OAAO,KAAK,OAAO,OAAO,OAAO,KAAA;CACrC,OAAO;AACT"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
//#region clis/project-ports.d.ts
|
|
2
|
-
type ProjectPorts = {
|
|
2
|
+
export type ProjectPorts = {
|
|
3
3
|
switchboardPort: number;
|
|
4
4
|
studioPort: number;
|
|
5
5
|
vetraConnectPort: number;
|
|
@@ -13,7 +13,7 @@ type ProjectPorts = {
|
|
|
13
13
|
* bands, and well-known services. Being generous here is nearly free — the
|
|
14
14
|
* whole list costs 83 of 1000 offsets.
|
|
15
15
|
*/
|
|
16
|
-
declare const PROJECT_PORT_DENYLIST: ReadonlySet<number>;
|
|
16
|
+
export declare const PROJECT_PORT_DENYLIST: ReadonlySet<number>;
|
|
17
17
|
/**
|
|
18
18
|
* Derive a project's dev-server port triple from its package name.
|
|
19
19
|
*
|
|
@@ -29,12 +29,12 @@ declare const PROJECT_PORT_DENYLIST: ReadonlySet<number>;
|
|
|
29
29
|
* until all three are clear — so the result stays reproducible from the name
|
|
30
30
|
* alone.
|
|
31
31
|
*/
|
|
32
|
-
declare function deriveProjectPorts(projectName: string): ProjectPorts;
|
|
32
|
+
export declare function deriveProjectPorts(projectName: string): ProjectPorts;
|
|
33
33
|
/** Every port this scheme can hand out, for cross-checking against other tools. */
|
|
34
|
-
declare function projectPortBands(): {
|
|
34
|
+
export declare function projectPortBands(): {
|
|
35
35
|
from: number;
|
|
36
36
|
to: number;
|
|
37
37
|
}[];
|
|
38
38
|
//#endregion
|
|
39
|
-
export {
|
|
39
|
+
export {};
|
|
40
40
|
//# sourceMappingURL=project-ports.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-ports.d.mts","names":[],"sources":["../../clis/project-ports.ts"],"mappings":";
|
|
1
|
+
{"version":3,"file":"project-ports.d.mts","names":[],"sources":["../../clis/project-ports.ts"],"mappings":";YAQY;EACV;EACA;EACA;;;;;;;;;;;qBAsBW,uBAAuB;;;;;;;;;;;;;;;;wBAuDpB,mBAAmB,sBAAsB;;wBAsBzC;EAAsB;EAAc"}
|
|
@@ -18,7 +18,7 @@ function inclusive(from, to) {
|
|
|
18
18
|
* bands, and well-known services. Being generous here is nearly free — the
|
|
19
19
|
* whole list costs 83 of 1000 offsets.
|
|
20
20
|
*/
|
|
21
|
-
const PROJECT_PORT_DENYLIST = new Set([
|
|
21
|
+
const PROJECT_PORT_DENYLIST = /* @__PURE__ */ new Set([
|
|
22
22
|
2e3,
|
|
23
23
|
2049,
|
|
24
24
|
2181,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project-ports.mjs","names":[],"sources":["../../clis/project-ports.ts"],"sourcesContent":["import fnv1a from \"@sindresorhus/fnv1a\";\nimport {\n PROJECT_PORT_BAND_SIZE,\n PROJECT_PORT_BAND_STUDIO,\n PROJECT_PORT_BAND_SWITCHBOARD,\n PROJECT_PORT_BAND_VETRA_CONNECT,\n} from \"./constants.js\";\n\nexport type ProjectPorts = {\n switchboardPort: number;\n studioPort: number;\n vetraConnectPort: number;\n};\n\nconst BANDS = [\n PROJECT_PORT_BAND_SWITCHBOARD,\n PROJECT_PORT_BAND_STUDIO,\n PROJECT_PORT_BAND_VETRA_CONNECT,\n] as const;\n\nfunction inclusive(from: number, to: number): number[] {\n return Array.from({ length: to - from + 1 }, (_, i) => from + i);\n}\n\n/**\n * Offsets whose derived port would land on something a developer machine\n * plausibly already holds. Skipped rather than assigned, so a project never\n * starts life needing a port override.\n *\n * Two sources: ports the Powerhouse repos themselves reference inside these\n * bands, and well-known services. Being generous here is nearly free — the\n * whole list costs 83 of 1000 offsets.\n */\nexport const PROJECT_PORT_DENYLIST: ReadonlySet<number> = new Set<number>([\n // 2000 band\n 2000, // Cisco SCCP\n 2049, // NFS\n 2181, // ZooKeeper\n 2222, // alternate SSH\n 2375,\n 2376,\n 2377, // Docker daemon and Swarm\n 2483,\n 2484, // Oracle DB\n // 6000 band\n ...inclusive(6000, 6063), // X11 TCP listeners\n 6006, // Storybook / TensorBoard\n 6060, // Go pprof\n 6100,\n 6200,\n 6300,\n 6500, // referenced elsewhere in the Powerhouse repos\n 6379, // Redis\n 6443, // Kubernetes API server\n 6666,\n 6667, // IRC\n // 7000 band\n 7000,\n 7001, // macOS AirPlay receiver / Cassandra\n 7077, // Spark\n 7474,\n 7687, // Neo4j HTTP and Bolt\n 7777, // referenced elsewhere in the Powerhouse repos\n]);\n\nfunction portsForOffset(offset: number): ProjectPorts {\n return {\n switchboardPort: PROJECT_PORT_BAND_SWITCHBOARD + offset,\n studioPort: PROJECT_PORT_BAND_STUDIO + offset,\n vetraConnectPort: PROJECT_PORT_BAND_VETRA_CONNECT + offset,\n };\n}\n\n/**\n * Derive a project's dev-server port triple from its package name.\n *\n * Name-derived rather than path-derived on purpose: the switchboard port is\n * written literally into the project's committed `.mcp.json`, because an MCP\n * client resolves that file at session start and cannot read the project\n * config or `.env`. A path-derived value would differ on every machine that\n * clones the repo.\n *\n * The three ports share one offset, so a project's numbers end in the same\n * three digits (`my-package` gets 7834 / 6834 / 2834). When any of the three\n * would hit {@link PROJECT_PORT_DENYLIST}, the offset advances deterministically\n * until all three are clear — so the result stays reproducible from the name\n * alone.\n */\nexport function deriveProjectPorts(projectName: string): ProjectPorts {\n if (!projectName.trim()) {\n throw new Error(\"A project name is required to derive project ports.\");\n }\n const start = Number(\n fnv1a(projectName, { size: 32 }) % BigInt(PROJECT_PORT_BAND_SIZE),\n );\n for (let step = 0; step < PROJECT_PORT_BAND_SIZE; step++) {\n const offset = (start + step) % PROJECT_PORT_BAND_SIZE;\n const ports = portsForOffset(offset);\n if (!Object.values(ports).some((port) => PROJECT_PORT_DENYLIST.has(port))) {\n return ports;\n }\n }\n // Unreachable: the denylist covers far fewer offsets than the band holds.\n throw new Error(\n `No free port offset for project \"${projectName}\" — every offset in the ` +\n `${PROJECT_PORT_BAND_SIZE}-wide band is denied.`,\n );\n}\n\n/** Every port this scheme can hand out, for cross-checking against other tools. */\nexport function projectPortBands(): { from: number; to: number }[] {\n return BANDS.map((base) => ({\n from: base,\n to: base + PROJECT_PORT_BAND_SIZE - 1,\n }));\n}\n"],"mappings":";;;AAcA,MAAM,QAAQ;CACZ;CACA;CACA;
|
|
1
|
+
{"version":3,"file":"project-ports.mjs","names":[],"sources":["../../clis/project-ports.ts"],"sourcesContent":["import fnv1a from \"@sindresorhus/fnv1a\";\nimport {\n PROJECT_PORT_BAND_SIZE,\n PROJECT_PORT_BAND_STUDIO,\n PROJECT_PORT_BAND_SWITCHBOARD,\n PROJECT_PORT_BAND_VETRA_CONNECT,\n} from \"./constants.js\";\n\nexport type ProjectPorts = {\n switchboardPort: number;\n studioPort: number;\n vetraConnectPort: number;\n};\n\nconst BANDS = [\n PROJECT_PORT_BAND_SWITCHBOARD,\n PROJECT_PORT_BAND_STUDIO,\n PROJECT_PORT_BAND_VETRA_CONNECT,\n] as const;\n\nfunction inclusive(from: number, to: number): number[] {\n return Array.from({ length: to - from + 1 }, (_, i) => from + i);\n}\n\n/**\n * Offsets whose derived port would land on something a developer machine\n * plausibly already holds. Skipped rather than assigned, so a project never\n * starts life needing a port override.\n *\n * Two sources: ports the Powerhouse repos themselves reference inside these\n * bands, and well-known services. Being generous here is nearly free — the\n * whole list costs 83 of 1000 offsets.\n */\nexport const PROJECT_PORT_DENYLIST: ReadonlySet<number> = new Set<number>([\n // 2000 band\n 2000, // Cisco SCCP\n 2049, // NFS\n 2181, // ZooKeeper\n 2222, // alternate SSH\n 2375,\n 2376,\n 2377, // Docker daemon and Swarm\n 2483,\n 2484, // Oracle DB\n // 6000 band\n ...inclusive(6000, 6063), // X11 TCP listeners\n 6006, // Storybook / TensorBoard\n 6060, // Go pprof\n 6100,\n 6200,\n 6300,\n 6500, // referenced elsewhere in the Powerhouse repos\n 6379, // Redis\n 6443, // Kubernetes API server\n 6666,\n 6667, // IRC\n // 7000 band\n 7000,\n 7001, // macOS AirPlay receiver / Cassandra\n 7077, // Spark\n 7474,\n 7687, // Neo4j HTTP and Bolt\n 7777, // referenced elsewhere in the Powerhouse repos\n]);\n\nfunction portsForOffset(offset: number): ProjectPorts {\n return {\n switchboardPort: PROJECT_PORT_BAND_SWITCHBOARD + offset,\n studioPort: PROJECT_PORT_BAND_STUDIO + offset,\n vetraConnectPort: PROJECT_PORT_BAND_VETRA_CONNECT + offset,\n };\n}\n\n/**\n * Derive a project's dev-server port triple from its package name.\n *\n * Name-derived rather than path-derived on purpose: the switchboard port is\n * written literally into the project's committed `.mcp.json`, because an MCP\n * client resolves that file at session start and cannot read the project\n * config or `.env`. A path-derived value would differ on every machine that\n * clones the repo.\n *\n * The three ports share one offset, so a project's numbers end in the same\n * three digits (`my-package` gets 7834 / 6834 / 2834). When any of the three\n * would hit {@link PROJECT_PORT_DENYLIST}, the offset advances deterministically\n * until all three are clear — so the result stays reproducible from the name\n * alone.\n */\nexport function deriveProjectPorts(projectName: string): ProjectPorts {\n if (!projectName.trim()) {\n throw new Error(\"A project name is required to derive project ports.\");\n }\n const start = Number(\n fnv1a(projectName, { size: 32 }) % BigInt(PROJECT_PORT_BAND_SIZE),\n );\n for (let step = 0; step < PROJECT_PORT_BAND_SIZE; step++) {\n const offset = (start + step) % PROJECT_PORT_BAND_SIZE;\n const ports = portsForOffset(offset);\n if (!Object.values(ports).some((port) => PROJECT_PORT_DENYLIST.has(port))) {\n return ports;\n }\n }\n // Unreachable: the denylist covers far fewer offsets than the band holds.\n throw new Error(\n `No free port offset for project \"${projectName}\" — every offset in the ` +\n `${PROJECT_PORT_BAND_SIZE}-wide band is denied.`,\n );\n}\n\n/** Every port this scheme can hand out, for cross-checking against other tools. */\nexport function projectPortBands(): { from: number; to: number }[] {\n return BANDS.map((base) => ({\n from: base,\n to: base + PROJECT_PORT_BAND_SIZE - 1,\n }));\n}\n"],"mappings":";;;AAcA,MAAM,QAAQ;CACZ;CACA;CACA;AACF;AAEA,SAAS,UAAU,MAAc,IAAsB;CACrD,OAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,OAAO,EAAE,IAAI,GAAG,MAAM,OAAO,CAAC;AACjE;;;;;;;;;;AAWA,MAAa,wCAA6C,IAAI,IAAY;CAExE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,GAAG,UAAU,KAAM,IAAI;CACvB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CAEA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,eAAe,QAA8B;CACpD,OAAO;EACL,iBAAiB,gCAAgC;EACjD,YAAY,2BAA2B;EACvC,kBAAkB,kCAAkC;CACtD;AACF;;;;;;;;;;;;;;;;AAiBA,SAAgB,mBAAmB,aAAmC;CACpE,IAAI,CAAC,YAAY,KAAK,GACpB,MAAM,IAAI,MAAM,qDAAqD;CAEvE,MAAM,QAAQ,OACZ,MAAM,aAAa,EAAE,MAAM,GAAG,CAAC,IAAI,OAAO,sBAAsB,CAClE;CACA,KAAK,IAAI,OAAO,GAAG,OAAO,wBAAwB,QAAQ;EAExD,MAAM,QAAQ,gBADE,QAAQ,QAAQ,sBACG;EACnC,IAAI,CAAC,OAAO,OAAO,KAAK,CAAC,CAAC,MAAM,SAAS,sBAAsB,IAAI,IAAI,CAAC,GACtE,OAAO;CAEX;CAEA,MAAM,IAAI,MACR,oCAAoC,YAAY,0BAC3C,uBAAuB,sBAC9B;AACF;;AAGA,SAAgB,mBAAmD;CACjE,OAAO,MAAM,KAAK,UAAU;EAC1B,MAAM;EACN,IAAI,OAAO,yBAAyB;CACtC,EAAE;AACJ"}
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
//#region clis/services/telemetry.d.ts
|
|
2
|
-
type CliInvocationInfo = {
|
|
2
|
+
export type CliInvocationInfo = {
|
|
3
3
|
command?: string;
|
|
4
4
|
subcommand?: string;
|
|
5
5
|
pm?: string;
|
|
6
6
|
argv: string[];
|
|
7
7
|
cwd?: string;
|
|
8
8
|
};
|
|
9
|
-
type TelemetryClient = {
|
|
9
|
+
export type TelemetryClient = {
|
|
10
10
|
/**
|
|
11
11
|
* Attaches per-invocation context (command, sanitized argv, package
|
|
12
12
|
* manager) as Sentry tags + a `invocation` context block, plus a single
|
|
@@ -25,23 +25,23 @@ type TelemetryClient = {
|
|
|
25
25
|
* Prompts the user once, caches the answer. Must be called before init.
|
|
26
26
|
* Returns `true` if telemetry should be enabled, `false` otherwise.
|
|
27
27
|
*/
|
|
28
|
-
declare function resolveTelemetryConsent(): Promise<boolean>;
|
|
28
|
+
export declare function resolveTelemetryConsent(): Promise<boolean>;
|
|
29
29
|
/**
|
|
30
30
|
* Initializes Sentry for CLI error reporting if telemetry is enabled.
|
|
31
31
|
* Safe to call multiple times; only the first call takes effect.
|
|
32
32
|
*/
|
|
33
|
-
declare function initCliTelemetry(opts: {
|
|
33
|
+
export declare function initCliTelemetry(opts: {
|
|
34
34
|
cliName: "ph-cli" | "ph-cmd";
|
|
35
35
|
release?: string;
|
|
36
36
|
}): Promise<TelemetryClient | undefined>;
|
|
37
37
|
/**
|
|
38
38
|
* Explicitly set telemetry consent (used by `ph telemetry on|off`).
|
|
39
39
|
*/
|
|
40
|
-
declare function setTelemetryConsent(enabled: boolean): void;
|
|
40
|
+
export declare function setTelemetryConsent(enabled: boolean): void;
|
|
41
41
|
/**
|
|
42
42
|
* Returns the current telemetry state — useful for `ph telemetry status`.
|
|
43
43
|
*/
|
|
44
|
-
declare function getTelemetryStatus(): {
|
|
44
|
+
export declare function getTelemetryStatus(): {
|
|
45
45
|
source: "env";
|
|
46
46
|
enabled: boolean;
|
|
47
47
|
} | {
|
|
@@ -53,5 +53,5 @@ declare function getTelemetryStatus(): {
|
|
|
53
53
|
enabled: false;
|
|
54
54
|
};
|
|
55
55
|
//#endregion
|
|
56
|
-
export {
|
|
56
|
+
export {};
|
|
57
57
|
//# sourceMappingURL=telemetry.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../../../clis/services/telemetry.ts"],"mappings":";
|
|
1
|
+
{"version":3,"file":"telemetry.d.mts","names":[],"sources":["../../../clis/services/telemetry.ts"],"mappings":";YAmCY;EACV;EACA;EACA;EACA;EACA;;YAGU;;;;;;EAMV,0BAA0B,MAAM;;;;;EAKhC,kBACE,cACA;IAAS;QACN;;;;;;wBA8Ce,2BAA2B;;;;;wBAgH3B,iBAAiB;EACrC;EACA;IACE,QAAQ;;;;wBAgGI,oBAAoB;;;;wBAOpB;EACV;EAAe;;EACf;EAAkB;EAAkB;;EACpC;EAAmB"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"telemetry.mjs","names":[],"sources":["../../../clis/services/telemetry.ts"],"sourcesContent":["/**\n * CLI telemetry (error reporting via Sentry).\n *\n * Design:\n * - Opt-out by default, asked once on first interactive run.\n * - Stores consent in ~/.ph/telemetry.json so we never ask twice.\n * - Respects PH_NO_TELEMETRY=1 and DO_NOT_TRACK=1 as immediate kill switches.\n * - Non-interactive (TTY missing, CI, piped) defaults to DISABLED — we don't\n * want to hang a CI pipeline on an unanswered prompt, and we don't want to\n * capture errors without informed consent.\n * - DSN is published in the CLI binary; Sentry DSNs accept events but grant\n * no read access, so this is safe. Hardcoded so users can't accidentally\n * misroute events.\n *\n * PII scrubbing in beforeSend hook:\n * - Home-directory paths collapsed to ~\n * - Flag/arg values that look like secrets (tokens, keys) stripped\n * - No source-context from user files\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n// Sentry project \"ph-cli\" on the powerhouse-hosted Sentry instance.\n// Public DSNs are safe to ship — they grant write-only ingest access.\nconst SENTRY_DSN =\n \"https://0e7793802288589b4923896118374462@sentry.monitoring.vetra.io/3\";\n\nconst TELEMETRY_FILE = join(homedir(), \".ph\", \"telemetry.json\");\n\ntype TelemetryConfig = {\n enabled: boolean;\n askedAt: string;\n};\n\nexport type CliInvocationInfo = {\n command?: string;\n subcommand?: string;\n pm?: string;\n argv: string[];\n cwd?: string;\n};\n\nexport type TelemetryClient = {\n /**\n * Attaches per-invocation context (command, sanitized argv, package\n * manager) as Sentry tags + a `invocation` context block, plus a single\n * \"cli invoked\" breadcrumb. Safe to call once per process.\n */\n attachInvocationContext: (info: CliInvocationInfo) => void;\n /**\n * Captures an error (if telemetry is initialized) and flushes before the\n * caller calls process.exit(). Safe no-op when telemetry is disabled.\n */\n captureCliError: (\n err: unknown,\n opts?: { kind?: \"crash\" | \"user\" },\n ) => Promise<void>;\n};\n\nfunction isExplicitlyDisabled(): boolean {\n // Standard opt-out signals respected by most OSS CLIs.\n return (\n process.env.PH_NO_TELEMETRY === \"1\" ||\n process.env.PH_NO_TELEMETRY === \"true\" ||\n process.env.DO_NOT_TRACK === \"1\" ||\n process.env.DO_NOT_TRACK === \"true\"\n );\n}\n\nfunction isExplicitlyEnabled(): boolean {\n return (\n process.env.PH_TELEMETRY === \"1\" || process.env.PH_TELEMETRY === \"true\"\n );\n}\n\nfunction isInteractive(): boolean {\n // Only ask if stdin is a TTY and CI env isn't set.\n return Boolean(process.stdin.isTTY) && !process.env.CI;\n}\n\nfunction readConfig(): TelemetryConfig | null {\n try {\n if (!existsSync(TELEMETRY_FILE)) return null;\n return JSON.parse(readFileSync(TELEMETRY_FILE, \"utf8\")) as TelemetryConfig;\n } catch {\n return null;\n }\n}\n\nfunction writeConfig(cfg: TelemetryConfig): void {\n try {\n mkdirSync(join(homedir(), \".ph\"), { recursive: true });\n writeFileSync(TELEMETRY_FILE, JSON.stringify(cfg, null, 2));\n } catch {\n // non-fatal; we'll just ask again next time\n }\n}\n\n/**\n * Prompts the user once, caches the answer. Must be called before init.\n * Returns `true` if telemetry should be enabled, `false` otherwise.\n */\nexport async function resolveTelemetryConsent(): Promise<boolean> {\n if (isExplicitlyDisabled()) return false;\n if (isExplicitlyEnabled()) return true;\n\n const cached = readConfig();\n if (cached) return cached.enabled;\n\n if (!isInteractive()) {\n // Non-interactive first run: stay silent, don't ask, don't send. User can\n // opt in later with `ph telemetry on` or PH_TELEMETRY=1.\n return false;\n }\n\n const enquirer = await import(\"enquirer\");\n try {\n const { enabled } = await enquirer.default.prompt<{ enabled: boolean }>({\n type: \"confirm\",\n name: \"enabled\",\n message:\n \"Help improve Powerhouse by sending anonymous error reports? \" +\n \"(stack traces only, paths and secrets are scrubbed)\",\n initial: true,\n });\n writeConfig({ enabled, askedAt: new Date().toISOString() });\n return enabled;\n } catch {\n // user hit Ctrl-C during prompt — treat as no, but don't persist so we\n // ask again next time\n return false;\n }\n}\n\nfunction scrubString(input: string): string {\n if (!input) return input;\n const home = homedir();\n let out = input;\n // Collapse home dir to ~\n if (home && out.includes(home)) {\n out = out.split(home).join(\"~\");\n }\n // Strip common secret-shaped flag values: --token=XYZ, --api-key XYZ, etc.\n out = out.replace(\n /(--?(?:token|api[-_]?key|password|secret|auth)[=\\s])([^\\s]+)/gi,\n \"$1<redacted>\",\n );\n return out;\n}\n\ntype ScrubbableFrame = {\n filename?: string;\n abs_path?: string;\n pre_context?: unknown;\n context_line?: unknown;\n post_context?: unknown;\n vars?: unknown;\n};\n\ntype ScrubbableException = {\n value?: string;\n stacktrace?: { frames?: ScrubbableFrame[] };\n};\n\ntype ScrubbableEvent = {\n message?: string;\n logentry?: { message?: string };\n exception?: { values?: ScrubbableException[] };\n server_name?: string;\n extra?: Record<string, unknown>;\n};\n\nfunction scrubEvent<T>(event: T): T {\n const e = event as ScrubbableEvent;\n try {\n if (e.message) e.message = scrubString(e.message);\n if (e.logentry?.message) {\n e.logentry.message = scrubString(e.logentry.message);\n }\n const values = e.exception?.values;\n if (Array.isArray(values)) {\n for (const ex of values) {\n if (ex.value) ex.value = scrubString(ex.value);\n const frames = ex.stacktrace?.frames;\n if (Array.isArray(frames)) {\n for (const f of frames) {\n if (f.filename) f.filename = scrubString(f.filename);\n if (f.abs_path) f.abs_path = scrubString(f.abs_path);\n // Drop captured source context from user machines — privacy.\n delete f.pre_context;\n delete f.context_line;\n delete f.post_context;\n delete f.vars;\n }\n }\n }\n }\n // Server name can leak the user's machine hostname; drop it.\n delete e.server_name;\n // Strip raw argv from extra context.\n if (e.extra) {\n delete e.extra.argv;\n delete e.extra.env;\n }\n } catch {\n // Never let scrubbing throw — worst case we drop the event below.\n }\n return event;\n}\n\n/**\n * Initializes Sentry for CLI error reporting if telemetry is enabled.\n * Safe to call multiple times; only the first call takes effect.\n */\nexport async function initCliTelemetry(opts: {\n cliName: \"ph-cli\" | \"ph-cmd\";\n release?: string;\n}): Promise<TelemetryClient | undefined> {\n const enabled = await resolveTelemetryConsent();\n if (!enabled) return;\n\n const Sentry = await import(\"@sentry/node-core/light\");\n const os = await import(\"node:os\");\n const sentryClient = Sentry.init({\n dsn: SENTRY_DSN,\n release: opts.release,\n environment: process.env.NODE_ENV || \"production\",\n sendDefaultPii: false,\n defaultIntegrations: false,\n integrations: [\n // Only the bare minimum — no automatic HTTP/FS instrumentation.\n ],\n beforeSend(event) {\n return scrubEvent(event);\n },\n beforeBreadcrumb(breadcrumb) {\n if (breadcrumb.message) {\n breadcrumb.message = scrubString(breadcrumb.message);\n }\n return breadcrumb;\n },\n });\n Sentry.setTag(\"cli_name\", opts.cliName);\n if (opts.release) Sentry.setTag(\"cli_version\", opts.release);\n // Environment tags — `defaultIntegrations: false` strips Sentry's auto\n // node-context, so attach the bits we care about manually (and keep\n // hostname out of it).\n Sentry.setTag(\"os\", process.platform);\n Sentry.setTag(\"arch\", process.arch);\n Sentry.setTag(\"node_version\", process.version);\n Sentry.setTag(\"ci\", String(Boolean(process.env.CI)));\n Sentry.setTag(\"tty\", String(Boolean(process.stdin.isTTY)));\n Sentry.setContext(\"runtime\", {\n name: \"node\",\n version: process.version,\n });\n Sentry.setContext(\"os\", {\n name: process.platform,\n version: os.release(),\n });\n Sentry.setContext(\"device\", {\n arch: process.arch,\n });\n if (!sentryClient) {\n return;\n }\n return {\n attachInvocationContext(info: CliInvocationInfo) {\n const argv = info.argv.map(scrubString);\n const flagNames = info.argv\n .filter((a) => a.startsWith(\"-\"))\n .map((a) => a.split(\"=\")[0]);\n if (info.command) Sentry.setTag(\"command\", info.command);\n if (info.subcommand) Sentry.setTag(\"subcommand\", info.subcommand);\n if (info.pm) Sentry.setTag(\"pm\", info.pm);\n Sentry.setContext(\"invocation\", {\n command: info.command,\n subcommand: info.subcommand,\n argv,\n flag_names: flagNames,\n argv_count: argv.length,\n cwd: info.cwd ? scrubString(info.cwd) : undefined,\n });\n Sentry.addBreadcrumb({\n category: \"cli\",\n level: \"info\",\n message: \"cli invoked\",\n data: {\n command: info.command,\n pm: info.pm,\n tty: Boolean(process.stdin.isTTY),\n ci: Boolean(process.env.CI),\n },\n });\n },\n captureCliError: async (\n err: unknown,\n captureOpts?: { kind?: \"crash\" | \"user\" },\n ) => {\n try {\n Sentry.setTag(\"error_kind\", captureOpts?.kind ?? \"crash\");\n sentryClient.captureException(err);\n await sentryClient.flush(2000);\n } catch {\n // Reporting must never mask the real error.\n }\n },\n };\n}\n\n/**\n * Explicitly set telemetry consent (used by `ph telemetry on|off`).\n */\nexport function setTelemetryConsent(enabled: boolean): void {\n writeConfig({ enabled, askedAt: new Date().toISOString() });\n}\n\n/**\n * Returns the current telemetry state — useful for `ph telemetry status`.\n */\nexport function getTelemetryStatus():\n | { source: \"env\"; enabled: boolean }\n | { source: \"config\"; enabled: boolean; askedAt: string }\n | { source: \"default\"; enabled: false } {\n if (isExplicitlyDisabled()) return { source: \"env\", enabled: false };\n if (isExplicitlyEnabled()) return { source: \"env\", enabled: true };\n const cached = readConfig();\n if (cached)\n return {\n source: \"config\",\n enabled: cached.enabled,\n askedAt: cached.askedAt,\n };\n return { source: \"default\", enabled: false };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"telemetry.mjs","names":[],"sources":["../../../clis/services/telemetry.ts"],"sourcesContent":["/**\n * CLI telemetry (error reporting via Sentry).\n *\n * Design:\n * - Opt-out by default, asked once on first interactive run.\n * - Stores consent in ~/.ph/telemetry.json so we never ask twice.\n * - Respects PH_NO_TELEMETRY=1 and DO_NOT_TRACK=1 as immediate kill switches.\n * - Non-interactive (TTY missing, CI, piped) defaults to DISABLED — we don't\n * want to hang a CI pipeline on an unanswered prompt, and we don't want to\n * capture errors without informed consent.\n * - DSN is published in the CLI binary; Sentry DSNs accept events but grant\n * no read access, so this is safe. Hardcoded so users can't accidentally\n * misroute events.\n *\n * PII scrubbing in beforeSend hook:\n * - Home-directory paths collapsed to ~\n * - Flag/arg values that look like secrets (tokens, keys) stripped\n * - No source-context from user files\n */\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\n\n// Sentry project \"ph-cli\" on the powerhouse-hosted Sentry instance.\n// Public DSNs are safe to ship — they grant write-only ingest access.\nconst SENTRY_DSN =\n \"https://0e7793802288589b4923896118374462@sentry.monitoring.vetra.io/3\";\n\nconst TELEMETRY_FILE = join(homedir(), \".ph\", \"telemetry.json\");\n\ntype TelemetryConfig = {\n enabled: boolean;\n askedAt: string;\n};\n\nexport type CliInvocationInfo = {\n command?: string;\n subcommand?: string;\n pm?: string;\n argv: string[];\n cwd?: string;\n};\n\nexport type TelemetryClient = {\n /**\n * Attaches per-invocation context (command, sanitized argv, package\n * manager) as Sentry tags + a `invocation` context block, plus a single\n * \"cli invoked\" breadcrumb. Safe to call once per process.\n */\n attachInvocationContext: (info: CliInvocationInfo) => void;\n /**\n * Captures an error (if telemetry is initialized) and flushes before the\n * caller calls process.exit(). Safe no-op when telemetry is disabled.\n */\n captureCliError: (\n err: unknown,\n opts?: { kind?: \"crash\" | \"user\" },\n ) => Promise<void>;\n};\n\nfunction isExplicitlyDisabled(): boolean {\n // Standard opt-out signals respected by most OSS CLIs.\n return (\n process.env.PH_NO_TELEMETRY === \"1\" ||\n process.env.PH_NO_TELEMETRY === \"true\" ||\n process.env.DO_NOT_TRACK === \"1\" ||\n process.env.DO_NOT_TRACK === \"true\"\n );\n}\n\nfunction isExplicitlyEnabled(): boolean {\n return (\n process.env.PH_TELEMETRY === \"1\" || process.env.PH_TELEMETRY === \"true\"\n );\n}\n\nfunction isInteractive(): boolean {\n // Only ask if stdin is a TTY and CI env isn't set.\n return Boolean(process.stdin.isTTY) && !process.env.CI;\n}\n\nfunction readConfig(): TelemetryConfig | null {\n try {\n if (!existsSync(TELEMETRY_FILE)) return null;\n return JSON.parse(readFileSync(TELEMETRY_FILE, \"utf8\")) as TelemetryConfig;\n } catch {\n return null;\n }\n}\n\nfunction writeConfig(cfg: TelemetryConfig): void {\n try {\n mkdirSync(join(homedir(), \".ph\"), { recursive: true });\n writeFileSync(TELEMETRY_FILE, JSON.stringify(cfg, null, 2));\n } catch {\n // non-fatal; we'll just ask again next time\n }\n}\n\n/**\n * Prompts the user once, caches the answer. Must be called before init.\n * Returns `true` if telemetry should be enabled, `false` otherwise.\n */\nexport async function resolveTelemetryConsent(): Promise<boolean> {\n if (isExplicitlyDisabled()) return false;\n if (isExplicitlyEnabled()) return true;\n\n const cached = readConfig();\n if (cached) return cached.enabled;\n\n if (!isInteractive()) {\n // Non-interactive first run: stay silent, don't ask, don't send. User can\n // opt in later with `ph telemetry on` or PH_TELEMETRY=1.\n return false;\n }\n\n const enquirer = await import(\"enquirer\");\n try {\n const { enabled } = await enquirer.default.prompt<{ enabled: boolean }>({\n type: \"confirm\",\n name: \"enabled\",\n message:\n \"Help improve Powerhouse by sending anonymous error reports? \" +\n \"(stack traces only, paths and secrets are scrubbed)\",\n initial: true,\n });\n writeConfig({ enabled, askedAt: new Date().toISOString() });\n return enabled;\n } catch {\n // user hit Ctrl-C during prompt — treat as no, but don't persist so we\n // ask again next time\n return false;\n }\n}\n\nfunction scrubString(input: string): string {\n if (!input) return input;\n const home = homedir();\n let out = input;\n // Collapse home dir to ~\n if (home && out.includes(home)) {\n out = out.split(home).join(\"~\");\n }\n // Strip common secret-shaped flag values: --token=XYZ, --api-key XYZ, etc.\n out = out.replace(\n /(--?(?:token|api[-_]?key|password|secret|auth)[=\\s])([^\\s]+)/gi,\n \"$1<redacted>\",\n );\n return out;\n}\n\ntype ScrubbableFrame = {\n filename?: string;\n abs_path?: string;\n pre_context?: unknown;\n context_line?: unknown;\n post_context?: unknown;\n vars?: unknown;\n};\n\ntype ScrubbableException = {\n value?: string;\n stacktrace?: { frames?: ScrubbableFrame[] };\n};\n\ntype ScrubbableEvent = {\n message?: string;\n logentry?: { message?: string };\n exception?: { values?: ScrubbableException[] };\n server_name?: string;\n extra?: Record<string, unknown>;\n};\n\nfunction scrubEvent<T>(event: T): T {\n const e = event as ScrubbableEvent;\n try {\n if (e.message) e.message = scrubString(e.message);\n if (e.logentry?.message) {\n e.logentry.message = scrubString(e.logentry.message);\n }\n const values = e.exception?.values;\n if (Array.isArray(values)) {\n for (const ex of values) {\n if (ex.value) ex.value = scrubString(ex.value);\n const frames = ex.stacktrace?.frames;\n if (Array.isArray(frames)) {\n for (const f of frames) {\n if (f.filename) f.filename = scrubString(f.filename);\n if (f.abs_path) f.abs_path = scrubString(f.abs_path);\n // Drop captured source context from user machines — privacy.\n delete f.pre_context;\n delete f.context_line;\n delete f.post_context;\n delete f.vars;\n }\n }\n }\n }\n // Server name can leak the user's machine hostname; drop it.\n delete e.server_name;\n // Strip raw argv from extra context.\n if (e.extra) {\n delete e.extra.argv;\n delete e.extra.env;\n }\n } catch {\n // Never let scrubbing throw — worst case we drop the event below.\n }\n return event;\n}\n\n/**\n * Initializes Sentry for CLI error reporting if telemetry is enabled.\n * Safe to call multiple times; only the first call takes effect.\n */\nexport async function initCliTelemetry(opts: {\n cliName: \"ph-cli\" | \"ph-cmd\";\n release?: string;\n}): Promise<TelemetryClient | undefined> {\n const enabled = await resolveTelemetryConsent();\n if (!enabled) return;\n\n const Sentry = await import(\"@sentry/node-core/light\");\n const os = await import(\"node:os\");\n const sentryClient = Sentry.init({\n dsn: SENTRY_DSN,\n release: opts.release,\n environment: process.env.NODE_ENV || \"production\",\n sendDefaultPii: false,\n defaultIntegrations: false,\n integrations: [\n // Only the bare minimum — no automatic HTTP/FS instrumentation.\n ],\n beforeSend(event) {\n return scrubEvent(event);\n },\n beforeBreadcrumb(breadcrumb) {\n if (breadcrumb.message) {\n breadcrumb.message = scrubString(breadcrumb.message);\n }\n return breadcrumb;\n },\n });\n Sentry.setTag(\"cli_name\", opts.cliName);\n if (opts.release) Sentry.setTag(\"cli_version\", opts.release);\n // Environment tags — `defaultIntegrations: false` strips Sentry's auto\n // node-context, so attach the bits we care about manually (and keep\n // hostname out of it).\n Sentry.setTag(\"os\", process.platform);\n Sentry.setTag(\"arch\", process.arch);\n Sentry.setTag(\"node_version\", process.version);\n Sentry.setTag(\"ci\", String(Boolean(process.env.CI)));\n Sentry.setTag(\"tty\", String(Boolean(process.stdin.isTTY)));\n Sentry.setContext(\"runtime\", {\n name: \"node\",\n version: process.version,\n });\n Sentry.setContext(\"os\", {\n name: process.platform,\n version: os.release(),\n });\n Sentry.setContext(\"device\", {\n arch: process.arch,\n });\n if (!sentryClient) {\n return;\n }\n return {\n attachInvocationContext(info: CliInvocationInfo) {\n const argv = info.argv.map(scrubString);\n const flagNames = info.argv\n .filter((a) => a.startsWith(\"-\"))\n .map((a) => a.split(\"=\")[0]);\n if (info.command) Sentry.setTag(\"command\", info.command);\n if (info.subcommand) Sentry.setTag(\"subcommand\", info.subcommand);\n if (info.pm) Sentry.setTag(\"pm\", info.pm);\n Sentry.setContext(\"invocation\", {\n command: info.command,\n subcommand: info.subcommand,\n argv,\n flag_names: flagNames,\n argv_count: argv.length,\n cwd: info.cwd ? scrubString(info.cwd) : undefined,\n });\n Sentry.addBreadcrumb({\n category: \"cli\",\n level: \"info\",\n message: \"cli invoked\",\n data: {\n command: info.command,\n pm: info.pm,\n tty: Boolean(process.stdin.isTTY),\n ci: Boolean(process.env.CI),\n },\n });\n },\n captureCliError: async (\n err: unknown,\n captureOpts?: { kind?: \"crash\" | \"user\" },\n ) => {\n try {\n Sentry.setTag(\"error_kind\", captureOpts?.kind ?? \"crash\");\n sentryClient.captureException(err);\n await sentryClient.flush(2000);\n } catch {\n // Reporting must never mask the real error.\n }\n },\n };\n}\n\n/**\n * Explicitly set telemetry consent (used by `ph telemetry on|off`).\n */\nexport function setTelemetryConsent(enabled: boolean): void {\n writeConfig({ enabled, askedAt: new Date().toISOString() });\n}\n\n/**\n * Returns the current telemetry state — useful for `ph telemetry status`.\n */\nexport function getTelemetryStatus():\n | { source: \"env\"; enabled: boolean }\n | { source: \"config\"; enabled: boolean; askedAt: string }\n | { source: \"default\"; enabled: false } {\n if (isExplicitlyDisabled()) return { source: \"env\", enabled: false };\n if (isExplicitlyEnabled()) return { source: \"env\", enabled: true };\n const cached = readConfig();\n if (cached)\n return {\n source: \"config\",\n enabled: cached.enabled,\n askedAt: cached.askedAt,\n };\n return { source: \"default\", enabled: false };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,aACJ;AAEF,MAAM,iBAAiB,KAAK,QAAQ,GAAG,OAAO,gBAAgB;AAgC9D,SAAS,uBAAgC;CAEvC,OACE,QAAQ,IAAI,oBAAoB,OAChC,QAAQ,IAAI,oBAAoB,UAChC,QAAQ,IAAI,iBAAiB,OAC7B,QAAQ,IAAI,iBAAiB;AAEjC;AAEA,SAAS,sBAA+B;CACtC,OACE,QAAQ,IAAI,iBAAiB,OAAO,QAAQ,IAAI,iBAAiB;AAErE;AAEA,SAAS,gBAAyB;CAEhC,OAAO,QAAQ,QAAQ,MAAM,KAAK,KAAK,CAAC,QAAQ,IAAI;AACtD;AAEA,SAAS,aAAqC;CAC5C,IAAI;EACF,IAAI,CAAC,WAAW,cAAc,GAAG,OAAO;EACxC,OAAO,KAAK,MAAM,aAAa,gBAAgB,MAAM,CAAC;CACxD,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,YAAY,KAA4B;CAC/C,IAAI;EACF,UAAU,KAAK,QAAQ,GAAG,KAAK,GAAG,EAAE,WAAW,KAAK,CAAC;EACrD,cAAc,gBAAgB,KAAK,UAAU,KAAK,MAAM,CAAC,CAAC;CAC5D,QAAQ,CAER;AACF;;;;;AAMA,eAAsB,0BAA4C;CAChE,IAAI,qBAAqB,GAAG,OAAO;CACnC,IAAI,oBAAoB,GAAG,OAAO;CAElC,MAAM,SAAS,WAAW;CAC1B,IAAI,QAAQ,OAAO,OAAO;CAE1B,IAAI,CAAC,cAAc,GAGjB,OAAO;CAGT,MAAM,WAAW,MAAM,OAAO;CAC9B,IAAI;EACF,MAAM,EAAE,YAAY,MAAM,SAAS,QAAQ,OAA6B;GACtE,MAAM;GACN,MAAM;GACN,SACE;GAEF,SAAS;EACX,CAAC;EACD,YAAY;GAAE;GAAS,0BAAS,IAAI,KAAK,EAAA,CAAE,YAAY;EAAE,CAAC;EAC1D,OAAO;CACT,QAAQ;EAGN,OAAO;CACT;AACF;AAEA,SAAS,YAAY,OAAuB;CAC1C,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,OAAO,QAAQ;CACrB,IAAI,MAAM;CAEV,IAAI,QAAQ,IAAI,SAAS,IAAI,GAC3B,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,KAAK,GAAG;CAGhC,MAAM,IAAI,QACR,kEACA,cACF;CACA,OAAO;AACT;AAwBA,SAAS,WAAc,OAAa;CAClC,MAAM,IAAI;CACV,IAAI;EACF,IAAI,EAAE,SAAS,EAAE,UAAU,YAAY,EAAE,OAAO;EAChD,IAAI,EAAE,UAAU,SACd,EAAE,SAAS,UAAU,YAAY,EAAE,SAAS,OAAO;EAErD,MAAM,SAAS,EAAE,WAAW;EAC5B,IAAI,MAAM,QAAQ,MAAM,GACtB,KAAK,MAAM,MAAM,QAAQ;GACvB,IAAI,GAAG,OAAO,GAAG,QAAQ,YAAY,GAAG,KAAK;GAC7C,MAAM,SAAS,GAAG,YAAY;GAC9B,IAAI,MAAM,QAAQ,MAAM,GACtB,KAAK,MAAM,KAAK,QAAQ;IACtB,IAAI,EAAE,UAAU,EAAE,WAAW,YAAY,EAAE,QAAQ;IACnD,IAAI,EAAE,UAAU,EAAE,WAAW,YAAY,EAAE,QAAQ;IAEnD,OAAO,EAAE;IACT,OAAO,EAAE;IACT,OAAO,EAAE;IACT,OAAO,EAAE;GACX;EAEJ;EAGF,OAAO,EAAE;EAET,IAAI,EAAE,OAAO;GACX,OAAO,EAAE,MAAM;GACf,OAAO,EAAE,MAAM;EACjB;CACF,QAAQ,CAER;CACA,OAAO;AACT;;;;;AAMA,eAAsB,iBAAiB,MAGE;CAEvC,IAAI,CAAC,MADiB,wBAAwB,GAChC;CAEd,MAAM,SAAS,MAAM,OAAO;CAC5B,MAAM,KAAK,MAAM,OAAO;CACxB,MAAM,eAAe,OAAO,KAAK;EAC/B,KAAK;EACL,SAAS,KAAK;EACd,aAAa,QAAQ,IAAI,YAAY;EACrC,gBAAgB;EAChB,qBAAqB;EACrB,cAAc,CAEd;EACA,WAAW,OAAO;GAChB,OAAO,WAAW,KAAK;EACzB;EACA,iBAAiB,YAAY;GAC3B,IAAI,WAAW,SACb,WAAW,UAAU,YAAY,WAAW,OAAO;GAErD,OAAO;EACT;CACF,CAAC;CACD,OAAO,OAAO,YAAY,KAAK,OAAO;CACtC,IAAI,KAAK,SAAS,OAAO,OAAO,eAAe,KAAK,OAAO;CAI3D,OAAO,OAAO,MAAM,QAAQ,QAAQ;CACpC,OAAO,OAAO,QAAQ,QAAQ,IAAI;CAClC,OAAO,OAAO,gBAAgB,QAAQ,OAAO;CAC7C,OAAO,OAAO,MAAM,OAAO,QAAQ,QAAQ,IAAI,EAAE,CAAC,CAAC;CACnD,OAAO,OAAO,OAAO,OAAO,QAAQ,QAAQ,MAAM,KAAK,CAAC,CAAC;CACzD,OAAO,WAAW,WAAW;EAC3B,MAAM;EACN,SAAS,QAAQ;CACnB,CAAC;CACD,OAAO,WAAW,MAAM;EACtB,MAAM,QAAQ;EACd,SAAS,GAAG,QAAQ;CACtB,CAAC;CACD,OAAO,WAAW,UAAU,EAC1B,MAAM,QAAQ,KAChB,CAAC;CACD,IAAI,CAAC,cACH;CAEF,OAAO;EACL,wBAAwB,MAAyB;GAC/C,MAAM,OAAO,KAAK,KAAK,IAAI,WAAW;GACtC,MAAM,YAAY,KAAK,KACpB,QAAQ,MAAM,EAAE,WAAW,GAAG,CAAC,CAAC,CAChC,KAAK,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,EAAE;GAC7B,IAAI,KAAK,SAAS,OAAO,OAAO,WAAW,KAAK,OAAO;GACvD,IAAI,KAAK,YAAY,OAAO,OAAO,cAAc,KAAK,UAAU;GAChE,IAAI,KAAK,IAAI,OAAO,OAAO,MAAM,KAAK,EAAE;GACxC,OAAO,WAAW,cAAc;IAC9B,SAAS,KAAK;IACd,YAAY,KAAK;IACjB;IACA,YAAY;IACZ,YAAY,KAAK;IACjB,KAAK,KAAK,MAAM,YAAY,KAAK,GAAG,IAAI,KAAA;GAC1C,CAAC;GACD,OAAO,cAAc;IACnB,UAAU;IACV,OAAO;IACP,SAAS;IACT,MAAM;KACJ,SAAS,KAAK;KACd,IAAI,KAAK;KACT,KAAK,QAAQ,QAAQ,MAAM,KAAK;KAChC,IAAI,QAAQ,QAAQ,IAAI,EAAE;IAC5B;GACF,CAAC;EACH;EACA,iBAAiB,OACf,KACA,gBACG;GACH,IAAI;IACF,OAAO,OAAO,cAAc,aAAa,QAAQ,OAAO;IACxD,aAAa,iBAAiB,GAAG;IACjC,MAAM,aAAa,MAAM,GAAI;GAC/B,QAAQ,CAER;EACF;CACF;AACF;;;;AAKA,SAAgB,oBAAoB,SAAwB;CAC1D,YAAY;EAAE;EAAS,0BAAS,IAAI,KAAK,EAAA,CAAE,YAAY;CAAE,CAAC;AAC5D;;;;AAKA,SAAgB,qBAG0B;CACxC,IAAI,qBAAqB,GAAG,OAAO;EAAE,QAAQ;EAAO,SAAS;CAAM;CACnE,IAAI,oBAAoB,GAAG,OAAO;EAAE,QAAQ;EAAO,SAAS;CAAK;CACjE,MAAM,SAAS,WAAW;CAC1B,IAAI,QACF,OAAO;EACL,QAAQ;EACR,SAAS,OAAO;EAChB,SAAS,OAAO;CAClB;CACF,OAAO;EAAE,QAAQ;EAAW,SAAS;CAAM;AAC7C"}
|