undercity 1.0.0

package/actions/user/carry/action.json

@@ -0,0 +1,25 @@
+{
+  "id": "user.carry",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Carry Form Result",
+  "desc": "Serialize a form into inventory so the user carries the answers.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "formSelector",
+      "label": "Form",
+      "type": "text",
+      "placeholder": "#my-form"
+    },
+    {
+      "name": "namespace",
+      "label": "Namespace",
+      "type": "text",
+      "placeholder": "loginForm",
+      "default": ""
+    }
+  ]
+}

package/actions/user/carry/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for user.carry
+ * Carry Form Result: Serialize a form into inventory so the user carries the answers.
+ *
+ * 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: 'user.carry — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.carry !== 'function') throw new Error('user.carry is not a function');
+    },
+  },
+
+  {
+    name: 'user.carry — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.User.carry?.("#my-form", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/check/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "user.check",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Check Condition",
+  "desc": "Evaluate a JS expression against inventory. Branch via diamond.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "expr",
+      "label": "Expression",
+      "type": "code",
+      "placeholder": "inventory.age >= 18"
+    },
+    {
+      "name": "into",
+      "label": "Into var",
+      "type": "text",
+      "placeholder": "isAdult"
+    }
+  ]
+}

package/actions/user/check/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for user.check
+ * Check Condition: Evaluate a JS expression against inventory. Branch via diamond.
+ *
+ * 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: 'user.check — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.check !== 'function') throw new Error('user.check is not a function');
+    },
+  },
+
+  {
+    name: 'user.check — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.User.check?.("inventory.age >= 18");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/clear/action.json

@@ -0,0 +1,11 @@
+{
+  "id": "user.clear",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Clear Inventory",
+  "desc": "Wipe everything the user carries.",
+  "version": "1.0.0",
+  "params": []
+}

package/actions/user/clear/action.test.js

@@ -0,0 +1,35 @@
+/**
+ * action.test.js — Unit tests for user.clear
+ * Clear Inventory: Wipe everything the user carries.
+ *
+ * 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: 'user.clear — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.clear !== 'function') throw new Error('user.clear is not a function');
+    },
+  },
+
+  {
+    name: 'user.clear — can be called with no arguments',
+    async run(RT, sandbox) {
+      // Smoke test: calling the action should not throw
+      // (may produce DOM changes or be a no-op depending on state)
+      try {
+        await RT.User.clear?.();
+      } catch (e) {
+        // Some actions require specific DOM state — acceptable
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/delete/action.json

@@ -0,0 +1,17 @@
+{
+  "id": "user.delete",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Delete Inventory Item",
+  "desc": "Remove a key from the user's inventory.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "key",
+      "label": "Key",
+      "type": "text"
+    }
+  ]
+}

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

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for user.delete
+ * Delete Inventory Item: Remove a key from the user's 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: 'user.delete — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.delete !== 'function') throw new Error('user.delete is not a function');
+    },
+  },
+
+  {
+    name: 'user.delete — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.User.delete?.("");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/dump/action.json

@@ -0,0 +1,11 @@
+{
+  "id": "user.dump",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Dump Inventory to Console",
+  "desc": "console.log the full user inventory (debug).",
+  "version": "1.0.0",
+  "params": []
+}

package/actions/user/dump/action.test.js

@@ -0,0 +1,35 @@
+/**
+ * action.test.js — Unit tests for user.dump
+ * Dump Inventory to Console: console.log the full user inventory (debug).
+ *
+ * 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: 'user.dump — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.dump !== 'function') throw new Error('user.dump is not a function');
+    },
+  },
+
+  {
+    name: 'user.dump — can be called with no arguments',
+    async run(RT, sandbox) {
+      // Smoke test: calling the action should not throw
+      // (may produce DOM changes or be a no-op depending on state)
+      try {
+        await RT.User.dump?.();
+      } catch (e) {
+        // Some actions require specific DOM state — acceptable
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/get/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "user.get",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Read Inventory Item",
+  "desc": "Read a value and optionally alias it.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "key",
+      "label": "Key",
+      "type": "text",
+      "placeholder": "myKey"
+    },
+    {
+      "name": "into",
+      "label": "Into var",
+      "type": "text",
+      "placeholder": "localAlias"
+    }
+  ]
+}

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

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for user.get
+ * Read Inventory Item: Read a value and optionally alias it.
+ *
+ * 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: 'user.get — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.get !== 'function') throw new Error('user.get is not a function');
+    },
+  },
+
+  {
+    name: 'user.get — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.User.get?.("myKey");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/merge/action.json

@@ -0,0 +1,18 @@
+{
+  "id": "user.merge",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Merge into Inventory",
+  "desc": "Merge an object (e.g., API response) into the user inventory.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "from",
+      "label": "Source var",
+      "type": "text",
+      "placeholder": "responseVar"
+    }
+  ]
+}

package/actions/user/merge/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for user.merge
+ * Merge into Inventory: Merge an object (e.g., API response) into the user 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: 'user.merge — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.merge !== 'function') throw new Error('user.merge is not a function');
+    },
+  },
+
+  {
+    name: 'user.merge — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.User.merge?.("responseVar");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/user/set/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "user.set",
+  "category": "user",
+  "categoryLabel": "User",
+  "icon": "backpack",
+  "color": "var(--sol-cyan)",
+  "label": "Set Inventory Item",
+  "desc": "Store a key/value in the user's inventory.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "key",
+      "label": "Key",
+      "type": "text",
+      "placeholder": "myKey"
+    },
+    {
+      "name": "value",
+      "label": "Value",
+      "type": "code",
+      "placeholder": "\"hello\" or inventory.email"
+    }
+  ]
+}

package/actions/user/set/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for user.set
+ * Set Inventory Item: Store a key/value in the user's 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: 'user.set — is exported from runtime',
+    run(RT) {
+      const ns = RT.User ?? RT.user;
+      if (!ns) throw new Error('Namespace User/user not found in runtime');
+      if (typeof ns.set !== 'function') throw new Error('user.set is not a function');
+    },
+  },
+
+  {
+    name: 'user.set — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.User.set?.("myKey", "\"hello\" or inventory.email");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];