@oscarpalmer/toretto 0.28.0 → 0.30.0

package/types/attribute/index.d.ts

@@ -1,3 +1,59 @@
-export { booleanAttributes, isBadAttribute, isBooleanAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute, } from '../internal/attribute';
+import type { Attribute } from '../models';
+/**
+ * Is the attribute considered bad and potentially harmful?
+ * @param attribute Attribute to check
+ * @returns `true` if attribute is considered bad
+ */
+export declare function isBadAttribute(attribute: Attr | Attribute): boolean;
+/**
+ * Is the attribute considered bad and potentially harmful?
+ * @param name Attribute name
+ * @param value Attribute value
+ * @returns `true` if attribute is considered bad
+ */
+export declare function isBadAttribute(name: string, value: string): boolean;
+/**
+ * Is the attribute a boolean attribute?
+ * @param name Attribute to check
+ * @returns `true` if attribute is a boolean attribute
+ */
+export declare function isBooleanAttribute(attribute: Attr | Attribute): boolean;
+/**
+ * Is the attribute a boolean attribute?
+ * @param name Attribute name
+ * @returns `true` if attribute is a boolean attribute
+ */
+export declare function isBooleanAttribute(name: string): boolean;
+/**
+ * Is the attribute empty and not a boolean attribute?
+ * @param attribute Attribute to check
+ * @returns `true` if attribute is empty and not a boolean attribute
+ */
+export declare function isEmptyNonBooleanAttribute(attribute: Attr | Attribute): boolean;
+/**
+ * Is the attribute empty and not a boolean attribute?
+ * @param name Attribute name
+ * @param value Attribute value
+ * @returns `true` if attribute is empty and not a boolean attribute
+ */
+export declare function isEmptyNonBooleanAttribute(name: string, value: string): boolean;
+/**
+ * Is the attribute an invalid boolean attribute?
+ *
+ * _(I.e., its value is not empty or the same as its name)_
+ * @param attribute Attribute to check
+ * @returns `true` if attribute is an invalid boolean attribute
+ */
+export declare function isInvalidBooleanAttribute(attribute: Attr | Attribute): boolean;
+/**
+ * Is the attribute an invalid boolean attribute?
+ *
+ * _(I.e., its value is not empty or the same as its name)_
+ * @param name Attribute name
+ * @param value Attribute value
+ * @returns `true` if attribute is an invalid boolean attribute
+ */
+export declare function isInvalidBooleanAttribute(name: string, value: string): boolean;
+export { booleanAttributes } from '../internal/attribute';
 export * from './get';
 export * from './set';

package/types/{html.d.ts → html/index.d.ts}

@@ -1,4 +1,3 @@
-import { type SanitizeOptions } from './internal/sanitize';
 type Html = {
     /**
      * Create nodes from an HTML string or a template element
@@ -26,10 +25,10 @@ type Html = {
 };
 type HtmlOptions = {
     /**
-     * Ignore caching the template element for the HTML string? _(defaults to `false`)_
+     * Cache template element for the HTML string? _(defaults to `true`)_
      */
-    ignoreCache?: boolean;
-} & SanitizeOptions;
+    cache?: boolean;
+};
 declare const html: Html;
 /**
  * Sanitize one or more nodes, recursively
@@ -37,5 +36,5 @@ declare const html: Html;
  * @param options Sanitization options
  * @returns Sanitized nodes
  */
-export declare function sanitize(value: Node | Node[], options?: SanitizeOptions): Node[];
+export declare function sanitize(value: Node | Node[]): Node[];
 export { html };

package/types/html/sanitize.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeAttributes(element: Element, attributes: Attr[]): void;
+export declare function sanitizeNodes(nodes: Node[], depth: number): Node[];

package/types/index.d.ts

@@ -1,10 +1,10 @@
 import supportsTouch from './touch';
-export * from './attribute';
+export { isBadAttribute, isBooleanAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute, } from './attribute';
 export * from './data';
 export * from './event/index';
 export * from './find/index';
 export * from './focusable';
-export * from './html';
+export * from './html/index';
 export * from './is';
 export * from './models';
 export * from './style';

package/types/internal/attribute.d.ts

@@ -1,59 +1,8 @@
 import type { Attribute, HTMLOrSVGElement, Property } from '../models';
-/**
- * Is the attribute considered bad and potentially harmful?
- * @param attribute Attribute to check
- * @returns `true` if attribute is considered bad
- */
-export declare function isBadAttribute(attribute: Attr | Attribute): boolean;
-/**
- * Is the attribute considered bad and potentially harmful?
- * @param name Attribute name
- * @param value Attribute value
- * @returns `true` if attribute is considered bad
- */
-export declare function isBadAttribute(name: string, value: string): boolean;
-/**
- * Is the attribute a boolean attribute?
- * @param name Attribute to check
- * @returns `true` if attribute is a boolean attribute
- */
-export declare function isBooleanAttribute(attribute: Attr | Attribute): boolean;
-/**
- * Is the attribute a boolean attribute?
- * @param name Attribute name
- * @returns `true` if attribute is a boolean attribute
- */
-export declare function isBooleanAttribute(name: string): boolean;
-/**
- * Is the attribute empty and not a boolean attribute?
- * @param attribute Attribute to check
- * @returns `true` if attribute is empty and not a boolean attribute
- */
-export declare function isEmptyNonBooleanAttribute(attribute: Attr | Attribute): boolean;
-/**
- * Is the attribute empty and not a boolean attribute?
- * @param name Attribute name
- * @param value Attribute value
- * @returns `true` if attribute is empty and not a boolean attribute
- */
-export declare function isEmptyNonBooleanAttribute(name: string, value: string): boolean;
-/**
- * Is the attribute an invalid boolean attribute?
- *
- * _(I.e., its value is not empty or the same as its name)_
- * @param attribute Attribute to check
- * @returns `true` if attribute is an invalid boolean attribute
- */
-export declare function isInvalidBooleanAttribute(attribute: Attr | Attribute): boolean;
-/**
- * Is the attribute an invalid boolean attribute?
- *
- * _(I.e., its value is not empty or the same as its name)_
- * @param name Attribute name
- * @param value Attribute value
- * @returns `true` if attribute is an invalid boolean attribute
- */
-export declare function isInvalidBooleanAttribute(name: string, value: string): boolean;
+export declare function isBadAttribute(first: unknown, second: unknown, decode: boolean): boolean;
+export declare function isBooleanAttribute(first: unknown, decode: boolean): boolean;
+export declare function isEmptyNonBooleanAttribute(first: unknown, second: unknown, decode: boolean): boolean;
+export declare function isInvalidBooleanAttribute(first: unknown, second: unknown, decode: boolean): boolean;
 export declare function isProperty(value: unknown): value is Property;
 export declare function updateValue(element: HTMLOrSVGElement, first: unknown, second: unknown): void;
 export declare function updateValues(element: HTMLOrSVGElement, values: Attribute<unknown>[] | Record<string, unknown>): void;

package/dist/html.js

@@ -1,55 +0,0 @@
-import { getSanitizeOptions, sanitizeNodes } from "./internal/sanitize.js";
-import { isPlainObject } from "@oscarpalmer/atoms/is";
-function createTemplate(html$1, ignore) {
-	const template = document.createElement("template");
-	template.innerHTML = html$1;
-	if (!ignore) templates[html$1] = template;
-	return template;
-}
-function getHtml(value, options) {
-	if (typeof value !== "string" && !(value instanceof HTMLTemplateElement)) return [];
-	const template = value instanceof HTMLTemplateElement ? value : getTemplate(value, options.ignoreCache);
-	if (template == null) return [];
-	const cloned = template.content.cloneNode(true);
-	const scripts = cloned.querySelectorAll("script");
-	for (const script of scripts) script.remove();
-	cloned.normalize();
-	return sanitizeNodes([...cloned.childNodes], options);
-}
-function getOptions(input) {
-	const options = isPlainObject(input) ? input : {};
-	options.ignoreCache = typeof options.ignoreCache === "boolean" ? options.ignoreCache : false;
-	options.sanitizeBooleanAttributes = typeof options.sanitizeBooleanAttributes === "boolean" ? options.sanitizeBooleanAttributes : true;
-	return options;
-}
-function getTemplate(value, ignore) {
-	if (typeof value !== "string" || value.trim().length === 0) return;
-	let template = templates[value];
-	if (template != null) return template;
-	const element = EXPRESSION_ID.test(value) ? document.querySelector(`#${value}`) : null;
-	template = element instanceof HTMLTemplateElement ? element : createTemplate(value, ignore);
-	return template;
-}
-var html = ((value, options) => {
-	return getHtml(value, getOptions(options));
-});
-html.clear = () => {
-	templates = {};
-};
-html.remove = (template) => {
-	if (typeof template !== "string" || templates[template] == null) return;
-	const keys = Object.keys(templates);
-	const { length } = keys;
-	const updated = {};
-	for (let index = 0; index < length; index += 1) {
-		const key = keys[index];
-		if (key !== template) updated[key] = templates[key];
-	}
-	templates = updated;
-};
-function sanitize(value, options) {
-	return sanitizeNodes(Array.isArray(value) ? value : [value], getSanitizeOptions(options));
-}
-var EXPRESSION_ID = /^[a-z][\w-]*$/i;
-var templates = {};
-export { html, sanitize };

package/dist/internal/sanitize.js

@@ -1,30 +0,0 @@
-import { isBadAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute } from "./attribute.js";
-import { isPlainObject } from "@oscarpalmer/atoms/is";
-function getSanitizeOptions(input) {
-	const options = isPlainObject(input) ? input : {};
-	options.sanitizeBooleanAttributes = typeof options.sanitizeBooleanAttributes === "boolean" ? options.sanitizeBooleanAttributes : true;
-	return options;
-}
-function sanitizeAttributes(element, attributes, options) {
-	const { length } = attributes;
-	for (let index = 0; index < length; index += 1) {
-		const attribute = attributes[index];
-		if (isBadAttribute(attribute) || isEmptyNonBooleanAttribute(attribute)) element.removeAttribute(attribute.name);
-		else if (options.sanitizeBooleanAttributes && isInvalidBooleanAttribute(attribute)) element.setAttribute(attribute.name, "");
-	}
-}
-function sanitizeNodes(nodes, options) {
-	const actual = nodes.filter((node) => node instanceof Node);
-	const { length } = nodes;
-	for (let index = 0; index < length; index += 1) {
-		const node = actual[index];
-		if (node instanceof Element) {
-			const scripts = node.querySelectorAll("script");
-			for (const script of scripts) script.remove();
-			sanitizeAttributes(node, [...node.attributes], options);
-		}
-		if (node.hasChildNodes()) sanitizeNodes([...node.childNodes], options);
-	}
-	return nodes;
-}
-export { getSanitizeOptions, sanitizeAttributes, sanitizeNodes };

package/src/internal/sanitize.ts

@@ -1,67 +0,0 @@
-import {isPlainObject} from '@oscarpalmer/atoms/is';
-import {isBadAttribute, isEmptyNonBooleanAttribute, isInvalidBooleanAttribute} from './attribute';
-
-//
-
-type Options = Required<SanitizeOptions>;
-
-export type SanitizeOptions = {
-	/**
-	 * Sanitize boolean attributes? _(Defaults to `true`)_
-	 *
-	 * E.g. `checked="abc"` => `checked=""`
-	 */
-	sanitizeBooleanAttributes?: boolean;
-};
-
-//
-
-export function getSanitizeOptions(input?: SanitizeOptions): Options {
-	const options = isPlainObject(input) ? input : {};
-
-	options.sanitizeBooleanAttributes =
-		typeof options.sanitizeBooleanAttributes === 'boolean'
-			? options.sanitizeBooleanAttributes
-			: true;
-
-	return options as Options;
-}
-
-export function sanitizeAttributes(element: Element, attributes: Attr[], options: Options): void {
-	const {length} = attributes;
-
-	for (let index = 0; index < length; index += 1) {
-		const attribute = attributes[index];
-
-		if (isBadAttribute(attribute) || isEmptyNonBooleanAttribute(attribute)) {
-			element.removeAttribute(attribute.name);
-		} else if (options.sanitizeBooleanAttributes && isInvalidBooleanAttribute(attribute)) {
-			element.setAttribute(attribute.name, '');
-		}
-	}
-}
-
-export function sanitizeNodes(nodes: Node[], options: Options): Node[] {
-	const actual = nodes.filter(node => node instanceof Node);
-	const {length} = nodes;
-
-	for (let index = 0; index < length; index += 1) {
-		const node = actual[index];
-
-		if (node instanceof Element) {
-			const scripts = node.querySelectorAll('script');
-
-			for (const script of scripts) {
-				script.remove();
-			}
-
-			sanitizeAttributes(node, [...node.attributes], options);
-		}
-
-		if (node.hasChildNodes()) {
-			sanitizeNodes([...node.childNodes], options);
-		}
-	}
-
-	return nodes;
-}

package/types/internal/sanitize.d.ts

@@ -1,13 +0,0 @@
-type Options = Required<SanitizeOptions>;
-export type SanitizeOptions = {
-    /**
-     * Sanitize boolean attributes? _(Defaults to `true`)_
-     *
-     * E.g. `checked="abc"` => `checked=""`
-     */
-    sanitizeBooleanAttributes?: boolean;
-};
-export declare function getSanitizeOptions(input?: SanitizeOptions): Options;
-export declare function sanitizeAttributes(element: Element, attributes: Attr[], options: Options): void;
-export declare function sanitizeNodes(nodes: Node[], options: Options): Node[];
-export {};