jsgui3-server 0.0.147 → 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

@@ -0,0 +1,213 @@
+const jsgui = require('jsgui3-client');
+const { controls, Control, mixins } = jsgui;
+const Active_HTML_Document = require('../controls/Active_HTML_Document');
+
+class Admin_Page extends Active_HTML_Document {
+    constructor(spec = {}) {
+        spec.__type_name = spec.__type_name || 'admin_page';
+        super(spec);
+        const { context } = this;
+
+        if (typeof this.body.add_class === 'function') {
+            this.body.add_class('admin-page');
+        }
+
+        const compose = () => {
+            // Sidebar
+            const sidebar = new controls.div({ context, class: 'admin-sidebar' });
+            this.body.add(sidebar);
+            this.sidebar = sidebar;
+
+            // Sidebar Header
+            const brand = new controls.div({ context, class: 'admin-brand' });
+            brand.add(new controls.span({ context, class: 'brand-icon' }).add('⚙️'));
+            brand.add(new controls.span({ context, class: 'brand-text' }).add('jsgui3 Admin'));
+            sidebar.add(brand);
+
+            // Menu Container (Placeholder for Resource_List and Observables_List)
+            const menu = new controls.div({ context, class: 'admin-menu' });
+            sidebar.add(menu);
+            this.menu = menu;
+
+            this._add_menu_item('Overview', 'overview', true);
+            this._add_menu_item('Resources', 'resources');
+            this._add_menu_item('Observables', 'observables');
+            this._add_menu_item('Settings', 'settings');
+
+
+            // Main Content Area
+            const main = new controls.div({ context, class: 'admin-main' });
+            this.body.add(main);
+            this.main = main;
+
+            // Top Bar
+            const top_bar = new controls.div({ context, class: 'admin-top-bar' });
+            main.add(top_bar);
+
+            // Breadcrumbs / Title
+            this.page_title = new controls.h2({ context, class: 'page-title' });
+            this.page_title.add('Overview');
+            top_bar.add(this.page_title);
+
+            // Content Panel
+            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();
+        };
+
+        if (!spec.el) {
+            compose();
+        }
+    }
+
+    _add_menu_item(label, id, active = false) {
+        const item = new controls.div({
+            context: this.context,
+            class: `menu-item ${active ? 'active' : ''}`
+        });
+        item.dom.attributes['data-id'] = id;
+        item.add(label);
+        this.menu.add(item);
+        return item;
+    }
+
+    _render_overview() {
+        // 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_panel.add(welcome);
+    }
+
+    activate() {
+        if (!this.__active) {
+            super.activate();
+
+            // Handle menu clicks
+            const menu_items = document.querySelectorAll('.menu-item');
+            menu_items.forEach(el => {
+                el.addEventListener('click', () => {
+                    // Update Active State
+                    menu_items.forEach(i => i.classList.remove('active'));
+                    el.classList.add('active');
+
+                    // Update Title
+                    const id = el.getAttribute('data-id');
+                    const label = el.innerText;
+                    document.querySelector('.page-title').innerText = label;
+
+                    // Placeholder navigation logic
+                    console.log('Navigate to:', id);
+                });
+            });
+        }
+    }
+}
+
+Admin_Page.css = `
+* { box-sizing: border-box; margin: 0; padding: 0; }
+body { 
+    background: #1a1a2e; 
+    color: #e0e0e0; 
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
+    height: 100vh;
+    overflow: hidden;
+}
+.admin-page {
+    display: grid;
+    grid-template-columns: 260px 1fr;
+    height: 100%;
+}
+
+/* Sidebar */
+.admin-sidebar {
+    background: #16213e;
+    border-right: 1px solid #2a2a4a;
+    display: flex;
+    flex-direction: column;
+}
+.admin-brand {
+    padding: 20px;
+    font-size: 1.2rem;
+    font-weight: bold;
+    color: #fff;
+    border-bottom: 1px solid #2a2a4a;
+    display: flex;
+    align-items: center;
+    gap: 10px;
+}
+.brand-icon { filter: drop-shadow(0 0 5px rgba(255,255,255,0.3)); }
+
+.admin-menu {
+    flex: 1;
+    padding: 20px 0;
+    overflow-y: auto;
+}
+.menu-item {
+    padding: 12px 24px;
+    cursor: pointer;
+    border-left: 3px solid transparent;
+    transition: all 0.2s;
+    color: #a0a0b0;
+}
+.menu-item:hover {
+    background: rgba(255,255,255,0.05);
+    color: #fff;
+}
+.menu-item.active {
+    background: rgba(79, 172, 254, 0.1);
+    color: #4facfe;
+    border-left-color: #4facfe;
+}
+
+/* Main Area */
+.admin-main {
+    display: flex;
+    flex-direction: column;
+    background: #1a1a2e;
+}
+.admin-top-bar {
+    height: 64px;
+    border-bottom: 1px solid #2a2a4a;
+    display: flex;
+    align-items: center;
+    padding: 0 30px;
+    background: #16213e;
+}
+.page-title {
+    font-size: 1.2rem;
+    font-weight: 500;
+    color: #fff;
+}
+
+.admin-content {
+    flex: 1;
+    overflow-y: auto;
+    padding: 30px;
+    position: relative;
+}
+
+/* Cards */
+.welcome-card {
+    background: #2a2a4a;
+    padding: 40px;
+    border-radius: 12px;
+    text-align: center;
+    max-width: 600px;
+    margin: 40px auto;
+    border: 1px solid #3a3a5a;
+    box-shadow: 0 4px 20px rgba(0,0,0,0.2);
+}
+.welcome-card h3 { color: #fff; margin-bottom: 15px; }
+.welcome-card p { color: #a0a0b0; }
+`;
+
+controls.Admin_Page = Admin_Page;
+module.exports = jsgui;