@symbiotejs/symbiote 3.8.3 → 3.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. package/README.md +52 -2
  2. package/core/AppRouter.js +97 -58
  3. package/core/PubSub.js +42 -11
  4. package/core/Symbiote.js +90 -59
  5. package/core/itemizeProcessor-keyed.js +88 -188
  6. package/core/itemizeProcessor.js +1 -12
  7. package/core/itemizeSetup.js +26 -3
  8. package/core/ownElements.js +1 -4
  9. package/core/resolveTemplate.js +12 -0
  10. package/core/tpl-processors.js +3 -3
  11. package/docs/README.md +5 -4
  12. package/docs/html-app-vs-htmx.md +55 -0
  13. package/docs/lifecycle.md +2 -0
  14. package/docs/list-rendering.md +10 -2
  15. package/docs/properties.md +28 -1
  16. package/docs/pubsub.md +3 -0
  17. package/docs/routing.md +15 -4
  18. package/docs/security.md +41 -12
  19. package/docs/templates.md +29 -0
  20. package/html-app/BaseClass.js +203 -0
  21. package/html-app/README.md +369 -0
  22. package/html-app/action-data.js +168 -0
  23. package/html-app/actions.js +366 -0
  24. package/html-app/collection-actions.js +104 -0
  25. package/html-app/collection-data.js +234 -0
  26. package/html-app/collection-items.js +45 -0
  27. package/html-app/conditions.js +42 -0
  28. package/html-app/context-data.js +185 -0
  29. package/html-app/context-requests.js +374 -0
  30. package/html-app/context-storage.js +376 -0
  31. package/html-app/declarations.js +55 -0
  32. package/html-app/examples/assets/actions.html +56 -0
  33. package/html-app/examples/assets/collections.html +72 -0
  34. package/html-app/examples/assets/components.html +25 -0
  35. package/html-app/examples/assets/conditional.html +29 -0
  36. package/html-app/examples/assets/data.html +31 -0
  37. package/html-app/examples/assets/guide.html +4 -0
  38. package/html-app/examples/assets/imports.html +11 -0
  39. package/html-app/examples/assets/not-found.html +4 -0
  40. package/html-app/examples/assets/routes.json +58 -0
  41. package/html-app/examples/assets/routing.html +27 -0
  42. package/html-app/examples/assets/state.html +32 -0
  43. package/html-app/examples/assets/storage.html +28 -0
  44. package/html-app/examples/assets/tasks.json +25 -0
  45. package/html-app/examples/full-app.html +147 -0
  46. package/html-app/examples/todo-ref.html +37 -0
  47. package/html-app/fetch-source.js +147 -0
  48. package/html-app/fragment-content.js +29 -0
  49. package/html-app/fragment-source.js +169 -0
  50. package/html-app/index.js +34 -0
  51. package/html-app/initial-data.js +88 -0
  52. package/html-app/pub-map.js +93 -0
  53. package/html-app/router-data.js +50 -0
  54. package/html-app/router-navigation.js +70 -0
  55. package/html-app/storage-revisions.js +130 -0
  56. package/html-app/sym-collection.js +142 -0
  57. package/html-app/sym-component.js +20 -0
  58. package/html-app/sym-conditional.js +141 -0
  59. package/html-app/sym-context.js +176 -0
  60. package/html-app/sym-import.js +218 -0
  61. package/html-app/sym-router.js +107 -0
  62. package/package.json +18 -8
  63. package/scripts/check-html-app-package.js +117 -0
  64. package/scripts/check-html-app-size.js +91 -0
  65. package/scripts/update-exports.js +4 -0
  66. package/skills/symbiote/SKILL.md +197 -0
  67. package/skills/symbiote/agents/openai.yaml +3 -0
  68. package/types/core/AppRouter.d.ts +13 -4
  69. package/types/core/AppRouter.d.ts.map +1 -1
  70. package/types/core/PubSub.d.ts +1 -1
  71. package/types/core/PubSub.d.ts.map +1 -1
  72. package/types/core/Symbiote.d.ts +6 -2
  73. package/types/core/Symbiote.d.ts.map +1 -1
  74. package/types/core/itemizeProcessor-keyed.d.ts.map +1 -1
  75. package/types/core/itemizeProcessor.d.ts.map +1 -1
  76. package/types/core/itemizeSetup.d.ts +1 -0
  77. package/types/core/itemizeSetup.d.ts.map +1 -1
  78. package/types/core/ownElements.d.ts +1 -1
  79. package/types/core/ownElements.d.ts.map +1 -1
  80. package/types/core/resolveTemplate.d.ts +2 -0
  81. package/types/core/resolveTemplate.d.ts.map +1 -0
  82. package/types/html-app/BaseClass.d.ts +24 -0
  83. package/types/html-app/BaseClass.d.ts.map +1 -0
  84. package/types/html-app/action-data.d.ts +15 -0
  85. package/types/html-app/action-data.d.ts.map +1 -0
  86. package/types/html-app/actions.d.ts +104 -0
  87. package/types/html-app/actions.d.ts.map +1 -0
  88. package/types/html-app/collection-actions.d.ts +12 -0
  89. package/types/html-app/collection-actions.d.ts.map +1 -0
  90. package/types/html-app/collection-data.d.ts +13 -0
  91. package/types/html-app/collection-data.d.ts.map +1 -0
  92. package/types/html-app/collection-items.d.ts +7 -0
  93. package/types/html-app/collection-items.d.ts.map +1 -0
  94. package/types/html-app/conditions.d.ts +5 -0
  95. package/types/html-app/conditions.d.ts.map +1 -0
  96. package/types/html-app/context-data.d.ts +31 -0
  97. package/types/html-app/context-data.d.ts.map +1 -0
  98. package/types/html-app/context-requests.d.ts +97 -0
  99. package/types/html-app/context-requests.d.ts.map +1 -0
  100. package/types/html-app/context-storage.d.ts +102 -0
  101. package/types/html-app/context-storage.d.ts.map +1 -0
  102. package/types/html-app/declarations.d.ts +3 -0
  103. package/types/html-app/declarations.d.ts.map +1 -0
  104. package/types/html-app/fetch-source.d.ts +23 -0
  105. package/types/html-app/fetch-source.d.ts.map +1 -0
  106. package/types/html-app/fragment-content.d.ts +6 -0
  107. package/types/html-app/fragment-content.d.ts.map +1 -0
  108. package/types/html-app/fragment-source.d.ts +14 -0
  109. package/types/html-app/fragment-source.d.ts.map +1 -0
  110. package/types/html-app/index.d.ts +9 -0
  111. package/types/html-app/index.d.ts.map +1 -0
  112. package/types/html-app/initial-data.d.ts +8 -0
  113. package/types/html-app/initial-data.d.ts.map +1 -0
  114. package/types/html-app/pub-map.d.ts +19 -0
  115. package/types/html-app/pub-map.d.ts.map +1 -0
  116. package/types/html-app/router-data.d.ts +4 -0
  117. package/types/html-app/router-data.d.ts.map +1 -0
  118. package/types/html-app/router-navigation.d.ts +3 -0
  119. package/types/html-app/router-navigation.d.ts.map +1 -0
  120. package/types/html-app/storage-revisions.d.ts +11 -0
  121. package/types/html-app/storage-revisions.d.ts.map +1 -0
  122. package/types/html-app/sym-collection.d.ts +16 -0
  123. package/types/html-app/sym-collection.d.ts.map +1 -0
  124. package/types/html-app/sym-component.d.ts +5 -0
  125. package/types/html-app/sym-component.d.ts.map +1 -0
  126. package/types/html-app/sym-conditional.d.ts +10 -0
  127. package/types/html-app/sym-conditional.d.ts.map +1 -0
  128. package/types/html-app/sym-context.d.ts +16 -0
  129. package/types/html-app/sym-context.d.ts.map +1 -0
  130. package/types/html-app/sym-import.d.ts +19 -0
  131. package/types/html-app/sym-import.d.ts.map +1 -0
  132. package/types/html-app/sym-router.d.ts +12 -0
  133. package/types/html-app/sym-router.d.ts.map +1 -0
  134. package/docs/llms-index.md +0 -49
  135. package/llms-full.txt +0 -5432
  136. package/llms.txt +0 -49
  137. package/scripts/build-llms.js +0 -56
@@ -0,0 +1 @@
1
+ {"version":3,"file":"initial-data.d.ts","sourceRoot":"","sources":["../../html-app/initial-data.js"],"names":[],"mappings":"AAWA,yFAFW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAUjC;AAGD,+BADY,MAAM,WAGjB;AAGD,uCADY,MAAM,OAajB;AAGD,sCADY,OAAO,GAAG,gBAAgB,OAWrC;AAMD,wCAFW,OAAO,gBAAgB,EAAE,SAAS,OAe5C;AAOD,2CAHW,OAAO,GAAG,gBAAgB,SAC1B,OAAO,gBAAgB,EAAE,SAAS,QAW5C;AAnFD,4BADW,OAAO,CAAC,uCAAkC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CACpC"}
@@ -0,0 +1,19 @@
1
+ export class PubMap {
2
+ constructor(owner: import("./BaseClass.js").BaseClass);
3
+ connected: boolean;
4
+ queued: boolean;
5
+ version: number;
6
+ bindings: {
7
+ target: string;
8
+ source: string;
9
+ }[];
10
+ subscriptions: {
11
+ remove(): void;
12
+ }[];
13
+ owner: import("./BaseClass.js").BaseClass;
14
+ connect(): void;
15
+ disconnect(): void;
16
+ refresh(): void;
17
+ schedule(): void;
18
+ }
19
+ //# sourceMappingURL=pub-map.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pub-map.d.ts","sourceRoot":"","sources":["../../html-app/pub-map.js"],"names":[],"mappings":"AAEA;IASE,mBADY,OAAO,gBAAgB,EAAE,SAAS,EAG7C;IAVD,mBAAkB;IAClB,gBAAe;IACf,gBAAY;IAEZ,UADW;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CACjC;IAEd,eADW;QAAE,MAAM,IAAI,IAAI,CAAA;KAAE,EAAE,CACZ;IAGjB,0CAAkB;IAEpB,gBAMC;IACD,mBASC;IACD,gBAgCC;IACD,iBA2BC;CACF"}
@@ -0,0 +1,4 @@
1
+ export function routingMap(value: unknown): typeof import("../core/AppRouter.js").AppRouter.appMap & Record<string, {
2
+ src?: string;
3
+ }>;
4
+ //# sourceMappingURL=router-data.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router-data.d.ts","sourceRoot":"","sources":["../../html-app/router-data.js"],"names":[],"mappings":"AAOA,kCAHW,OAAO,GACL,cAAc,sBAAsB,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4CrG"}
@@ -0,0 +1,3 @@
1
+ export function navigateAction(owner: import("./BaseClass.js").BaseClass, reference: string, element: Element, operand: Element, event: import("./actions.js").ActionEvent): ReturnType<typeof AppRouter.navigate> | undefined;
2
+ import { AppRouter } from '../core/AppRouter.js';
3
+ //# sourceMappingURL=router-navigation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"router-navigation.d.ts","sourceRoot":"","sources":["../../html-app/router-navigation.js"],"names":[],"mappings":"AAcA,sCAPW,OAAO,gBAAgB,EAAE,SAAS,aAClC,MAAM,WACN,OAAO,WACP,OAAO,SACP,OAAO,cAAc,EAAE,WAAW,GAChC,UAAU,CAAC,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,SAAS,CAyD7D;0BArEyB,sBAAsB"}
@@ -0,0 +1,11 @@
1
+ export function commitStorageRevision<T>(win: Window, change: RevisionChange & {
2
+ signal: AbortSignal;
3
+ }, commit: () => T): Promise<T>;
4
+ export type RevisionChange = {
5
+ key: string;
6
+ expected: string | null | undefined;
7
+ next: string | undefined;
8
+ overwrite: boolean;
9
+ signal?: AbortSignal;
10
+ };
11
+ //# sourceMappingURL=storage-revisions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"storage-revisions.d.ts","sourceRoot":"","sources":["../../html-app/storage-revisions.js"],"names":[],"mappings":"AA8GA,sCANa,CAAC,OACH,MAAM,UACN,cAAc,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,UACxC,MAAM,CAAC,GACL,OAAO,CAAC,CAAC,CAAC,CAqBtB;;SA1Fa,MAAM;cACN,MAAM,GAAG,IAAI,GAAG,SAAS;UACzB,MAAM,GAAG,SAAS;eAClB,OAAO;aACP,WAAW"}
@@ -0,0 +1,16 @@
1
+ export class SymCollection extends BaseClass {
2
+ init$: {
3
+ items: any[];
4
+ count: number;
5
+ totalCount: number;
6
+ empty: boolean;
7
+ };
8
+ attributeChangedCallback(name: string, previous: string | null, value: string | null): void;
9
+ source(): import("../core/parseProp.js").ParsedProp;
10
+ bindSource(): void;
11
+ project(): void;
12
+ #private;
13
+ }
14
+ export default SymCollection;
15
+ import BaseClass from './BaseClass.js';
16
+ //# sourceMappingURL=sym-collection.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sym-collection.d.ts","sourceRoot":"","sources":["../../html-app/sym-collection.js"],"names":[],"mappings":"AAMA;IAUE;;;;;MAKE;IAWF,+BAJW,MAAM,YACN,MAAM,GAAG,IAAI,SACb,MAAM,GAAG,IAAI,QAQvB;IAED,oDAUC;IA0BD,mBAgCC;IAED,gBAmBC;;CAUF;;sBA3IqB,gBAAgB"}
@@ -0,0 +1,5 @@
1
+ export class SymComponent extends BaseClass {
2
+ }
3
+ export default SymComponent;
4
+ import BaseClass from './BaseClass.js';
5
+ //# sourceMappingURL=sym-component.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sym-component.d.ts","sourceRoot":"","sources":["../../html-app/sym-component.js"],"names":[],"mappings":"AAGA;CAcC;;sBAjBqB,gBAAgB"}
@@ -0,0 +1,10 @@
1
+ export class SymConditional extends BaseClass {
2
+ attributeChangedCallback(name: string, previous: string | null, value: string | null): void;
3
+ bindCondition(): void;
4
+ updateContent(): void;
5
+ unmount(): void;
6
+ #private;
7
+ }
8
+ export default SymConditional;
9
+ import BaseClass from './BaseClass.js';
10
+ //# sourceMappingURL=sym-conditional.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sym-conditional.d.ts","sourceRoot":"","sources":["../../html-app/sym-conditional.js"],"names":[],"mappings":"AAKA;IAuBE,+BAJW,MAAM,YACN,MAAM,GAAG,IAAI,SACb,MAAM,GAAG,IAAI,QAQvB;IAkCD,sBAWC;IAED,sBAmCC;IAED,gBAOC;;CAaF;;sBA1IqB,gBAAgB"}
@@ -0,0 +1,16 @@
1
+ export class SymContext extends BaseClass {
2
+ contextData: ContextData;
3
+ requests: ContextRequests;
4
+ storage: ContextStorage;
5
+ attributeChangedCallback(name: string, previous: string | null, value: string | null): void;
6
+ watchData(key: string): void;
7
+ publishData(key: string, value: unknown): void;
8
+ mergeSource(data: Record<string, unknown>): void;
9
+ #private;
10
+ }
11
+ export default SymContext;
12
+ import BaseClass from './BaseClass.js';
13
+ import { ContextData } from './context-data.js';
14
+ import { ContextRequests } from './context-requests.js';
15
+ import { ContextStorage } from './context-storage.js';
16
+ //# sourceMappingURL=sym-context.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sym-context.d.ts","sourceRoot":"","sources":["../../html-app/sym-context.js"],"names":[],"mappings":"AAOA;IAYE,yBAAoC;IACpC,0BAAqC;IACrC,wBAAmC;IAOnC,+BAJW,MAAM,YACN,MAAM,GAAG,IAAI,SACb,MAAM,GAAG,IAAI,QAYvB;IA6ED,eADY,MAAM,QAOjB;IAMD,iBAHW,MAAM,SACN,OAAO,QAkBjB;IAGD,kBADY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAQlC;;CAoBF;;sBA5KqB,gBAAgB;4BAEV,mBAAmB;gCACf,uBAAuB;+BACxB,sBAAsB"}
@@ -0,0 +1,19 @@
1
+ export class SymImport extends BaseClass {
2
+ attributeChangedCallback(name: string, previous: string | null, value: string | null): void;
3
+ status(loading: boolean, error?: {
4
+ operation: string;
5
+ code: string;
6
+ message: string;
7
+ status: number | null;
8
+ } | null): void;
9
+ cancel(): void;
10
+ schedule(): void;
11
+ mount(fragment: DocumentFragment, source?: ReturnType<typeof importSource>): void;
12
+ unmount(): void;
13
+ load(): Promise<void>;
14
+ #private;
15
+ }
16
+ export default SymImport;
17
+ import BaseClass from './BaseClass.js';
18
+ import { importSource } from './fragment-source.js';
19
+ //# sourceMappingURL=sym-import.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sym-import.d.ts","sourceRoot":"","sources":["../../html-app/sym-import.js"],"names":[],"mappings":"AAKA;IAmBE,+BAJW,MAAM,YACN,MAAM,GAAG,IAAI,SACb,MAAM,GAAG,IAAI,QASvB;IAgDD,gBAHW,OAAO,UACP;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,QAQ5F;IAED,eAOC;IAED,iBAWC;IAMD,gBAHW,gBAAgB,WAChB,UAAU,CAAC,OAAO,YAAY,CAAC,QAkBzC;IAED,gBAOC;IAED,sBAwDC;;CAmBF;;sBAvNqB,gBAAgB;6BAE0B,sBAAsB"}
@@ -0,0 +1,12 @@
1
+ export class SymRouter extends SymContext {
2
+ init$: {
3
+ route: any;
4
+ options: any;
5
+ title: any;
6
+ };
7
+ checkOwnership(): void;
8
+ #private;
9
+ }
10
+ export default SymRouter;
11
+ import { SymContext } from './sym-context.js';
12
+ //# sourceMappingURL=sym-router.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sym-router.d.ts","sourceRoot":"","sources":["../../html-app/sym-router.js"],"names":[],"mappings":"AAQA;IACE;;;;MAIE;IA6BF,uBAKC;;CAyDF;;2BAvG0B,kBAAkB"}
@@ -1,49 +0,0 @@
1
- # Symbiote.js
2
-
3
- > Lightweight, standards-first UI library built on Web Components. Zero dependencies, ~7.3 kb brotli. No virtual DOM, no compiler, no build step required. Works in any framework or plain HTML.
4
-
5
- Symbiote.js extends HTMLElement natively. State changes update the DOM synchronously. Components are real custom elements. Supports SSR with isomorphic hydration, WebMCP for exposing UI as browser-native agent tools, and optional Shadow DOM.
6
-
7
- ## Key resources
8
-
9
- - [Full documentation (single file)](https://rnd-pro.com/symbiote/llms-full.txt): Complete merged reference — paste this into any AI tool for full context
10
- - [README](https://github.com/symbiotejs/symbiote.js/blob/main/README.md): Overview, quick start, and feature summary
11
-
12
- ## Core concepts
13
-
14
- - [Get Started](https://github.com/symbiotejs/symbiote.js/blob/main/docs/get-started.md): Installation, CDN usage, first component
15
- - [Templates](https://github.com/symbiotejs/symbiote.js/blob/main/docs/templates.md): html` ` tagged template, binding syntax, slots, refs
16
- - [Properties & State](https://github.com/symbiotejs/symbiote.js/blob/main/docs/properties.md): init$, $ proxy, subscriptions, computed properties
17
- - [Context](https://github.com/symbiotejs/symbiote.js/blob/main/docs/context.md): Local, named (`X/`), pop-up (`^`), shared (`*`) contexts
18
- - [List Rendering](https://github.com/symbiotejs/symbiote.js/blob/main/docs/list-rendering.md): itemize API, inline templates, item-tag
19
- - [Lifecycle](https://github.com/symbiotejs/symbiote.js/blob/main/docs/lifecycle.md): initCallback, renderCallback, destroyCallback
20
- - [Flags](https://github.com/symbiotejs/symbiote.js/blob/main/docs/flags.md): pauseRender, renderShadow, ssrMode, isoMode, lazyMode
21
- - [Attributes](https://github.com/symbiotejs/symbiote.js/blob/main/docs/attributes.md): bindAttributes, attribute observation
22
-
23
- ## State management
24
-
25
- - [PubSub](https://github.com/symbiotejs/symbiote.js/blob/main/docs/pubsub.md): Standalone named contexts, registerCtx, multiPub
26
-
27
- ## Styling
28
-
29
- - [Styling](https://github.com/symbiotejs/symbiote.js/blob/main/docs/styling.md): rootStyles, shadowStyles, css` ` tag, adoptedStyleSheets
30
- - [CSS Data](https://github.com/symbiotejs/symbiote.js/blob/main/docs/css-data.md): CSS custom properties as reactive component state
31
-
32
- ## Features
33
-
34
- - [WebMCP (Experimental)](https://github.com/symbiotejs/symbiote.js/blob/main/docs/webmcp.md): Expose live UI handlers as browser-native agent tools
35
- - [Routing](https://github.com/symbiotejs/symbiote.js/blob/main/docs/routing.md): AppRouter, path patterns, guards, lazy loading
36
- - [SSR](https://github.com/symbiotejs/symbiote.js/blob/main/docs/ssr.md): Server-side rendering, streaming, hydration
37
- - [SSR Server Setup](https://github.com/symbiotejs/symbiote.js/blob/main/docs/ssr-server.md): Static build, Express, Fastify
38
- - [Animations](https://github.com/symbiotejs/symbiote.js/blob/main/docs/animations.md): animateOut, CSS-driven exit transitions
39
-
40
- ## Development
41
-
42
- - [Dev Mode](https://github.com/symbiotejs/symbiote.js/blob/main/docs/dev-mode.md): Verbose warnings, devMessages.js
43
- - [TypeScript](https://github.com/symbiotejs/symbiote.js/blob/main/docs/typescript.md): JSDoc types, d.ts, hybrid template checks
44
- - [Security](https://github.com/symbiotejs/symbiote.js/blob/main/docs/security.md): Trusted Types, CSP
45
-
46
- ## Guidance
47
-
48
- - [Common Mistakes](https://github.com/symbiotejs/symbiote.js/blob/main/docs/common-mistakes.md): Patterns that frequently cause bugs
49
- - [Examples](https://github.com/symbiotejs/symbiote.js/blob/main/docs/examples.md): 26 complete working examples across all features