@supersoniks/concorde 4.2.0 → 4.2.1

package/docs/src/docs/search/docs-search.json

@@ -4274,6 +4274,121 @@
       }
     }
   },
+  {
+    "search": "The @subscribe decorator is a simplified version of @bind without reflect. It accepts only Key<T> and enforces that the decorated property must be of type T:\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "subscribe-read-only-strictly-typed-with-key": {
+            "count": 1,
+            "title": "@subscribe (read-only, strictly typed with Key)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const statsKey = new Key("idDonneesDeStats");\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "subscribe-read-only-strictly-typed-with-key": {
+            "count": 1,
+            "title": "@subscribe (read-only, strictly typed with Key)",
+            "type": "paragraph"
+          }
+        }
+      },
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "integration-with-subscribe": {
+            "count": 1,
+            "title": "Integration with @subscribe",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "@subscribe(statsKey.gauge)\n@state()\ngauge: number = 0;  // OK — matches Key\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "subscribe-read-only-strictly-typed-with-key": {
+            "count": 1,
+            "title": "@subscribe (read-only, strictly typed with Key)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "// @subscribe(statsKey.gauge)\n// gauge: string = "";  // Error — type 'string' is not assignable to type 'number'\n  \n\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "subscribe-read-only-strictly-typed-with-key": {
+            "count": 1,
+            "title": "@subscribe (read-only, strictly typed with Key)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The @publish decorator is the inverse of @subscribe: when you write to the property, the value is published to the publisher path. No subscription (no read from publisher).\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "publish-write-only-inverse-of-subscribe": {
+            "count": 1,
+            "title": "@publish (write-only, inverse of @subscribe)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const formKey = new Key("formData");\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "publish-write-only-inverse-of-subscribe": {
+            "count": 1,
+            "title": "@publish (write-only, inverse of @subscribe)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "@publish(formKey.email)\n@state()\nemail = "";  // Writing to email publishes to formData.email\n  \n\n",
+    "files": {
+      "docs/_misc/bind.md": {
+        "title": "@bind",
+        "hashes": {
+          "publish-write-only-inverse-of-subscribe": {
+            "count": 1,
+            "title": "@publish (write-only, inverse of @subscribe)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Lorsque vous avez besoin que les modifications locales se propagent également vers le publisher, activez l'option reflect :\n",
     "files": {
@@ -4399,6 +4514,201 @@
       }
     }
   },
+  {
+    "search": "Key",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "key": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The Key<T> utility provides type-safe navigation through composite data structures. Each property or index access extends the path, and the final key can be retrieved via toString() or the path property.\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "key": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Key uses a Proxy to intercept property access and build a cumulative path string. TypeScript infers the nested type at each level, so myKey.checkedTickets[0] is correctly typed as Key<LegacyCheckedTicket> when checkedTickets is LegacyCheckedTicket[].\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "principle": {
+            "count": 1,
+            "title": "Principle",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "// Create a key and navigate through the structure\nconst myKey = new Key("idDonneesDeStats").checkedTickets[0];\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "// Equivalent to: new Key("idDonneesDeStats.checkedTickets.0")\nmyKey.toString();  // "idDonneesDeStats.checkedTickets.0"\nmyKey.path;        // same value\n// myKey is typed as Key\n  \n\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "basic-example": {
+            "count": 1,
+            "title": "Basic example",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const firstTicket = ticketsKey[0];\nfirstTicket.path;  // "data.checkedTickets.0"\n// firstTicket is Key\n  \n\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "array-index-access": {
+            "count": 1,
+            "title": "Array index access",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const key = Key("root");\nkey.path;  // "root"\n  \n\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "usage-without-new": {
+            "count": 1,
+            "title": "Usage without `new`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The final path is built by concatenating each accessed property with a dot:\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "path-retrieval": {
+            "count": 1,
+            "title": "Path retrieval",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use toString() or path to get the full path string:\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "path-retrieval": {
+            "count": 1,
+            "title": "Path retrieval",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use Key with the @subscribe decorator for strictly typed, read-only bindings (no reflect). The decorated property must match the Key type:\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "integration-with-subscribe": {
+            "count": 1,
+            "title": "Integration with @subscribe",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "@customElement("stats-gauge")\nexport class StatsGauge extends LitElement {\n  @subscribe(statsKey.gauge)\n  @state()\n  gauge: number = 0;  // Type enforced: must be number\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "integration-with-subscribe": {
+            "count": 1,
+            "title": "Integration with @subscribe",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "  render() {\n    return html<span>Gauge: ${this.gauge}</span>;\n  }\n}\n  \n\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "integration-with-subscribe": {
+            "count": 1,
+            "title": "Integration with @subscribe",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "If you declare gauge: string with @subscribe(statsKey.gauge) (Key), TypeScript will error.\n",
+    "files": {
+      "docs/_misc/key.md": {
+        "title": "Key",
+        "hashes": {
+          "integration-with-subscribe": {
+            "count": 1,
+            "title": "Integration with @subscribe",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "@onAssign",
     "files": {

package/docs/src/tsconfig-model.json

@@ -1,5 +1,5 @@
 {
-  "exclude": ["node_modules/**/*", "dist/**/*", "vite.config.mts", "docs.ts", "docs/*", "router-test.html"],
+  "exclude": ["node_modules/**/*", "dist/**/*", "vite.config.mts", "docs.ts", "docs/*", "router-test.html", "**/*.type-test.ts"],
   "compilerOptions": {
     "target": "es2021",
     "experimentalDecorators": true,