@seriousgaming/sdk-tools 1.6.0 → 1.7.0
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/agent/guidance.md +350 -0
- package/dist/{cli-I355WTAF.js → cli-2DQJACAH.js} +20 -12
- package/dist/{cli-PTT5RGKO.js → cli-3PIJLSRQ.js} +5 -5
- package/dist/{cli-O6PWMJTZ.js → cli-4CHKF4DQ.js} +1 -1
- package/dist/{cli-UJ4UCL2Z.js → cli-4VZIJYKU.js} +1 -1
- package/dist/{cli-O5KP4OVN.js → cli-4XCQUM3E.js} +2 -2
- package/dist/{cli-6WXLXJVX.js → cli-57C72YKJ.js} +14 -14
- package/dist/{cli-GFBGYFYD.js → cli-57V4ARER.js} +1 -1
- package/dist/{cli-IRZ5KB7D.js → cli-5G7TZHD3.js} +14 -14
- package/dist/{cli-QEVDDBNO.js → cli-64AA7367.js} +8 -8
- package/dist/{cli-LMDJCHHD.js → cli-6HB6HTC6.js} +47 -47
- package/dist/{cli-TCY5LJ7E.js → cli-6ZSMW4HR.js} +10 -10
- package/dist/{cli-RN6IWTL2.js → cli-7MBLH4M3.js} +14 -14
- package/dist/{cli-K2B6WHKA.js → cli-7RYIEKMB.js} +10 -10
- package/dist/{cli-ZVSFYDPQ.js → cli-7TOLC62D.js} +16 -14
- package/dist/{cli-LXYPE3L5.js → cli-ATI6OLJU.js} +12 -12
- package/dist/{cli-ROT3DRKU.js → cli-BOXXMDSX.js} +16 -18
- package/dist/{cli-UKQYZYFK.js → cli-C3OERMIR.js} +1 -1
- package/dist/{cli-VCKOC2EV.js → cli-C6G65H6S.js} +2 -2
- package/dist/{cli-ORIG557O.js → cli-CV4JGVJR.js} +17 -27
- package/dist/{cli-HYY64SUD.js → cli-CXCL7VRK.js} +13 -13
- package/dist/{cli-FBTRTIZJ.js → cli-DEBCP7UH.js} +10 -10
- package/dist/{cli-BPYMTOUL.js → cli-DHOWZCXT.js} +10 -10
- package/dist/{cli-E6DJIMYD.js → cli-EDCAH2TC.js} +17 -23
- package/dist/{cli-C6TH5S7K.js → cli-EJVAQCMQ.js} +30 -3
- package/dist/{cli-DZW3XD5F.js → cli-ESA6YNPF.js} +17 -25
- package/dist/{cli-UTJU4IYG.js → cli-FP32D3T6.js} +10 -10
- package/dist/{cli-EVFS55WN.js → cli-FXWWYBYU.js} +22 -25
- package/dist/{cli-MBNMPVDC.js → cli-FXY3DKPW.js} +8 -5
- package/dist/{cli-G6UE5NL4.js → cli-FZ7QAZZP.js} +11 -11
- package/dist/{cli-KL3756X6.js → cli-G5DQGZ2E.js} +17 -19
- package/dist/{cli-JFU22EJ2.js → cli-GEQUJF4L.js} +11 -11
- package/dist/{cli-WAE26SVW.js → cli-GHLILDH7.js} +9 -9
- package/dist/{cli-PFFCNGHI.js → cli-GPAN6XK2.js} +3 -3
- package/dist/{cli-LFGRFIEO.js → cli-GTWEGYSU.js} +12 -12
- package/dist/{cli-4BV45LBH.js → cli-H3J3ICCQ.js} +2 -2
- package/dist/{cli-3E3MD5U4.js → cli-HHPMAV4F.js} +1 -1
- package/dist/{cli-M6BCQRID.js → cli-HM7CD4VU.js} +18 -29
- package/dist/{cli-DMW2OQIJ.js → cli-HYEU3QS6.js} +1 -1
- package/dist/{cli-TPU4TUR6.js → cli-IPP5FDCH.js} +12 -12
- package/dist/{cli-UELGBQG7.js → cli-JGFJWZFU.js} +1 -1
- package/dist/{cli-2GOFEW26.js → cli-JIZTQVL2.js} +8 -8
- package/dist/{cli-GXD36NF2.js → cli-JPAXKLVT.js} +8 -8
- package/dist/{cli-YVVXUD2G.js → cli-JR5AZLLK.js} +7 -2
- package/dist/{cli-PQBXVLEU.js → cli-JRIIAZ33.js} +8 -8
- package/dist/{cli-3HE4AVZG.js → cli-JRMHSMYT.js} +17 -21
- package/dist/{cli-SIPDUBFL.js → cli-L5IG7MY2.js} +14 -14
- package/dist/{cli-FYINNRML.js → cli-LE5ICDAF.js} +27 -70
- package/dist/{cli-LFM7GJHI.js → cli-LQ4VSM5R.js} +0 -0
- package/dist/{cli-RA673NGF.js → cli-LQERHJFE.js} +4 -4
- package/dist/{cli-ZWPYIXNI.js → cli-LRQDF3ZO.js} +7 -7
- package/dist/{cli-V4GHRWOV.js → cli-M7WEAIRF.js} +5 -5
- package/dist/{cli-GUXKQMJ7.js → cli-MM3A4SPH.js} +1 -1
- package/dist/{cli-5JEGTVTG.js → cli-MULKSLA4.js} +12 -12
- package/dist/{cli-B4TN6PJP.js → cli-MYJGGLC5.js} +2 -2
- package/dist/{cli-7OGYADZ3.js → cli-NEOLMC2P.js} +12 -12
- package/dist/{cli-IDKYF5XB.js → cli-NOQBWJQN.js} +1 -1
- package/dist/{cli-TLLA6KAP.js → cli-NPPY557S.js} +10 -10
- package/dist/{cli-GTSGLN3Z.js → cli-OANH3BTQ.js} +1 -1
- package/dist/{cli-UMFFURZ7.js → cli-OQG3Y4RU.js} +10 -10
- package/dist/{cli-6RRVEGFB.js → cli-PIO7NWMH.js} +10 -10
- package/dist/{cli-GDQ6ILJY.js → cli-PKQNOGBO.js} +7 -7
- package/dist/{cli-DL2CVMRF.js → cli-PVA52RC2.js} +11 -11
- package/dist/{cli-JZM7XTNV.js → cli-R7RG2VMW.js} +10 -10
- package/dist/{cli-ZISJ36MM.js → cli-SOFCTQAL.js} +10 -10
- package/dist/{cli-6AMT3BUO.js → cli-SOMIB4B4.js} +12 -12
- package/dist/{cli-E33CJRRQ.js → cli-SPGUVL6Z.js} +14 -14
- package/dist/{cli-4AKVLEC4.js → cli-SWZY7L7K.js} +3 -3
- package/dist/{cli-C3NVCKO6.js → cli-SX3ULO5P.js} +8 -8
- package/dist/{cli-S5QDONIQ.js → cli-T4HWGMY4.js} +7 -7
- package/dist/{cli-272KBNJH.js → cli-TDYKRXUA.js} +12 -12
- package/dist/{cli-UNJ5X6BU.js → cli-TFMNNVJ7.js} +10 -10
- package/dist/{cli-PNLYX6R6.js → cli-TFZ53OA2.js} +12 -12
- package/dist/{cli-KNOOKGYW.js → cli-TJ3PLRHF.js} +10 -10
- package/dist/{cli-JMZLT65J.js → cli-TPNQLYPC.js} +1 -1
- package/dist/{cli-QEVE5HUM.js → cli-UBQCSUDH.js} +11 -11
- package/dist/{cli-E2NLWIFE.js → cli-UTM4QU67.js} +1 -1
- package/dist/{cli-U2UE7I7J.js → cli-UY4VDI7W.js} +8 -8
- package/dist/{cli-XCO2VQOH.js → cli-VPON5HGB.js} +19 -17
- package/dist/{cli-Q2XJF5AS.js → cli-VYR326C6.js} +18 -21
- package/dist/{cli-G522CPRL.js → cli-WAZD75KE.js} +10 -10
- package/dist/{cli-R4PCG5YX.js → cli-WG36UJRK.js} +12 -12
- package/dist/{cli-GBFM76BF.js → cli-WM6SQJ6Q.js} +5 -5
- package/dist/{cli-G6KELFSX.js → cli-X7E3637I.js} +84 -17
- package/dist/{cli-AK7OIPWY.js → cli-XR2XSWQN.js} +13 -17
- package/dist/{cli-GGPDQNM3.js → cli-XTANOFQR.js} +2 -2
- package/dist/{cli-BYJWFFCF.js → cli-YSPZZQCP.js} +2 -2
- package/dist/{cli-EEFJKIGL.js → cli-Z5HWENER.js} +17 -25
- package/dist/{cli-57RXC3HQ.js → cli-ZBTFLZUL.js} +14 -14
- package/dist/{cli-SMFSZF2G.js → cli-ZF7IFB54.js} +21 -4
- package/dist/{cli-VCI3CG36.js → cli-ZKG3OPZ6.js} +9 -9
- package/dist/{cli-WOGIAU2E.js → cli-ZQ2Y3U7F.js} +7 -7
- package/dist/{cli-QUIJCBYB.js → cli-ZRPWZOCW.js} +15 -7
- package/dist/{cli-UHSZBKYO.js → cli-ZTZ5H55T.js} +12 -12
- package/dist/cli.js +36 -34
- package/dist/client.js +178 -69
- package/dist/core/game-settings.d.ts +5 -3
- package/dist/core/session-roster.d.ts +10 -0
- package/dist/dev/console/assets/{index-CuMOOH9m.js → index-CnXlPeLX.js} +47 -47
- package/dist/dev/console/index.html +1 -1
- package/dist/dev/routes.d.ts +5 -2
- package/dist/dev/shell.d.ts +9 -1
- package/dist/dev/view/batch.d.ts +11 -1
- package/dist/dev/view/route.d.ts +18 -1
- package/dist/dev/view/view.d.ts +9 -0
- package/dist/docs/ai-agents.md +1 -1
- package/dist/docs/api/index.md +1 -1
- package/dist/docs/api/sdk-commands.md +4 -0
- package/dist/docs/api/sdk-e2e.md +5 -0
- package/dist/docs/api/sdk-tools-client.md +4 -0
- package/dist/docs/api/sdk-ui-testing.md +1 -0
- package/dist/docs/api/sdk-ui.md +28 -0
- package/dist/docs/api/sdk.md +2 -0
- package/dist/docs/changelog.md +26 -0
- package/dist/docs/cli-and-dev-server.md +4 -0
- package/dist/docs/cli-reference.md +17 -2
- package/dist/docs/getting-started.md +1 -1
- package/dist/docs/guides/presentation.md +11 -10
- package/dist/docs/guides/session-hooks.md +16 -0
- package/dist/docs/guides/settings.md +4 -2
- package/dist/docs/guides/starter-game.md +1 -1
- package/dist/docs/guides/upgrading.md +31 -2
- package/dist/docs/page-index.md +6 -6
- package/dist/host/protocol.d.ts +10 -1
- package/dist/host.js +1 -0
- package/dist/playwright.js +178 -69
- package/dist/runtime/manifest-version.d.ts +1 -1
- package/dist/runtime.js +1 -1
- package/dist/schema.json +10 -1
- package/dist/templates/package/CLAUDE.md.template +7 -346
- package/dist/templates/package/claude/rules/workflow-create-engine.md +2 -2
- package/dist/templates/package/claude/rules/workflow-create-guide.md +2 -2
- package/dist/templates/package/claude/rules/workflow-create-user-interface.md +1 -1
- package/dist/templates/package/claude/rules/workflow-update-sdk-version.md +3 -3
- package/package.json +3 -3
|
@@ -0,0 +1,350 @@
|
|
|
1
|
+
# Serious Gaming SDK guidance
|
|
2
|
+
|
|
3
|
+
Guidance for an AI coding agent working in a Serious Gaming SDK package. A package is a game. This file ships inside `@seriousgaming/sdk-tools`, so it describes the SDK version the package has installed and changes when the package upgrades. What this particular game is, and any rules of its own, belong in the package's own `CLAUDE.md`, which imports this file. Read the package's files rather than assuming what they hold.
|
|
4
|
+
|
|
5
|
+
## Non-negotiables
|
|
6
|
+
|
|
7
|
+
- **Logic returns what it writes under `capabilities`**, and removes keys with `deletes` beside it. Never mutate `context`: spread
|
|
8
|
+
- **Declare `reads`, `writes`, `settings` and `uses`.** A resource receives exactly what it declares; a write or a service outside them is refused
|
|
9
|
+
- **Await every `setData`**, through `useMutationReporter`, so a refusal reaches the person. Never retry a write automatically
|
|
10
|
+
- **Never start `pnpm start`, `pnpm run sdk dev` or watch-mode `pnpm test`.** The user starts long-running processes
|
|
11
|
+
- **No host globals in logic.** `meta.now`, not `Date.now()`; `meta.seed` with `deriveSeed` and `seededRandom`, not `Math.random()`; no `fetch`, timers or Node built-ins
|
|
12
|
+
- **Use `update`, not `new`, for a slot that is already filled** (`engine`, `ui`, `session`, …). Change bundles through the CLI, not by hand
|
|
13
|
+
- **Never edit a generated `types.ts`, and never use `any`**
|
|
14
|
+
- **Never publish, and never `pnpm add`, unless the user asks**
|
|
15
|
+
|
|
16
|
+
## Workflows
|
|
17
|
+
|
|
18
|
+
Before touching a resource, read its rule in the package's `.claude/rules/`. A tool that loads only this file still finds them here:
|
|
19
|
+
|
|
20
|
+
- `capabilities/`: `.claude/rules/workflow-create-capability.md`
|
|
21
|
+
- `engine/`: `.claude/rules/workflow-create-engine.md`
|
|
22
|
+
- `ui/`, `session/`, `waiting_room/`, `setup/`, `scenario_editor/`: `.claude/rules/workflow-create-user-interface.md`
|
|
23
|
+
- `endpoints/`: `.claude/rules/workflow-create-endpoint.md`
|
|
24
|
+
- `guide/`: `.claude/rules/workflow-create-guide.md`
|
|
25
|
+
- `presentation/`: `.claude/rules/workflow-create-presentation.md`
|
|
26
|
+
- Any `*.test.ts` or `*.test.tsx`: `.claude/rules/workflow-test-engine-or-ui.md`
|
|
27
|
+
- `package.json` and an SDK upgrade: `.claude/rules/workflow-update-sdk-version.md`
|
|
28
|
+
- Publishing: `.claude/rules/workflow-publish-package.md`
|
|
29
|
+
|
|
30
|
+
## Documentation
|
|
31
|
+
|
|
32
|
+
The SDK's documentation ships inside it, so it describes the version the package has installed. **Read the recipe before you start a task; do not guess.**
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
pnpm run --silent sdk docs view # the documentation tree
|
|
36
|
+
pnpm run --silent sdk docs view page-index.md # every page: summary and length
|
|
37
|
+
pnpm run --silent sdk docs view recipes/index.md # every recipe, one line each
|
|
38
|
+
pnpm run --silent sdk docs view recipes/create-hook.md # one document
|
|
39
|
+
pnpm run --silent sdk docs view guides/session.md --outline # the headings of a page, with section lengths
|
|
40
|
+
pnpm run --silent sdk docs view guides/session.md --section 'Building the session UI' # one section
|
|
41
|
+
pnpm run --silent sdk docs view cli-reference.md # every command and flag
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Some guides run past 50,000 characters, more than one read may show you. Before reading a long page whole, find it in `page-index.md`, list its headings with `--outline`, and read the section you need with `--section`.
|
|
45
|
+
|
|
46
|
+
The same files are on disk in `node_modules/@seriousgaming/sdk-tools/dist/docs/`, so you can search them with `grep -rn`. Start from `recipes/` for a task, `guides/` for a whole subject, and `concepts/` for the model.
|
|
47
|
+
|
|
48
|
+
`pnpm run sdk docs export` copies them into the package, for a tool that cannot read `node_modules`. The same docs for the newest release are at https://sdk.seriousgaming.com/llms.txt; prefer the installed copy, which matches the version this package runs.
|
|
49
|
+
|
|
50
|
+
## Patterns to keep
|
|
51
|
+
|
|
52
|
+
Four things are easy to get wrong and expensive to retrofit. Build them in from the start, whatever the game is about:
|
|
53
|
+
|
|
54
|
+
- **Key state so participants cannot overwrite each other.** Where several people edit one capability, key it by item or by person (a hook can put each participant in charge of one key), so two people changing two values write two different keys. See `recipes/design-state-for-concurrent-writes.md`
|
|
55
|
+
- **Put a validator on what they share.** Two changes can each fit while their merged result breaks a limit, so a validator checks the merged result and refuses it out loud
|
|
56
|
+
- **Await every write.** Route each `setData` through one mutation reporter, so a refusal reaches the person who made it
|
|
57
|
+
- **Choose how teams play.** In independent mode each team runs its own rounds, and the facilitator watches from `session/` and can undo
|
|
58
|
+
|
|
59
|
+
The starter game (`sdk new package` without `--empty`) is a worked example of all four. A package that began from it may since have been reskinned or rebuilt, so read the files on disk rather than assuming the starter's. `pnpm run --silent sdk docs view guides/starter-game.md` walks through the starter file by file, and `recipes/start-from-an-empty-package.md` begins without it.
|
|
60
|
+
|
|
61
|
+
## How a game is built
|
|
62
|
+
|
|
63
|
+
### Mental model
|
|
64
|
+
|
|
65
|
+
A game works like a **reactive spreadsheet**:
|
|
66
|
+
|
|
67
|
+
- **Capabilities**: column headers (named groups of variables, schema only)
|
|
68
|
+
- **Settings**: read-only parameters, each property with a default, overridden by scenarios
|
|
69
|
+
- **The engine**: the formulas (`Init` sets up, `Run` computes one tick)
|
|
70
|
+
- **User interfaces**: charts and input cells (`ui/` for participants, `session/` for the facilitator, `waiting_room/` before play, `setup/` and `scenario_editor/` for settings)
|
|
71
|
+
- **Validators**: data validation on input cells (reject a write, never change it), and an optional `Scenario` gate that refuses a scenario breaking the game's rules
|
|
72
|
+
- **Hooks**: handlers that run outside the tick on a signal such as `participantJoin`
|
|
73
|
+
- **Endpoints**: server-side functions a surface, or with `visibility: "external"` a caller outside the game, calls by identifier
|
|
74
|
+
- **Guide and presentation**: the facilitator's run-sheet and slide deck
|
|
75
|
+
|
|
76
|
+
Data flows: surfaces write decisions with `setData`, a tick runs the engine, and surfaces show the results.
|
|
77
|
+
|
|
78
|
+
### Layout
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
.
|
|
82
|
+
├── seriousgaming.sdk.json # The package identifier, locales, maxTicks and teams
|
|
83
|
+
├── engine/ # THE engine: Init and Run
|
|
84
|
+
├── ui/ # THE participant interface
|
|
85
|
+
├── session/ # THE facilitator's screen
|
|
86
|
+
├── waiting_room/ # THE holding screen
|
|
87
|
+
├── setup/ # THE settings form at session creation (sdk new setup)
|
|
88
|
+
├── scenario_editor/ # THE scenario authoring screen (sdk new scenario_editor)
|
|
89
|
+
├── presentation/ # THE slide deck the facilitator projects
|
|
90
|
+
├── tick_controller/ # THE timer, for timed rounds (sdk new tick_controller)
|
|
91
|
+
├── guide/ # THE facilitator guide (markdown per locale, plus assets)
|
|
92
|
+
├── capabilities/<name>/ # Data definitions
|
|
93
|
+
├── settings/<name>/ # Read-only parameters
|
|
94
|
+
├── endpoints/<name>/ # Server-side functions
|
|
95
|
+
├── hooks/<name>/ # Lifecycle handlers
|
|
96
|
+
├── validators/<name>/ # Reject-only gates on writes and tick requests
|
|
97
|
+
├── scenarios/<name>/ # Settings overrides, plus assets
|
|
98
|
+
├── testing/engine/ # Whole-game tests (createTestSession)
|
|
99
|
+
└── testing/e2e/ # Playwright specs, and the global setup that starts their server
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
A game holds one of each slot resource, so it lives in its slot and carries no name. Everything else sits at `<plural>/<name>/` and is named by its directory: `"identifier": "sales"` makes `capabilities/sales/`, `context.sales`, and `"sales"` in `reads`. A name is lowercase letters, digits, and underscores, starting with a letter. Only the package carries a dotted reverse-DNS identifier, and its game is that identifier with `.game` appended. There is no list to keep in step: a package declares whatever is on disk.
|
|
103
|
+
|
|
104
|
+
## The loop: edit, validate, test
|
|
105
|
+
|
|
106
|
+
Pass `--json` to any command (or set `SERIOUSGAMING_JSON=1`) and it prints exactly one JSON document on stdout, success or failure, with progress on stderr. Always invoke it as `pnpm run --silent sdk …`, so no pnpm banner precedes the JSON.
|
|
107
|
+
|
|
108
|
+
```json
|
|
109
|
+
{ "ok": true, "command": "tick", "data": { "completedTicks": 1 }, "diagnostics": [], "warnings": [] }
|
|
110
|
+
{ "ok": false, "command": "build", "error": { "code": "PACKAGE_INVALID", "message": "…", "hint": "…" }, "diagnostics": [{ "severity": "error", "code": "SETTINGS_UNKNOWN_KEY", "file": "scenarios/hard/scenario.sdk.json", "pointer": "/definition/settings/engine/BaseDemnd", "hint": "Did you mean 'BaseDemand'?", "message": "…" }], "warnings": [] }
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
After every change, run these in order and stop at the first that fails:
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
pnpm run --silent sdk build --validate-only --json # the package: bundles, references, settings
|
|
117
|
+
pnpm run typecheck # tsc over the whole package
|
|
118
|
+
pnpm run lint # oxlint, warnings included
|
|
119
|
+
pnpm test:run # unit and component tests beside each resource
|
|
120
|
+
pnpm test:engine # whole games, in-process
|
|
121
|
+
pnpm run --silent sdk tick --no-server --json # one tick in the restricted production runtime
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
Branch on `ok`, the exit code and `error.code`, never on the message:
|
|
125
|
+
|
|
126
|
+
| Exit | Meaning | What to do |
|
|
127
|
+
| ---- | ------------------- | -------------------------------------------------------------------------- |
|
|
128
|
+
| 0 | Success | |
|
|
129
|
+
| 1 | A bug in the CLI | Report it; do not retry blindly |
|
|
130
|
+
| 2 | Usage error | Fix the command: a flag, an argument, or input you did not pass |
|
|
131
|
+
| 3 | Invalid package | Fix the package: `diagnostics` says which file and where |
|
|
132
|
+
| 4 | Refused by the game | The game said no (`REFUSED_VALIDATION`, `TICK_FAILED`, …): read the reason |
|
|
133
|
+
| 5 | Environment | No session, a port in use, the platform unreachable: fix the environment |
|
|
134
|
+
|
|
135
|
+
**On a failure, read `diagnostics[]` first.** `file` is relative to the package root; `pointer` is an RFC 6901 pointer into that JSON file (`/definition/reads/0` is the bundle's first read), and `line` and `column` locate a TypeScript file instead. Open it there, apply the `hint`, and rerun the same command. Branch on each diagnostic's `code` (`SCHEMA_INVALID`, `REFERENCE_UNKNOWN`, `SETTINGS_UNKNOWN_KEY`, `REMOVED_FIELD`, `LOGIC_ERROR`, …). Logic that throws during `init`, `tick` or `endpoint call` exits 4 with a `LOGIC_ERROR` naming the source line, `tick` and `team`. Warnings do not fail a command, but are usually worth fixing.
|
|
136
|
+
|
|
137
|
+
The CLI never prompts without a terminal: a command that would ask fails with `PROMPT_REQUIRED` (exit 2). Pass definitions as an argument, with `--file`, or on stdin, and pass `--yes` to `delete`. `pnpm run --silent sdk docs view recipes/check-a-package-from-a-script.md` has the whole contract.
|
|
138
|
+
|
|
139
|
+
## Commands
|
|
140
|
+
|
|
141
|
+
### Resources
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
pnpm run sdk new capability --help # every type prints its JSON format with --help
|
|
145
|
+
pnpm run sdk new capability '{...}' # likewise hook, validator, endpoint, settings, scenario
|
|
146
|
+
pnpm run sdk new setup '{...}' # an empty slot: setup, scenario_editor, presentation, tick_controller
|
|
147
|
+
pnpm run sdk update engine --patch '[{"op":"add","path":"/definition/writes/-","value":"results"}]'
|
|
148
|
+
pnpm run sdk update capability <name> '{...}' # full replacement
|
|
149
|
+
pnpm run sdk update package --patch '[{"op":"replace","path":"/maxTicks","value":12}]'
|
|
150
|
+
pnpm run sdk delete capability <name> --yes
|
|
151
|
+
pnpm run generate # regenerate types after a hand edit (new and update already do)
|
|
152
|
+
pnpm run build # validate, generate and bundle into dist/
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
A slot command takes no identifier. `new` refuses a slot that is already filled, so check what is on disk first and `update` a slot the package already has. `update package` changes the manifest, which takes no identifier either.
|
|
156
|
+
|
|
157
|
+
### Playing the game from the CLI
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
pnpm run --silent sdk init # start the session, or rebuild it at tick 0
|
|
161
|
+
pnpm run --silent sdk tick --patch '[{"op":"replace","path":"/<capability>/<variable>","value":70}]'
|
|
162
|
+
pnpm run --silent sdk patch '[{"op":"replace","path":"/<capability>/<variable>","value":0}]'
|
|
163
|
+
pnpm run --silent sdk view # the current state (--full for the whole projection)
|
|
164
|
+
pnpm run --silent sdk undo # undo the last tick
|
|
165
|
+
pnpm run --silent sdk reset # back to tick 0
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
Patch paths start at the capability. `--team N` picks the team in a game with several. `pnpm run sdk configure '{"<settings>":{"<property>":60}}'` overrides settings for the session, keyed by settings identifier, and restarts a running session on the new values.
|
|
169
|
+
|
|
170
|
+
**Know which session a command touches:**
|
|
171
|
+
|
|
172
|
+
- **If a dev server is running**, session commands act on its session, which is what the user is watching
|
|
173
|
+
- **If none is running**, they start one in the background and say so on stderr
|
|
174
|
+
- **With `--no-server`**, they run in-process against a fresh session and leave nothing behind; each starts again at tick 0
|
|
175
|
+
|
|
176
|
+
Edits to logic and bundles reach a running dev server from its next tick, without a reset. Prefer `--no-server` and `pnpm test:engine` for your own checks. Use the shared session only when the user wants to watch. `pnpm run sdk dev status` says whether a server is running; never stop one you did not start. `pnpm test:e2e` starts an isolated server of its own on free ports, beside the user's.
|
|
177
|
+
|
|
178
|
+
## How things work
|
|
179
|
+
|
|
180
|
+
### Reads, writes and what the runtime owns
|
|
181
|
+
|
|
182
|
+
Every resource declares its data flow as arrays of capability identifiers: `reads` for what it consumes, `writes` for what it produces (a capability may appear in both). A capability you forgot to declare is absent from `context` (or a surface's `data`), and the generated `Context` says so. A game holds one engine; a simulation with several steps calls them as plain functions from its `Run`.
|
|
183
|
+
|
|
184
|
+
Do not rebuild runtime concerns in context:
|
|
185
|
+
|
|
186
|
+
- **Ticks**: no `CurrentRound` variable; read `meta.tick`, the tick being run
|
|
187
|
+
- **Time**: `meta.now`, the instant the operation started, which a re-run sees again
|
|
188
|
+
- **Who is on a team**: the read-only `participants` argument, not a roster kept from hooks
|
|
189
|
+
- **Lifecycle**: set `maxTicks` in `seriousgaming.sdk.json`, or return `complete: true` from `Run`. A tick controller is for timed rounds, or ending on a participant's write between ticks
|
|
190
|
+
- **Undo and reset**: built in
|
|
191
|
+
- **Parameters**: a settings resource (`settings/<name>/settings.sdk.json`, a default on every property), read by each resource that lists it in `settings`
|
|
192
|
+
|
|
193
|
+
`setData` updates context immediately, and other surfaces see it at once; the engine's `Run` sees it on the next tick.
|
|
194
|
+
|
|
195
|
+
### Logic
|
|
196
|
+
|
|
197
|
+
Every logic function is async, takes one args object, and returns what it writes under `capabilities`, always by spreading:
|
|
198
|
+
|
|
199
|
+
```typescript
|
|
200
|
+
import type { InitializationFunction, RunFunction } from '@seriousgaming/sdk';
|
|
201
|
+
import type { Context, Settings } from './types';
|
|
202
|
+
|
|
203
|
+
export const Init: InitializationFunction<Context, Settings> = async ({ context, settings }) => ({
|
|
204
|
+
capabilities: { ...context },
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
export const Run: RunFunction<Context, Settings> = async ({ context, meta }) => ({
|
|
208
|
+
capabilities: {
|
|
209
|
+
...context,
|
|
210
|
+
results: { ...context.results, Day: meta.tick }, // never context.results.Day = …
|
|
211
|
+
},
|
|
212
|
+
});
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
- The args are `{ context, settings, callbacks, meta, participants }`, plus `state` for an engine. `settings` is keyed by settings identifier and already resolved for the session; `guides/settings.md` has the order
|
|
216
|
+
- Hooks, aggregate engines (`{ shared: { capabilities }, teams: [{ capabilities }] }`) and writing endpoints (`{ response, capabilities }`) return the same way. A flat return fails the call
|
|
217
|
+
- **To remove a key**, return its path in `deletes` beside `capabilities` (`deletes: [['orders', 'Open', id]]`), under a capability in `writes`. Leaving a key out never removes it
|
|
218
|
+
- `Init` is optional: without it each team starts from the capabilities' defaults
|
|
219
|
+
- `Run` may return `complete: true` to end the game, and an engine may return `state` beside `capabilities` for private memory between ticks (type it with `RunFunction`'s fourth parameter)
|
|
220
|
+
- A step of a split engine is a `StepFunction<Context, Settings>`: steps pass the context flat, and only the exported function wraps the result
|
|
221
|
+
|
|
222
|
+
### The logic runtime: ECMAScript intrinsics only
|
|
223
|
+
|
|
224
|
+
Engine, hook, validator, endpoint, and tick controller logic runs in a **bare V8 isolate** in production. `process`, `require`, `fetch`, timers, `structuredClone`, `Buffer`, `TextEncoder`, `URL`, `crypto`, `atob`, `window`, `document` and `localStorage` are absent and throw at tick time. `console.log` is fine.
|
|
225
|
+
|
|
226
|
+
| Instead of | Use |
|
|
227
|
+
| ----------------------------- | -------------------------------------------------------------- |
|
|
228
|
+
| `structuredClone(v)` | `JSON.parse(JSON.stringify(v))` |
|
|
229
|
+
| `TextEncoder`, `TextDecoder` | `encodeUtf8`, `decodeUtf8` from `@seriousgaming/sdk` |
|
|
230
|
+
| `fetch(...)` | The injected `callbacks`, or an endpoint |
|
|
231
|
+
| `setTimeout(...)` | Nothing: ticks are the scheduling primitive |
|
|
232
|
+
| `process.env.X` | The `settings` argument |
|
|
233
|
+
| `Math.random()` for kept data | `deriveSeed` and `seededRandom` from the SDK, from `meta.seed` |
|
|
234
|
+
| `Date.now()`, `new Date()` | `meta.now` |
|
|
235
|
+
|
|
236
|
+
Importing a Node built-in (`node:fs`, `path`, `os`, …), directly or through a library, fails `build`, `dev` and `tick` with `LOGIC_NODE_BUILTIN`. `pnpm run lint` refuses the globals above as errors in every logic file, and fails on any warning, so run it before you call logic done. It cannot see `globalThis.fetch`, and it is off for tests, which run in Node: **a green unit test does not prove logic is portable**, so finish with `tick --no-server`.
|
|
237
|
+
|
|
238
|
+
### Type safety
|
|
239
|
+
|
|
240
|
+
`variablesSchema` and `settingsSchema` are full JSON Schema 7 objects, and the generated types are only as precise as they are:
|
|
241
|
+
|
|
242
|
+
- **Wrap every schema**: `type: 'object'`, `properties`, `additionalProperties: false` (and `required` in a `variablesSchema`)
|
|
243
|
+
- **Type every field.** Never a string holding JSON; give an object its `properties` and an array its `items`
|
|
244
|
+
- **Key collections by id** where several people write at once (`additionalProperties` with a schema): two writes to two keys cannot collide, and an entry leaves through `deletes`. See `recipes/design-state-for-concurrent-writes.md`
|
|
245
|
+
- **A `default` must satisfy its own schema**: `build --validate-only` fails one that does not
|
|
246
|
+
|
|
247
|
+
```json
|
|
248
|
+
{
|
|
249
|
+
"definition": {
|
|
250
|
+
"identifier": "market",
|
|
251
|
+
"variablesSchema": {
|
|
252
|
+
"type": "object",
|
|
253
|
+
"properties": {
|
|
254
|
+
"Competitors": {
|
|
255
|
+
"type": "object",
|
|
256
|
+
"properties": {
|
|
257
|
+
"count": { "type": "number", "minimum": 1 },
|
|
258
|
+
"priceList": {
|
|
259
|
+
"type": "array",
|
|
260
|
+
"items": { "type": "number", "minimum": 0 }
|
|
261
|
+
}
|
|
262
|
+
},
|
|
263
|
+
"required": ["count", "priceList"],
|
|
264
|
+
"additionalProperties": false,
|
|
265
|
+
"default": { "count": 5, "priceList": [10, 15, 20] }
|
|
266
|
+
}
|
|
267
|
+
},
|
|
268
|
+
"required": ["Competitors"],
|
|
269
|
+
"additionalProperties": false
|
|
270
|
+
}
|
|
271
|
+
}
|
|
272
|
+
}
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
Every resource with logic or a surface has a generated `types.ts` beside it: `Context` holds exactly the capabilities it declares, `Settings` the settings resources it lists, and `Callbacks` the services in its `uses`. Import from `./types` (or `../types` from a `logic/` directory), never edit it or `defaults.ts`, and never write your own. `pnpm run --silent sdk docs view guides/type-safety.md` has the rest.
|
|
276
|
+
|
|
277
|
+
### Testing logic
|
|
278
|
+
|
|
279
|
+
Call a logic function with `logicArgs` from `@seriousgaming/sdk/testing`, which fills `meta`, the roster and offline stub callbacks around what you name; pass the generated `defaultSettings`. A whole game runs in `createTestSession<Context, SharedContext>` (`testing/engine/`), whose `setData` and `requestTick` act as a participant, so validators judge them. Never cast an argument or a context:
|
|
280
|
+
|
|
281
|
+
```ts
|
|
282
|
+
const result = await Run(
|
|
283
|
+
logicArgs.run({ context: defaultContext, settings: defaultSettings, meta: { tick: 3 } })
|
|
284
|
+
);
|
|
285
|
+
|
|
286
|
+
const session = await createTestSession<Context, SharedContext>({ packagePath });
|
|
287
|
+
await session.setData(0, { decisions: { Price: 4 } }); // a write to a capability the UI declares
|
|
288
|
+
await session.tick();
|
|
289
|
+
expect(session.team(0).context.results.Day).toBe(1);
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
## User interfaces
|
|
293
|
+
|
|
294
|
+
- **Default to MUI** (`@mui/material`), as the starter game does. Build each surface's theme with `createTheme(createSurfaceTheme(theme, { fonts: { body: 'Work Sans Variable' } }), { ...your shapes })`, as the starter game's `ui/src/theme.ts` does: it applies the host's colours, their `contrastText`, and the brand's fonts. Another library must integrate with `useUserInterfaceTheme` the same way, so colours and dark mode work, and text on a theme colour uses that colour's `contrastText` (`colors.contrastText.primary`)
|
|
295
|
+
- **Honour the host's brand.** A white-label host may send a logo and fonts; `useBrandLogo()` gives the logo for the current mode, or nothing, as the starter game's `ui/src/HostLogo.tsx` shows, and `useBrandIcon()` the square mark. Do not hard-code a platform's logo in its place: the host's brand is the host's to send. For join sheets, open the host's `'print-sheets'` overlay where it offers one rather than drawing your own
|
|
296
|
+
- **Await writes.** `setData` rejects when the host refuses the write. Route writes through `useMutationReporter`, as the starter game's `ui/src/writes.ts` does; on a `conflict`, offer `failure.retry` behind a 'Try again' button
|
|
297
|
+
- **Endpoint calls fail typed.** `callbacks.endpoints['<name>'](request)` rejects with an `EndpointError` whose `kind` says why; a non-empty `applied` means some effects landed. Never retry one automatically
|
|
298
|
+
- **A viewer's own choices** (a tab, a collapsed panel) go in `useViewerStorage(key, initial)`, never `localStorage`, which collides across sessions
|
|
299
|
+
- **Assets and history through the hooks.** `useAssetUrl(ref)` for a `src`, `useAsset(ref, { as })` to read a file (it finds the locale's copy in `<dir>/<locale>/<file>`), and `usePastState(query)` for past rounds, rather than hand-rolled effects. The wrapper already sets `lang`, `dir` and `color-scheme` on the document
|
|
300
|
+
- **Every string** goes through `src/i18n.ts`
|
|
301
|
+
- **The facilitator's screen** is `session/`: rendered full-bleed beneath a thin band of host chrome, it owns teams, participants and game controls (`guides/session.md`)
|
|
302
|
+
|
|
303
|
+
### Testing a surface
|
|
304
|
+
|
|
305
|
+
Every surface but the presentation scaffolds an `App.test.tsx`; the starter game's own tests are worked examples, and `pnpm run --silent sdk docs view guides/testing.md` is the reference. A deck is tested through what its slides show, kept in plain functions (the starter game's `presentation/src/stalls.test.ts`), and a Playwright spec that it opens.
|
|
306
|
+
|
|
307
|
+
- **Render through the helper**: `renderUserInterface()` from `@seriousgaming/sdk/ui/testing` (or `renderSessionUserInterface<SessionData>()`, or `renderSettingsEditor()` for setup and the scenario editor). It supplies every provider the host does; pass `data`, `settings`, `callbacks` and the rest as options
|
|
308
|
+
- **Never `vi.mock` the SDK, and never wire its providers by hand**
|
|
309
|
+
- **Use `fireEvent.change` on controlled inputs**: the mock `setData` does not update the value between `userEvent.type` keystrokes
|
|
310
|
+
- **Look at every screen you change**, at phone and desktop size: `pnpm run --silent sdk screenshot /team/1/player/1 --width 390 --height 844 --json`, then again with `--width 1280 --height 800`. Open each PNG, fix text that is cut off, overlaps or is hard to read, and clear the `consoleErrors`, `failedRequests` and `uncaughtExceptions` it lists. Reach the state first with `sdk tick` (`recipes/screenshot-a-surface.md`)
|
|
311
|
+
|
|
312
|
+
## Presentations
|
|
313
|
+
|
|
314
|
+
The `presentation/` slot holds the facilitator's slide deck, built with `@seriousgaming/deck` at the SDK's version. It reads every team's state and writes nothing. The starter game's deck is a worked example: a title, a slide a day, and the results. A facilitator exports it to PDF or PowerPoint and edits the copy, so:
|
|
315
|
+
|
|
316
|
+
- **Use the building blocks** (`Heading`, `Text`, `Bullets`, `Table`) for anything a facilitator might edit; anything else exports as a picture
|
|
317
|
+
- **Render with `session === null`**, showing labelled sample figures where results would go
|
|
318
|
+
- **Branch on settings, not the scenario name**, and draw a custom animation's end state when `useSlide().mode` is `'static'`
|
|
319
|
+
- **Route every word through i18n**, and keep one element per slide
|
|
320
|
+
|
|
321
|
+
## LLM integration
|
|
322
|
+
|
|
323
|
+
Logic calls `callbacks.generateText()` only if its bundle lists `generateText` in `uses`; once listed it is always present on the generated `Callbacks`, so call it without `?.`. A surface reaches an LLM only through an endpoint. The dev server needs `SERIOUSGAMING_API_KEY` in the environment or `.env`, and `createTestSession` stubs it offline. See `guides/llm-integration.md`.
|
|
324
|
+
|
|
325
|
+
## Keeping the SDK up to date
|
|
326
|
+
|
|
327
|
+
```bash
|
|
328
|
+
pnpm run --silent sdk version # the installed version
|
|
329
|
+
pnpm run sdk docs view changelog.md # newest first: read every entry above your version
|
|
330
|
+
pnpm run sdk docs view guides/upgrading.md # a step for each breaking change
|
|
331
|
+
```
|
|
332
|
+
|
|
333
|
+
Upgrade only when the user asks, or when the changelog has a fix the task needs, and then follow `.claude/rules/workflow-update-sdk-version.md`: it bumps the SDK, its tools and the deck together, and adopts newer rules without overwriting the package's own. This guidance updates with the installed version and needs no merging.
|
|
334
|
+
|
|
335
|
+
## Troubleshooting
|
|
336
|
+
|
|
337
|
+
| Problem | Solution |
|
|
338
|
+
| ------------------------------------- | ------------------------------------------------------------------------------------------ |
|
|
339
|
+
| Types not updating | `pnpm run generate` |
|
|
340
|
+
| A capability is missing in code | Add it to the resource's `reads` or `writes`; `update` regenerates the types |
|
|
341
|
+
| A surface's write is refused | Add the capability to that surface's `writes` |
|
|
342
|
+
| Build failing | `pnpm run --silent sdk build --validate-only --json`, then read `diagnostics` |
|
|
343
|
+
| Edit not showing, or `SETTINGS_STALE` | A setting, `teams` or a capability's scope applies only at init: `sdk init` |
|
|
344
|
+
| A hook reads empty data in a surface | Two copies of a package with React context: add it to `resolve.dedupe` in `vite.config.ts` |
|
|
345
|
+
| Anything else | `pnpm run --silent sdk docs view troubleshooting.md` |
|
|
346
|
+
|
|
347
|
+
Keep `DESIGN.md` up to date as the game changes, and hold to two habits for every surface:
|
|
348
|
+
|
|
349
|
+
- **Brief first.** Before you build or redesign a screen, write its brief under 'User interfaces' in `DESIGN.md`: who uses it and on what device, its one main action, its layout, the states it must handle, and the game's identity
|
|
350
|
+
- **Check, then go round once more.** Once it is built, check every screen at phone and desktop size against `pnpm run --silent sdk docs view guides/designing-screens.md`, fix what you find, and check again
|
|
@@ -2,32 +2,33 @@
|
|
|
2
2
|
import {
|
|
3
3
|
connectSession,
|
|
4
4
|
resolveSession
|
|
5
|
-
} from "./cli-
|
|
5
|
+
} from "./cli-OANH3BTQ.js";
|
|
6
6
|
import "./cli-WU43JT4T.js";
|
|
7
7
|
import {
|
|
8
8
|
DevShell,
|
|
9
|
+
LOCAL_ORIGINS_FLAG,
|
|
9
10
|
parseRoute
|
|
10
|
-
} from "./cli-
|
|
11
|
+
} from "./cli-X7E3637I.js";
|
|
11
12
|
import "./cli-BWX5E7TQ.js";
|
|
12
|
-
import "./cli-
|
|
13
|
+
import "./cli-M7WEAIRF.js";
|
|
13
14
|
import "./cli-ILKCQNM6.js";
|
|
14
|
-
import "./cli-
|
|
15
|
-
import "./cli-
|
|
16
|
-
import "./cli-
|
|
15
|
+
import "./cli-TPNQLYPC.js";
|
|
16
|
+
import "./cli-LQ4VSM5R.js";
|
|
17
|
+
import "./cli-EJVAQCMQ.js";
|
|
17
18
|
import {
|
|
18
19
|
loadEnvironmentConfig
|
|
19
20
|
} from "./cli-TDSQSCX4.js";
|
|
20
21
|
import "./cli-SRHBXZCN.js";
|
|
21
|
-
import "./cli-
|
|
22
|
+
import "./cli-MM3A4SPH.js";
|
|
22
23
|
import "./cli-4LKXZQ2B.js";
|
|
23
24
|
import "./cli-MMN4BPO4.js";
|
|
24
25
|
import "./cli-YOTGR3NB.js";
|
|
25
26
|
import "./cli-QUNIRH7A.js";
|
|
26
|
-
import "./cli-
|
|
27
|
-
import "./cli-
|
|
27
|
+
import "./cli-C6G65H6S.js";
|
|
28
|
+
import "./cli-UTM4QU67.js";
|
|
28
29
|
import "./cli-25RWY5BQ.js";
|
|
29
30
|
import "./cli-QWQMPCL6.js";
|
|
30
|
-
import "./cli-
|
|
31
|
+
import "./cli-ZF7IFB54.js";
|
|
31
32
|
import "./cli-F2D4GGUA.js";
|
|
32
33
|
import "./cli-4YB3ROVR.js";
|
|
33
34
|
import {
|
|
@@ -136,6 +137,7 @@ function planScreenshot(path, options, packagePath) {
|
|
|
136
137
|
);
|
|
137
138
|
}
|
|
138
139
|
url.searchParams.set("bare", "");
|
|
140
|
+
url.searchParams.set(LOCAL_ORIGINS_FLAG, "");
|
|
139
141
|
if (scheme !== void 0) url.searchParams.set("scheme", scheme);
|
|
140
142
|
if (options.brand !== void 0) url.searchParams.set("brand", options.brand);
|
|
141
143
|
const width = dimension(options.width, "--width", DEFAULT_WIDTH);
|
|
@@ -151,8 +153,8 @@ function planScreenshot(path, options, packagePath) {
|
|
|
151
153
|
throw new CliError("USAGE_BAD_FLAG", `--out names a PNG file, and got "${options.out}"`);
|
|
152
154
|
}
|
|
153
155
|
return {
|
|
154
|
-
//
|
|
155
|
-
target: `${url.pathname}${url.search.replace(
|
|
156
|
+
// Flags, not values: `?bare=` reads as one, as the console's own links avoid.
|
|
157
|
+
target: `${url.pathname}${url.search.replace(/=(?=&|$)/g, "")}`,
|
|
156
158
|
route,
|
|
157
159
|
width,
|
|
158
160
|
height,
|
|
@@ -343,6 +345,12 @@ async function capture(chromium, url, plan) {
|
|
|
343
345
|
});
|
|
344
346
|
const page = await context.newPage();
|
|
345
347
|
watch(page, problems);
|
|
348
|
+
const consoleHost = new URL(url).host;
|
|
349
|
+
await page.routeWebSocket(
|
|
350
|
+
(socket) => socket.host !== consoleHost,
|
|
351
|
+
() => {
|
|
352
|
+
}
|
|
353
|
+
);
|
|
346
354
|
const deadline = Date.now() + plan.timeoutMs;
|
|
347
355
|
try {
|
|
348
356
|
await page.goto(url, { waitUntil: "load", timeout: plan.timeoutMs });
|
|
@@ -1,19 +1,19 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
resolveSession
|
|
4
|
-
} from "./cli-
|
|
4
|
+
} from "./cli-OANH3BTQ.js";
|
|
5
5
|
import "./cli-WU43JT4T.js";
|
|
6
|
-
import "./cli-
|
|
6
|
+
import "./cli-EJVAQCMQ.js";
|
|
7
7
|
import "./cli-TDSQSCX4.js";
|
|
8
8
|
import "./cli-SRHBXZCN.js";
|
|
9
|
-
import "./cli-
|
|
9
|
+
import "./cli-MM3A4SPH.js";
|
|
10
10
|
import "./cli-4LKXZQ2B.js";
|
|
11
11
|
import "./cli-MMN4BPO4.js";
|
|
12
12
|
import "./cli-QUNIRH7A.js";
|
|
13
|
-
import "./cli-
|
|
13
|
+
import "./cli-UTM4QU67.js";
|
|
14
14
|
import "./cli-25RWY5BQ.js";
|
|
15
15
|
import "./cli-QWQMPCL6.js";
|
|
16
|
-
import "./cli-
|
|
16
|
+
import "./cli-ZF7IFB54.js";
|
|
17
17
|
import "./cli-F2D4GGUA.js";
|
|
18
18
|
import "./cli-4YB3ROVR.js";
|
|
19
19
|
import {
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
validateEngine
|
|
4
|
-
} from "./cli-
|
|
4
|
+
} from "./cli-TPNQLYPC.js";
|
|
5
5
|
import "./cli-4LKXZQ2B.js";
|
|
6
6
|
import {
|
|
7
7
|
LOGIC_NODE_BUILTIN,
|
|
8
8
|
Transpile,
|
|
9
9
|
loadConfig
|
|
10
|
-
} from "./cli-
|
|
10
|
+
} from "./cli-ZF7IFB54.js";
|
|
11
11
|
import "./cli-F2D4GGUA.js";
|
|
12
12
|
import "./cli-4YB3ROVR.js";
|
|
13
13
|
import {
|
|
@@ -1,28 +1,28 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
createSettingsEditor
|
|
4
|
-
} from "./cli-
|
|
5
|
-
import "./cli-
|
|
6
|
-
import "./cli-
|
|
4
|
+
} from "./cli-XR2XSWQN.js";
|
|
5
|
+
import "./cli-XTANOFQR.js";
|
|
6
|
+
import "./cli-4VZIJYKU.js";
|
|
7
7
|
import "./cli-S5IVGDDD.js";
|
|
8
|
-
import "./cli-
|
|
8
|
+
import "./cli-JR5AZLLK.js";
|
|
9
9
|
import "./cli-4UWFQNGF.js";
|
|
10
|
-
import "./cli-
|
|
10
|
+
import "./cli-LE5ICDAF.js";
|
|
11
11
|
import "./cli-IUS2YCD3.js";
|
|
12
12
|
import "./cli-QUNIRH7A.js";
|
|
13
|
-
import "./cli-
|
|
13
|
+
import "./cli-YSPZZQCP.js";
|
|
14
14
|
import "./cli-XSVGKI3R.js";
|
|
15
|
-
import "./cli-
|
|
16
|
-
import "./cli-
|
|
17
|
-
import "./cli-
|
|
15
|
+
import "./cli-FXY3DKPW.js";
|
|
16
|
+
import "./cli-57V4ARER.js";
|
|
17
|
+
import "./cli-JGFJWZFU.js";
|
|
18
18
|
import "./cli-ZTWOE3ZT.js";
|
|
19
|
-
import "./cli-
|
|
20
|
-
import "./cli-
|
|
21
|
-
import "./cli-
|
|
22
|
-
import "./cli-
|
|
19
|
+
import "./cli-H3J3ICCQ.js";
|
|
20
|
+
import "./cli-SWZY7L7K.js";
|
|
21
|
+
import "./cli-C6G65H6S.js";
|
|
22
|
+
import "./cli-UTM4QU67.js";
|
|
23
23
|
import "./cli-25RWY5BQ.js";
|
|
24
24
|
import "./cli-QWQMPCL6.js";
|
|
25
|
-
import "./cli-
|
|
25
|
+
import "./cli-ZF7IFB54.js";
|
|
26
26
|
import "./cli-F2D4GGUA.js";
|
|
27
27
|
import "./cli-4YB3ROVR.js";
|
|
28
28
|
import "./cli-N6H6T2E2.js";
|
|
@@ -1,28 +1,28 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
createSettingsEditor
|
|
4
|
-
} from "./cli-
|
|
5
|
-
import "./cli-
|
|
6
|
-
import "./cli-
|
|
4
|
+
} from "./cli-XR2XSWQN.js";
|
|
5
|
+
import "./cli-XTANOFQR.js";
|
|
6
|
+
import "./cli-4VZIJYKU.js";
|
|
7
7
|
import "./cli-S5IVGDDD.js";
|
|
8
|
-
import "./cli-
|
|
8
|
+
import "./cli-JR5AZLLK.js";
|
|
9
9
|
import "./cli-4UWFQNGF.js";
|
|
10
|
-
import "./cli-
|
|
10
|
+
import "./cli-LE5ICDAF.js";
|
|
11
11
|
import "./cli-IUS2YCD3.js";
|
|
12
12
|
import "./cli-QUNIRH7A.js";
|
|
13
|
-
import "./cli-
|
|
13
|
+
import "./cli-YSPZZQCP.js";
|
|
14
14
|
import "./cli-XSVGKI3R.js";
|
|
15
|
-
import "./cli-
|
|
16
|
-
import "./cli-
|
|
17
|
-
import "./cli-
|
|
15
|
+
import "./cli-FXY3DKPW.js";
|
|
16
|
+
import "./cli-57V4ARER.js";
|
|
17
|
+
import "./cli-JGFJWZFU.js";
|
|
18
18
|
import "./cli-ZTWOE3ZT.js";
|
|
19
|
-
import "./cli-
|
|
20
|
-
import "./cli-
|
|
21
|
-
import "./cli-
|
|
22
|
-
import "./cli-
|
|
19
|
+
import "./cli-H3J3ICCQ.js";
|
|
20
|
+
import "./cli-SWZY7L7K.js";
|
|
21
|
+
import "./cli-C6G65H6S.js";
|
|
22
|
+
import "./cli-UTM4QU67.js";
|
|
23
23
|
import "./cli-25RWY5BQ.js";
|
|
24
24
|
import "./cli-QWQMPCL6.js";
|
|
25
|
-
import "./cli-
|
|
25
|
+
import "./cli-ZF7IFB54.js";
|
|
26
26
|
import "./cli-F2D4GGUA.js";
|
|
27
27
|
import "./cli-4YB3ROVR.js";
|
|
28
28
|
import "./cli-N6H6T2E2.js";
|
|
@@ -1,20 +1,20 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
import {
|
|
3
3
|
runResourceCommand
|
|
4
|
-
} from "./cli-
|
|
4
|
+
} from "./cli-HYEU3QS6.js";
|
|
5
5
|
import {
|
|
6
6
|
RESOURCE_DESCRIPTORS_BY_TYPE,
|
|
7
7
|
supportedTypes
|
|
8
|
-
} from "./cli-
|
|
9
|
-
import "./cli-
|
|
8
|
+
} from "./cli-6HB6HTC6.js";
|
|
9
|
+
import "./cli-JGFJWZFU.js";
|
|
10
10
|
import "./cli-ZTWOE3ZT.js";
|
|
11
|
-
import "./cli-
|
|
12
|
-
import "./cli-
|
|
13
|
-
import "./cli-
|
|
14
|
-
import "./cli-
|
|
11
|
+
import "./cli-H3J3ICCQ.js";
|
|
12
|
+
import "./cli-SWZY7L7K.js";
|
|
13
|
+
import "./cli-C6G65H6S.js";
|
|
14
|
+
import "./cli-UTM4QU67.js";
|
|
15
15
|
import "./cli-25RWY5BQ.js";
|
|
16
16
|
import "./cli-QWQMPCL6.js";
|
|
17
|
-
import "./cli-
|
|
17
|
+
import "./cli-ZF7IFB54.js";
|
|
18
18
|
import "./cli-F2D4GGUA.js";
|
|
19
19
|
import "./cli-4YB3ROVR.js";
|
|
20
20
|
import {
|