procdeck 1.1.1 → 2.0.0

package/schema.json

@@ -7,22 +7,16 @@
     "$schema": {
       "type": "string",
       "description": "URL of the procdeck JSON schema, for editor completion and validation.",
-      "examples": [
-        "https://unpkg.com/procdeck/schema.json"
-      ]
+      "examples": ["https://unpkg.com/procdeck/schema.json"]
     },
     "name": {
       "type": "string",
       "description": "Deck name — the tab title and the name of the installed web app. Defaults to the config directory's basename.",
-      "examples": [
-        "my-app"
-      ]
+      "examples": ["my-app"]
     },
     "port": {
       "description": "Port for the web UI and the `*.localhost` proxy. Defaults to 4820.",
-      "examples": [
-        4820
-      ],
+      "examples": [4820],
       "type": "integer",
       "allOf": [
         {
@@ -34,16 +28,30 @@
     "host": {
       "type": "string",
       "description": "Interface the UI and proxy bind to. Defaults to \"127.0.0.1\" — loopback only, because the UI types into real terminals. Set \"0.0.0.0\" to reach the deck from another machine or from a container's host.",
-      "examples": [
-        "127.0.0.1",
-        "0.0.0.0"
-      ],
+      "examples": ["127.0.0.1", "0.0.0.0"],
       "allOf": [
         {
           "minLength": 1
         }
       ]
     },
+    "envFile": {
+      "description": "Dotenv file(s), relative to the config file's directory, whose variables every proc and preflight sees — on top of the inherited environment, below each proc's own `env`. Read at every spawn, so a refreshed file reaches a proc on its next restart; a missing file is skipped with a note in the pane.",
+      "examples": [".env", [".env", ".env.local"]],
+      "anyOf": [
+        {
+          "type": "string",
+          "minLength": 1
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      ]
+    },
     "procs": {
       "type": "array",
       "items": {
@@ -52,10 +60,7 @@
           "id": {
             "type": "string",
             "description": "Stable identifier: the pane label, and the proxy subdomain (`api` → http://api.localhost:4820).",
-            "examples": [
-              "api",
-              "web"
-            ],
+            "examples": ["api", "web"],
             "allOf": [
               {
                 "minLength": 1
@@ -65,9 +70,7 @@
           "shell": {
             "type": "string",
             "description": "Command line handed to `$SHELL -c` — pipes, `&&` and globs work. Exactly one of `shell` or `cmd` must be set.",
-            "examples": [
-              "pnpm --filter api dev"
-            ]
+            "examples": ["pnpm --filter api dev"]
           },
           "cmd": {
             "type": "array",
@@ -75,12 +78,7 @@
               "type": "string"
             },
             "description": "argv, executed directly without a shell. Exactly one of `shell` or `cmd` must be set.",
-            "examples": [
-              [
-                "node",
-                "server.js"
-              ]
-            ],
+            "examples": [["node", "server.js"]],
             "allOf": [
               {
                 "minItems": 1
@@ -90,9 +88,7 @@
           "cwd": {
             "type": "string",
             "description": "Working directory; defaults to the config file's directory.",
-            "examples": [
-              "packages/api"
-            ]
+            "examples": ["packages/api"]
           },
           "env": {
             "type": "object",
@@ -114,15 +110,11 @@
           "url": {
             "type": "string",
             "description": "URL this process serves, shown in the UI as a link. Also pins readiness to that URL's port.",
-            "examples": [
-              "http://localhost:${port}"
-            ]
+            "examples": ["http://localhost:${port}"]
           },
           "port": {
             "description": "Pin this proc's assigned `${port}` to a fixed public number instead of a random free one — dependents outside the deck (dotenv files, mobile simulators, teammates' scripts) keep their hardcoded addresses, and an observed proc still binds a hidden internal port behind the HTTP observer. Requires `${port}` somewhere in the spec.",
-            "examples": [
-              8787
-            ],
+            "examples": [8787],
             "type": "integer",
             "allOf": [
               {
@@ -137,18 +129,11 @@
               "type": "string"
             },
             "description": "Ids of procs that must be ready before this one spawns. Declarative: readiness is auto-detected, no port numbers in the config.",
-            "examples": [
-              [
-                "api"
-              ]
-            ]
+            "examples": [["api"]]
           },
           "readyWhen": {
             "type": "string",
-            "enum": [
-              "listening",
-              "started"
-            ],
+            "enum": ["listening", "started"],
             "description": "What \"ready\" means for dependents: \"listening\" (default) — the process tree opened a TCP port; \"started\" — it merely spawned, for procs that never listen."
           },
           "observe": {
@@ -161,9 +146,7 @@
               "shell": {
                 "type": "string",
                 "description": "Shell command; exit 0 lets the proc spawn.",
-                "examples": [
-                  "wrangler whoami"
-                ],
+                "examples": ["wrangler whoami"],
                 "allOf": [
                   {
                     "minLength": 1
@@ -173,21 +156,15 @@
               "expect": {
                 "type": "string",
                 "description": "Regex the check's output must also match. For checks that exit 0 either way — `wrangler whoami` reports \"not authenticated\" with exit 0 — so the config needs no `| grep` pipelines.",
-                "examples": [
-                  "You are logged in"
-                ]
+                "examples": ["You are logged in"]
               },
               "hint": {
                 "type": "string",
                 "description": "What the human should do when the check fails; shown on the blocked pane.",
-                "examples": [
-                  "run `wrangler login`, then Start"
-                ]
+                "examples": ["run `wrangler login`, then Start"]
               }
             },
-            "required": [
-              "shell"
-            ],
+            "required": ["shell"],
             "additionalProperties": false,
             "description": "A gate that must pass before the process spawns — e.g. `wrangler whoami` before a proc whose tree needs a Cloudflare token. Keeps interactive auth flows out of supervised panes, where a restart would kill their callback servers mid-handshake."
           },
@@ -199,17 +176,12 @@
                 "pattern": {
                   "type": "string",
                   "description": "Regex matched against a rolling tail of the pane's output.",
-                  "examples": [
-                    "ERROR",
-                    "not authenticated"
-                  ]
+                  "examples": ["ERROR", "not authenticated"]
                 },
                 "label": {
                   "type": "string",
                   "description": "Badge text shown in the UI when the pattern matches.",
-                  "examples": [
-                    "needs login"
-                  ],
+                  "examples": ["needs login"],
                   "allOf": [
                     {
                       "minLength": 1
@@ -217,26 +189,19 @@
                   ]
                 }
               },
-              "required": [
-                "pattern",
-                "label"
-              ],
+              "required": ["pattern", "label"],
               "additionalProperties": false,
               "description": "A regex watched in the pane output; a match raises a badge in the UI."
             },
             "description": "Output patterns that raise a badge when they appear in the pane."
           }
         },
-        "required": [
-          "id"
-        ],
+        "required": ["id"],
         "additionalProperties": false
       },
       "description": "The processes this deck supervises."
     }
   },
-  "required": [
-    "procs"
-  ],
+  "required": ["procs"],
   "additionalProperties": false
 }

package/dist/chunk-SIAA4J6H.js

@@ -1,21 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __require,
-  __commonJS,
-  __export
-};