@rindo/core 3.1.0 → 3.2.1

package/internal/app-data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal/app-data",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "Used for default app data and build conditionals within builds.",
   "main": "./index.cjs",
   "module": "./index.js",

package/internal/client/css-shim.js

@@ -1,4 +1,4 @@
 /*
- Rindo Client Patch Esm v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Client Patch Esm v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 var __assign=undefined&&undefined.__assign||function(){return __assign=Object.assign||function(e){for(var t,r=1,n=arguments.length;r<n;r++)for(var s in t=arguments[r])Object.prototype.hasOwnProperty.call(t,s)&&(e[s]=t[s]);return e},__assign.apply(this,arguments)},StyleNode=function(){this.start=0,this.end=0,this.previous=null,this.parent=null,this.rules=null,this.parsedCssText="",this.cssText="",this.atRule=!1,this.type=0,this.keyframesName="",this.selector="",this.parsedSelector="";};function parse(e){return parseCss(lex(e=clean(e)),e)}function clean(e){return e.replace(RX.comments,"").replace(RX.port,"")}function lex(e){var t=new StyleNode;t.start=0,t.end=e.length;for(var r=t,n=0,s=e.length;n<s;n++)if(e[n]===OPEN_BRACE){r.rules||(r.rules=[]);var o=r,a=o.rules[o.rules.length-1]||null;(r=new StyleNode).start=n+1,r.parent=o,r.previous=a,o.rules.push(r);}else e[n]===CLOSE_BRACE&&(r.end=n+1,r=r.parent||t);return t}function parseCss(e,t){var r=t.substring(e.start,e.end-1);if(e.parsedCssText=e.cssText=r.trim(),e.parent){var n=e.previous?e.previous.end:e.parent.start;r=(r=(r=_expandUnicodeEscapes(r=t.substring(n,e.start-1))).replace(RX.multipleSpaces," ")).substring(r.lastIndexOf(";")+1);var s=e.parsedSelector=e.selector=r.trim();e.atRule=0===s.indexOf(AT_START),e.atRule?0===s.indexOf(MEDIA_START)?e.type=types.MEDIA_RULE:s.match(RX.keyframesRule)&&(e.type=types.KEYFRAMES_RULE,e.keyframesName=e.selector.split(RX.multipleSpaces).pop()):0===s.indexOf(VAR_START)?e.type=types.MIXIN_RULE:e.type=types.STYLE_RULE;}var o=e.rules;if(o)for(var a=0,i=o.length,l=void 0;a<i&&(l=o[a]);a++)parseCss(l,t);return e}function _expandUnicodeEscapes(e){return e.replace(/\\([0-9a-f]{1,6})\s/gi,(function(){for(var e=arguments[1],t=6-e.length;t--;)e="0"+e;return "\\"+e}))}var types={STYLE_RULE:1,KEYFRAMES_RULE:7,MEDIA_RULE:4,MIXIN_RULE:1e3},OPEN_BRACE="{",CLOSE_BRACE="}",RX={comments:/\/\*[^*]*\*+([^/*][^*]*\*+)*\//gim,port:/@import[^;]*;/gim,customProp:/(?:^[^;\-\s}]+)?--[^;{}]*?:[^{};]*?(?:[;\n]|$)/gim,mixinProp:/(?:^[^;\-\s}]+)?--[^;{}]*?:[^{};]*?{[^}]*?}(?:[;\n]|$)?/gim,mixinApply:/@apply\s*\(?[^);]*\)?\s*(?:[;\n]|$)?/gim,varApply:/[^;:]*?:[^;]*?var\([^;]*\)(?:[;\n]|$)?/gim,keyframesRule:/^@[^\s]*keyframes/,multipleSpaces:/\s+/g},VAR_START="--",MEDIA_START="@media",AT_START="@",VAR_USAGE_START=/\bvar\(/,VAR_ASSIGN_START=/\B--[\w-]+\s*:/,COMMENTS=/\/\*[^*]*\*+([^/*][^*]*\*+)*\//gim,TRAILING_LINES=/^[\t ]+\n/gm;function findRegex(e,t,r){e.lastIndex=0;var n=t.substring(r).match(e);if(n){var s=r+n.index;return {start:s,end:s+n[0].length}}return null}function resolveVar(e,t,r){return e[t]?e[t]:r?executeTemplate(r,e):""}function findVarEndIndex(e,t){for(var r=0,n=t;n<e.length;n++){var s=e[n];if("("===s)r++;else if(")"===s&&--r<=0)return n+1}return n}function parseVar(e,t){var r=findRegex(VAR_USAGE_START,e,t);if(!r)return null;var n=findVarEndIndex(e,r.start),s=e.substring(r.end,n-1).split(","),o=s[0],a=s.slice(1);return {start:r.start,end:n,propName:o.trim(),fallback:a.length>0?a.join(",").trim():void 0}}function compileVar(e,t,r){var n=parseVar(e,r);if(!n)return t.push(e.substring(r,e.length)),e.length;var s=n.propName,o=null!=n.fallback?compileTemplate(n.fallback):void 0;return t.push(e.substring(r,n.start),(function(e){return resolveVar(e,s,o)})),n.end}function executeTemplate(e,t){for(var r="",n=0;n<e.length;n++){var s=e[n];r+="string"==typeof s?s:s(t);}return r}function findEndValue(e,t){for(var r=!1,n=!1,s=t;s<e.length;s++){var o=e[s];if(r)n&&'"'===o&&(r=!1),n||"'"!==o||(r=!1);else if('"'===o)r=!0,n=!0;else if("'"===o)r=!0,n=!1;else {if(";"===o)return s+1;if("}"===o)return s}}return s}function removeCustomAssigns(e){for(var t="",r=0;;){var n=findRegex(VAR_ASSIGN_START,e,r),s=n?n.start:e.length;if(t+=e.substring(r,s),!n)break;r=findEndValue(e,s);}return t}function compileTemplate(e){var t=0;e=removeCustomAssigns(e=e.replace(COMMENTS,"")).replace(TRAILING_LINES,"");for(var r=[];t<e.length;)t=compileVar(e,r,t);return r}function resolveValues(e){var t={};e.forEach((function(e){e.declarations.forEach((function(e){t[e.prop]=e.value;}));}));for(var r={},n=Object.entries(t),s=function(e){var t=!1;if(n.forEach((function(e){var n=e[0],s=executeTemplate(e[1],r);s!==r[n]&&(r[n]=s,t=!0);})),!t)return "break"},o=0;o<10;o++){if("break"===s())break}return r}function getSelectors(e,t){if(void 0===t&&(t=0),!e.rules)return [];var r=[];return e.rules.filter((function(e){return e.type===types.STYLE_RULE})).forEach((function(e){var n=getDeclarations(e.cssText);n.length>0&&e.parsedSelector.split(",").forEach((function(e){e=e.trim(),r.push({selector:e,declarations:n,specificity:computeSpecificity(),nu:t});})),t++;})),r}function computeSpecificity(e){return 1}var IMPORTANT="!important",FIND_DECLARATIONS=/(?:^|[;\s{]\s*)(--[\w-]*?)\s*:\s*(?:((?:'(?:\\'|.)*?'|"(?:\\"|.)*?"|\([^)]*?\)|[^};{])+)|\{([^}]*)\}(?:(?=[;\s}])|$))/gm;function getDeclarations(e){for(var t,r=[];t=FIND_DECLARATIONS.exec(e.trim());){var n=normalizeValue(t[2]),s=n.value,o=n.important;r.push({prop:t[1].trim(),value:compileTemplate(s),important:o});}return r}function normalizeValue(e){var t=(e=e.replace(/\s+/gim," ").trim()).endsWith(IMPORTANT);return t&&(e=e.slice(0,e.length-IMPORTANT.length).trim()),{value:e,important:t}}function getActiveSelectors(e,t,r){var n=[],s=getScopesForElement(t,e);return r.forEach((function(e){return n.push(e)})),s.forEach((function(e){return n.push(e)})),sortSelectors(getSelectorsForScopes(n).filter((function(t){return matches(e,t.selector)})))}function getScopesForElement(e,t){for(var r=[];t;){var n=e.get(t);n&&r.push(n),t=t.parentElement;}return r}function getSelectorsForScopes(e){var t=[];return e.forEach((function(e){t.push.apply(t,e.selectors);})),t}function sortSelectors(e){return e.sort((function(e,t){return e.specificity===t.specificity?e.nu-t.nu:e.specificity-t.specificity})),e}function matches(e,t){return ":root"===t||"html"===t||e.matches(t)}function parseCSS(e){var t=parse(e),r=compileTemplate(e);return {original:e,template:r,selectors:getSelectors(t),usesCssVars:r.length>1}}function addGlobalStyle(e,t){if(e.some((function(e){return e.styleEl===t})))return !1;var r=parseCSS(t.textContent);return r.styleEl=t,e.push(r),!0}function updateGlobalScopes(e){var t=resolveValues(getSelectorsForScopes(e));e.forEach((function(e){e.usesCssVars&&(e.styleEl.textContent=executeTemplate(e.template,t));}));}function reScope(e,t){var r=e.template.map((function(r){return "string"==typeof r?replaceScope(r,e.scopeId,t):r})),n=e.selectors.map((function(r){return __assign(__assign({},r),{selector:replaceScope(r.selector,e.scopeId,t)})}));return __assign(__assign({},e),{template:r,selectors:n,scopeId:t})}function replaceScope(e,t,r){return e=replaceAll(e,"\\.".concat(t),".".concat(r))}function replaceAll(e,t,r){return e.replace(new RegExp(t,"g"),r)}function loadDocument(e,t){return loadDocumentStyles(e,t),loadDocumentLinks(e,t).then((function(){updateGlobalScopes(t);}))}function startWatcher(e,t){"undefined"!=typeof MutationObserver&&new MutationObserver((function(){loadDocumentStyles(e,t)&&updateGlobalScopes(t);})).observe(document.head,{childList:!0});}function loadDocumentLinks(e,t){for(var r=[],n=e.querySelectorAll('link[rel="stylesheet"][href]:not([data-no-shim])'),s=0;s<n.length;s++)r.push(addGlobalLink(e,t,n[s]));return Promise.all(r)}function loadDocumentStyles(e,t){return Array.from(e.querySelectorAll("style:not([data-styles]):not([data-no-shim])")).map((function(e){return addGlobalStyle(t,e)})).some(Boolean)}function addGlobalLink(e,t,r){var n=r.href;return fetch(n).then((function(e){return e.text()})).then((function(s){if(hasCssVariables(s)&&r.parentNode){hasRelativeUrls(s)&&(s=fixRelativeUrls(s,n));var o=e.createElement("style");o.setAttribute("data-styles",""),o.textContent=s,addGlobalStyle(t,o),r.parentNode.insertBefore(o,r),r.remove();}})).catch((function(e){console.error(e);}))}var CSS_VARIABLE_REGEXP=/[\s;{]--[-a-zA-Z0-9]+\s*:/m;function hasCssVariables(e){return e.indexOf("var(")>-1||CSS_VARIABLE_REGEXP.test(e)}var CSS_URL_REGEXP=/url[\s]*\([\s]*['"]?(?!(?:https?|data)\:|\/)([^\'\"\)]*)[\s]*['"]?\)[\s]*/gim;function hasRelativeUrls(e){return CSS_URL_REGEXP.lastIndex=0,CSS_URL_REGEXP.test(e)}function fixRelativeUrls(e,t){var r=t.replace(/[^/]*$/,"");return e.replace(CSS_URL_REGEXP,(function(e,t){var n=r+t;return e.replace(t,n)}))}var CustomStyle=function(){function e(e,t){this.win=e,this.doc=t,this.count=0,this.hostStyleMap=new WeakMap,this.hostScopeMap=new WeakMap,this.globalScopes=[],this.scopesMap=new Map,this.didInit=!1;}return e.prototype.i=function(){var e=this;return this.didInit||!this.win.requestAnimationFrame?Promise.resolve():(this.didInit=!0,new Promise((function(t){e.win.requestAnimationFrame((function(){startWatcher(e.doc,e.globalScopes),loadDocument(e.doc,e.globalScopes).then((function(){return t()}));}));})))},e.prototype.addLink=function(e){var t=this;return addGlobalLink(this.doc,this.globalScopes,e).then((function(){t.updateGlobal();}))},e.prototype.addGlobalStyle=function(e){addGlobalStyle(this.globalScopes,e)&&this.updateGlobal();},e.prototype.createHostStyle=function(e,t,r,n){if(this.hostScopeMap.has(e))throw new Error("host style already created");var s=this.registerHostTemplate(r,t,n),o=this.doc.createElement("style");return o.setAttribute("data-no-shim",""),s.usesCssVars?n?(o["s-sc"]=t="".concat(s.scopeId,"-").concat(this.count),o.textContent="/*needs update*/",this.hostStyleMap.set(e,o),this.hostScopeMap.set(e,reScope(s,t)),this.count++):(s.styleEl=o,s.usesCssVars||(o.textContent=executeTemplate(s.template,{})),this.globalScopes.push(s),this.updateGlobal(),this.hostScopeMap.set(e,s)):o.textContent=r,o},e.prototype.removeHost=function(e){var t=this.hostStyleMap.get(e);t&&t.remove(),this.hostStyleMap.delete(e),this.hostScopeMap.delete(e);},e.prototype.updateHost=function(e){var t=this.hostScopeMap.get(e);if(t&&t.usesCssVars&&t.isScoped){var r=this.hostStyleMap.get(e);if(r){var n=resolveValues(getActiveSelectors(e,this.hostScopeMap,this.globalScopes));r.textContent=executeTemplate(t.template,n);}}},e.prototype.updateGlobal=function(){updateGlobalScopes(this.globalScopes);},e.prototype.registerHostTemplate=function(e,t,r){var n=this.scopesMap.get(t);return n||((n=parseCSS(e)).scopeId=t,n.isScoped=r,this.scopesMap.set(t,n)),n},e}();!function(e){!e||e.__cssshim||e.CSS&&e.CSS.supports&&e.CSS.supports("color","var(--c)")||(e.__cssshim=new CustomStyle(e,e.document));}("undefined"!=typeof window&&window);

package/internal/client/dom.js

@@ -1,5 +1,5 @@
 /*
- Rindo Client Patch Browser v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Client Patch Browser v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 (function(){
 var aa=new Set("annotation-xml color-profile font-face font-face-src font-face-uri font-face-format font-face-name missing-glyph".split(" "));function g(a){var b=aa.has(a);a=/^[a-z][.0-9_a-z]*-[\-.0-9_a-z]*$/.test(a);return !b&&a}function l(a){var b=a.isConnected;if(void 0!==b)return b;for(;a&&!(a.__CE_isImportDocument||a instanceof Document);)a=a.parentNode||(window.ShadowRoot&&a instanceof ShadowRoot?a.host:void 0);return !(!a||!(a.__CE_isImportDocument||a instanceof Document))}

package/internal/client/index.js

@@ -19,7 +19,7 @@ let renderingRef = null;
 let queueCongestion = 0;
 let queuePending = false;
 /*
- Rindo Client Platform v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Client Platform v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 import { BUILD, NAMESPACE } from '@rindo/core/internal/app-data';
 const Build = {

package/internal/client/package.json

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

package/internal/client/patch-browser.js

@@ -1,5 +1,5 @@
 /*
- Rindo Client Patch Browser v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Client Patch Browser v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 import { BUILD, NAMESPACE } from '@rindo/core/internal/app-data';
 import { consoleDevInfo, plt, win, doc, promiseResolve, H } from '@rindo/core';

package/internal/client/patch-esm.js

@@ -1,5 +1,5 @@
 /*
- Rindo Client Patch Esm v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Client Patch Esm v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 import { BUILD } from '@rindo/core/internal/app-data';
 import { CSS, plt, win, promiseResolve } from '@rindo/core';

package/internal/client/shadow-css.js

@@ -1,5 +1,5 @@
 /*
- Rindo Client Platform v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Client Platform v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 /**
  * @license

package/internal/hydrate/package.json

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

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal",
-  "version": "3.1.0",
+  "version": "3.2.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

@@ -1,5 +1,5 @@
 import type { InMemoryFileSystem } from '../compiler/sys/in-memory-fs';
-import type { BuildEvents, BuildLog, BuildResultsComponentGraph, CompilerBuildResults, CompilerBuildStart, CompilerFsStats, CompilerRequestResponse, CompilerSystem, Config, CopyResults, DevServerConfig, DevServerEditor, Diagnostic, Logger, LoggerLineUpdater, LoggerTimeSpan, OptimizeCssInput, OptimizeCssOutput, OutputTargetWww, PageReloadStrategy, PrerenderConfig, StyleDoc, TaskCommand } from './rindo-public-compiler';
+import type { BuildEvents, BuildLog, BuildResultsComponentGraph, CompilerBuildResults, CompilerBuildStart, CompilerFsStats, CompilerRequestResponse, CompilerSystem, Config, CopyResults, DevServerConfig, DevServerEditor, Diagnostic, Logger, LoggerLineUpdater, LoggerTimeSpan, OptimizeCssInput, OptimizeCssOutput, OutputTarget, OutputTargetWww, PageReloadStrategy, PrerenderConfig, StyleDoc, TaskCommand } from './rindo-public-compiler';
 import type { ComponentInterface, ListenOptions, ListenTargetOptions, VNode, VNodeData } from './rindo-public-runtime';
 export interface SourceMap {
     file: string;
@@ -187,6 +187,9 @@ export interface BuildCtx {
     indexBuildCount: number;
     indexDoc: Document;
     isRebuild: boolean;
+    /**
+     * A collection of Rindo's intermediate representation of components, tied to the current build
+     */
     moduleFiles: Module[];
     packageJson: PackageJsonData;
     pendingCopyTasks: Promise<CopyResults>[];
@@ -571,6 +574,9 @@ export interface CompilerCtx {
     hasSuccessfulBuild: boolean;
     isActivelyBuilding: boolean;
     lastBuildResults: CompilerBuildResults;
+    /**
+     * A mapping of a file path to a Rindo {@link Module}
+     */
     moduleMap: ModuleMap;
     nodeMap: NodeMap;
     resolvedCollections: Set<string>;
@@ -639,6 +645,13 @@ export interface ComponentCompilerFeatures {
     htmlTagNames: string[];
     htmlParts: string[];
     isUpdateable: boolean;
+    /**
+     * A plain component is one that doesn't have:
+     * - any members decorated with `@Prop()`, `@State()`, `@Element()`, `@Method()`
+     * - any methods decorated with `@Listen()`
+     * - any styles
+     * - any lifecycle methods, including `render()`
+     */
     isPlain: boolean;
     potentialCmpRefs: string[];
 }
@@ -709,9 +722,26 @@ export interface ComponentCompilerVirtualProperty {
     docs: string;
 }
 export type ComponentCompilerPropertyType = 'any' | 'string' | 'boolean' | 'number' | 'unknown';
+/**
+ * Information about the type of a Rindo-implemented component property, in
+ * particular a `@Prop()` or `@Event()`.
+ */
 export interface ComponentCompilerPropertyComplexType {
+    /**
+     * The string of the original type annotation in the Rindo source code
+     */
     original: string;
+    /**
+     * A 'resolved' type, where e.g. imported types have been resolved and inlined
+     *
+     * For instance, an annotation like `(foo: Foo) => string;` will be
+     * converted to `(foo: { foo: string }) => string;`.
+     */
     resolved: string;
+    /**
+     * A record of the types which were referenced in the assorted type
+     * annotation in the original source file.
+     */
     references: ComponentCompilerTypeReferences;
 }
 /**
@@ -1155,18 +1185,33 @@ export interface MinifyJsResult {
         pos: number;
     };
 }
+/**
+ * A mapping from a TypeScript or JavaScript source file path on disk, to a Rindo {@link Module}.
+ *
+ * It is advised that the key (path) be normalized before storing/retrieving the `Module` to avoid unnecessary lookup
+ * failures.
+ */
 export type ModuleMap = Map<string, Module>;
 /**
  * Rindo's Intermediate Representation (IR) of a module, bundling together
  * various pieces of information like the classes declared within it, the path
  * to the original source file, HTML tag names defined in the file, and so on.
  *
- * Note that this gets serialized/parsed as JSON and therefore cannot be a
+ * Note that this gets serialized/parsed as JSON and therefore cannot contain a
  * `Map` or a `Set`.
  */
 export interface Module {
     cmps: ComponentCompilerMeta[];
+    /**
+     * A collection of modules that a component will need. The modules in this list must have import statements generated
+     * in order for the component to function.
+     */
     coreRuntimeApis: string[];
+    /**
+     * A collection of modules that a component will need for a specific output target. The modules in this list must
+     * have import statements generated in order for the component to function, but only for a specific output target.
+     */
+    outputTargetCoreRuntimeApis: Partial<Record<OutputTarget['type'], string[]>>;
     collectionName: string;
     dtsFilePath: string;
     excludeFromCollection: boolean;

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

@@ -272,8 +272,17 @@ export interface ConfigExtras {
      * loading components when using a bundler such as Wite or Parcel. Setting this flag to `true` will change how Rindo
      * lazily loads components in a way that works with additional bundlers. Setting this flag to `true` will increase
      * the size of the compiled output. Defaults to `false`.
+     * @deprecated This flag has been deprecated in favor of `enableImportInjection`, which provides the same
+     * functionality. `experimentalImportInjection` will be removed in a future major version of Rindo.
      */
     experimentalImportInjection?: boolean;
+    /**
+     * Projects that use a Rindo library built using the `dist` output target may have trouble lazily
+     * loading components when using a bundler such as Vite or Parcel. Setting this flag to `true` will change how Rindo
+     * lazily loads components in a way that works with additional bundlers. Setting this flag to `true` will increase
+     * the size of the compiled output. Defaults to `false`.
+     */
+    enableImportInjection?: boolean;
     /**
      * Dispatches component lifecycle events. Mainly used for testing. Defaults to `false`.
      */
@@ -1082,7 +1091,23 @@ export interface CompilerSystem {
     statSync(p: string): CompilerFsStats;
     tmpDirSync(): string;
     watchDirectory?(p: string, callback: CompilerFileWatcherCallback, recursive?: boolean): CompilerFileWatcher;
-    watchFile?(p: string, callback: CompilerFileWatcherCallback): CompilerFileWatcher;
+    /**
+     * A `watchFile` implementation in order to hook into the rest of the {@link CompilerSystem} implementation that is
+     * used when running Rindo's compiler in "watch mode".
+     *
+     * It is analogous to TypeScript's `watchFile`  implementation.
+     *
+     * Note, this function may be called for full builds of Rindo projects by the TypeScript compiler. It should not
+     * assume that it will only be called in watch mode.
+     *
+     * This function should not perform any file watcher registration itself. Each `path` provided to it when called
+     * should already have been registered as a file to watch.
+     *
+     * @param path the path to the file that is being watched
+     * @param callback a callback to invoke when a file that is being watched has changed in some way
+     * @returns an object with a method for unhooking the file watcher from the system
+     */
+    watchFile?(path: string, callback: CompilerFileWatcherCallback): CompilerFileWatcher;
     /**
      * How many milliseconds to wait after a change before calling watch callbacks.
      */
@@ -1259,7 +1284,16 @@ export interface CompilerBuildStart {
     buildId: number;
     timestamp: string;
 }
+/**
+ * A type describing a function to call when an event is emitted by a file watcher
+ * @param fileName the path of the file tied to event
+ * @param eventKind a variant describing the type of event that was emitter (added, edited, etc.)
+ */
 export type CompilerFileWatcherCallback = (fileName: string, eventKind: CompilerFileWatcherEvent) => void;
+/**
+ * A type describing the different types of events that Rindo expects may happen when a file being watched is altered
+ * in some way
+ */
 export type CompilerFileWatcherEvent = CompilerEventFileAdd | CompilerEventFileDelete | CompilerEventFileUpdate | CompilerEventDirAdd | CompilerEventDirDelete;
 export type CompilerEventName = CompilerEventFsChange | CompilerEventFileUpdate | CompilerEventFileAdd | CompilerEventFileDelete | CompilerEventDirAdd | CompilerEventDirDelete | CompilerEventBuildStart | CompilerEventBuildFinish | CompilerEventBuildNoChange | CompilerEventBuildLog;
 export type CompilerEventFsChange = 'fsChange';
@@ -1862,6 +1896,12 @@ export interface OutputTargetDocsReadme extends OutputTargetBase {
 export interface OutputTargetDocsJson extends OutputTargetBase {
     type: 'docs-json';
     file: string;
+    /**
+     * Set an optional file path where Rindo should write a `d.ts` file to disk
+     * at build-time containing type declarations for {@link JsonDocs} and related
+     * interfaces. If this is omitted or set to `null` Rindo will not write such
+     * a file.
+     */
     typesFile?: string | null;
     strict?: boolean;
 }
@@ -1924,14 +1964,6 @@ export interface OutputTargetDistCustomElements extends OutputTargetBaseNext {
      */
     customElementsExportBehavior?: CustomElementsExportBehavior;
 }
-export interface OutputTargetDistCustomElementsBundle extends OutputTargetBaseNext {
-    type: 'dist-custom-elements-bundle';
-    empty?: boolean;
-    externalRuntime?: boolean;
-    copy?: CopyTask[];
-    includeGlobalScripts?: boolean;
-    minify?: boolean;
-}
 /**
  * The base type for output targets. All output targets should extend this base type.
  */
@@ -2021,7 +2053,7 @@ export interface OutputTargetWww extends OutputTargetBase {
     serviceWorker?: ServiceWorkerConfig | null | false;
     appDir?: string;
 }
-export type OutputTarget = OutputTargetCopy | OutputTargetCustom | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistCustomElementsBundle | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
+export type OutputTarget = OutputTargetCopy | OutputTargetCustom | OutputTargetDist | OutputTargetDistCollection | OutputTargetDistCustomElements | OutputTargetDistLazy | OutputTargetDistGlobalStyles | OutputTargetDistLazyLoader | OutputTargetDocsJson | OutputTargetDocsCustom | OutputTargetDocsReadme | OutputTargetDocsVscode | OutputTargetWww | OutputTargetHydrate | OutputTargetStats | OutputTargetDistTypes;
 export interface ServiceWorkerConfig {
     unregister?: boolean;
     swDest?: string;
@@ -2180,9 +2212,17 @@ export interface LazyRequire {
     require(fromDir: string, moduleId: string): any;
     getModulePath(fromDir: string, moduleId: string): string;
 }
+/**
+ * @deprecated This interface is no longer used by Rindo
+ * TODO: Remove this interface
+ */
 export interface FsWatcherItem {
     close(): void;
 }
+/**
+ * @deprecated This interface is no longer used by Rindo
+ * TODO: Remove this interface
+ */
 export interface MakeDirectoryOptions {
     /**
      * Indicates whether parent folders should be created.
@@ -2195,6 +2235,10 @@ export interface MakeDirectoryOptions {
      */
     mode?: number;
 }
+/**
+ * @deprecated This interface is no longer used by Rindo
+ * TODO: Remove this interface
+ */
 export interface FsStats {
     isFile(): boolean;
     isDirectory(): boolean;

package/internal/testing/index.js

@@ -93,7 +93,11 @@ function stopAutoApplyChanges() {
  isAutoApplyingChanges = !1, autoApplyTimer && (clearTimeout(autoApplyTimer), autoApplyTimer = void 0);
 }
 
-const mockDoc = require("@rindo/core/mock-doc"), appData = require("@rindo/core/internal/app-data"), styles = new Map, modeResolutionChain = [], cstrs = new Map, queuedTicks = [], queuedWriteTasks = [], queuedReadTasks = [], moduleLoaded = new Map, queuedLoadModules = [], caughtErrors = [], hostRefs = new Map, getAssetPath = e => {
+const mockDoc = require("@rindo/core/mock-doc"), appData = require("@rindo/core/internal/app-data");
+
+require("path");
+
+const styles = new Map, modeResolutionChain = [], cstrs = new Map, queuedTicks = [], queuedWriteTasks = [], queuedReadTasks = [], moduleLoaded = new Map, queuedLoadModules = [], caughtErrors = [], hostRefs = new Map, getAssetPath = e => {
  const t = new URL(e, plt.$resourcesUrl$);
  return t.origin !== win.location.origin ? t.href : t.pathname;
 };

package/internal/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal/testing",
-  "version": "3.1.0",
+  "version": "3.2.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) v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Mock Doc (CommonJS) v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 var mockDoc = (function(exports) {
 'use strict';
@@ -3997,9 +3997,14 @@ class MockWindow {
       this.__location = val;
     }
   }
-  matchMedia() {
+  matchMedia(media) {
     return {
+      media,
       matches: false,
+      addEventListener,
+      dispatchEvent,
+      removeEventListener,
+      onchange: null,
     };
   }
   get Node() {

package/mock-doc/index.d.ts

@@ -890,8 +890,13 @@ declare class MockWindow {
   set localStorage(locStorage: MockStorage);
   get location(): MockLocation;
   set location(val: Location | string);
-  matchMedia(): {
+  matchMedia(media: string): {
+    media: string;
     matches: boolean;
+    addEventListener: typeof addEventListener;
+    dispatchEvent: typeof dispatchEvent;
+    removeEventListener: typeof removeEventListener;
+    onchange: (this: MediaQueryList, ev: MediaQueryListEvent) => any;
   };
   get Node(): any;
   get NodeList(): any;

package/mock-doc/index.js

@@ -1,5 +1,5 @@
 /*!
- Rindo Mock Doc v3.1.0 | MIT Licensed | https://rindojs.web.app
+ Rindo Mock Doc v3.2.1 | MIT Licensed | https://rindojs.web.app
  */
 const CONTENT_REF_ID = 'r';
 const ORG_LOCATION_ID = 'o';
@@ -3994,9 +3994,14 @@ class MockWindow {
       this.__location = val;
     }
   }
-  matchMedia() {
+  matchMedia(media) {
     return {
+      media,
       matches: false,
+      addEventListener,
+      dispatchEvent,
+      removeEventListener,
+      onchange: null,
     };
   }
   get Node() {

package/mock-doc/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/mock-doc",
-  "version": "3.1.0",
+  "version": "3.2.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": "3.1.0",
+  "version": "3.2.1",
   "license": "MIT",
   "main": "./internal/rindo-core/index.cjs",
   "module": "./internal/rindo-core/index.js",
@@ -91,12 +91,12 @@
     "jest-cli": "^27.4.5",
     "jest-environment-node": "^27.4.4",
     "listr": "^0.14.3",
-    "magic-string": "^0.29.0",
+    "magic-string": "^0.30.0",
     "merge-source-map": "^1.1.0",
     "mime-db": "^1.46.0",
     "minimatch": "5.1.2",
     "node-fetch": "2.6.7",
-    "open": "^8.4.0",
+    "open": "^9.0.0",
     "open-in-editor": "2.2.0",
     "parse5": "7.1.2",
     "path-browserify": "^1.0.1",

package/screenshot/package.json

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