jsgui3-server 0.0.148 → 0.0.149

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-bfe89d2c78ed44f95ed7dd73.js

@@ -0,0 +1,40 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+    Active_HTML_Document: require('/mnt/c/Users/james/Documents/repos/jsgui3-html/controls/organised/1-standard/5-ui/Active_HTML_Document'),
+    Button: require('/mnt/c/Users/james/Documents/repos/jsgui3-html/controls/organised/0-core/0-basic/0-native-compositional/button')
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-c06f04806a1e688e1187110c.js

@@ -0,0 +1,40 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+    Active_HTML_Document: require('/mnt/c/Users/james/Documents/repos/jsgui3-html/controls/organised/1-standard/5-ui/Active_HTML_Document'),
+    Window: require('/mnt/c/Users/james/Documents/repos/jsgui3-html/controls/organised/1-standard/6-layout/window')
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-c3f3adf904f585afc544b96a.js

@@ -0,0 +1,39 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+    Window: require('/mnt/c/Users/james/Documents/repos/jsgui3-html/controls/organised/1-standard/6-layout/window')
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-d45acb873e1d8e32d5e60f2e.js

@@ -0,0 +1,39 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-db06f132533706f4a0163b8c.js

@@ -0,0 +1,39 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-f660f40d78b135fc8560a862.js

@@ -0,0 +1,39 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/.jsgui3-server-cache/jsgui3-html-shims/jsgui3-html-controls-shim-f9dee4ec18a96e09bee06bae.js

@@ -0,0 +1,39 @@
+const jsgui = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/html-core/html-core.js');
+jsgui.Router = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/router/router.js');
+jsgui.Resource = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/resource.js');
+jsgui.Resource_Pool = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/pool.js');
+jsgui.Resource.Data_KV = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-kv-resource.js');
+jsgui.Resource.Data_Transform = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/data-transform-resource.js');
+jsgui.Resource.Compilation = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compilation-resource.js');
+jsgui.Resource.Compiler = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/resource/compiler-resource.js');
+jsgui.gfx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/node_modules/jsgui3-gfx-core/core/gfx-core.js');
+jsgui.Resource.load_compiler = (name, jsfn, options) => {
+    const compiler_name = name;
+    const compiler_fn = jsfn;
+    const compiler_options = options || {};
+    if (typeof compiler_name !== 'string' || compiler_name.length === 0) {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a non-empty string name');
+    }
+    if (typeof compiler_fn !== 'function') {
+        throw new Error('Resource.load_compiler(name, fn, options) requires a function compiler implementation');
+    }
+    const compiler_resource = new jsgui.Resource.Compiler({ name: compiler_name });
+    compiler_resource.transform = (input, transform_options = {}) => {
+        const merged_options = Object.assign({}, compiler_options, transform_options);
+        return compiler_fn(input, merged_options);
+    };
+    jsgui.Resource.compilers = jsgui.Resource.compilers || {};
+    jsgui.Resource.compilers[compiler_name] = compiler_resource;
+    const pool = compiler_options.pool || compiler_options.resource_pool;
+    if (pool && typeof pool.add === 'function') {
+        pool.add(compiler_resource);
+    }
+    return compiler_resource;
+};
+jsgui.controls = jsgui.controls || {};
+Object.assign(jsgui.controls, {
+    Window: require('/mnt/c/Users/james/Documents/repos/jsgui3-html/controls/organised/1-standard/6-layout/window')
+});
+Object.assign(jsgui, jsgui.controls);
+jsgui.mixins = jsgui.mx = require('/mnt/c/Users/james/Documents/repos/jsgui3-html/control_mixins/mx.js');
+module.exports = jsgui;

package/README.md

@@ -8,7 +8,7 @@ This is the primary entry point for understanding the JSGUI3 Server project. Rea
 - You're looking for quick start guides and basic usage examples
 - You need to understand the project's capabilities and limitations
 
-**Note:** For detailed API documentation, see [docs/comprehensive-documentation.md](docs/comprehensive-documentation.md). For advanced server API design, see [docs/simple-server-api-design.md](docs/simple-server-api-design.md).
+**Note:** For detailed API documentation, see [docs/comprehensive-documentation.md](docs/comprehensive-documentation.md). For advanced server API design, see [docs/simple-server-api-design.md](docs/simple-server-api-design.md). For dense internals focused on startup, resources, SSE, and E2E verification, see [docs/core/jsgui3-server-core-book/00-table-of-contents.md](docs/core/jsgui3-server-core-book/00-table-of-contents.md). For deep bundling research and lightweight-bundle strategy, see [docs/books/jsgui3-bundling-research-book/README.md](docs/books/jsgui3-bundling-research-book/README.md).
 
 # Jsgui3 Server
 
@@ -72,6 +72,66 @@ Server.serve({
 });
 ```
 
+### Managed Resources (In-Process, Direct Process, Remote Process)
+
+```javascript
+const Server = require('jsgui3-server');
+const { Resource } = require('jsgui3-server');
+
+class In_Process_Cache_Resource extends Resource {
+    constructor(spec = {}) {
+        super(spec);
+        this.cache = new Map();
+    }
+    start(callback) { callback(null, true); }
+    stop(callback) { this.cache.clear(); callback(null, true); }
+}
+
+const server = await Server.serve({
+    port: 3000,
+    api: {
+        'resources/summary': () => server.resource_pool.summary
+    },
+    resources: {
+        // Existing in-process resource instance
+        cache: new In_Process_Cache_Resource({ name: 'cache' }),
+
+        // Local child process (default process_manager is direct)
+        worker_direct: {
+            type: 'process',
+            command: process.execPath,
+            args: ['worker.js'],
+            autoRestart: true
+        },
+
+        // Local process managed by PM2 (pm2Path is optional)
+        worker_pm2: {
+            type: 'process',
+            processManager: {
+                type: 'pm2'
+            },
+            command: process.execPath,
+            args: ['worker.js']
+        },
+
+        // Remote process controlled over HTTP
+        remote_worker: {
+            type: 'remote',
+            host: '127.0.0.1',
+            port: 3400
+        }
+    },
+    events: true // creates /events SSE endpoint and forwards pool resource lifecycle events
+});
+```
+
+All process-style resources expose a consistent API:
+- `start()`
+- `stop()`
+- `restart()`
+- `status` (includes `state`, `pid`, `uptime`, `restartCount`, `lastHealthCheck`, `memoryUsage`, `processManager`)
+- `get_abstract()`
+
 ### Real-time SSE Streams
 
 ```javascript
@@ -83,11 +143,29 @@ const obs = observable(next => {
 
 // Start server and publish stream
 const server = await Server.serve(MyControl);
-server.publish_observable('/api/stream', obs);
-// Server publishes SSE stream at http://localhost:3000/api/stream
+
+// Simple name - auto-prefixes /api/
+server.publish_observable('stream', obs);
+// Server publishes SSE stream at http://localhost:8080/api/stream
+
+// Or use full route path for custom routes
+server.publish_observable('/custom/events', obs);
+// Server publishes SSE stream at http://localhost:8080/custom/events
+
 // Client connects via EventSource or Remote_Observable
 ```
 
+### General SSE Publisher
+
+```javascript
+const HTTP_SSE_Publisher = require('jsgui3-server/publishers/http-sse-publisher');
+
+const sse_publisher = new HTTP_SSE_Publisher({ name: 'events' });
+server.server_router.set_route('/events', sse_publisher, sse_publisher.handle_http);
+
+sse_publisher.broadcast('resource_update', { running: 3, total: 5 });
+```
+
 > **Note:** The new `Server.serve()` API is the recommended approach for most use cases. See [Simple Server API Design](docs/simple-server-api-design.md) for complete documentation and advanced features.
 
 ## Architecture Overview
@@ -909,11 +987,15 @@ Minimal example:
 ```javascript
 // Inside your server bootstrap (after constructing Server)
 server.on('ready', () => {
+  // Simple name - auto-prefixes /api/
   // Returns text/plain at GET/POST /api/hello
   server.publish('hello', name => `Hello ${name || 'world'}`);
 
   // Returns application/json at GET/POST /api/sum
   server.publish('sum', ({ a, b }) => ({ sum: a + b }));
+  
+  // Full route path for custom routes (no auto-prefix)
+  server.publish('/custom/endpoint', () => ({ custom: true }));
 });
 ```
 

package/admin-ui/client.js

@@ -50,9 +50,9 @@ class Admin_Page extends Active_HTML_Document {
             top_bar.add(this.page_title);
 
             // Content Panel
-            const content = new controls.div({ context, class: 'admin-content' });
-            main.add(content);
-            this.content = content;
+            const content_panel = new controls.div({ context, class: 'admin-content' });
+            main.add(content_panel);
+            this.content_panel = content_panel;
 
             // Default content (Overview)
             this._render_overview();
@@ -75,15 +75,15 @@ class Admin_Page extends Active_HTML_Document {
     }
 
     _render_overview() {
-        // Clear main content area (this.content is the admin-content div)
-        if (this.content && this.content.content && typeof this.content.content.clear === 'function') {
-            this.content.content.clear();
-        }
+        // Clear main content area (content_panel is the admin-content div)
+        if (this.content_panel && this.content_panel.content && typeof this.content_panel.content.clear === 'function') {
+            this.content_panel.content.clear();
+        }
 
         const welcome = new controls.div({ context: this.context, class: 'welcome-card' });
         welcome.add(new controls.h3({ context: this.context }).add('Welcome directly to jsgui3-server Admin'));
         welcome.add(new controls.p({ context: this.context }).add('Select a resource from the sidebar to inspect.'));
-        this.content.add(welcome);
+        this.content_panel.add(welcome);
     }
 
     activate() {

package/dev-status.svg

@@ -0,0 +1,139 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 850" style="background:#1e1e2e; font-family: 'Segoe UI', sans-serif; color: #cdd6f4;">
+  <!-- Definitions for gradients and shadows -->
+  <defs>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="3" dy="3" stdDeviation="4" flood-color="#000000" flood-opacity="0.5"/>
+    </filter>
+    <linearGradient id="grad-server" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#313244;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#45475a;stop-opacity:1" />
+    </linearGradient>
+    <linearGradient id="grad-client" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#181825;stop-opacity:1" />
+      <stop offset="100%" style="stop-color:#1e1e2e;stop-opacity:1" />
+    </linearGradient>
+    <linearGradient id="grad-success" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" style="stop-color:#a6e3a1;stop-opacity:0.2" />
+      <stop offset="100%" style="stop-color:#a6e3a1;stop-opacity:0.1" />
+    </linearGradient>
+    <marker id="arrow" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto" markerUnits="strokeWidth">
+      <path d="M0,0 L0,6 L9,3 z" fill="#89b4fa" />
+    </marker>
+  </defs>
+
+  <!-- Title -->
+  <text x="50" y="50" fill="#cdd6f4" font-size="32" font-weight="bold">jsgui3-server: Dev Status & Architecture</text>
+  <text x="50" y="80" fill="#a6adc8" font-size="16">Admin UI • Auto-Observables • Defensive Programming • Server Lifecycle</text>
+
+  <!-- Areas -->
+  <rect x="50" y="110" width="500" height="700" rx="15" fill="url(#grad-server)" stroke="#585b70" stroke-width="2" />
+  <text x="70" y="140" fill="#fab387" font-size="24" font-weight="bold">Server Side (Node.js)</text>
+
+  <rect x="650" y="110" width="500" height="700" rx="15" fill="url(#grad-client)" stroke="#585b70" stroke-width="2" />
+  <text x="670" y="140" fill="#89b4fa" font-size="24" font-weight="bold">Client Side (Browser)</text>
+
+  <!-- Server Components -->
+  
+  <!-- Server Lifecycle Box -->
+  <g transform="translate(80, 180)">
+    <rect width="440" height="140" rx="8" fill="#313244" stroke="#f38ba8" stroke-width="2" stroke-dasharray="5,5" filter="url(#shadow)" />
+    <text x="15" y="30" fill="#f38ba8" font-size="18" font-weight="bold">Lifecycle Fixes</text>
+    
+    <g transform="translate(20, 50)">
+      <circle cx="10" cy="10" r="5" fill="#f38ba8" />
+      <text x="25" y="15" fill="#cdd6f4" font-size="14">1. _started Guard (Prevents double start)</text>
+    </g>
+    <g transform="translate(20, 80)">
+      <circle cx="10" cy="10" r="5" fill="#f38ba8" />
+      <text x="25" y="15" fill="#cdd6f4" font-size="14">2. Split Events: 'ready' vs 'listening'</text>
+    </g>
+     <g transform="translate(20, 110)">
+      <text x="25" y="15" fill="#a6adc8" font-size="12" font-style="italic">Fixed EADDRINUSE crash root cause</text>
+    </g>
+  </g>
+
+  <!-- Admin Module -->
+  <g transform="translate(80, 350)">
+    <rect width="200" height="120" rx="8" fill="#45475a" stroke="#89b4fa" stroke-width="2" filter="url(#shadow)" />
+    <text x="50" y="30" fill="#89b4fa" font-size="18" font-weight="bold">Admin_Module</text>
+    <line x1="10" y1="40" x2="190" y2="40" stroke="#585b70" />
+    <text x="15" y="65" fill="#cdd6f4" font-size="14">GET /api/admin/resources</text>
+    <text x="15" y="90" fill="#cdd6f4" font-size="14">GET /api/admin/observables</text>
+  </g>
+
+  <!-- Publishers -->
+  <g transform="translate(320, 350)">
+    <rect width="200" height="120" rx="8" fill="#45475a" stroke="#a6e3a1" stroke-width="2" filter="url(#shadow)" />
+    <text x="30" y="30" fill="#a6e3a1" font-size="18" font-weight="bold">Publishers</text>
+    <line x1="10" y1="40" x2="190" y2="40" stroke="#585b70" />
+    <text x="15" y="65" fill="#cdd6f4" font-size="14">HTTP_Webpage_Publisher</text>
+    <text x="15" y="90" fill="#cdd6f4" font-size="14">HTTP_Observable_Publisher</text>
+  </g>
+
+  <!-- Defensive Layers -->
+  <g transform="translate(80, 500)">
+    <rect width="440" height="100" rx="8" fill="url(#grad-success)" stroke="#a6e3a1" stroke-width="1" />
+    <text x="15" y="30" fill="#a6e3a1" font-size="18" font-weight="bold">Defensive Coding Layers</text>
+    <text x="20" y="60" fill="#cdd6f4" font-size="14">• Resource_Pool.add(undefined) → Warn & Return</text>
+    <text x="20" y="80" fill="#cdd6f4" font-size="14">• Bundler Failures → Fallback Empty Bundle</text>
+  </g>
+  
+  <!-- Bundler -->
+  <g transform="translate(80, 630)">
+    <rect width="440" height="60" rx="8" fill="#313244" stroke="#fab387" stroke-width="2" />
+    <text x="15" y="35" fill="#fab387" font-size="18" font-weight="bold">Bundler (esbuild)</text>
+    <text x="180" y="35" fill="#cdd6f4" font-size="14">Fixed: npm link jsgui3-html</text>
+  </g>
+
+
+  <!-- Client Components -->
+
+  <!-- Admin Page -->
+  <g transform="translate(680, 250)">
+    <rect width="440" height="180" rx="8" fill="#313244" stroke="#89b4fa" stroke-width="2" filter="url(#shadow)" />
+    <text x="15" y="30" fill="#89b4fa" font-size="18" font-weight="bold">Admin_Page (Client)</text>
+    <line x1="10" y1="40" x2="430" y2="40" stroke="#585b70" />
+    
+    <!-- Child Controls -->
+    <g transform="translate(20, 60)">
+      <rect width="180" height="40" rx="4" fill="#45475a" stroke="#cba6f7" stroke-width="1" />
+      <text x="35" y="25" fill="#cba6f7" font-size="14">Resource_List</text>
+    </g>
+    
+    <g transform="translate(220, 60)">
+      <rect width="180" height="40" rx="4" fill="#45475a" stroke="#cba6f7" stroke-width="1" />
+      <text x="25" y="25" fill="#cba6f7" font-size="14">Observables_List</text>
+    </g>
+    
+    <g transform="translate(120, 120)">
+      <rect width="200" height="40" rx="4" fill="#45475a" stroke="#f9e2af" stroke-width="1" />
+      <text x="30" y="25" fill="#f9e2af" font-size="14">Auto_Observable_UI</text>
+    </g>
+  </g>
+
+  <!-- Data Flow Arrows -->
+  
+  <!-- Route Info -->
+  <path d="M 280 410 L 680 300" stroke="#89b4fa" stroke-width="2" stroke-dasharray="5,5" fill="none" marker-end="url(#arrow)" />
+  <rect x="420" y="330" width="120" height="25" rx="4" fill="#1e1e2e" stroke="#89b4fa" />
+  <text x="430" y="347" fill="#89b4fa" font-size="12">JSON Data</text>
+
+  <!-- Observable Stream -->
+  <path d="M 430 470 L 800 390" stroke="#a6e3a1" stroke-width="2" fill="none" marker-end="url(#arrow)" />
+  <rect x="560" y="440" width="100" height="25" rx="4" fill="#1e1e2e" stroke="#a6e3a1" />
+  <text x="575" y="457" fill="#a6e3a1" font-size="12">SSE Steam</text>
+
+  <!-- Legend -->
+  <g transform="translate(900, 750)">
+    <text x="0" y="0" fill="#a6adc8" font-size="14" font-weight="bold">Legend</text>
+    <rect x="0" y="10" width="15" height="15" fill="#313244" stroke="#f38ba8" />
+    <text x="25" y="23" fill="#cdd6f4" font-size="12">Lifecycle Code</text>
+    
+    <rect x="0" y="35" width="15" height="15" fill="#313244" stroke="#89b4fa" />
+    <text x="25" y="48" fill="#cdd6f4" font-size="12">UI / Route Component</text>
+    
+    <rect x="0" y="60" width="15" height="15" fill="#313244" stroke="#a6e3a1" />
+    <text x="25" y="73" fill="#cdd6f4" font-size="12">Observable / Defensive</text>
+  </g>
+
+</svg>