@openelement/core 0.41.0-alpha.1

package/src/tag-utils.js

@@ -0,0 +1,28 @@
+/**
+ * @openelement/core — Tag name validation utility.
+ *
+ * Validates custom element tag names per HTML spec:
+ * - Must contain at least one hyphen
+ * - Must start with a lowercase letter
+ * - Only lowercase letters, digits, and hyphens allowed
+ * - Must not be a reserved name
+ *
+ * @module @openelement/core/tag-utils
+ */ /** Check if a tag name is a valid custom element name per HTML spec. */ export function isValidTagName(tagName) {
+  if (!tagName || typeof tagName !== 'string') return false;
+  const reserved = new Set([
+    'annotation-xml',
+    'color-profile',
+    'font-face',
+    'font-face-src',
+    'font-face-uri',
+    'font-face-format',
+    'font-face-name',
+    'missing-glyph'
+  ]);
+  if (reserved.has(tagName)) return false;
+  // Must start with a lowercase letter, contain at least one hyphen,
+  // and only contain [a-z], [0-9], and hyphens.
+  return /^[a-z][a-z0-9]*(-[a-z0-9]+)+$/.test(tagName);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImZpbGU6Ly8vaG9tZS9ydW5uZXIvd29yay9vcGVuZWxlbWVudC9vcGVuZWxlbWVudC9wYWNrYWdlcy9jb3JlL3NyYy90YWctdXRpbHMudHMiXSwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBAb3BlbmVsZW1lbnQvY29yZSDigJQgVGFnIG5hbWUgdmFsaWRhdGlvbiB1dGlsaXR5LlxuICpcbiAqIFZhbGlkYXRlcyBjdXN0b20gZWxlbWVudCB0YWcgbmFtZXMgcGVyIEhUTUwgc3BlYzpcbiAqIC0gTXVzdCBjb250YWluIGF0IGxlYXN0IG9uZSBoeXBoZW5cbiAqIC0gTXVzdCBzdGFydCB3aXRoIGEgbG93ZXJjYXNlIGxldHRlclxuICogLSBPbmx5IGxvd2VyY2FzZSBsZXR0ZXJzLCBkaWdpdHMsIGFuZCBoeXBoZW5zIGFsbG93ZWRcbiAqIC0gTXVzdCBub3QgYmUgYSByZXNlcnZlZCBuYW1lXG4gKlxuICogQG1vZHVsZSBAb3BlbmVsZW1lbnQvY29yZS90YWctdXRpbHNcbiAqL1xuXG4vKiogQ2hlY2sgaWYgYSB0YWcgbmFtZSBpcyBhIHZhbGlkIGN1c3RvbSBlbGVtZW50IG5hbWUgcGVyIEhUTUwgc3BlYy4gKi9cbmV4cG9ydCBmdW5jdGlvbiBpc1ZhbGlkVGFnTmFtZSh0YWdOYW1lOiBzdHJpbmcpOiBib29sZWFuIHtcbiAgaWYgKCF0YWdOYW1lIHx8IHR5cGVvZiB0YWdOYW1lICE9PSAnc3RyaW5nJykgcmV0dXJuIGZhbHNlO1xuXG4gIGNvbnN0IHJlc2VydmVkID0gbmV3IFNldChbXG4gICAgJ2Fubm90YXRpb24teG1sJyxcbiAgICAnY29sb3ItcHJvZmlsZScsXG4gICAgJ2ZvbnQtZmFjZScsXG4gICAgJ2ZvbnQtZmFjZS1zcmMnLFxuICAgICdmb250LWZhY2UtdXJpJyxcbiAgICAnZm9udC1mYWNlLWZvcm1hdCcsXG4gICAgJ2ZvbnQtZmFjZS1uYW1lJyxcbiAgICAnbWlzc2luZy1nbHlwaCcsXG4gIF0pO1xuICBpZiAocmVzZXJ2ZWQuaGFzKHRhZ05hbWUpKSByZXR1cm4gZmFsc2U7XG5cbiAgLy8gTXVzdCBzdGFydCB3aXRoIGEgbG93ZXJjYXNlIGxldHRlciwgY29udGFpbiBhdCBsZWFzdCBvbmUgaHlwaGVuLFxuICAvLyBhbmQgb25seSBjb250YWluIFthLXpdLCBbMC05XSwgYW5kIGh5cGhlbnMuXG4gIHJldHVybiAvXlthLXpdW2EtejAtOV0qKC1bYS16MC05XSspKyQvLnRlc3QodGFnTmFtZSk7XG59XG4iXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Q0FVQyxHQUVELHNFQUFzRSxHQUN0RSxPQUFPLFNBQVMsZUFBZSxPQUFlO0VBQzVDLElBQUksQ0FBQyxXQUFXLE9BQU8sWUFBWSxVQUFVLE9BQU87RUFFcEQsTUFBTSxXQUFXLElBQUksSUFBSTtJQUN2QjtJQUNBO0lBQ0E7SUFDQTtJQUNBO0lBQ0E7SUFDQTtJQUNBO0dBQ0Q7RUFDRCxJQUFJLFNBQVMsR0FBRyxDQUFDLFVBQVUsT0FBTztFQUVsQyxtRUFBbUU7RUFDbkUsOENBQThDO0VBQzlDLE9BQU8sZ0NBQWdDLElBQUksQ0FBQztBQUM5QyJ9

package/src/vnode.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @openelement/core - VNode interface definition.
+ *
+ * VNode is the intermediate representation of a component's declarative output.
+ * It is a pure JS object — zero DOM dependency, zero runtime binding.
+ *
+ * ⚠️ VNode 接口冻结条款 (ADR-0057 §1.1):
+ * v1.0 前只允许以下 5 个字段，不增加 hooks/memo/suspense/context/portal。
+ * 任何新字段提案必须走 ADR 流程，并证明它不引入 VDOM diff 语义。
+ *
+ * @module @openelement/core/vnode
+ */ import type { VNode } from '@openelement/protocol/vnode';
+/**
+ * Returns true if the given value is a VNode object.
+ */ export declare function isVNode(v: unknown): v is VNode;

package/src/vnode.js

@@ -0,0 +1,31 @@
+/**
+ * @openelement/core - VNode interface definition.
+ *
+ * VNode is the intermediate representation of a component's declarative output.
+ * It is a pure JS object — zero DOM dependency, zero runtime binding.
+ *
+ * ⚠️ VNode 接口冻结条款 (ADR-0057 §1.1):
+ * v1.0 前只允许以下 5 个字段，不增加 hooks/memo/suspense/context/portal。
+ * 任何新字段提案必须走 ADR 流程，并证明它不引入 VDOM diff 语义。
+ *
+ * @module @openelement/core/vnode
+ */ // ─── Type guard ──────────────────────────────────────────────────────────────
+/**
+ * Returns true if the given value is a VNode object.
+ */ export function isVNode(v) {
+  if (typeof v !== 'object' || v === null || Array.isArray(v)) return false;
+  const candidate = v;
+  const tagType = typeof candidate.tag;
+  return (tagType === 'string' || tagType === 'function' || tagType === 'symbol') && typeof candidate.props === 'object' && candidate.props !== null && !Array.isArray(candidate.props) && Array.isArray(candidate.children);
+}
+/**
+ * Returns true if the VNode tag is a class component constructor.
+ */ export function isComponentCtor(tag) {
+  return typeof tag === 'function' && tag.prototype !== undefined && typeof tag.prototype.render === 'function';
+}
+/**
+ * Returns true if the VNode tag is a function component.
+ */ export function isComponentFn(tag) {
+  return typeof tag === 'function' && !isComponentCtor(tag);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbImZpbGU6Ly8vaG9tZS9ydW5uZXIvd29yay9vcGVuZWxlbWVudC9vcGVuZWxlbWVudC9wYWNrYWdlcy9jb3JlL3NyYy92bm9kZS50cyJdLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEBvcGVuZWxlbWVudC9jb3JlIC0gVk5vZGUgaW50ZXJmYWNlIGRlZmluaXRpb24uXG4gKlxuICogVk5vZGUgaXMgdGhlIGludGVybWVkaWF0ZSByZXByZXNlbnRhdGlvbiBvZiBhIGNvbXBvbmVudCdzIGRlY2xhcmF0aXZlIG91dHB1dC5cbiAqIEl0IGlzIGEgcHVyZSBKUyBvYmplY3Qg4oCUIHplcm8gRE9NIGRlcGVuZGVuY3ksIHplcm8gcnVudGltZSBiaW5kaW5nLlxuICpcbiAqIOKaoO+4jyBWTm9kZSDmjqXlj6Plhrvnu5PmnaHmrL4gKEFEUi0wMDU3IMKnMS4xKTpcbiAqIHYxLjAg5YmN5Y+q5YWB6K645Lul5LiLIDUg5Liq5a2X5q6177yM5LiN5aKe5YqgIGhvb2tzL21lbW8vc3VzcGVuc2UvY29udGV4dC9wb3J0YWzjgIJcbiAqIOS7u+S9leaWsOWtl+auteaPkOahiOW/hemhu+i1sCBBRFIg5rWB56iL77yM5bm26K+B5piO5a6D5LiN5byV5YWlIFZET00gZGlmZiDor63kuYnjgIJcbiAqXG4gKiBAbW9kdWxlIEBvcGVuZWxlbWVudC9jb3JlL3Zub2RlXG4gKi9cblxuaW1wb3J0IHR5cGUgeyBDb21wb25lbnRDdG9yLCBDb21wb25lbnRGbiwgUmVuZGVyRm4sIFZOb2RlIH0gZnJvbSAnQG9wZW5lbGVtZW50L3Byb3RvY29sL3Zub2RlJztcbmV4cG9ydCB0eXBlIHsgQ29tcG9uZW50Q3RvciwgQ29tcG9uZW50Rm4sIFJlbmRlckZuLCBWTm9kZSB9O1xuXG4vLyDilIDilIDilIAgVHlwZSBndWFyZCDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIDilIBcblxuLyoqXG4gKiBSZXR1cm5zIHRydWUgaWYgdGhlIGdpdmVuIHZhbHVlIGlzIGEgVk5vZGUgb2JqZWN0LlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNWTm9kZSh2OiB1bmtub3duKTogdiBpcyBWTm9kZSB7XG4gIGlmICh0eXBlb2YgdiAhPT0gJ29iamVjdCcgfHwgdiA9PT0gbnVsbCB8fCBBcnJheS5pc0FycmF5KHYpKSByZXR1cm4gZmFsc2U7XG5cbiAgY29uc3QgY2FuZGlkYXRlID0gdiBhcyB7XG4gICAgdGFnPzogdW5rbm93bjtcbiAgICBwcm9wcz86IHVua25vd247XG4gICAgY2hpbGRyZW4/OiB1bmtub3duO1xuICB9O1xuICBjb25zdCB0YWdUeXBlID0gdHlwZW9mIGNhbmRpZGF0ZS50YWc7XG5cbiAgcmV0dXJuIChcbiAgICAodGFnVHlwZSA9PT0gJ3N0cmluZycgfHwgdGFnVHlwZSA9PT0gJ2Z1bmN0aW9uJyB8fCB0YWdUeXBlID09PSAnc3ltYm9sJykgJiZcbiAgICB0eXBlb2YgY2FuZGlkYXRlLnByb3BzID09PSAnb2JqZWN0JyAmJlxuICAgIGNhbmRpZGF0ZS5wcm9wcyAhPT0gbnVsbCAmJlxuICAgICFBcnJheS5pc0FycmF5KGNhbmRpZGF0ZS5wcm9wcykgJiZcbiAgICBBcnJheS5pc0FycmF5KGNhbmRpZGF0ZS5jaGlsZHJlbilcbiAgKTtcbn1cblxuLyoqXG4gKiBSZXR1cm5zIHRydWUgaWYgdGhlIFZOb2RlIHRhZyBpcyBhIGNsYXNzIGNvbXBvbmVudCBjb25zdHJ1Y3Rvci5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzQ29tcG9uZW50Q3Rvcih0YWc6IFZOb2RlWyd0YWcnXSk6IHRhZyBpcyBDb21wb25lbnRDdG9yIHtcbiAgcmV0dXJuIHR5cGVvZiB0YWcgPT09ICdmdW5jdGlvbicgJiZcbiAgICB0YWcucHJvdG90eXBlICE9PSB1bmRlZmluZWQgJiZcbiAgICB0eXBlb2YgKHRhZyBhcyBDb21wb25lbnRDdG9yKS5wcm90b3R5cGUucmVuZGVyID09PSAnZnVuY3Rpb24nO1xufVxuXG4vKipcbiAqIFJldHVybnMgdHJ1ZSBpZiB0aGUgVk5vZGUgdGFnIGlzIGEgZnVuY3Rpb24gY29tcG9uZW50LlxuICovXG5leHBvcnQgZnVuY3Rpb24gaXNDb21wb25lbnRGbih0YWc6IFZOb2RlWyd0YWcnXSk6IHRhZyBpcyBDb21wb25lbnRGbiB7XG4gIHJldHVybiB0eXBlb2YgdGFnID09PSAnZnVuY3Rpb24nICYmICFpc0NvbXBvbmVudEN0b3IodGFnKTtcbn1cbiJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Q0FXQyxHQUtELGdGQUFnRjtBQUVoRjs7Q0FFQyxHQUNELE9BQU8sU0FBUyxRQUFRLENBQVU7RUFDaEMsSUFBSSxPQUFPLE1BQU0sWUFBWSxNQUFNLFFBQVEsTUFBTSxPQUFPLENBQUMsSUFBSSxPQUFPO0VBRXBFLE1BQU0sWUFBWTtFQUtsQixNQUFNLFVBQVUsT0FBTyxVQUFVLEdBQUc7RUFFcEMsT0FDRSxDQUFDLFlBQVksWUFBWSxZQUFZLGNBQWMsWUFBWSxRQUFRLEtBQ3ZFLE9BQU8sVUFBVSxLQUFLLEtBQUssWUFDM0IsVUFBVSxLQUFLLEtBQUssUUFDcEIsQ0FBQyxNQUFNLE9BQU8sQ0FBQyxVQUFVLEtBQUssS0FDOUIsTUFBTSxPQUFPLENBQUMsVUFBVSxRQUFRO0FBRXBDO0FBRUE7O0NBRUMsR0FDRCxPQUFPLFNBQVMsZ0JBQWdCLEdBQWlCO0VBQy9DLE9BQU8sT0FBTyxRQUFRLGNBQ3BCLElBQUksU0FBUyxLQUFLLGFBQ2xCLE9BQU8sQUFBQyxJQUFzQixTQUFTLENBQUMsTUFBTSxLQUFLO0FBQ3ZEO0FBRUE7O0NBRUMsR0FDRCxPQUFPLFNBQVMsY0FBYyxHQUFpQjtFQUM3QyxPQUFPLE9BQU8sUUFBUSxjQUFjLENBQUMsZ0JBQWdCO0FBQ3ZEIn0=