@stencil/core 5.0.0-alpha.1 → 5.0.0-alpha.10

package/dist/regular-expression-CFVJOTUh.mjs

@@ -0,0 +1,508 @@
+const MEMBER_FLAGS = {
+	String: 1,
+	Number: 2,
+	Boolean: 4,
+	Any: 8,
+	Unknown: 16,
+	State: 32,
+	Method: 64,
+	Event: 128,
+	Element: 256,
+	ReflectAttr: 512,
+	Mutable: 1024,
+	Getter: 2048,
+	Setter: 4096,
+	Prop: 31,
+	HasAttribute: 31,
+	PropLike: 63
+};
+const WATCH_FLAGS = { Immediate: 1 };
+const EVENT_FLAGS = {
+	Cancellable: 1,
+	Composed: 2,
+	Bubbles: 4
+};
+const LISTENER_FLAGS = {
+	Passive: 1,
+	Capture: 2,
+	TargetDocument: 4,
+	TargetWindow: 8,
+	TargetBody: 16
+};
+const HOST_FLAGS = {
+	hasConnected: 1,
+	hasRendered: 2,
+	isWaitingForChildren: 4,
+	isConstructingInstance: 8,
+	isQueuedForUpdate: 16,
+	hasInitializedComponent: 32,
+	hasLoadedComponent: 64,
+	isWatchReady: 128,
+	isListenReady: 256,
+	needsRerender: 512,
+	devOnRender: 1024,
+	devOnDidLoad: 2048
+};
+const CF_scopedCssEncapsulation = 2;
+/**
+* A set of flags used for bitwise calculations against {@link ComponentRuntimeMeta#$flags$}.
+*
+* These flags should only be used in conjunction with {@link ComponentRuntimeMeta#$flags$}.
+* They should _not_ be used for calculations against other fields/numbers
+*/
+const CMP_FLAGS = {
+	/**
+	* Used to determine if a component is using the shadow DOM.
+	* e.g. `shadow: true | {}` is set on the `@Component()` decorator
+	*/
+	shadowDomEncapsulation: 1,
+	/**
+	* Used to determine if a component is using scoped stylesheets
+	* e.g. `scoped: true` is set on the `@Component()` decorator
+	*/
+	scopedCssEncapsulation: CF_scopedCssEncapsulation,
+	/**
+	* Used to determine if a component does not use the shadow DOM _and_ has `<slot/>` tags in its markup.
+	*/
+	hasSlotRelocation: 4,
+	/**
+	* Determines if `delegatesFocus` is enabled for a component that uses the shadow DOM.
+	* e.g. `shadow: { delegatesFocus: true }` is set on the `@Component()` decorator
+	*/
+	shadowDelegatesFocus: 16,
+	/**
+	* Determines if `mode` is set on the `@Component()` decorator
+	*/
+	hasMode: 32,
+	/**
+	* Determines if styles must be scoped - i.e. the component uses scoped stylesheets.
+	*/
+	needsScopedEncapsulation: CF_scopedCssEncapsulation,
+	/**
+	* Determines if a component is form-associated or not. This is set based on
+	* options passed to the `@Component` decorator.
+	*/
+	formAssociated: 64,
+	/**
+	* Determines if a `shadow: true` component needs
+	* to have its styles scoped during SSR as opposed to using DSD.
+	*/
+	shadowNeedsScopedCss: 128,
+	/**
+	* Determines if a component has a `<slot>` in its template.
+	*/
+	hasSlot: 256,
+	/**
+	* Determines if a component uses modern class property declarations.
+	*/
+	hasModernPropertyDecls: 512,
+	/**
+	* Determines if `slotAssignment` is set to `'manual'` for a component that uses the shadow DOM.
+	* e.g. `shadow: { slotAssignment: 'manual' }` is set on the `@Component()` decorator
+	*/
+	shadowSlotAssignmentManual: 1024,
+	/**
+	* Determines if the shadow DOM mode is 'closed'.
+	* e.g. `encapsulation: { type: 'shadow', mode: 'closed' }` is set on the `@Component()` decorator
+	*/
+	shadowModeClosed: 2048,
+	/**
+	* Determines if the component should patch child node accessors for slot handling.
+	* e.g. `encapsulation: { type: 'none', patches: ['children'] }`
+	*/
+	patchChildren: 4096,
+	/**
+	* Determines if the component should patch cloneNode() for slot handling.
+	* e.g. `encapsulation: { type: 'none', patches: ['clone'] }`
+	*/
+	patchClone: 8192,
+	/**
+	* Determines if the component should patch appendChild/insertBefore for slot handling.
+	* e.g. `encapsulation: { type: 'none', patches: ['insert'] }`
+	*/
+	patchInsert: 16384,
+	/**
+	* Determines if the component should apply all slot patches.
+	* e.g. `encapsulation: { type: 'none', patches: ['all'] }`
+	* Equivalent to the global `experimentalSlotFixes` config option.
+	*/
+	patchAll: 32768
+};
+/**
+* Default style mode id
+*/
+const DEFAULT_STYLE_MODE = "$";
+/**
+* Namespaces
+*/
+const SVG_NS = "http://www.w3.org/2000/svg";
+const HTML_NS = "http://www.w3.org/1999/xhtml";
+const XLINK_NS = "http://www.w3.org/1999/xlink";
+/**
+* File names and value
+*/
+const COLLECTION_MANIFEST_FILE_NAME = "collection-manifest.json";
+const COLLECTION_APP_DATA_FILE_NAME = "app-data.js";
+/**
+* Constant for the 'copy' output target
+*/
+const COPY = "copy";
+/**
+* Constant for the 'custom' output target
+*/
+const CUSTOM = "custom";
+/**
+* Constant for the 'loader-bundle' output target
+* (formerly 'dist' in v4)
+*/
+const LOADER_BUNDLE = "loader-bundle";
+/**
+* Constant for the 'standalone' output target
+* (formerly 'dist-custom-elements' in v4)
+*/
+const STANDALONE = "standalone";
+/**
+* Constant for the 'ssr' output target
+* (formerly 'dist-hydrate-script' in v4)
+*/
+const SSR = "ssr";
+/**
+* Constant for the 'ssr-wasm' output target.
+* Compiles the SSR script to a WASM binary via javy for use in any WASM-capable host
+* (PHP, Java, Ruby, Go, etc.) without requiring a JavaScript runtime.
+*/
+const SSR_WASM = "ssr-wasm";
+/**
+* Constant for the 'collection' output target
+* (formerly 'dist-collection' sub-output in v4)
+*
+* Contains transpiled source + metadata for downstream Stencil projects
+* to re-compile/bundle.
+*/
+const COLLECTION = "collection";
+/**
+* Constant for the 'types' output target
+* (formerly 'dist-types' sub-output in v4)
+*/
+const TYPES = "types";
+/**
+* Constant for the 'global-style' output target
+* Outputs global styles to a unified location available to all distributions.
+*/
+const GLOBAL_STYLE = "global-style";
+/**
+* Constant for the 'assets' output target
+* Copies component assetsDirs to a unified location available to all distributions.
+*/
+const ASSETS = "assets";
+/**
+* Internal constant for the 'dist-lazy' output target
+* (used by loader-bundle and www)
+*/
+const DIST_LAZY = "dist-lazy";
+/**
+* Constant for the 'docs-custom' output target
+*/
+const DOCS_CUSTOM = "docs-custom";
+/**
+* Constant for the 'docs-json' output target
+*/
+const DOCS_JSON = "docs-json";
+/**
+* Constant for the 'docs-readme' output target
+*/
+const DOCS_README = "docs-readme";
+/**
+* Constant for the 'docs-vscode' output target
+*/
+const DOCS_VSCODE = "docs-vscode";
+/**
+* Constant for the 'docs-custom-elements-manifest' output target
+*/
+const DOCS_CUSTOM_ELEMENTS_MANIFEST = "docs-custom-elements-manifest";
+/**
+* Constant for the 'stats' output target
+*/
+const STATS = "stats";
+/**
+* Constant for the 'www' output target
+*/
+const WWW = "www";
+/**
+* Valid output targets to specify in a Stencil config.
+*
+* Note that some internal output targets (e.g. `DIST_LAZY`, `DIST_GLOBAL_STYLES`)
+* are programmatically created by the compiler and are not user-configurable.
+*
+* In v5, `TYPES` and `COLLECTION` are auto-generated in production builds unless explicitly configured.
+*/
+const VALID_CONFIG_OUTPUT_TARGETS = [
+	"www",
+	LOADER_BUNDLE,
+	STANDALONE,
+	"ssr",
+	SSR_WASM,
+	COLLECTION,
+	TYPES,
+	GLOBAL_STYLE,
+	ASSETS,
+	"dist",
+	"dist-custom-elements",
+	"dist-hydrate-script",
+	"dist-collection",
+	"dist-types",
+	DOCS_JSON,
+	DOCS_README,
+	DOCS_VSCODE,
+	DOCS_CUSTOM,
+	DOCS_CUSTOM_ELEMENTS_MANIFEST,
+	COPY,
+	CUSTOM,
+	STATS
+];
+const GENERATED_DTS = "components.d.ts";
+const STYLE_EXT = [
+	"css",
+	"scss",
+	"sass",
+	"pcss",
+	"styl",
+	"stylus",
+	"less"
+];
+/**
+* DOM Node types
+*
+* See https://developer.mozilla.org/en-US/docs/Web/API/Node/nodeType
+*
+* Note: this is a duplicate of the `NODE_TYPES` enum in mock-doc, it's
+* copied over here so that we do not need to introduce a dependency on the
+* mock-doc bundle in the runtime. See
+* https://github.com/stenciljs/core/pull/5705 for more details.
+*/
+const NODE_TYPES = {
+	ELEMENT_NODE: 1,
+	ATTRIBUTE_NODE: 2,
+	TEXT_NODE: 3,
+	CDATA_SECTION_NODE: 4,
+	ENTITY_REFERENCE_NODE: 5,
+	ENTITY_NODE: 6,
+	PROCESSING_INSTRUCTION_NODE: 7,
+	COMMENT_NODE: 8,
+	DOCUMENT_NODE: 9,
+	DOCUMENT_TYPE_NODE: 10,
+	DOCUMENT_FRAGMENT_NODE: 11,
+	NOTATION_NODE: 12
+};
+//#endregion
+//#region src/utils/query-nonce-meta-tag-content.ts
+/**
+* Helper method for querying a `meta` tag that contains a nonce value
+* out of a DOM's head.
+*
+* @param doc The DOM containing the `head` to query against
+* @returns The content of the meta tag representing the nonce value, or `undefined` if no tag
+* exists or the tag has no content.
+*/
+function queryNonceMetaTagContent(doc) {
+	return doc.head?.querySelector("meta[name=\"csp-nonce\"]")?.getAttribute("content") ?? void 0;
+}
+//#endregion
+//#region src/utils/helpers.ts
+/**
+* Check if a value is defined (not null and not undefined).
+*
+* @param v - the value to check
+* @returns true if the value is defined
+*/
+const isDef = (v) => v != null && v !== void 0;
+/**
+* Convert a string from PascalCase to dash-case
+*
+* @param str the string to convert
+* @returns a converted string
+*/
+const toDashCase = (str) => str.replace(/([A-Z0-9])/g, (match) => ` ${match[0]}`).trim().split(" ").join("-").toLowerCase();
+/**
+* Convert a string from dash-case / kebab-case to PascalCase (or CamelCase,
+* or whatever you call it!)
+*
+* @param str a string to convert
+* @returns a converted string
+*/
+const dashToPascalCase = (str) => str.toLowerCase().split("-").map((segment) => segment.charAt(0).toUpperCase() + segment.slice(1)).join("");
+/**
+* Convert a string to 'camelCase'
+*
+* @param str the string to convert
+* @returns the converted string
+*/
+const toCamelCase = (str) => {
+	const pascalCase = dashToPascalCase(str);
+	return pascalCase.charAt(0).toLowerCase() + pascalCase.slice(1);
+};
+/**
+* Capitalize the first letter of a string
+*
+* @param str the string to capitalize
+* @returns a capitalized string
+*/
+const toTitleCase = (str) => str.charAt(0).toUpperCase() + str.slice(1);
+/**
+* Escapes all occurrences of a specified pattern in a string.
+* This function replaces all matches of a given pattern in the input text with a specified replacement string.
+* It can handle both string and regular expression patterns and allows toggling between global and single-match replacements.
+*
+* @param text - The input string to process.
+* @param pattern - The pattern to search for in the input string. Can be a regular expression or a string.
+* @param replacement - The string to replace each match with.
+* @param replaceAll - Whether to replace all occurrences (true) or just the first occurrence (false). Defaults to true.
+* @returns The processed string with the replacements applied.
+*/
+const escapeWithPattern = (text, pattern, replacement, replaceAll = true) => {
+	let regex;
+	if (typeof pattern === "string") {
+		const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		regex = new RegExp(escaped, replaceAll ? "g" : "");
+	} else {
+		const flags = pattern.flags;
+		const hasG = flags.includes("g");
+		const newFlags = replaceAll ? hasG ? flags : flags + "g" : hasG ? flags.replace(/g/g, "") : flags;
+		regex = new RegExp(pattern.source, newFlags);
+	}
+	return text.replace(regex, replacement);
+};
+/**
+* This is just a no-op, don't expect it to do anything.
+*/
+const noop = () => {};
+/**
+* Check whether a value is a 'complex type', defined here as an object or a
+* function.
+*
+* @param o the value to check
+* @returns whether it's a complex type or not
+*/
+const isComplexType = (o) => {
+	o = typeof o;
+	return o === "object" || o === "function";
+};
+/**
+* Sort an array without mutating it in-place (as `Array.prototype.sort`
+* unfortunately does)
+*
+* @param array the array you'd like to sort
+* @param prop a function for deriving sortable values (strings or numbers)
+* from array members
+* @returns a new array of all items `x` in `array` ordered by `prop(x)`
+*/
+const sortBy = (array, prop) => {
+	return array.slice().sort((a, b) => {
+		const nameA = prop(a);
+		const nameB = prop(b);
+		if (nameA < nameB) return -1;
+		if (nameA > nameB) return 1;
+		return 0;
+	});
+};
+/**
+* A polyfill of sorts for `Array.prototype.flat` which will return the result
+* of calling that method if present and, if not, return an equivalent based on
+* `Array.prototype.reduce`.
+*
+* @param array the array to flatten (one level)
+* @returns a flattened array
+*/
+const flatOne = (array) => {
+	if (array.flat) return array.flat(1);
+	return array.reduce((result, item) => {
+		result.push(...item);
+		return result;
+	}, []);
+};
+/**
+* Deduplicate an array, retaining items at the earliest position in which
+* they appear.
+*
+* So `unique([1,3,2,1,1,4])` would be `[1,3,2,4]`.
+*
+* @param array the array to deduplicate
+* @param predicate an optional function used to generate the key used to
+* determine uniqueness
+* @returns a new, deduplicated array
+*/
+const unique = (array, predicate = (i) => i) => {
+	const set = /* @__PURE__ */ new Set();
+	return array.filter((item) => {
+		const key = predicate(item);
+		if (key == null) return true;
+		if (set.has(key)) return false;
+		set.add(key);
+		return true;
+	});
+};
+/**
+* Merge elements of an array into an existing array, using a predicate to
+* determine uniqueness and only adding elements when they are not present in
+* the first array.
+*
+* **Note**: this mutates the target array! This is intentional to avoid
+* unnecessary array allocation, but be sure that it's what you want!
+*
+* @param target the target array, to which new unique items should be added
+* @param newItems a list of new items, some (or all!) of which may be added
+* @param mergeWith a predicate function which reduces the items in `target`
+* and `newItems` to a value which can be equated with `===` for the purposes
+* of determining uniqueness
+*/
+function mergeIntoWith(target, newItems, mergeWith) {
+	for (const item of newItems) if (!target.find((existingItem) => mergeWith(existingItem) === mergeWith(item))) target.push(item);
+}
+/**
+* A utility for building an object from an iterable very similar to
+* `Object.fromEntries`
+*
+* @param entries an iterable object holding entries (key-value tuples) to
+* plop into a new object
+* @returns an object containing those entries
+*/
+const fromEntries = (entries) => {
+	const object = {};
+	for (const [key, value] of entries) object[key] = value;
+	return object;
+};
+/**
+* Based on a given object, create a new object which has only the specified
+* key-value pairs included in it.
+*
+* @param obj the object from which to take values
+* @param keys a set of keys to take
+* @returns an object mapping `key` to `obj[key]` if `obj[key]` is truthy for
+* every `key` in `keys`
+*/
+const pluck = (obj, keys) => {
+	return keys.reduce((final, key) => {
+		if (obj[key]) final[key] = obj[key];
+		return final;
+	}, {});
+};
+const isDefined = (v) => v !== null && v !== void 0;
+const isBoolean = (v) => typeof v === "boolean";
+const isFunction = (v) => typeof v === "function";
+const isNumber = (v) => typeof v === "number";
+const isObject = (val) => val != null && typeof val === "object" && Array.isArray(val) === false;
+const isString = (v) => typeof v === "string";
+const isIterable = (v) => isDefined(v) && isFunction(v[Symbol.iterator]);
+//#endregion
+//#region src/utils/regular-expression.ts
+/**
+* Utility function that will escape all regular expression special characters in a string.
+*
+* @param text The string potentially containing special characters.
+* @returns The string with all special characters escaped.
+*/
+const escapeRegExpSpecialCharacters = (text) => {
+	return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
+//#endregion
+export { VALID_CONFIG_OUTPUT_TARGETS as $, DEFAULT_STYLE_MODE as A, HOST_FLAGS as B, ASSETS as C, COLLECTION_MANIFEST_FILE_NAME as D, COLLECTION_APP_DATA_FILE_NAME as E, DOCS_README as F, NODE_TYPES as G, LISTENER_FLAGS as H, DOCS_VSCODE as I, STANDALONE as J, SSR as K, EVENT_FLAGS as L, DOCS_CUSTOM as M, DOCS_CUSTOM_ELEMENTS_MANIFEST as N, COPY as O, DOCS_JSON as P, TYPES as Q, GENERATED_DTS as R, queryNonceMetaTagContent as S, COLLECTION as T, LOADER_BUNDLE as U, HTML_NS as V, MEMBER_FLAGS as W, STYLE_EXT as X, STATS as Y, SVG_NS as Z, sortBy as _, fromEntries as a, toTitleCase as b, isDef as c, isNumber as d, WATCH_FLAGS as et, isObject as f, pluck as g, noop as h, flatOne as i, DIST_LAZY as j, CUSTOM as k, isFunction as l, mergeIntoWith as m, dashToPascalCase as n, XLINK_NS as nt, isBoolean as o, isString as p, SSR_WASM as q, escapeWithPattern as r, isComplexType as s, escapeRegExpSpecialCharacters as t, WWW as tt, isIterable as u, toCamelCase as v, CMP_FLAGS as w, unique as x, toDashCase as y, GLOBAL_STYLE as z };