@tsrx/core 0.0.1

package/src/utils/escaping.js

@@ -0,0 +1,26 @@
+const ATTR_REGEX = /[&"<]/g;
+const CONTENT_REGEX = /[&<]/g;
+
+/**
+ * @template V
+ * @param {V} value
+ * @param {boolean} [is_attr]
+ */
+export function escape(value, is_attr) {
+	const str = String(value ?? '');
+
+	const pattern = is_attr ? ATTR_REGEX : CONTENT_REGEX;
+	pattern.lastIndex = 0;
+
+	let escaped = '';
+	let last = 0;
+
+	while (pattern.test(str)) {
+		const i = pattern.lastIndex - 1;
+		const ch = str[i];
+		escaped += str.substring(last, i) + (ch === '&' ? '&amp;' : ch === '"' ? '&quot;' : '&lt;');
+		last = i + 1;
+	}
+
+	return escaped + str.substring(last);
+}

package/src/utils/events.js

@@ -0,0 +1,154 @@
+/** @import { AddEventObject } from '../../types/index'*/
+
+const NON_DELEGATED_EVENTS = new Set([
+	'abort',
+	'afterprint',
+	'beforeprint',
+	'beforetoggle',
+	'beforeunload',
+	'blur',
+	'close',
+	'command',
+	'contextmenu',
+	'cuechange',
+	'DOMContentLoaded',
+	'error',
+	'focus',
+	'invalid',
+	'load',
+	'loadend',
+	'loadstart',
+	'mouseenter',
+	'mouseleave',
+	'pointerenter',
+	'pointerleave',
+	'progress',
+	'readystatechange',
+	'resize',
+	'scroll',
+	'scrollend',
+	'toggle',
+	'unload',
+	'visibilitychange',
+	// Media Events
+	'canplay',
+	'canplaythrough',
+	'durationchange',
+	'emptied',
+	'encrypted',
+	'ended',
+	'loadeddata',
+	'loadedmetadata',
+	'loadstart',
+	'pause',
+	'play',
+	'playing',
+	'progress',
+	'ratechange',
+	'seeked',
+	'seeking',
+	'stalled',
+	'suspend',
+	'timeupdate',
+	'volumechange',
+	'waiting',
+	'waitingforkey',
+]);
+
+/**
+ * Checks if an event should be delegated
+ * @param {string} event_name - The event name (e.g., 'click', 'focus')
+ * @returns {boolean}
+ */
+export function is_non_delegated(event_name) {
+	return NON_DELEGATED_EVENTS.has(event_name);
+}
+
+/**
+ * Determines if an attribute is an event attribute (e.g., 'onClick').
+ * @param {string} attr - The attribute name.
+ * @returns {boolean}
+ */
+export function is_event_attribute(attr) {
+	return attr.startsWith('on') && attr.length > 2 && attr[2] === attr[2].toUpperCase();
+}
+
+/**
+ * Checks if the event is a capture event.
+ * @param {string} event_name - The event name.
+ * @returns {boolean}
+ */
+export function is_capture_event(event_name) {
+	var lowered = event_name.toLowerCase();
+	return (
+		event_name.endsWith('Capture') &&
+		lowered !== 'gotpointercapture' &&
+		lowered !== 'lostpointercapture'
+	);
+}
+
+/**
+ * Retrieves the original event name from an event attribute.
+ * @param {string} name
+ * @returns {string}
+ */
+export function get_original_event_name(name) {
+	return name.slice(2);
+}
+
+/**
+ * Normalizes the event name to lowercase.
+ * @param {string} name
+ * @returns {string}
+ */
+export function normalize_event_name(name) {
+	return extract_event_name(name).toLowerCase();
+}
+
+/**
+ * Extracts the base event name from an event attribute.
+ * @param {string} name
+ * @returns {string}
+ */
+function extract_event_name(name) {
+	name = get_original_event_name(name);
+
+	if (is_capture_event(name)) {
+		return event_name_from_capture(name);
+	}
+	return name;
+}
+
+/**
+ * Converts a capture event name to its base event name.
+ * @param {string} event_name
+ * @returns {string}
+ */
+export function event_name_from_capture(event_name) {
+	return event_name.slice(0, -7); // strip "Capture"
+}
+
+/**
+ * Converts an event attribute name to the actual event name.
+ * @param {string} name
+ * @param {EventListener | AddEventObject} handler
+ * @returns {string}
+ */
+export function get_attribute_event_name(name, handler) {
+	name = extract_event_name(name);
+
+	return typeof handler === 'object' && handler.customName
+		? handler.customName
+		: name.toLowerCase();
+}
+
+const PASSIVE_EVENTS = ['touchstart', 'touchmove', 'wheel', 'mousewheel'];
+
+/**
+ * Checks if an event is passive (e.g., 'touchstart', 'touchmove').
+ * @param {string} name - The event name.
+ * @returns {boolean}
+ */
+export function is_passive_event(name) {
+	return PASSIVE_EVENTS.includes(name);
+}

package/src/utils/hashing.js

@@ -0,0 +1,15 @@
+const regex_return_characters = /\r/g;
+
+/**
+ * Hashes a string to a base36 value
+ * @param {string} str
+ * @returns {string}
+ */
+export function hash(str) {
+	str = str.replace(regex_return_characters, '');
+	let hash = 5381;
+	let i = str.length;
+
+	while (i--) hash = ((hash << 5) - hash) ^ str.charCodeAt(i);
+	return (hash >>> 0).toString(36);
+}

package/src/utils/normalize_css_property_name.js

@@ -0,0 +1,23 @@
+/** @type {Map<string, string>} */
+const normalized_properties_cache = new Map();
+
+/**
+ * Takes a camelCased string and returns a hyphenated string
+ * @param {string} str
+ * @returns {string}
+ * @example
+ * normalize_css_property_name('backgroundColor') // 'background-color'
+ */
+export function normalize_css_property_name(str) {
+	if (str.startsWith('--')) return str;
+
+	let normalized_result = normalized_properties_cache.get(str);
+	if (normalized_result != null) {
+		return normalized_result;
+	}
+
+	normalized_result = str.replace(/[A-Z]/g, (m) => '-' + m.toLowerCase());
+	normalized_properties_cache.set(str, normalized_result);
+
+	return normalized_result;
+}

package/src/utils/patterns.js

@@ -0,0 +1,24 @@
+export const regex_whitespace = /\s/;
+export const regex_whitespaces = /\s+/;
+export const regex_starts_with_newline = /^\r?\n/;
+export const regex_starts_with_whitespace = /^\s/;
+export const regex_starts_with_whitespaces = /^[ \t\r\n]+/;
+export const regex_ends_with_whitespace = /\s$/;
+export const regex_ends_with_whitespaces = /[ \t\r\n]+$/;
+/** Not \S because that also removes explicit whitespace defined through things like ` ` */
+export const regex_not_whitespace = /[^ \t\r\n]/;
+/** Not \s+ because that also includes explicit whitespace defined through things like ` ` */
+export const regex_whitespaces_strict = /[ \t\n\r\f]+/g;
+
+export const regex_only_whitespaces = /^[ \t\n\r\f]+$/;
+
+export const regex_newline_characters = /\n/g;
+export const regex_not_newline_characters = /[^\n]/g;
+
+export const regex_is_valid_identifier = /^[a-zA-Z_$][a-zA-Z_$0-9]*$/;
+// used in replace all to remove all invalid chars from a literal identifier
+export const regex_invalid_identifier_chars = /(^[^a-zA-Z_$]|[^a-zA-Z0-9_$])/g;
+
+export const regex_starts_with_vowel = /^[aeiou]/;
+export const regex_heading_tags = /^h[1-6]$/;
+export const regex_illegal_attribute_character = /(^[0-9-.])|[\^$@%&#?!|()[\]{}^*+~;]/;

package/src/utils/sanitize_template_string.js

@@ -0,0 +1,7 @@
+/**
+ * @param {string | null | undefined} str
+ * @returns {string}
+ */
+export function sanitize_template_string(str) {
+	return (str ?? '').replace(/(`|\${|\\)/g, '\\$1');
+}

package/src/utils.js

@@ -0,0 +1,165 @@
+/**
+ * Generic compiler utilities for tsrx-based frameworks.
+ * Framework-specific utilities should be in the framework package.
+ */
+
+export { hash } from './utils/hashing.js';
+
+const VOID_ELEMENT_NAMES = [
+	'area',
+	'base',
+	'br',
+	'col',
+	'command',
+	'embed',
+	'hr',
+	'img',
+	'input',
+	'keygen',
+	'link',
+	'meta',
+	'param',
+	'source',
+	'track',
+	'wbr',
+];
+
+/**
+ * Returns true if name is a void element
+ * @param {string} name
+ * @returns {boolean}
+ */
+export function is_void_element(name) {
+	return VOID_ELEMENT_NAMES.includes(name) || name.toLowerCase() === '!doctype';
+}
+
+const RESERVED_WORDS = [
+	'arguments',
+	'await',
+	'break',
+	'case',
+	'catch',
+	'class',
+	'const',
+	'continue',
+	'debugger',
+	'default',
+	'delete',
+	'do',
+	'else',
+	'enum',
+	'eval',
+	'export',
+	'extends',
+	'false',
+	'finally',
+	'for',
+	'function',
+	'if',
+	'implements',
+	'import',
+	'in',
+	'instanceof',
+	'interface',
+	'let',
+	'new',
+	'null',
+	'package',
+	'private',
+	'protected',
+	'public',
+	'return',
+	'static',
+	'super',
+	'switch',
+	'this',
+	'throw',
+	'true',
+	'try',
+	'typeof',
+	'var',
+	'void',
+	'while',
+	'with',
+	'yield',
+];
+
+/**
+ * Returns true if word is a reserved JS keyword
+ * @param {string} word
+ * @returns {boolean}
+ */
+export function is_reserved(word) {
+	return RESERVED_WORDS.includes(word);
+}
+
+/**
+ * Attributes that are boolean, i.e. they are present or not present.
+ */
+const DOM_BOOLEAN_ATTRIBUTES = [
+	'allowfullscreen',
+	'async',
+	'autofocus',
+	'autoplay',
+	'checked',
+	'controls',
+	'default',
+	'disabled',
+	'formnovalidate',
+	'hidden',
+	'indeterminate',
+	'inert',
+	'ismap',
+	'loop',
+	'multiple',
+	'muted',
+	'nomodule',
+	'novalidate',
+	'open',
+	'playsinline',
+	'readonly',
+	'required',
+	'reversed',
+	'seamless',
+	'selected',
+	'webkitdirectory',
+	'defer',
+	'disablepictureinpicture',
+	'disableremoteplayback',
+];
+
+/**
+ * Returns true if name is a boolean DOM attribute
+ * @param {string} name
+ * @returns {boolean}
+ */
+export function is_boolean_attribute(name) {
+	return DOM_BOOLEAN_ATTRIBUTES.includes(name);
+}
+
+const DOM_PROPERTIES = [
+	...DOM_BOOLEAN_ATTRIBUTES,
+	'formNoValidate',
+	'isMap',
+	'noModule',
+	'playsInline',
+	'readOnly',
+	'value',
+	'volume',
+	'defaultValue',
+	'defaultChecked',
+	'srcObject',
+	'noValidate',
+	'allowFullscreen',
+	'disablePictureInPicture',
+	'disableRemotePlayback',
+];
+
+/**
+ * Returns true if name is a DOM property
+ * @param {string} name
+ * @returns {boolean}
+ */
+export function is_dom_property(name) {
+	return DOM_PROPERTIES.includes(name);
+}

package/types/acorn.d.ts

@@ -0,0 +1,3 @@
+// Re-export acorn types with @tsrx/core augmentations applied.
+import './parse';
+export * from 'acorn';

package/types/estree-jsx.d.ts

@@ -0,0 +1,3 @@
+// Re-export estree-jsx types with @tsrx/core augmentations applied.
+import './index';
+export * from 'estree-jsx';

package/types/estree.d.ts

@@ -0,0 +1,3 @@
+// Re-export estree types with @tsrx/core augmentations applied.
+import './index';
+export * from 'estree';