@rindo/core 4.21.0 → 4.22.1

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal",
-  "version": "4.21.0",
+  "version": "4.22.1",
   "description": "Rindo internals only to be imported by the Rindo Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/internal/rindo-private.d.ts

@@ -4,6 +4,14 @@ import type { CPSerializable } from './child_process';
 import type { BuildEvents, BuildLog, BuildResultsComponentGraph, CompilerBuildResults, CompilerFsStats, CompilerRequestResponse, CompilerSystem, Config, CopyResults, DevServerConfig, DevServerEditor, Diagnostic, Logger, LoggerLineUpdater, LoggerTimeSpan, OptimizeCssInput, OptimizeCssOutput, OutputTarget, OutputTargetWww, PageReloadStrategy, PrerenderConfig, StyleDoc, TaskCommand, ValidatedConfig } from './rindo-public-compiler';
 import type { JsonDocMethodParameter } from './rindo-public-docs';
 import type { ComponentInterface, ListenTargetOptions, VNode } from './rindo-public-runtime';
+export interface DocData {
+    hostIds: number;
+    rootLevelIds: number;
+    staticComponents: Set<string>;
+}
+export type RindoDocument = Document & {
+    _rindoDocData: DocData;
+};
 export interface SourceMap {
     file: string;
     mappings: string;

package/internal/rindo-public-compiler.d.ts

@@ -2,6 +2,7 @@ import type { ConfigFlags } from '../cli/config-flags';
 import type { PrerenderUrlResults, PrintLine } from '../internal';
 import type { BuildCtx, CompilerCtx } from './rindo-private';
 import type { JsonDocs } from './rindo-public-docs';
+import type { ResolutionHandler } from './rindo-public-runtime';
 export * from './rindo-public-docs';
 /**
  * https://rindojs.web.app/docs/config/
@@ -246,6 +247,7 @@ export interface RindoConfig {
     env?: {
         [prop: string]: string | undefined;
     };
+    docs?: RindoDocsConfig;
     globalScript?: string;
     srcIndexHtml?: string;
     watch?: boolean;
@@ -859,6 +861,11 @@ export interface SerializeDocumentOptions extends HydrateDocumentOptions {
      * @default true
      */
     fullDocument?: boolean;
+    /**
+     * Style modes to render the component in.
+     * @see https://rindojs.web.app/docs/styling#style-modes
+     */
+    modes?: ResolutionHandler[];
 }
 export interface HydrateFactoryOptions extends SerializeDocumentOptions {
     serializeToHtml: boolean;
@@ -1558,6 +1565,33 @@ export interface CopyTask {
      */
     keepDirStructure?: boolean;
 }
+/**
+ * Configuration for generating documentation from Rindo components.
+ */
+export interface RindoDocsConfig {
+    /**
+     * Options for processing and rendering Markdown documentation files.
+     */
+    markdown?: {
+        /**
+         * Styling for how the target component will be represented within documentation (e.g., in component diagrams).
+         */
+        targetComponent?: {
+            /**
+             * Background color used for nodes representing the component in diagrams (e.g., Mermaid graphs).
+             * Use standard color names or hex codes.
+             * @example '#f0f0f0' (light gray)
+             */
+            background?: string;
+            /**
+             * Text color used within nodes representing the component in diagrams (e.g., Mermaid graphs).
+             * Use standard color names or hex codes.
+             * @example '#333' (dark gray)
+             */
+            textColor?: string;
+        };
+    };
+}
 export interface BundlingConfig {
     /**
      * @deprecated the `namedExports` field is no longer honored by `@rollup/plugin-commonjs` and is not used by Rindo.

package/internal/rindo-public-runtime.d.ts

@@ -1564,6 +1564,10 @@ export declare namespace JSXBase {
         onSubmitCapture?: (event: Event) => void;
         onInvalid?: (event: Event) => void;
         onInvalidCapture?: (event: Event) => void;
+        onBeforeToggle?: (event: Event) => void;
+        onBeforeToggleCapture?: (event: Event) => void;
+        onToggle?: (event: Event) => void;
+        onToggleCapture?: (event: Event) => void;
         onLoad?: (event: Event) => void;
         onLoadCapture?: (event: Event) => void;
         onError?: (event: Event) => void;

package/internal/testing/index.js

@@ -560,6 +560,12 @@ var HYDRATE_ID = "s-id";
 var HYDRATED_STYLE_ID = "sty-id";
 var HYDRATE_CHILD_ID = "c-id";
 var HYDRATED_CSS = "{visibility:hidden}.hydrated{visibility:inherit}";
+var RINDO_DOC_DATA = "_rindoDocData";
+var DEFAULT_DOC_DATA = {
+  hostIds: 0,
+  rootLevelIds: 0,
+  staticComponents: /* @__PURE__ */ new Set()
+};
 var SLOT_FB_CSS = "slot-fb{display:contents}slot-fb[hidden]{display:none}";
 var XLINK_NS = "http://www.w3.org/1999/xlink";
 var FORM_ASSOCIATED_CUSTOM_ELEMENT_CALLBACKS = [
@@ -1017,10 +1023,15 @@ var addStyle = (styleContainerNode, cmpMeta, mode) => {
           if (!(cmpMeta.$flags$ & 1 /* shadowDomEncapsulation */)) {
             if (styleContainerNode.nodeName === "HEAD") {
               const preconnectLinks = styleContainerNode.querySelectorAll("link[rel=preconnect]");
-              const referenceNode2 = preconnectLinks.length > 0 ? preconnectLinks[preconnectLinks.length - 1].nextSibling : document.querySelector("style");
+              const referenceNode2 = preconnectLinks.length > 0 ? preconnectLinks[preconnectLinks.length - 1].nextSibling : styleContainerNode.querySelector("style");
               styleContainerNode.insertBefore(styleElm, referenceNode2);
             } else if ("host" in styleContainerNode) {
-              styleContainerNode.prepend(styleElm, null);
+              const existingStyleContainer = styleContainerNode.querySelector("style");
+              if (existingStyleContainer) {
+                existingStyleContainer.innerHTML = style + existingStyleContainer.innerHTML;
+              } else {
+                styleContainerNode.prepend(styleElm);
+              }
             } else {
               styleContainerNode.append(styleElm);
             }
@@ -2514,6 +2525,11 @@ var patchSlotAppendChild = (HostElementPrototype) => {
     const slotName = newChild["s-sn"] = getSlotName(newChild);
     const slotNode = getHostSlotNode(this.childNodes, slotName, this.tagName);
     if (slotNode) {
+      const slotPlaceholder = document.createTextNode("");
+      slotPlaceholder["s-nr"] = newChild;
+      slotNode["s-cr"].parentNode.__appendChild(slotPlaceholder);
+      newChild["s-ol"] = slotPlaceholder;
+      newChild["s-sh"] = slotNode["s-hn"];
       const slotChildNodes = getHostSlotChildNodes(slotNode, slotName);
       const appendAfter = slotChildNodes[slotChildNodes.length - 1];
       const insertedNode = insertBefore(appendAfter.parentNode, newChild, appendAfter.nextSibling);
@@ -2555,6 +2571,7 @@ var patchSlotPrepend = (HostElementPrototype) => {
         slotPlaceholder["s-nr"] = newChild;
         slotNode["s-cr"].parentNode.__appendChild(slotPlaceholder);
         newChild["s-ol"] = slotPlaceholder;
+        newChild["s-sh"] = slotNode["s-hn"];
         const slotChildNodes = getHostSlotChildNodes(slotNode, slotName);
         const appendAfter = slotChildNodes[0];
         return insertBefore(appendAfter.parentNode, newChild, appendAfter.nextSibling);
@@ -3119,11 +3136,8 @@ var setPlatformOptions = (opts) => Object.assign(plt, opts);
 // src/runtime/vdom/vdom-annotations.ts
 var insertVdomAnnotations = (doc2, staticComponents) => {
   if (doc2 != null) {
-    const docData = {
-      hostIds: 0,
-      rootLevelIds: 0,
-      staticComponents: new Set(staticComponents)
-    };
+    const docData = RINDO_DOC_DATA in doc2 ? doc2[RINDO_DOC_DATA] : { ...DEFAULT_DOC_DATA };
+    docData.staticComponents = new Set(staticComponents);
     const orgLocationNodes = [];
     parseVNodeAnnotations(doc2, doc2.body, docData, orgLocationNodes);
     orgLocationNodes.forEach((orgLocationNode) => {

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal/testing",
-  "version": "4.21.0",
+  "version": "4.22.1",
   "description": "Rindo internal testing platform to be imported by the Rindo Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "private": true

package/mock-doc/index.cjs

@@ -1,5 +1,5 @@
 /*!
- Rindo Mock Doc (CommonJS) v4.21.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Mock Doc (CommonJS) v4.22.1 | MIT Licensed | https://rindojs.web.app
  */
 "use strict";
 var __defProp = Object.defineProperty;
@@ -60,6 +60,7 @@ var CONTENT_REF_ID = "r";
 var ORG_LOCATION_ID = "o";
 var SLOT_NODE_ID = "s";
 var TEXT_NODE_ID = "t";
+var HYDRATE_ID = "s-id";
 var XLINK_NS = "http://www.w3.org/1999/xlink";
 
 // src/mock-doc/attribute.ts
@@ -6438,6 +6439,13 @@ style="${cssText}">`;
               output.indent = output.indent + ((_h = opts.indentSpaces) != null ? _h : 0);
             }
             for (let i = 0; i < childNodeLength; i++) {
+              const sId = node.attributes.getNamedItem(HYDRATE_ID);
+              const isRindoDeclarativeShadowDOM = childNodes[i].nodeName.toLowerCase() === "template" && sId;
+              if (isRindoDeclarativeShadowDOM) {
+                yield `
+${" ".repeat(output.indent)}<!--r.${sId.value}-->`;
+                continue;
+              }
               yield* streamToHtml(childNodes[i], opts, output);
             }
             if (ignoreTag === false) {
@@ -8926,6 +8934,71 @@ function resetPerformance(perf) {
   }
 }
 
+// src/mock-doc/resize-observer.ts
+var MockResizeObserver = class {
+  constructor() {
+  }
+  disconnect() {
+  }
+  observe() {
+  }
+  takeRecords() {
+    return [];
+  }
+  unobserve() {
+  }
+};
+
+// src/mock-doc/shadow-root.ts
+var MockShadowRoot = class extends MockDocumentFragment {
+  get activeElement() {
+    return null;
+  }
+  set adoptedStyleSheets(_adoptedStyleSheets) {
+    throw new Error("Unimplemented");
+  }
+  get adoptedStyleSheets() {
+    return [];
+  }
+  get cloneable() {
+    return false;
+  }
+  get delegatesFocus() {
+    return false;
+  }
+  get fullscreenElement() {
+    return null;
+  }
+  get host() {
+    let parent = this.parentElement();
+    while (parent) {
+      if (parent.nodeType === 11) {
+        return parent;
+      }
+      parent = parent.parentElement();
+    }
+    return null;
+  }
+  get mode() {
+    return "open";
+  }
+  get pictureInPictureElement() {
+    return null;
+  }
+  get pointerLockElement() {
+    return null;
+  }
+  get serializable() {
+    return false;
+  }
+  get slotAssignment() {
+    return "named";
+  }
+  get styleSheets() {
+    return [];
+  }
+};
+
 // src/mock-doc/storage.ts
 var MockStorage = class {
   constructor() {
@@ -8955,11 +9028,11 @@ var MockStorage = class {
 };
 
 // src/mock-doc/window.ts
-var nativeClearInterval = clearInterval;
-var nativeClearTimeout = clearTimeout;
-var nativeSetInterval = setInterval;
-var nativeSetTimeout = setTimeout;
-var nativeURL = URL;
+var nativeClearInterval = globalThis.clearInterval;
+var nativeClearTimeout = globalThis.clearTimeout;
+var nativeSetInterval = globalThis.setInterval;
+var nativeSetTimeout = globalThis.setTimeout;
+var nativeURL = globalThis.URL;
 var nativeWindow = globalThis.window;
 var MockWindow = class {
   constructor(html = null) {
@@ -9054,6 +9127,9 @@ var MockWindow = class {
   set DocumentFragment(docFragCstr) {
     this.__docFragCstr = docFragCstr;
   }
+  get ShadowRoot() {
+    return MockShadowRoot;
+  }
   get DocumentType() {
     if (this.__docTypeCstr == null) {
       const ownerDocument = this.document;
@@ -9165,6 +9241,9 @@ var MockWindow = class {
   get IntersectionObserver() {
     return MockIntersectionObserver;
   }
+  get ResizeObserver() {
+    return MockResizeObserver;
+  }
   get localStorage() {
     if (this.__localStorage == null) {
       this.__localStorage = new MockStorage();

package/mock-doc/index.d.ts

@@ -825,6 +825,13 @@ declare class MockResponse {
   text(): Promise<string>;
   clone(): MockResponse;
 }
+declare class MockResizeObserver {
+  constructor();
+  disconnect(): void;
+  observe(): void;
+  takeRecords(): any[];
+  unobserve(): void;
+}
 /**
  * Check whether an element of interest matches a given selector.
  *
@@ -893,6 +900,21 @@ interface SerializeNodeToHtmlOptions {
   serializeShadowRoot?: boolean;
   fullDocument?: boolean;
 }
+declare class MockShadowRoot extends MockDocumentFragment {
+  get activeElement(): HTMLElement | null;
+  set adoptedStyleSheets(_adoptedStyleSheets: StyleSheet[]);
+  get adoptedStyleSheets(): StyleSheet[];
+  get cloneable(): boolean;
+  get delegatesFocus(): boolean;
+  get fullscreenElement(): HTMLElement | null;
+  get host(): HTMLElement | null;
+  get mode(): 'open' | 'closed';
+  get pictureInPictureElement(): HTMLElement | null;
+  get pointerLockElement(): HTMLElement | null;
+  get serializable(): boolean;
+  get slotAssignment(): 'named' | 'manual';
+  get styleSheets(): StyleSheet[];
+}
 declare class MockStorage {
   key(_value: number): void;
   getItem(key: string): string;
@@ -947,6 +969,7 @@ declare class MockWindow {
   set Document(docCstr: any);
   get DocumentFragment(): any;
   set DocumentFragment(docFragCstr: any);
+  get ShadowRoot(): typeof MockShadowRoot;
   get DocumentType(): any;
   set DocumentType(docTypeCstr: any);
   get DOMTokenList(): any;
@@ -963,6 +986,7 @@ declare class MockWindow {
   get HTMLElement(): any;
   set HTMLElement(htmlElementCstr: any);
   get IntersectionObserver(): typeof MockIntersectionObserver;
+  get ResizeObserver(): typeof MockResizeObserver;
   get localStorage(): MockStorage;
   set localStorage(locStorage: MockStorage);
   get location(): MockLocation;

package/mock-doc/index.js

@@ -1,5 +1,5 @@
 /*!
- Rindo Mock Doc v4.21.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Mock Doc v4.22.1 | MIT Licensed | https://rindojs.web.app
  */
 
 // src/runtime/runtime-constants.ts
@@ -7,6 +7,7 @@ var CONTENT_REF_ID = "r";
 var ORG_LOCATION_ID = "o";
 var SLOT_NODE_ID = "s";
 var TEXT_NODE_ID = "t";
+var HYDRATE_ID = "s-id";
 var XLINK_NS = "http://www.w3.org/1999/xlink";
 
 // src/mock-doc/attribute.ts
@@ -6385,6 +6386,13 @@ style="${cssText}">`;
               output.indent = output.indent + ((_h = opts.indentSpaces) != null ? _h : 0);
             }
             for (let i = 0; i < childNodeLength; i++) {
+              const sId = node.attributes.getNamedItem(HYDRATE_ID);
+              const isRindoDeclarativeShadowDOM = childNodes[i].nodeName.toLowerCase() === "template" && sId;
+              if (isRindoDeclarativeShadowDOM) {
+                yield `
+${" ".repeat(output.indent)}<!--r.${sId.value}-->`;
+                continue;
+              }
               yield* streamToHtml(childNodes[i], opts, output);
             }
             if (ignoreTag === false) {
@@ -8873,6 +8881,71 @@ function resetPerformance(perf) {
   }
 }
 
+// src/mock-doc/resize-observer.ts
+var MockResizeObserver = class {
+  constructor() {
+  }
+  disconnect() {
+  }
+  observe() {
+  }
+  takeRecords() {
+    return [];
+  }
+  unobserve() {
+  }
+};
+
+// src/mock-doc/shadow-root.ts
+var MockShadowRoot = class extends MockDocumentFragment {
+  get activeElement() {
+    return null;
+  }
+  set adoptedStyleSheets(_adoptedStyleSheets) {
+    throw new Error("Unimplemented");
+  }
+  get adoptedStyleSheets() {
+    return [];
+  }
+  get cloneable() {
+    return false;
+  }
+  get delegatesFocus() {
+    return false;
+  }
+  get fullscreenElement() {
+    return null;
+  }
+  get host() {
+    let parent = this.parentElement();
+    while (parent) {
+      if (parent.nodeType === 11) {
+        return parent;
+      }
+      parent = parent.parentElement();
+    }
+    return null;
+  }
+  get mode() {
+    return "open";
+  }
+  get pictureInPictureElement() {
+    return null;
+  }
+  get pointerLockElement() {
+    return null;
+  }
+  get serializable() {
+    return false;
+  }
+  get slotAssignment() {
+    return "named";
+  }
+  get styleSheets() {
+    return [];
+  }
+};
+
 // src/mock-doc/storage.ts
 var MockStorage = class {
   constructor() {
@@ -8902,11 +8975,11 @@ var MockStorage = class {
 };
 
 // src/mock-doc/window.ts
-var nativeClearInterval = clearInterval;
-var nativeClearTimeout = clearTimeout;
-var nativeSetInterval = setInterval;
-var nativeSetTimeout = setTimeout;
-var nativeURL = URL;
+var nativeClearInterval = globalThis.clearInterval;
+var nativeClearTimeout = globalThis.clearTimeout;
+var nativeSetInterval = globalThis.setInterval;
+var nativeSetTimeout = globalThis.setTimeout;
+var nativeURL = globalThis.URL;
 var nativeWindow = globalThis.window;
 var MockWindow = class {
   constructor(html = null) {
@@ -9001,6 +9074,9 @@ var MockWindow = class {
   set DocumentFragment(docFragCstr) {
     this.__docFragCstr = docFragCstr;
   }
+  get ShadowRoot() {
+    return MockShadowRoot;
+  }
   get DocumentType() {
     if (this.__docTypeCstr == null) {
       const ownerDocument = this.document;
@@ -9112,6 +9188,9 @@ var MockWindow = class {
   get IntersectionObserver() {
     return MockIntersectionObserver;
   }
+  get ResizeObserver() {
+    return MockResizeObserver;
+  }
   get localStorage() {
     if (this.__localStorage == null) {
       this.__localStorage = new MockStorage();

package/mock-doc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/mock-doc",
-  "version": "4.21.0",
+  "version": "4.22.1",
   "description": "Mock window, document and DOM outside of a browser environment.",
   "main": "./index.cjs",
   "module": "./index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core",
-  "version": "4.21.0",
+  "version": "4.22.1",
   "license": "MIT",
   "main": "./internal/rindo-core/index.cjs",
   "module": "./internal/rindo-core/index.js",
@@ -183,7 +183,7 @@
     "semver": "^7.3.7",
     "terser": "5.31.1",
     "tsx": "^4.10.3",
-    "typescript": "~5.5.3",
+    "typescript": "~5.5.4",
     "webpack": "^5.75.0",
     "ws": "8.17.1"
   },

package/screenshot/index.js

@@ -1,5 +1,5 @@
 /*
- Rindo Screenshot v4.21.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Screenshot v4.22.1 | MIT Licensed | https://rindojs.web.app
  */
 "use strict";
 var __create = Object.create;

package/screenshot/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/screenshot",
-  "version": "4.21.0",
+  "version": "4.22.1",
   "description": "Rindo Screenshot.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/screenshot/pixel-match.js

@@ -1,5 +1,5 @@
 /*
- Rindo Screenshot Pixel Match v4.21.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Screenshot Pixel Match v4.22.1 | MIT Licensed | https://rindojs.web.app
  */
 "use strict";
 var __create = Object.create;