@yuhere/js-jsonrpc2 2.1.9 → 2.1.10

package/README.md

@@ -105,7 +105,8 @@ s.string()                 // string
 s.string().min(1).max(64)  // length-constrained string
 s.number()                 // finite number
 s.boolean()                // boolean
-s.literal('2.0')           // exact literal
+s.literal('2.0')           // exact literal (string | number | boolean only)
+s.null()                   // exactly null
 s.array(s.string())        // string[]
 s.object({ id: s.number() })          // open object
 s.object({ id: s.number() }).strict() // all props required, no extras
@@ -113,7 +114,7 @@ s.record(s.number())       // Record<string, number>
 s.union([s.string(), s.number()])
 s.tuple([s.string(), s.number()])
 s.enum(['pending', 'success', 'failed'])
-s.unknown()                // any JSON value
+s.unknown()                // any JSON value (already includes null)
 s.void()                   // RPC-only: no return value
 s.injectable('request')    // RPC-only: server-injected parameter
 ```
@@ -123,6 +124,13 @@ Chainable modifiers: `.min()`, `.max()`, `.nullable()`, `.strict()`,
 `SchemaValidationError`) and `.safeParse(input)` (returns a result object).
 Introspection: `.toJSON()` returns a `SchemaDescription`.
 
+Nullability notes:
+
+- `.nullable()` / `.nullable(true)` allow `null`; `.nullable(false)` clears it. All calls are immutable.
+- `s.unknown()` and `s.null()` do not expose `.nullable()`; they already accept / are `null`.
+- `s.literal(v)` accepts `string | number | boolean`. Use `s.null()` for exact null, or `.nullable()` for "literal or null".
+- `s.union([...])` strips member-level nullability; only the union's own `.nullable()` decides whether `null` is accepted.
+
 ## Transports
 
 ### Express

package/SKILL.md

@@ -27,10 +27,16 @@ Hard constraints (by design, do not work around):
 5. Write `handler` so its positional args match the non-injectable slots in order;
    injectable slots are filled at their declared positions.
 6. Use `s.*` factories for schemas: `s.string()`, `s.number()`, `s.boolean()`,
-   `s.literal(v)`, `s.array(item)`, `s.object(shape)`, `s.record(v)`,
-   `s.union([...])`, `s.tuple([...])`, `s.enum([...])`, `s.unknown()`.
-7. Chain modifiers before registering: `.min()`, `.max()`, `.nullable()`,
+   `s.literal(v)` (`v` is `string | number | boolean` only), `s.null()`,
+   `s.array(item)`, `s.object(shape)`, `s.record(v)`, `s.union([...])`,
+   `s.tuple([...])`, `s.enum([...])`, `s.unknown()`.
+7. Chain modifiers before registering: `.min()`, `.max()`, `.nullable(bool)`,
    `.strict()`, `.describe(text)`.
+8. Nullability rules:
+   - `.nullable()` / `.nullable(true)` allow `null`; `.nullable(false)` clears it. Calls are immutable.
+   - `s.unknown()` and `s.null()` already handle `null`; they do not expose `.nullable()`.
+   - `s.literal(v)` rejects `null`; use `s.null()` for exact null, `.nullable()` for "literal or null".
+   - `s.union([...])` strips member-level nullability at construction; use `s.union([...]).nullable()` to accept `null`.
 
 ```ts
 import { createRepository, s } from '@yuhere/js-jsonrpc2';
@@ -235,3 +241,15 @@ so `system.methodHelp` returns useful text.
 - **Treating a terminal `error` frame as a broken connection.** A mid-stream
   throw is delivered as `{ done: true, error }`; the HTTP/WS/stdio response
   itself ends cleanly. Only transport-level failures abort the connection.
+- **Calling `.nullable()` on `s.unknown()` or `s.null()`.** Those schemas do not
+  extend `NullableSchema`; the call is a TypeScript error. Use `.nullable()` on
+  the concrete schema instead (e.g. `s.string().nullable()`), or `s.null()`
+  when the value must be exactly `null`.
+- **Expecting member-level `.nullable()` inside a union to matter.**
+  `s.union([s.string().nullable(), s.number()])` is equivalent to
+  `s.union([s.string(), s.number()])` — members are cloned and set to
+  `nullable(false)` at construction. Put `.nullable()` on the union itself:
+  `s.union([s.string(), s.number()]).nullable()`.
+- **Calling `s.literal(null)`.** `literal` only accepts `string | number |
+  boolean`; construction throws `TypeError`. Use `s.null()` for exact null, or
+  `.nullable()` for "literal or null".

package/htdoc/assets/{index-BAZmvr5x.css → index-Ck-39Igh.css}

@@ -25,6 +25,7 @@
     --syn-container: #7ee787;
     --syn-object: #79c0ff;
     --syn-union: #ffa657;
+    --syn-nullable: #ff79c6;
     --syn-muted: #8b949e;
 
     --mono: "JetBrains Mono", "Fira Code", Menlo, Consolas, "Courier New", monospace;
@@ -52,6 +53,7 @@
     --syn-container: #116329;
     --syn-object: #0969da;
     --syn-union: #bc4c00;
+    --syn-nullable: #a626a4;
     --syn-muted: #57606a;
 }
 
@@ -391,6 +393,15 @@ textarea:focus {
     color: var(--fg-dim);
 }
 
+.schema-nullable-badge {
+    color: var(--syn-nullable);
+    font-size: 90%;
+    font-weight: bold;
+    letter-spacing: .5px;
+    text-transform: lowercase;
+    opacity: .9;
+}
+
 .schema-constraints {
     color: var(--syn-muted);
     font-size: 90%;
@@ -458,6 +469,15 @@ textarea:focus {
     color: var(--fg-dim);
 }
 
+.sf-nullable-badge {
+    color: var(--syn-nullable);
+    font-size: 90%;
+    font-weight: bold;
+    letter-spacing: .5px;
+    text-transform: lowercase;
+    opacity: .9;
+}
+
 .sf-desc {
     color: var(--fg-dim);
     font-style: italic;
@@ -739,4 +759,205 @@ textarea:focus {
 
 .elapsed-badge .hint {
     font-size: 11px;
+}
+
+
+
+/* ================================================================
+ * Metrics 面板
+ * ================================================================ */
+.metrics {
+    display: flex;
+    flex-direction: column;
+    gap: 16px;
+}
+
+.metrics-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 12px;
+    flex-wrap: wrap;
+}
+
+.metrics-header h2 {
+    margin: 0;
+    color: var(--accent);
+    font-size: 16px;
+}
+
+.metrics-controls {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    flex-wrap: wrap;
+}
+
+.metrics-auto {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    font-size: 12px;
+    color: var(--fg-dim);
+    cursor: pointer;
+    user-select: none;
+}
+
+.metrics-cards {
+    display: grid;
+    grid-template-columns: repeat(auto-fill, minmax(140px, 1fr));
+    gap: 10px;
+}
+
+.metric-card {
+    background: var(--bg-elev);
+    border: 1px solid var(--border);
+    border-radius: 4px;
+    padding: 10px 12px;
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+}
+
+.metric-card-label {
+    font-size: 11px;
+    color: var(--fg-dim);
+    text-transform: uppercase;
+    letter-spacing: 1px;
+}
+
+.metric-card-value {
+    font-size: 22px;
+    font-weight: bold;
+    color: var(--fg);
+    font-variant-numeric: tabular-nums;
+}
+
+.metric-card-danger .metric-card-value {
+    color: var(--danger);
+}
+
+.metric-card-warn .metric-card-value {
+    color: var(--syn-number);
+}
+
+.metrics-table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 12px;
+    font-variant-numeric: tabular-nums;
+}
+
+.metrics-table th,
+.metrics-table td {
+    padding: 6px 8px;
+    border-bottom: 1px solid var(--border);
+    text-align: left;
+    white-space: nowrap;
+}
+
+.metrics-table th {
+    color: var(--fg-dim);
+    font-weight: normal;
+    text-transform: uppercase;
+    letter-spacing: .5px;
+    font-size: 11px;
+    position: sticky;
+    top: 0;
+    background: var(--bg);
+    z-index: 1;
+}
+
+.metrics-table td.num,
+.metrics-table th.num {
+    text-align: right;
+}
+
+.metrics-table tr:hover td {
+    background: var(--hover-bg);
+}
+
+.metrics-table .method-name {
+    color: var(--accent);
+    font-family: var(--mono);
+    max-width: 260px;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.metrics-table .error {
+    color: var(--danger);
+}
+
+.metrics-table .warn {
+    color: var(--syn-number);
+}
+
+.metrics-table .rate-hot {
+    color: var(--syn-boolean);
+    font-weight: bold;
+}
+
+.metrics-table .rate-warm {
+    color: var(--syn-number);
+}
+
+.metrics-table .rate-cold {
+    color: var(--fg-dim);
+}
+
+.metrics-table.compact th,
+.metrics-table.compact td {
+    padding: 3px 6px;
+    font-size: 11px;
+}
+
+.view-switch {
+    margin-bottom: 8px;
+    width: 100%;
+}
+
+.view-switch button {
+    flex: 1;
+}
+
+/* ---- Metrics 侧边栏 ---- */
+.metrics-sidebar {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+}
+
+.metrics-filter {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+}
+
+.metrics-filter-label {
+    font-size: 11px;
+    color: var(--fg-dim);
+    text-transform: uppercase;
+    letter-spacing: 1px;
+}
+
+.metrics-filter-help {
+    font-size: 11px;
+    line-height: 1.5;
+    margin: 0;
+}
+
+.metrics-filter-help code {
+    background: var(--bg-deep);
+    border: 1px solid var(--border);
+    border-radius: 3px;
+    padding: 0 4px;
+    font-size: 11px;
+    color: var(--syn-literal);
+}
+
+.metrics-filter-stat {
+    font-size: 11px;
+    margin: 4px 0 0;
+    color: var(--accent);
 }