undercity 1.0.0

package/actions/dom/hide/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.hide
+ * Hide Element: Add d-none class to matching elements.
+ *
+ * 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: 'dom.hide — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.hide !== 'function') throw new Error('dom.hide is not a function');
+    },
+  },
+
+  {
+    name: 'dom.hide — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.hide?.("#my-div");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/removeClass/action.json

@@ -0,0 +1,22 @@
+{
+  "id": "dom.removeClass",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Remove Class",
+  "desc": "Remove one or more CSS classes.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    },
+    {
+      "name": "classes",
+      "label": "Classes",
+      "type": "text"
+    }
+  ]
+}

package/actions/dom/removeClass/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.removeClass
+ * Remove Class: Remove one or more CSS classes.
+ *
+ * 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: 'dom.removeClass — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.removeClass !== 'function') throw new Error('dom.removeClass is not a function');
+    },
+  },
+
+  {
+    name: 'dom.removeClass — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.removeClass?.("", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/scroll/action.json

@@ -0,0 +1,29 @@
+{
+  "id": "dom.scroll",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Scroll To Element",
+  "desc": "Smoothly scroll the selector into view.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    },
+    {
+      "name": "block",
+      "label": "Position",
+      "type": "select",
+      "options": [
+        "start",
+        "center",
+        "end",
+        "nearest"
+      ],
+      "default": "start"
+    }
+  ]
+}

package/actions/dom/scroll/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.scroll
+ * Scroll To Element: Smoothly scroll the selector into view.
+ *
+ * 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: 'dom.scroll — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.scroll !== 'function') throw new Error('dom.scroll is not a function');
+    },
+  },
+
+  {
+    name: 'dom.scroll — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.scroll?.("", "start");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/setAttr/action.json

@@ -0,0 +1,29 @@
+{
+  "id": "dom.setAttr",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Set Attribute",
+  "desc": "Set an attribute on matching elements.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    },
+    {
+      "name": "attr",
+      "label": "Attribute",
+      "type": "text",
+      "placeholder": "src"
+    },
+    {
+      "name": "value",
+      "label": "Value",
+      "type": "code",
+      "placeholder": "\"https://…\""
+    }
+  ]
+}

package/actions/dom/setAttr/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.setAttr
+ * Set Attribute: Set an attribute on matching elements.
+ *
+ * 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: 'dom.setAttr — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.setAttr !== 'function') throw new Error('dom.setAttr is not a function');
+    },
+  },
+
+  {
+    name: 'dom.setAttr — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.setAttr?.("", "src", "\"https://…\"");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/setHtml/action.json

@@ -0,0 +1,22 @@
+{
+  "id": "dom.setHtml",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Set Inner HTML",
+  "desc": "Set innerHTML of matching elements.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    },
+    {
+      "name": "html",
+      "label": "HTML",
+      "type": "textarea"
+    }
+  ]
+}

package/actions/dom/setHtml/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.setHtml
+ * Set Inner HTML: Set innerHTML of matching elements.
+ *
+ * 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: 'dom.setHtml — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.setHtml !== 'function') throw new Error('dom.setHtml is not a function');
+    },
+  },
+
+  {
+    name: 'dom.setHtml — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.setHtml?.("", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/setStyle/action.json

@@ -0,0 +1,29 @@
+{
+  "id": "dom.setStyle",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Set Inline Style",
+  "desc": "Set a CSS property directly.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    },
+    {
+      "name": "prop",
+      "label": "Property",
+      "type": "text",
+      "placeholder": "color"
+    },
+    {
+      "name": "value",
+      "label": "Value",
+      "type": "text",
+      "placeholder": "#268bd2"
+    }
+  ]
+}

package/actions/dom/setStyle/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.setStyle
+ * Set Inline Style: Set a CSS property directly.
+ *
+ * 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: 'dom.setStyle — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.setStyle !== 'function') throw new Error('dom.setStyle is not a function');
+    },
+  },
+
+  {
+    name: 'dom.setStyle — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.setStyle?.("", "color", "#268bd2");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/setText/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "dom.setText",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Set Text",
+  "desc": "Set the textContent of matching elements.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text",
+      "placeholder": "#my-label"
+    },
+    {
+      "name": "text",
+      "label": "Text",
+      "type": "code",
+      "placeholder": "inventory.firstName"
+    }
+  ]
+}

package/actions/dom/setText/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.setText
+ * Set Text: Set the textContent of matching elements.
+ *
+ * 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: 'dom.setText — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.setText !== 'function') throw new Error('dom.setText is not a function');
+    },
+  },
+
+  {
+    name: 'dom.setText — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.setText?.("#my-label", "inventory.firstName");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/show/action.json

@@ -0,0 +1,18 @@
+{
+  "id": "dom.show",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Show Element",
+  "desc": "Remove d-none / display:none from matching elements.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text",
+      "placeholder": "#my-div"
+    }
+  ]
+}

package/actions/dom/show/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.show
+ * Show Element: Remove d-none / display:none from matching elements.
+ *
+ * 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: 'dom.show — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.show !== 'function') throw new Error('dom.show is not a function');
+    },
+  },
+
+  {
+    name: 'dom.show — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.show?.("#my-div");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/toggle/action.json

@@ -0,0 +1,17 @@
+{
+  "id": "dom.toggle",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Toggle Visibility",
+  "desc": "Toggle d-none on matching elements.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    }
+  ]
+}

package/actions/dom/toggle/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.toggle
+ * Toggle Visibility: Toggle d-none on matching elements.
+ *
+ * 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: 'dom.toggle — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.toggle !== 'function') throw new Error('dom.toggle is not a function');
+    },
+  },
+
+  {
+    name: 'dom.toggle — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.toggle?.("");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/dom/toggleClass/action.json

@@ -0,0 +1,22 @@
+{
+  "id": "dom.toggleClass",
+  "category": "dom",
+  "categoryLabel": "DOM",
+  "icon": "image",
+  "color": "var(--sol-green)",
+  "label": "Toggle Class",
+  "desc": "Toggle a CSS class on matching elements.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "selector",
+      "label": "Selector",
+      "type": "text"
+    },
+    {
+      "name": "class",
+      "label": "Class",
+      "type": "text"
+    }
+  ]
+}

package/actions/dom/toggleClass/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for dom.toggleClass
+ * Toggle Class: Toggle a CSS class on matching elements.
+ *
+ * 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: 'dom.toggleClass — is exported from runtime',
+    run(RT) {
+      const ns = RT.Dom ?? RT.dom;
+      if (!ns) throw new Error('Namespace Dom/dom not found in runtime');
+      if (typeof ns.toggleClass !== 'function') throw new Error('dom.toggleClass is not a function');
+    },
+  },
+
+  {
+    name: 'dom.toggleClass — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Dom.toggleClass?.("", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/event/emit/action.json

@@ -0,0 +1,24 @@
+{
+  "id": "event.emit",
+  "category": "events",
+  "categoryLabel": "Events",
+  "icon": "broadcast",
+  "color": "var(--sol-cyan)",
+  "label": "Emit Event",
+  "desc": "Broadcast a named event on the flow event bus.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "event",
+      "label": "Event name",
+      "type": "text",
+      "placeholder": "user-ready"
+    },
+    {
+      "name": "data",
+      "label": "Payload",
+      "type": "code",
+      "placeholder": "{ id: inventory.userId }"
+    }
+  ]
+}

package/actions/event/emit/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for event.emit
+ * Emit Event: Broadcast a named event on the flow event bus.
+ *
+ * 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: 'event.emit — is exported from runtime',
+    run(RT) {
+      const ns = RT.Event ?? RT.event;
+      if (!ns) throw new Error('Namespace Event/event not found in runtime');
+      if (typeof ns.emit !== 'function') throw new Error('event.emit is not a function');
+    },
+  },
+
+  {
+    name: 'event.emit — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Event.emit?.("user-ready", "{ id: inventory.userId }");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/event/on/action.json

@@ -0,0 +1,23 @@
+{
+  "id": "event.on",
+  "category": "events",
+  "categoryLabel": "Events",
+  "icon": "broadcast",
+  "color": "var(--sol-cyan)",
+  "label": "Listen for Event",
+  "desc": "Register a handler for an event. Auto-unsubscribed on room exit.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "event",
+      "label": "Event name",
+      "type": "text"
+    },
+    {
+      "name": "handler",
+      "label": "Handler fn",
+      "type": "code",
+      "placeholder": "(data) => { /* ... */ }"
+    }
+  ]
+}

package/actions/event/on/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for event.on
+ * Listen for Event: Register a handler for an event. Auto-unsubscribed on room exit.
+ *
+ * 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: 'event.on — is exported from runtime',
+    run(RT) {
+      const ns = RT.Event ?? RT.event;
+      if (!ns) throw new Error('Namespace Event/event not found in runtime');
+      if (typeof ns.on !== 'function') throw new Error('event.on is not a function');
+    },
+  },
+
+  {
+    name: 'event.on — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Event.on?.("", "(data) => { /* ... */ }");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];