@rindo/core 4.20.0 → 4.22.0

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal",
-  "version": "4.20.0",
+  "version": "4.22.0",
   "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-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;
@@ -847,10 +849,10 @@ export interface SerializeDocumentOptions extends HydrateDocumentOptions {
      */
     removeHtmlComments?: boolean;
     /**
-     * If set to `false` Rindo will ignore the fact that a component has a `shadow: true`
-     * flag and serializes it as a scoped component. If set to `true` the component will
-     * be rendered within a Declarative Shadow DOM.
-     * @default false
+     * If set to `true` the component will be rendered within a Declarative Shadow DOM.
+     * If set to `false` Rindo will ignore the contents of the shadow root and render the
+     * element as given in provided template.
+     * @default true
      */
     serializeShadowRoot?: 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;
@@ -1504,6 +1511,11 @@ export interface CopyTask {
      * the output target for which this copy operation is configured.
      */
     dest?: string;
+    /**
+     * An optional array of glob patterns to exclude from the copy operation.
+     * @default ['**\/__mocks__/**', '**\/__fixtures__/**', '**\/dist/**', '**\/.{idea,git,cache,output,temp}/**', '**\/.ds_store', '**\/.gitignore', '**\/desktop.ini', '**\/thumbs.db']
+     */
+    ignore?: string[];
     /**
      * Whether or not Rindo should issue warnings if it cannot find the
      * specified source files or directories. Defaults to `false`.
@@ -1553,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

@@ -1014,17 +1014,19 @@ var addStyle = (styleContainerNode, cmpMeta, mode) => {
           if ((import_app_data7.BUILD.hydrateServerSide || import_app_data7.BUILD.hotModuleReplacement) && cmpMeta.$flags$ & 2 /* scopedCssEncapsulation */) {
             styleElm.setAttribute(HYDRATED_STYLE_ID, scopeId2);
           }
-          const injectStyle = (
-            /**
-             * we render a scoped component
-             */
-            !(cmpMeta.$flags$ & 1 /* shadowDomEncapsulation */) || /**
-             * we are using shadow dom and render the style tag within the shadowRoot
-             */
-            cmpMeta.$flags$ & 1 /* shadowDomEncapsulation */ && styleContainerNode.nodeName !== "HEAD"
-          );
-          if (injectStyle) {
-            styleContainerNode.insertBefore(styleElm, styleContainerNode.querySelector("link"));
+          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 : styleContainerNode.querySelector("style");
+              styleContainerNode.insertBefore(styleElm, referenceNode2);
+            } else if ("host" in styleContainerNode) {
+              styleContainerNode.prepend(styleElm, null);
+            } else {
+              styleContainerNode.append(styleElm);
+            }
+          }
+          if (cmpMeta.$flags$ & 1 /* shadowDomEncapsulation */ && styleContainerNode.nodeName !== "HEAD") {
+            styleContainerNode.insertBefore(styleElm, null);
           }
         }
         if (cmpMeta.$flags$ & 4 /* hasSlotRelocation */) {
@@ -1132,7 +1134,11 @@ var setAccessor = (elm, memberName, oldValue, newValue, isSvg, flags) => {
             if (memberName === "list") {
               isProp = false;
             } else if (oldValue == null || elm[memberName] != n) {
-              elm[memberName] = n;
+              if (typeof elm.__lookupSetter__(memberName) === "function") {
+                elm[memberName] = n;
+              } else {
+                elm.setAttribute(memberName, n);
+              }
             }
           } else {
             elm[memberName] = newValue;
@@ -2508,6 +2514,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);
@@ -2549,6 +2560,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);

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal/testing",
-  "version": "4.20.0",
+  "version": "4.22.0",
   "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.20.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Mock Doc (CommonJS) v4.22.0 | 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) {
@@ -7853,6 +7861,11 @@ patchPropAttributes(
     type: "submit"
   }
 );
+Object.defineProperty(MockButtonElement.prototype, "form", {
+  get() {
+    return this.hasAttribute("form") ? this.getAttribute("form") : null;
+  }
+});
 var MockImageElement = class extends MockHTMLElement {
   constructor(ownerDocument) {
     super(ownerDocument, "img");
@@ -8921,6 +8934,21 @@ function resetPerformance(perf) {
   }
 }
 
+// src/mock-doc/resize-observer.ts
+var MockResizeObserver = class {
+  constructor() {
+  }
+  disconnect() {
+  }
+  observe() {
+  }
+  takeRecords() {
+    return [];
+  }
+  unobserve() {
+  }
+};
+
 // src/mock-doc/storage.ts
 var MockStorage = class {
   constructor() {
@@ -9160,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/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.
  *
@@ -963,6 +970,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.20.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Mock Doc v4.22.0 | 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) {
@@ -7800,6 +7808,11 @@ patchPropAttributes(
     type: "submit"
   }
 );
+Object.defineProperty(MockButtonElement.prototype, "form", {
+  get() {
+    return this.hasAttribute("form") ? this.getAttribute("form") : null;
+  }
+});
 var MockImageElement = class extends MockHTMLElement {
   constructor(ownerDocument) {
     super(ownerDocument, "img");
@@ -8868,6 +8881,21 @@ function resetPerformance(perf) {
   }
 }
 
+// src/mock-doc/resize-observer.ts
+var MockResizeObserver = class {
+  constructor() {
+  }
+  disconnect() {
+  }
+  observe() {
+  }
+  takeRecords() {
+    return [];
+  }
+  unobserve() {
+  }
+};
+
 // src/mock-doc/storage.ts
 var MockStorage = class {
   constructor() {
@@ -9107,6 +9135,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.20.0",
+  "version": "4.22.0",
   "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.20.0",
+  "version": "4.22.0",
   "license": "MIT",
   "main": "./internal/rindo-core/index.cjs",
   "module": "./internal/rindo-core/index.js",
@@ -96,11 +96,11 @@
     "build": "npm run clean && npm run tsc.prod && npm run ts scripts/index.ts -- --prod --ci",
     "build.watch": "npm run build -- --watch",
     "build.updateSelectorEngine": "npm run ts scripts/updateSelectorEngine.ts",
-    "clean": "rm -rf build/ cli/ compiler/ dev-server/ internal/ mock-doc/ sys/ testing/ && npm run clean:scripts && npm run clean.screenshots",
-    "clean.screenshots": "rm -rf test/end-to-end/screenshot/builds test/end-to-end/screenshot/images",
-    "clean:scripts": "rm -rf scripts/build",
+    "clean": "rimraf build/ cli/ compiler/ dev-server/ internal/ mock-doc/ sys/ testing/ && npm run clean:scripts && npm run clean.screenshots",
+    "clean.screenshots": "rimraf test/end-to-end/screenshot/builds test/end-to-end/screenshot/images",
+    "clean:scripts": "rimraf scripts/build",
     "lint": "eslint 'bin/*' 'scripts/*.ts' 'scripts/**/*.ts' 'src/*.ts' 'src/**/*.ts' 'src/**/*.tsx'",
-    "install.jest": "bash ./src/testing/jest/install-dependencies.sh",
+    "install.jest": "npx tsx ./src/testing/jest/install-dependencies.mts",
     "prettier": "npm run prettier.base -- --write",
     "prettier.base": "prettier --cache \"./({bin,scripts,src,test}/**/*.{ts,tsx,js,jsx})|bin/rindo|.github/(**/)?*.(yml|yaml)|*.js\"",
     "prettier.dry-run": "npm run prettier.base -- --list-different",
@@ -109,6 +109,7 @@
     "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage",
     "test.analysis": "cd test && npm run analysis.build-and-analyze",
     "test.bundlers": "cd test && npm run bundlers",
+    "test.copytask": "cd test/copy-task && npm ci && npm run test",
     "test.dist": "npm run ts scripts/index.ts -- --validate-build",
     "test.end-to-end": "cd test/end-to-end && npm ci && npm test && npm run test.dist",
     "test.jest": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js",
@@ -152,7 +153,7 @@
     "eslint": "^8.23.1",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-jest": "^28.0.0",
-    "eslint-plugin-jsdoc": "^48.0.0",
+    "eslint-plugin-jsdoc": "^50.0.0",
     "eslint-plugin-simple-import-sort": "^12.0.0",
     "execa": "9.3.0",
     "exit": "^0.1.2",
@@ -177,11 +178,12 @@
     "prettier": "3.3.1",
     "prompts": "2.4.2",
     "puppeteer": "^21.0.0",
+    "rimraf": "^6.0.1",
     "rollup": "2.56.3",
     "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.20.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Screenshot v4.22.0 | 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.20.0",
+  "version": "4.22.0",
   "description": "Rindo Screenshot.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/screenshot/pixel-match.js

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