undercity 1.0.0

package/actions/render/divider/action.json

@@ -0,0 +1,11 @@
+{
+  "id": "render.divider",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Divider",
+  "desc": "Append a horizontal rule.",
+  "version": "1.0.0",
+  "params": []
+}

package/actions/render/divider/action.test.js

@@ -0,0 +1,35 @@
+/**
+ * action.test.js — Unit tests for render.divider
+ * Divider: Append a horizontal rule.
+ *
+ * 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: 'render.divider — is exported from runtime',
+    run(RT) {
+      const ns = RT.Render ?? RT.render;
+      if (!ns) throw new Error('Namespace Render/render not found in runtime');
+      if (typeof ns.divider !== 'function') throw new Error('render.divider is not a function');
+    },
+  },
+
+  {
+    name: 'render.divider — 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.Render.divider?.();
+      } catch (e) {
+        // Some actions require specific DOM state — acceptable
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/render/field/action.js

@@ -0,0 +1,17 @@
+/** render.field — Append a Bootstrap form field (label + input + error div) */
+import { _container, _escA } from '../../_shared/container.js';
+
+export function field(name = '', label = '', type = 'text', placeholder = '', autocomplete = '', required = false) {
+  const id  = `pw-field-${_escA(name)}`;
+  const req = Boolean(required) || (String(required) === 'true');
+  const div = document.createElement('div');
+  div.className = 'mb-3';
+  div.innerHTML = `<label for="${id}" class="form-label">${String(label ?? '')}</label>
+<input type="${_escA(type)}" id="${id}" name="${_escA(name)}"
+  class="form-control pw-input"
+  placeholder="${_escA(placeholder)}"
+  ${autocomplete ? `autocomplete="${_escA(autocomplete)}"` : ''}${req ? ' aria-required="true" required' : ''}
+  aria-describedby="${id}-error">
+<div id="${id}-error" class="invalid-feedback" data-error="${_escA(name)}"></div>`;
+  _container().appendChild(div);
+}

package/actions/render/field/action.json

@@ -0,0 +1,59 @@
+{
+  "id": "render.field",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Form Field",
+  "desc": "Append a labelled Bootstrap input field.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "name",
+      "label": "Field name",
+      "type": "text",
+      "placeholder": "email"
+    },
+    {
+      "name": "label",
+      "label": "Label",
+      "type": "text",
+      "placeholder": "Email Address"
+    },
+    {
+      "name": "type",
+      "label": "Input type",
+      "type": "select",
+      "options": [
+        "text",
+        "email",
+        "password",
+        "tel",
+        "url",
+        "number",
+        "date",
+        "search"
+      ],
+      "default": "text"
+    },
+    {
+      "name": "placeholder",
+      "label": "Placeholder",
+      "type": "text",
+      "placeholder": "you@example.com"
+    },
+    {
+      "name": "autocomplete",
+      "label": "Autocomplete",
+      "type": "text",
+      "placeholder": "email",
+      "default": ""
+    },
+    {
+      "name": "required",
+      "label": "Required",
+      "type": "boolean",
+      "default": true
+    }
+  ]
+}

package/actions/render/field/action.test.js

@@ -0,0 +1,57 @@
+/**
+ * action.test.js — Tests for render.field
+ */
+import { field } from './action.js';
+
+export const tests = [
+
+  {
+    name: 'render.field — exported from runtime',
+    run(RT) {
+      if (!RT.Render?.field) throw new Error('RT.Render.field not found');
+    },
+  },
+
+  {
+    name: 'render.field — appends label and input',
+    run() {
+      field('email', 'Email Address', 'email', 'you@example.com');
+      const ct = document.getElementById('pw-content');
+      const label = ct.querySelector('label');
+      const input = ct.querySelector('input[type="email"]');
+      if (!label) throw new Error('No <label>');
+      if (!label.textContent.includes('Email Address')) throw new Error(`Label: ${label.textContent}`);
+      if (!input) throw new Error('No <input type="email">');
+      if (input.name !== 'email') throw new Error(`input.name: ${input.name}`);
+      if (!input.placeholder.includes('you@example.com')) throw new Error(`placeholder: ${input.placeholder}`);
+    },
+  },
+
+  {
+    name: 'render.field — required flag sets required attr',
+    run() {
+      field('pw', 'Password', 'password', '', '', true);
+      const input = document.getElementById('pw-content').querySelector('input[type="password"]');
+      if (!input?.required) throw new Error('Expected required');
+    },
+  },
+
+  {
+    name: 'render.field — has form-control class',
+    run() {
+      field('username', 'Username');
+      const input = document.getElementById('pw-content').querySelector('input');
+      if (!input?.classList.contains('form-control')) throw new Error('Missing form-control');
+    },
+  },
+
+  {
+    name: 'render.field — error div has correct data-error attr',
+    run() {
+      field('myfield', 'My Field');
+      const errDiv = document.getElementById('pw-content').querySelector('[data-error="myfield"]');
+      if (!errDiv) throw new Error('No element with data-error="myfield"');
+    },
+  },
+
+];

package/actions/render/link/action.js

@@ -0,0 +1,20 @@
+/** render.link — Append a small centred text link */
+import { _container } from '../../_shared/container.js';
+
+export function link(text = '', target = '', prefix = '') {
+  const p = document.createElement('p');
+  p.className = 'text-center text-muted small mt-3 mb-0';
+  const a = document.createElement('a');
+  a.href = '#';
+  a.className = 'text-info';
+  a.textContent = String(text);
+  a.addEventListener('click', e => {
+    e.preventDefault();
+    const fn = 'goTo_' + String(target).replace(/[^a-zA-Z0-9]/g, '_');
+    if (typeof window[fn] === 'function') window[fn]();
+    else if (target && typeof window.Navigator !== 'undefined') window.Navigator.goto(target);
+  });
+  if (prefix) p.append(String(prefix) + ' ');
+  p.appendChild(a);
+  _container().appendChild(p);
+}

package/actions/render/link/action.json

@@ -0,0 +1,30 @@
+{
+  "id": "render.link",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Link / Text Link",
+  "desc": "Append a small centred text link that navigates to a room.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "text",
+      "label": "Link text",
+      "type": "text",
+      "placeholder": "Forgot password?"
+    },
+    {
+      "name": "target",
+      "label": "Room",
+      "type": "room",
+      "placeholder": "forgot"
+    },
+    {
+      "name": "prefix",
+      "label": "Prefix text (optional)",
+      "type": "text",
+      "default": ""
+    }
+  ]
+}

package/actions/render/link/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for render.link
+ * Link / Text Link: Append a small centred text link that navigates to a room.
+ *
+ * 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: 'render.link — is exported from runtime',
+    run(RT) {
+      const ns = RT.Render ?? RT.render;
+      if (!ns) throw new Error('Namespace Render/render not found in runtime');
+      if (typeof ns.link !== 'function') throw new Error('render.link is not a function');
+    },
+  },
+
+  {
+    name: 'render.link — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Render.link?.("Forgot password?", "forgot", "");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/render/markdown/action.json

@@ -0,0 +1,18 @@
+{
+  "id": "render.markdown",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Markdown Block",
+  "desc": "Append a rendered Markdown block to the page.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "content",
+      "label": "Markdown",
+      "type": "textarea",
+      "placeholder": "**Bold** and _italic_…"
+    }
+  ]
+}

package/actions/render/markdown/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for render.markdown
+ * Markdown Block: Append a rendered Markdown block to the page.
+ *
+ * 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: 'render.markdown — is exported from runtime',
+    run(RT) {
+      const ns = RT.Render ?? RT.render;
+      if (!ns) throw new Error('Namespace Render/render not found in runtime');
+      if (typeof ns.markdown !== 'function') throw new Error('render.markdown is not a function');
+    },
+  },
+
+  {
+    name: 'render.markdown — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Render.markdown?.("**Bold** and _italic_…");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/render/paragraph/action.js

@@ -0,0 +1,9 @@
+/** render.paragraph — Append a styled paragraph */
+import { _container } from '../../_shared/container.js';
+
+export function paragraph(text, style = 'muted') {
+  const p = document.createElement('p');
+  p.className = style === 'body' ? 'mb-3' : `text-${style} small mb-2`;
+  p.textContent = String(text ?? '');
+  _container().appendChild(p);
+}

package/actions/render/paragraph/action.json

@@ -0,0 +1,32 @@
+{
+  "id": "render.paragraph",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Paragraph",
+  "desc": "Append a styled paragraph of text.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "text",
+      "label": "Text",
+      "type": "textarea",
+      "placeholder": "Body copy…"
+    },
+    {
+      "name": "style",
+      "label": "Style",
+      "type": "select",
+      "options": [
+        "muted",
+        "info",
+        "success",
+        "warning",
+        "danger",
+        "body"
+      ],
+      "default": "muted"
+    }
+  ]
+}

package/actions/render/paragraph/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for render.paragraph
+ * Paragraph: Append a styled paragraph of text.
+ *
+ * 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: 'render.paragraph — is exported from runtime',
+    run(RT) {
+      const ns = RT.Render ?? RT.render;
+      if (!ns) throw new Error('Namespace Render/render not found in runtime');
+      if (typeof ns.paragraph !== 'function') throw new Error('render.paragraph is not a function');
+    },
+  },
+
+  {
+    name: 'render.paragraph — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Render.paragraph?.("Body copy…", "muted");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/render/section/action.js

@@ -0,0 +1,10 @@
+/** render.section — Append an uppercase section label */
+import { _container } from '../../_shared/container.js';
+
+export function section(title) {
+  const div = document.createElement('div');
+  div.className = 'text-uppercase fw-semibold text-muted small mt-3 mb-1';
+  div.style.letterSpacing = '.08em';
+  div.textContent = String(title ?? '');
+  _container().appendChild(div);
+}

package/actions/render/section/action.json

@@ -0,0 +1,18 @@
+{
+  "id": "render.section",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Section Header",
+  "desc": "Append a small uppercase section divider label.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "title",
+      "label": "Title",
+      "type": "text",
+      "placeholder": "Personal Details"
+    }
+  ]
+}

package/actions/render/section/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for render.section
+ * Section Header: Append a small uppercase section divider label.
+ *
+ * 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: 'render.section — is exported from runtime',
+    run(RT) {
+      const ns = RT.Render ?? RT.render;
+      if (!ns) throw new Error('Namespace Render/render not found in runtime');
+      if (typeof ns.section !== 'function') throw new Error('render.section is not a function');
+    },
+  },
+
+  {
+    name: 'render.section — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Render.section?.("Personal Details");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/render/subtitle/action.js

@@ -0,0 +1,9 @@
+/** render.subtitle — Append a muted subtitle paragraph */
+import { _container } from '../../_shared/container.js';
+
+export function subtitle(text) {
+  const p = document.createElement('p');
+  p.className = 'text-muted small mb-4';
+  p.textContent = String(text ?? '');
+  _container().appendChild(p);
+}

package/actions/render/subtitle/action.json

@@ -0,0 +1,18 @@
+{
+  "id": "render.subtitle",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Subtitle",
+  "desc": "Append a muted subtitle paragraph.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "text",
+      "label": "Text",
+      "type": "text",
+      "placeholder": "Welcome back. Enter your credentials."
+    }
+  ]
+}

package/actions/render/subtitle/action.test.js

@@ -0,0 +1,32 @@
+/**
+ * action.test.js — Unit tests for render.subtitle
+ * Subtitle: Append a muted subtitle paragraph.
+ *
+ * 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: 'render.subtitle — is exported from runtime',
+    run(RT) {
+      const ns = RT.Render ?? RT.render;
+      if (!ns) throw new Error('Namespace Render/render not found in runtime');
+      if (typeof ns.subtitle !== 'function') throw new Error('render.subtitle is not a function');
+    },
+  },
+
+  {
+    name: 'render.subtitle — can be called with default params',
+    async run(RT, sandbox) {
+      try {
+        await RT.Render.subtitle?.("Welcome back. Enter your credentials.");
+      } catch (e) {
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];

package/actions/render/title/action.js

@@ -0,0 +1,9 @@
+/** render.title — Append a heading to #pw-content */
+import { _container } from '../../_shared/container.js';
+
+export function title(text, size = 'h2') {
+  const el = document.createElement(size);
+  el.className = 'pw-heading mb-1';
+  el.textContent = String(text ?? '');
+  _container().appendChild(el);
+}

package/actions/render/title/action.json

@@ -0,0 +1,30 @@
+{
+  "id": "render.title",
+  "category": "render",
+  "categoryLabel": "Page Builder",
+  "icon": "layout-text-window",
+  "color": "var(--sol-violet)",
+  "label": "Page Title",
+  "desc": "Append a heading to the page content area.",
+  "version": "1.0.0",
+  "params": [
+    {
+      "name": "text",
+      "label": "Title text",
+      "type": "text",
+      "placeholder": "Sign In"
+    },
+    {
+      "name": "size",
+      "label": "Size",
+      "type": "select",
+      "options": [
+        "h1",
+        "h2",
+        "h3",
+        "h4"
+      ],
+      "default": "h2"
+    }
+  ]
+}

package/actions/render/title/action.test.js

@@ -0,0 +1,44 @@
+/**
+ * action.test.js — Tests for render.title
+ * Imports action.js directly for self-contained testing.
+ */
+import { title } from './action.js';
+
+export const tests = [
+
+  {
+    name: 'render.title — is exported from runtime',
+    run(RT) {
+      if (!RT.Render?.title) throw new Error('RT.Render.title not found');
+    },
+  },
+
+  {
+    name: 'render.title — appends <h2> with correct text',
+    run() {
+      title('Hello World');
+      const el = document.getElementById('pw-content').querySelector('h2');
+      if (!el) throw new Error('Expected <h2> in #pw-content');
+      if (!el.textContent.includes('Hello World')) throw new Error(`Got: ${el.textContent}`);
+    },
+  },
+
+  {
+    name: 'render.title — respects custom heading size',
+    run() {
+      title('Big', 'h1');
+      if (!document.getElementById('pw-content').querySelector('h1'))
+        throw new Error('Expected <h1>');
+    },
+  },
+
+  {
+    name: 'render.title — has pw-heading class',
+    run() {
+      title('Styled');
+      const el = document.getElementById('pw-content').querySelector('h2');
+      if (!el?.classList.contains('pw-heading')) throw new Error('Missing pw-heading class');
+    },
+  },
+
+];

package/actions/session/clear/action.json

@@ -0,0 +1,11 @@
+{
+  "id": "session.clear",
+  "category": "session",
+  "categoryLabel": "Session",
+  "icon": "floppy",
+  "color": "var(--sol-base1)",
+  "label": "Clear Session",
+  "desc": "Remove all Undercity keys from sessionStorage.",
+  "version": "1.0.0",
+  "params": []
+}

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

@@ -0,0 +1,35 @@
+/**
+ * action.test.js — Unit tests for session.clear
+ * Clear Session: Remove all Undercity keys from sessionStorage.
+ *
+ * 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: 'session.clear — is exported from runtime',
+    run(RT) {
+      const ns = RT.Session ?? RT.session;
+      if (!ns) throw new Error('Namespace Session/session not found in runtime');
+      if (typeof ns.clear !== 'function') throw new Error('session.clear is not a function');
+    },
+  },
+
+  {
+    name: 'session.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.Session.clear?.();
+      } catch (e) {
+        // Some actions require specific DOM state — acceptable
+        if (e instanceof TypeError) throw e;
+      }
+    },
+  },
+
+];