@elaraai/create-e3 1.0.28 → 1.0.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elaraai/create-e3",
-  "version": "1.0.28",
+  "version": "1.0.29",
   "description": "Scaffold a new e3 project (BSL-1.1, Node + Python, durable execution): npm create @elaraai/e3",
   "type": "module",
   "bin": {

package/templates/e3/README.md

@@ -42,6 +42,11 @@ npm run clean     # remove build output, dependencies, and the local repo
 
 If you scaffolded with UI, `src/ui/index.tsx` holds a decision surface — a `ui()` task an operator
 uses to observe and act on the recommendation, registered in the package next to the decision.
+Render it to a PNG with `npm run shot` (first time on a machine: `npx e3-ui install-browser`
+downloads the headless Chromium it renders with; `npx e3-ui doctor` diagnoses browser problems).
+`npm run shots:png` sweeps `src/` for EVERY renderable UI export (surfaces and `example()` defs
+alike) into git-ignored `.shots/<path>/<export>.png` + a `manifest.json` of what rendered and why
+anything was skipped; `npm run shots:html` adds a standalone HTML beside each PNG.
 
 If you scaffolded with `--platform`, `src/platform/` holds project-owned TS-East platform functions
 (exported via `./platform`) and `platform_module/` holds the Python ones — replace the generated

package/templates/e3/gitignore

@@ -7,3 +7,4 @@ __pycache__/
 .pytest_cache/
 .repos/
 uv.lock
+.shots/

package/templates/e3/package.json

@@ -14,6 +14,9 @@
     "deploy": "e3 repo create .repos --exist-ok && e3 workspace deploy .repos __WORKSPACE_NAME__ --from-source ./src/index.ts",
     "start": "npm run deploy && e3 dataflow run .repos __WORKSPACE_NAME__",
     "watch": "e3 watch ./src/index.ts .repos __WORKSPACE_NAME__ --start",
+    "shot": "e3-ui shot --from-source src/ui/index.tsx --export surface -o surface.png",
+    "shots:png": "e3-ui shots src --out .shots --json",
+    "shots:html": "e3-ui shots src --out .shots --json --html",
     "lint": "eslint .",
     "clean": "rimraf dist node_modules .venv uv.lock .repos *.tsbuildinfo"
   },
@@ -29,6 +32,7 @@
   },
   "devDependencies": {
     "@elaraai/e3-cli": "workspace:*",
+    "@elaraai/e3-ui-cli": "workspace:*",
     "@elaraai/east-node-cli": "workspace:*",
     "@elaraai/east-c-cli": "workspace:*",
     "@types/node": "^22",

package/templates/e3/template.json

@@ -2,54 +2,104 @@
   "features": {
     "tests": {
       "default": true,
-      "files": ["src/index.spec.ts", "tests/test_unit.py"],
-      "scripts": ["test:ts", "test:export", "test:py"]
+      "files": [
+        "src/index.spec.ts",
+        "tests/test_unit.py"
+      ],
+      "scripts": [
+        "test:ts",
+        "test:export",
+        "test:py"
+      ]
     },
     "ui": {
       "default": false,
-      "files": ["src/ui/index.tsx"],
-      "dependencies": ["@elaraai/east-ui", "@elaraai/e3-ui"]
+      "files": [
+        "src/ui/index.tsx"
+      ],
+      "dependencies": [
+        "@elaraai/east-ui",
+        "@elaraai/e3-ui"
+      ],
+      "devDependencies": [
+        "@elaraai/e3-ui-cli"
+      ],
+      "scripts": [
+        "shot",
+        "shots:png",
+        "shots:html"
+      ]
     },
     "platform": {
       "default": false,
-      "files": ["src/platform/index.ts", "src/platform/example.ts"],
+      "files": [
+        "src/platform/index.ts",
+        "src/platform/example.ts"
+      ],
       "packageJson": {
         "exports": {
           ".": "./dist/index.js",
           "./platform": "./dist/platform/index.js",
           "./package.json": "./package.json"
-        }
+        },
+        "files": [
+          "dist",
+          "platform_module"
+        ]
       }
     },
     "platform-py": {
-      "allOf": ["platform", "runner:east-py"],
+      "allOf": [
+        "platform",
+        "runner:east-py"
+      ],
       "files": [
         "platform_module/__init__.py",
         "platform_module/example.py",
         "src/platform_module.ts",
         "pyproject.platform.toml"
       ],
-      "disable": ["pyproject.toml"],
-      "rename": { "pyproject.platform.toml": "pyproject.toml" }
+      "disable": [
+        "pyproject.toml"
+      ],
+      "rename": {
+        "pyproject.platform.toml": "pyproject.toml"
+      }
     },
     "runner:east-node": {
       "default": true,
-      "devDependencies": ["@elaraai/east-node-cli"]
+      "devDependencies": [
+        "@elaraai/east-node-cli"
+      ]
     },
     "runner:east-c": {
       "default": true,
-      "devDependencies": ["@elaraai/east-c-cli"]
+      "devDependencies": [
+        "@elaraai/east-c-cli"
+      ]
     },
     "runner:east-py": {
       "default": true,
-      "files": ["pyproject.toml", ".python-version", "tests/test_unit.py"],
-      "scripts": ["test:py"],
-      "dependencies": ["@elaraai/east-py-datascience"]
+      "files": [
+        "pyproject.toml",
+        ".python-version",
+        "tests/test_unit.py"
+      ],
+      "scripts": [
+        "test:py"
+      ],
+      "dependencies": [
+        "@elaraai/east-py-datascience"
+      ]
     },
     "eslint": {
       "default": true,
-      "files": ["eslint.config.js"],
-      "scripts": ["lint"],
+      "files": [
+        "eslint.config.js"
+      ],
+      "scripts": [
+        "lint"
+      ],
       "devDependencies": [
         "eslint",
         "@typescript-eslint/eslint-plugin",
@@ -59,29 +109,90 @@
     },
     "editor-diagnostics": {
       "default": true,
-      "devDependencies": ["@elaraai/tsserver-plugin-east"]
+      "devDependencies": [
+        "@elaraai/tsserver-plugin-east"
+      ]
     }
   },
   "indexVariants": [
-    { "when": ["ui", "platform", "runner:east-py"], "source": "src/index.ui.platform.py.ts" },
-    { "when": ["ui", "platform"], "source": "src/index.ui.platform.ts" },
-    { "when": ["ui"], "source": "src/index.ui.ts" },
-    { "when": ["platform", "runner:east-py"], "source": "src/index.platform.py.ts" },
-    { "when": ["platform"], "source": "src/index.platform.ts" },
-    { "when": [], "source": "src/index.ts" }
+    {
+      "when": [
+        "ui",
+        "platform",
+        "runner:east-py"
+      ],
+      "source": "src/index.ui.platform.py.ts"
+    },
+    {
+      "when": [
+        "ui",
+        "platform"
+      ],
+      "source": "src/index.ui.platform.ts"
+    },
+    {
+      "when": [
+        "ui"
+      ],
+      "source": "src/index.ui.ts"
+    },
+    {
+      "when": [
+        "platform",
+        "runner:east-py"
+      ],
+      "source": "src/index.platform.py.ts"
+    },
+    {
+      "when": [
+        "platform"
+      ],
+      "source": "src/index.platform.ts"
+    },
+    {
+      "when": [],
+      "source": "src/index.ts"
+    }
   ],
   "scriptVariants": {
     "test": [
-      { "when": ["tests", "runner:east-py"], "value": "npm run build && npm run test:export && npm run test:py" },
-      { "when": ["tests"], "value": "npm run build && npm run test:export" }
+      {
+        "when": [
+          "tests",
+          "runner:east-py"
+        ],
+        "value": "npm run build && npm run test:export && npm run test:py"
+      },
+      {
+        "when": [
+          "tests"
+        ],
+        "value": "npm run build && npm run test:export"
+      }
     ],
     "setup": [
-      { "when": ["runner:east-py"], "value": "npm install && uv sync" },
-      { "when": [], "value": "npm install" }
+      {
+        "when": [
+          "runner:east-py"
+        ],
+        "value": "npm install && uv sync"
+      },
+      {
+        "when": [],
+        "value": "npm install"
+      }
     ],
     "start": [
-      { "when": ["platform"], "value": "npm run build && npm run deploy && e3 dataflow run .repos __WORKSPACE_NAME__" },
-      { "when": [], "value": "npm run deploy && e3 dataflow run .repos __WORKSPACE_NAME__" }
+      {
+        "when": [
+          "platform"
+        ],
+        "value": "npm run build && npm run deploy && e3 dataflow run .repos __WORKSPACE_NAME__"
+      },
+      {
+        "when": [],
+        "value": "npm run deploy && e3 dataflow run .repos __WORKSPACE_NAME__"
+      }
     ]
   }
 }

package/templates/e3/tsconfig.json

@@ -1,15 +1,22 @@
 {
-  "exclude": ["dist"],
+  "exclude": [
+    "dist"
+  ],
   "compilerOptions": {
     "outDir": "./dist",
     "rootDir": "./src",
     "module": "nodenext",
     "target": "esnext",
-    "lib": ["esnext", "es2024"],
-    "types": ["node"],
+    "lib": [
+      "esnext",
+      "es2024"
+    ],
+    "types": [
+      "node"
+    ],
     "sourceMap": true,
-    "declaration": true,
-    "declarationMap": true,
+    "declaration": false,
+    "declarationMap": false,
     "noUncheckedIndexedAccess": true,
     "exactOptionalPropertyTypes": true,
     "strict": true,
@@ -22,6 +29,10 @@
     "skipLibCheck": true,
     "noErrorTruncation": true,
     "incremental": true,
-    "plugins": [{ "name": "@elaraai/tsserver-plugin-east" }]
+    "plugins": [
+      {
+        "name": "@elaraai/tsserver-plugin-east"
+      }
+    ]
   }
 }