tinybase 9.5.0 → 9.6.0-beta.1

package/@types/ui-svelte-dom/with-schemas/index.d.ts

@@ -751,7 +751,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <TableInHtmlTable /> (Svelte) demo for this component in action:
  *
- * ![TableInHtmlTable example](https://tinybase.org/shots/tableinhtmltable-svelte-demo.png
+ * ![TableInHtmlTable example](https://beta.tinybase.org/shots/tableinhtmltable-svelte-demo.png
  * "TableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -921,7 +921,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <SortedTableInHtmlTable /> (Svelte) demo for this component in
  * action:
  *
- * ![SortedTableInHtmlTable example](https://tinybase.org/shots/sortedtableinhtmltable-svelte-demo.png
+ * ![SortedTableInHtmlTable example](https://beta.tinybase.org/shots/sortedtableinhtmltable-svelte-demo.png
  * "SortedTableInHtmlTable example")
  *
  * The component's props identify which Table to render based on Table Id, and
@@ -1117,7 +1117,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <ValuesInHtmlTable /> (Svelte) demo for this component in action:
  *
- * ![ValuesInHtmlTable example](https://tinybase.org/shots/valuesinhtmltable-svelte-demo.png
+ * ![ValuesInHtmlTable example](https://beta.tinybase.org/shots/valuesinhtmltable-svelte-demo.png
  * "ValuesInHtmlTable example")
  *
  * The component's props identify which Row to render based on Table Id, Row Id,
@@ -1268,7 +1268,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <SliceInHtmlTable /> (Svelte) demo for this component in action:
  *
- * ![SliceInHtmlTable example](https://tinybase.org/shots/sliceinhtmltable-svelte-demo.png
+ * ![SliceInHtmlTable example](https://beta.tinybase.org/shots/sliceinhtmltable-svelte-demo.png
  * "SliceInHtmlTable example")
  *
  * The component's props identify which Slice to render based on Index Id, Slice
@@ -1446,7 +1446,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <RelationshipInHtmlTable /> (Svelte) demo for this component in
  * action:
  *
- * ![RelationshipInHtmlTable example](https://tinybase.org/shots/relationshipinhtmltable-svelte-demo.png
+ * ![RelationshipInHtmlTable example](https://beta.tinybase.org/shots/relationshipinhtmltable-svelte-demo.png
  * "RelationshipInHtmlTable example")
  *
  * The component's props identify which Relationship to render based on
@@ -1641,7 +1641,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <ResultTableInHtmlTable /> (Svelte) demo for this component in
  * action:
  *
- * ![ResultTableInHtmlTable example](https://tinybase.org/shots/resulttableinhtmltable-svelte-demo.png
+ * ![ResultTableInHtmlTable example](https://beta.tinybase.org/shots/resulttableinhtmltable-svelte-demo.png
  * "ResultTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -1818,7 +1818,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <ResultSortedTableInHtmlTable /> (Svelte) demo for this component in
  * action:
  *
- * ![ResultSortedTableInHtmlTable example](https://tinybase.org/shots/resultsortedtableinhtmltable-svelte-demo.png
+ * ![ResultSortedTableInHtmlTable example](https://beta.tinybase.org/shots/resultsortedtableinhtmltable-svelte-demo.png
  * "ResultSortedTableInHtmlTable example")
  *
  * The component's props identify which ResultTable to render based on query Id,
@@ -2015,7 +2015,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <EditableCellView /> (Svelte) demo for this component in action:
  *
- * ![EditableCellView example](https://tinybase.org/shots/editablecellview-svelte-demo.png
+ * ![EditableCellView example](https://beta.tinybase.org/shots/editablecellview-svelte-demo.png
  * "EditableCellView example")
  *
  * The component's props identify which Cell to render based on Table Id, Row
@@ -2102,7 +2102,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  *
  * See the <EditableValueView /> (Svelte) demo for this component in action:
  *
- * ![EditableValueView example](https://tinybase.org/shots/editablevalueview-svelte-demo.png
+ * ![EditableValueView example](https://beta.tinybase.org/shots/editablevalueview-svelte-demo.png
  * "EditableValueView example")
  *
  * The component's props identify which Value to render based on Table Id, Row
@@ -2177,7 +2177,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * See the <SortedTableInHtmlTable /> (Svelte) demo for this component in
  * action:
  *
- * ![SortedTablePaginator example](https://tinybase.org/shots/sortedtablepaginator-svelte-demo.png
+ * ![SortedTablePaginator example](https://beta.tinybase.org/shots/sortedtablepaginator-svelte-demo.png
  * "SortedTablePaginator example")
  *
  * The component displays 'previous' and 'next' buttons for paging through the

package/@types/ui-svelte-inspector/index.d.ts

@@ -49,7 +49,7 @@ export type InspectorProps = {
  *
  * See the <Inspector /> (Svelte) demo for this component in action:
  *
- * ![Inspector example](https://tinybase.org/shots/inspector-svelte-demo.png
+ * ![Inspector example](https://beta.tinybase.org/shots/inspector-svelte-demo.png
  * "Inspector example")
  *
  * The component displays a nub in the corner of the screen which you may then

package/@types/ui-svelte-inspector/with-schemas/index.d.ts

@@ -49,7 +49,7 @@ export type InspectorProps = {
  *
  * See the <Inspector /> (Svelte) demo for this component in action:
  *
- * ![Inspector example](https://tinybase.org/shots/inspector-svelte-demo.png
+ * ![Inspector example](https://beta.tinybase.org/shots/inspector-svelte-demo.png
  * "Inspector example")
  *
  * The component displays a nub in the corner of the screen which you may then

package/agents.md

@@ -380,6 +380,59 @@ from source code and markdown files.
    old path whose summary is just `-> /new-url`. The site generator hides these
    from navigation and renders them as meta-refresh redirect pages.
 
+### API Member Links In Prose
+
+TinyDocs scans prose outside code fences and turns recognized API member names
+into links, adding the code wrapper itself. This applies to guides, release
+notes, `docs.js`, and the home page. The rules live in the markdown linkers in
+`tinydocs/src/ui/structure/Markdown.tsx`.
+
+**Never put an API member name in backticks.** The generator emits the link with
+the name already wrapped in backticks, so adding your own turns the entire link
+into a code span, which renders as literal broken text on the page:
+
+```md
+CellSchema and ValueSchema can now use an `enum` property <- correct
+`CellSchema` and `ValueSchema` can now use an `enum` property <- broken
+```
+
+**Whether a bare name links at all depends on what follows it**, and that
+differs by kind:
+
+| Kind                              | Links when followed by                                              |
+| --------------------------------- | ------------------------------------------------------------------- |
+| TypeAlias, Interface, Enum, Class | any non-word character, so these link on their own                  |
+| Guide and demo pages              | any non-word character, as above                                    |
+| Function                          | ` function`, ` component`, ` hook`, ` primitive`, ` callback`, `()` |
+| Method                            | ` method` or `()`                                                   |
+| Module                            | ` module`                                                           |
+
+The last three also link when followed by a pipe, which is what makes bare names
+work inside markdown table cells.
+
+So capitalized types link bare anywhere, whereas lowercase-initial functions,
+hooks, and methods need their qualifier word. Prefer the qualifier form over
+`()`, and repeat it for every entry when listing several. Guide and demo names
+link without a following word, but house style is still to write "the X guide"
+or "the Y demo".
+
+**The qualifier must be exactly one whitespace character away.** The pattern
+matches a single whitespace before the qualifier, so a line wrap between a name
+and its qualifier silently breaks the link: the newline plus the next line's
+indent is more than one character. Keep each pair on one line. Prettier has no
+`proseWrap` setting here, so it defaults to preserving prose line breaks and
+will not undo this.
+
+Names already inside a markdown link, between `[` and `]`, are skipped, so
+existing explicit links are safe.
+
+Backticks remain correct for anything that is not an API member, since those are
+never linked: property and parameter names, module paths, type expressions, and
+third-party library APIs.
+
+Links only resolve once the API index has been built, so verify prose changes
+with a full `npm run compileDocs` and inspect the generated output.
+
 ### Documentation Testing
 
 TinyBase has automated tests that validate all inline code examples in
@@ -580,9 +633,9 @@ When adding a new feature:
 
 2. **Update `/site/home/index.md`**:
    - Update the "NEW!" link to point to new version: `<a
-     href='/guides/releases/#v7-1'>`
+href='/guides/releases/#v7-1'>`
    - Update the tagline: `<span id="one-with">"The one with
-     Schematizers!"</span>`
+Schematizers!"</span>`
 
 3. **Generated files update automatically** during build process