Fix code quality violations for publish

Progressive breadcrumb resolution with caching, fix double headers 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-16 04:43:47 +00:00
parent ba3268caca
commit 14dd2fd223
1456 changed files with 136243 additions and 7631 deletions
--- a/node_modules/@jqhtml/ssr/QUICKSTART.md
+++ b/node_modules/@jqhtml/ssr/QUICKSTART.md
@@ -0,0 +1,114 @@
+# JQHTML SSR Quickstart
+
+## 1. Configure npm Registry
+
+Create `.npmrc` in your project root:
+
+```
+@jqhtml:registry=https://privatenpm.hanson.xyz/
+//privatenpm.hanson.xyz/:_auth=anFodG1sOkFHbTMyNStFdklOQXdUMnN0S0g2cXc9PQ==
+```
+
+## 2. Install
+
+```bash
+npm install @jqhtml/ssr
+```
+
+## 3. Start the Server
+
+```bash
+# TCP (for remote/container access)
+npx jqhtml-ssr --tcp 9876
+
+# Or Unix socket (better performance, local only)
+npx jqhtml-ssr --socket /tmp/jqhtml-ssr.sock
+```
+
+## 4. Test with Reference CLI
+
+```bash
+npx jqhtml-ssr-example \
+  --vendor ./path/to/vendor-bundle.js \
+  --app ./path/to/app-bundle.js \
+  --component Dashboard_Index_Action \
+  --base-url http://localhost:8000
+```
+
+## 5. Integration
+
+### Protocol
+
+Send newline-delimited JSON to the server:
+
+```json
+{
+  "id": "req-1",
+  "type": "render",
+  "payload": {
+    "bundles": [
+      { "id": "vendor", "content": "<vendor bundle JS>" },
+      { "id": "app", "content": "<app bundle JS>" }
+    ],
+    "component": "Component_Name",
+    "args": {},
+    "options": {
+      "baseUrl": "http://localhost:8000",
+      "timeout": 30000
+    }
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "id": "req-1",
+  "status": "success",
+  "payload": {
+    "html": "<div class=\"Component_Name Component\">...</div>",
+    "cache": {
+      "localStorage": {},
+      "sessionStorage": {}
+    },
+    "timing": {
+      "total_ms": 230,
+      "bundle_load_ms": 50,
+      "render_ms": 100
+    }
+  }
+}
+```
+
+### PHP Example
+
+```php
+<?php
+$socket = stream_socket_client('unix:///tmp/jqhtml-ssr.sock');
+
+$request = json_encode([
+    'id' => uniqid(),
+    'type' => 'render',
+    'payload' => [
+        'bundles' => [
+            ['id' => 'vendor', 'content' => file_get_contents('vendor.js')],
+            ['id' => 'app', 'content' => file_get_contents('app.js')]
+        ],
+        'component' => 'Dashboard_Index_Action',
+        'args' => [],
+        'options' => ['baseUrl' => 'http://localhost', 'timeout' => 30000]
+    ]
+]) . "\n";
+
+fwrite($socket, $request);
+$response = json_decode(fgets($socket), true);
+
+echo $response['payload']['html'];
+```
+
+## Documentation
+
+- `README.md` - Full integration guide
+- `SPECIFICATION.md` - Protocol specification
+- `bin/jqhtml-ssr-example.js` - Reference implementation (source of truth)