undercity 1.0.0

package/actions/forms/setCheck/action.json

@@ -0,0 +1,23 @@
+{
+  "id": "form.setCheck",
+  "category": "forms",
+  "categoryLabel": "Forms",
+  "icon": "clipboard-check",
+  "color": "var(--sol-yellow)",
+  "label": "Set Checkbox",
+  "desc": "Check or uncheck a checkbox by name.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "name",
+      "label": "Field name",
+      "type": "text"
+    },
+    {
+      "name": "checked",
+      "label": "Checked",
+      "type": "boolean",
+      "default": true
+    }
+  ]
+}

package/actions/forms/setCheck/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for form.setCheck
+ * Set Checkbox: Check or uncheck a checkbox by name.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'form.setCheck — is exported from runtime',
+    run(RT) {
+      const ns = RT.Form ?? RT.form;
+      if (!ns) throw new Error('Namespace Form/form not found in runtime');
+      if (typeof ns.setCheck !== 'function') throw new Error('form.setCheck is not a function');
+    },
+  },
+
+  {
+    name: 'form.setCheck — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Form.setCheck?.("", true);
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/forms/setError/action.json

@@ -0,0 +1,22 @@
+{
+  "id": "form.setError",
+  "category": "forms",
+  "categoryLabel": "Forms",
+  "icon": "clipboard-check",
+  "color": "var(--sol-yellow)",
+  "label": "Set Field Error",
+  "desc": "Show an error message under a field using [data-error=\"name\"].",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "name",
+      "label": "Field name",
+      "type": "text"
+    },
+    {
+      "name": "msg",
+      "label": "Message",
+      "type": "text"
+    }
+  ]
+}

package/actions/forms/setError/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for form.setError
+ * Set Field Error: Show an error message under a field using [data-error="name"].
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'form.setError — is exported from runtime',
+    run(RT) {
+      const ns = RT.Form ?? RT.form;
+      if (!ns) throw new Error('Namespace Form/form not found in runtime');
+      if (typeof ns.setError !== 'function') throw new Error('form.setError is not a function');
+    },
+  },
+
+  {
+    name: 'form.setError — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Form.setError?.("", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/forms/setField/action.js

@@ -0,0 +1,14 @@
+/**
+ * form.setField — runtime implementation
+ *
+ * Sets a form input's value. When called via a step with an inventory-key param,
+ * runPayload resolves { $$inv: "key" } → Inventory.get("key") before passing here.
+ * So this function always receives the resolved value.
+ *
+ * In runtime.js, this lives inside the Actions object:
+ *
+ *   setField(name, val) {
+ *     const el = document.querySelector(`[name="${name}"]`);
+ *     if (el) el.value = val ?? '';
+ *   },
+ */

package/actions/forms/setField/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "form.setField",
+  "category": "forms",
+  "categoryLabel": "Forms",
+  "icon": "clipboard-check",
+  "color": "var(--sol-yellow)",
+  "label": "Set Field Value",
+  "desc": "Set a form field's value from an inventory key once when this step runs. Use Configure mode for JS expressions.",
+  "version": "2.0.0",
+  "params": [
+    {
+      "name": "name",
+      "label": "Field name",
+      "type": "text",
+      "placeholder": "email"
+    },
+    {
+      "name": "value",
+      "label": "Inventory key",
+      "type": "inventory-key",
+      "placeholder": "userEmail"
+    }
+  ]
+}

package/actions/forms/setField/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for form.setField
+ * Set Field Value: Programmatically set a form field value.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'form.setField — is exported from runtime',
+    run(RT) {
+      const ns = RT.Form ?? RT.form;
+      if (!ns) throw new Error('Namespace Form/form not found in runtime');
+      if (typeof ns.setField !== 'function') throw new Error('form.setField is not a function');
+    },
+  },
+
+  {
+    name: 'form.setField — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Form.setField?.("", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/forms/submit/action.json

@@ -0,0 +1,18 @@
+{
+  "id": "form.submit",
+  "category": "forms",
+  "categoryLabel": "Forms",
+  "icon": "clipboard-check",
+  "color": "var(--sol-yellow)",
+  "label": "Submit Form",
+  "desc": "Programmatically submit a form element.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Form",
+      "type": "text",
+      "placeholder": "#my-form"
+    }
+  ]
+}

package/actions/forms/submit/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for form.submit
+ * Submit Form: Programmatically submit a form element.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'form.submit — is exported from runtime',
+    run(RT) {
+      const ns = RT.Form ?? RT.form;
+      if (!ns) throw new Error('Namespace Form/form not found in runtime');
+      if (typeof ns.submit !== 'function') throw new Error('form.submit is not a function');
+    },
+  },
+
+  {
+    name: 'form.submit — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Form.submit?.("#my-form");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/forms/validate/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "form.validate",
+  "category": "forms",
+  "categoryLabel": "Forms",
+  "icon": "clipboard-check",
+  "color": "var(--sol-yellow)",
+  "label": "Validate Form",
+  "desc": "Run HTML5 constraint validation and show Bootstrap invalid-feedback.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Form selector",
+      "type": "text",
+      "placeholder": "#my-form"
+    },
+    {
+      "name": "into",
+      "label": "Result var",
+      "type": "text",
+      "placeholder": "isValid"
+    }
+  ]
+}

package/actions/forms/validate/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for form.validate
+ * Validate Form: Run HTML5 constraint validation and show Bootstrap invalid-feedback.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'form.validate — is exported from runtime',
+    run(RT) {
+      const ns = RT.Form ?? RT.form;
+      if (!ns) throw new Error('Namespace Form/form not found in runtime');
+      if (typeof ns.validate !== 'function') throw new Error('form.validate is not a function');
+    },
+  },
+
+  {
+    name: 'form.validate — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Form.validate?.("#my-form");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/http/delete/action.json

@@ -0,0 +1,22 @@
+{
+  "id": "http.delete",
+  "category": "http",
+  "categoryLabel": "HTTP",
+  "icon": "globe",
+  "color": "var(--sol-violet)",
+  "label": "HTTP DELETE",
+  "desc": "Send a DELETE request.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "url",
+      "label": "URL",
+      "type": "code"
+    },
+    {
+      "name": "into",
+      "label": "Store in",
+      "type": "text"
+    }
+  ]
+}

package/actions/http/delete/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for http.delete
+ * HTTP DELETE: Send a DELETE request.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'http.delete — is exported from runtime',
+    run(RT) {
+      const ns = RT.Http ?? RT.http;
+      if (!ns) throw new Error('Namespace Http/http not found in runtime');
+      if (typeof ns.delete !== 'function') throw new Error('http.delete is not a function');
+    },
+  },
+
+  {
+    name: 'http.delete — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Http.delete?.("");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/http/get/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "http.get",
+  "category": "http",
+  "categoryLabel": "HTTP",
+  "icon": "globe",
+  "color": "var(--sol-violet)",
+  "label": "HTTP GET",
+  "desc": "Fetch JSON from a URL. Stores response in inventory.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "url",
+      "label": "URL",
+      "type": "code",
+      "placeholder": "\"/api/user\""
+    },
+    {
+      "name": "into",
+      "label": "Store in",
+      "type": "text",
+      "placeholder": "result"
+    }
+  ]
+}

package/actions/http/get/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for http.get
+ * HTTP GET: Fetch JSON from a URL. Stores response in inventory.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'http.get — is exported from runtime',
+    run(RT) {
+      const ns = RT.Http ?? RT.http;
+      if (!ns) throw new Error('Namespace Http/http not found in runtime');
+      if (typeof ns.get !== 'function') throw new Error('http.get is not a function');
+    },
+  },
+
+  {
+    name: 'http.get — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Http.get?.("\"/api/user\"");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/http/post/action.json

@@ -0,0 +1,30 @@
+{
+  "id": "http.post",
+  "category": "http",
+  "categoryLabel": "HTTP",
+  "icon": "globe",
+  "color": "var(--sol-violet)",
+  "label": "HTTP POST",
+  "desc": "POST JSON body to a URL.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "url",
+      "label": "URL",
+      "type": "code",
+      "placeholder": "\"/api/login\""
+    },
+    {
+      "name": "body",
+      "label": "Body",
+      "type": "code",
+      "placeholder": "{ email, password }"
+    },
+    {
+      "name": "into",
+      "label": "Store in",
+      "type": "text",
+      "placeholder": "result"
+    }
+  ]
+}

package/actions/http/post/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for http.post
+ * HTTP POST: POST JSON body to a URL.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'http.post — is exported from runtime',
+    run(RT) {
+      const ns = RT.Http ?? RT.http;
+      if (!ns) throw new Error('Namespace Http/http not found in runtime');
+      if (typeof ns.post !== 'function') throw new Error('http.post is not a function');
+    },
+  },
+
+  {
+    name: 'http.post — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Http.post?.("\"/api/login\"", "{ email, password }");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/http/put/action.json

@@ -0,0 +1,27 @@
+{
+  "id": "http.put",
+  "category": "http",
+  "categoryLabel": "HTTP",
+  "icon": "globe",
+  "color": "var(--sol-violet)",
+  "label": "HTTP PUT",
+  "desc": "PUT JSON body to a URL.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "url",
+      "label": "URL",
+      "type": "code"
+    },
+    {
+      "name": "body",
+      "label": "Body",
+      "type": "code"
+    },
+    {
+      "name": "into",
+      "label": "Store in",
+      "type": "text"
+    }
+  ]
+}

package/actions/http/put/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for http.put
+ * HTTP PUT: PUT JSON body to a URL.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'http.put — is exported from runtime',
+    run(RT) {
+      const ns = RT.Http ?? RT.http;
+      if (!ns) throw new Error('Namespace Http/http not found in runtime');
+      if (typeof ns.put !== 'function') throw new Error('http.put is not a function');
+    },
+  },
+
+  {
+    name: 'http.put — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Http.put?.("", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/http/upload/action.json

@@ -0,0 +1,35 @@
+{
+  "id": "http.upload",
+  "category": "http",
+  "categoryLabel": "HTTP",
+  "icon": "globe",
+  "color": "var(--sol-violet)",
+  "label": "Upload File (multipart)",
+  "desc": "POST a file from inventory as multipart/form-data.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "url",
+      "label": "URL",
+      "type": "code"
+    },
+    {
+      "name": "fileVar",
+      "label": "File var",
+      "type": "text",
+      "placeholder": "uploadedVideo"
+    },
+    {
+      "name": "fieldName",
+      "label": "Field name",
+      "type": "text",
+      "placeholder": "file"
+    },
+    {
+      "name": "into",
+      "label": "Store in",
+      "type": "text",
+      "placeholder": "uploadResult"
+    }
+  ]
+}

package/actions/http/upload/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for http.upload
+ * Upload File (multipart): POST a file from inventory as multipart/form-data.
+ *
+ * Each test receives (RT, sandbox) where:
+ *   RT      — the generated runtime module (Inventory, Navigator, Actions, ...)
+ *   sandbox — a <div> containing #pw-content, #pw-form, #pw-loading
+ */
+
+export const tests = [
+
+  {
+    name: 'http.upload — is exported from runtime',
+    run(RT) {
+      const ns = RT.Http ?? RT.http;
+      if (!ns) throw new Error('Namespace Http/http not found in runtime');
+      if (typeof ns.upload !== 'function') throw new Error('http.upload is not a function');
+    },
+  },
+
+  {
+    name: 'http.upload — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Http.upload?.("", "uploadedVideo", "file");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];