ctx-core 5.0.0 → 5.1.0

package/all/a_nowrap/index.d.ts

@@ -2,4 +2,4 @@ export declare type a_nowrap_T<I> =
 	I
 	|readonly I[]
 	|readonly I[][]
-export declare type ANowrapT = a_nowrap_T
+export declare type ANowrapT<I> = a_nowrap_T<I>

package/all/be_/index.test.ts

@@ -159,7 +159,7 @@ test('be_|Ctx generic type', ()=>{
 	// @ts-expect-error TS2322
 	throws(()=>val_(ctx_()))
 })
-test('be_|Ctx|NestedMapCtx', ()=>{
+test('be_|Ctx|ns', ()=>{
 	const ctx0 = ctx__new()
 	const ctx1 = ctx__new()
 	ctx1.s[''].set('matching', true)

package/all/binary_sort_rank/index.d.ts

@@ -2,8 +2,9 @@ import type { compare_1_T } from '../array_types/index.js'
 /**
  * Returns the rank of the item where the compare function === 0, using binarySort
  */
-export declare function binary_sort_rank(
-	a:readonly unknown[], compare_1:compare_1_T
+export declare function binary_sort_rank<I>(
+	a:readonly I[],
+	compare_1:compare_1_T<I>
 ):number
 export {
 	binary_sort_rank as binarySort_rank,

package/all/deep_equal/index.d.ts

@@ -0,0 +1 @@
+export declare function deep_equal(a:unknown, b:unknown):boolean

package/all/deep_equal/index.js

@@ -0,0 +1,54 @@
+'use strict'
+// TODO: Remove when https://github.com/epoberezkin/fast-deep-equal/issues/124 is fixed
+export function deep_equal(a, b) {
+	if (a === b) return true
+	if (a && b && typeof a == 'object' && typeof b == 'object') {
+		if (a.constructor !== b.constructor) return false
+		let length, i, keys
+		if (Array.isArray(a)) {
+			length = a.length
+			if (length != b.length) return false
+			for (i = length; (i--) !== 0;) if (!deep_equal(a[i], b[i])) return false
+			return true
+		}
+		if (a instanceof Map && b instanceof Map) {
+			if (a.size !== b.size) return false
+			for (i of a.entries()) if (!b.has(i[0])) return false
+			for (i of a.entries()) if (!deep_equal(i[1], b.get(i[0]))) return false
+			return true
+		}
+		if (a instanceof Set && b instanceof Set) {
+			if (a.size !== b.size) return false
+			for (i of a.entries()) if (!b.has(i[0])) return false
+			return true
+		}
+		if (ArrayBuffer.isView(a) && ArrayBuffer.isView(b)) {
+			length = a.length
+			if (length != b.length) return false
+			for (i = length; (i--) !== 0;) if (a[i] !== b[i]) return false
+			return true
+		}
+		if (a.constructor === RegExp) return a.source === b.source && a.flags === b.flags
+		if (
+			a.valueOf !== Object.prototype.valueOf
+			&& typeof a.valueOf === 'function'
+			&& typeof b.valueOf === 'function'
+		) return a.valueOf() === b.valueOf()
+		if (
+			a.toString !== Object.prototype.toString
+			&& typeof a.toString === 'function'
+			&& typeof b.toString === 'function'
+		) return a.toString() === b.toString()
+		keys = Object.keys(a)
+		length = keys.length
+		if (length !== Object.keys(b).length) return false
+		for (i = length; (i--) !== 0;) if (!Object.prototype.hasOwnProperty.call(b, keys[i])) return false
+		for (i = length; (i--) !== 0;) {
+			let key = keys[i]
+			if (!deep_equal(a[key], b[key])) return false
+		}
+		return true
+	}
+	// true if both NaN, false otherwise
+	return a !== a && b !== b
+}

package/all/html/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns a string of escaped html
+ */
+export declare function html_(unsafe:string):string
+export { html_ as _html, }

package/all/html/index.js

@@ -0,0 +1,19 @@
+/**
+ * Returns a string of escaped html
+ * @param {string}unsafe
+ * @returns string
+ */
+export function html_(unsafe) {
+	return (
+		unsafe
+			.replace(/&/g, '&')
+			.replace(/</g, '&lt;')
+			.replace(/>/g, '&gt;')
+			.replace(/"/g, '&quot;')
+			.replace(/'/g, '&#039;')
+	)
+}
+export {
+	html_ as html__escape,
+	html_ as _html,
+}

package/all/html/index.test.ts

@@ -0,0 +1,9 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_ } from './index.js'
+test('html_', ()=>{
+	equal(html_(
+		`<div>"&'foo'bar"</div>`
+	), '&lt;div&gt;&quot;&amp;&#039;foo&#039;bar&quot;&lt;/div&gt;')
+})
+test.run()

package/all/html_attr/index.d.ts

@@ -0,0 +1,8 @@
+import type { nullish } from '../nullish/index.js'
+export declare function html_attr_(key:string, val:string):string
+export { html_attr_ as attr_ }
+export declare function raw__html_attr_(key:string, val:string):string
+export { raw__html_attr_ as raw__attr_ }
+export type html_attr_def_T = Record<string, unknown>|string|string[]|nullish
+export type attr_def_T = html_attr_def_T
+

package/all/html_attr/index.js

@@ -0,0 +1,21 @@
+import { html_ } from '../html/index.js'
+/**
+ * @param {string}key
+ * @param {string}val
+ * @returns {string}
+ * @private
+ */
+export function html_attr_(key, val) {
+	return key + '="' + html_(val) + '"'
+}
+export { html_attr_ as attr_ }
+/**
+ * @param {string}key
+ * @param {string}val
+ * @returns {string}
+ * @private
+ */
+export function raw__html_attr_(key, val) {
+	return key + '="' + val + '"'
+}
+export { raw__html_attr_ as raw__attr_ }

package/all/html_attr/index.test.ts

@@ -0,0 +1,10 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_attr_, raw__html_attr_ } from './index.js'
+test('html_attr_', ()=>{
+	equal(html_attr_('id', '123&bar'), 'id="123&bar"')
+})
+test('raw__html_attr_', ()=>{
+	equal(raw__html_attr_('id', '123&bar'), 'id="123&bar"')
+})
+test.run()

package/all/html_attrs/index.d.ts

@@ -0,0 +1,6 @@
+import type { html_attr_def_T } from '../html_attr/index.js'
+/**
+ * Returns a string of attrs for an html element
+ */
+export declare function html_attrs_(...attr_def_a:html_attr_def_T[]):string
+export { html_attrs_ as attrs_, html_attrs_ as _attrs, }

package/all/html_attrs/index.js

@@ -0,0 +1,29 @@
+/// <reference types="../attr/index.d.ts" />
+import { html_attr_ } from '../html_attr/index.js'
+import { isArray } from '../isArray/index.js'
+/**
+ * Returns a string of attrs for an html element
+ * @param {attr_def_T}attr_def_a
+ * @returns {string}
+ */
+export function html_attrs_(...attr_def_a) {
+	/** @type {string[]} */
+	let a = []
+	for (let i = 0; i < attr_def_a.length; i++) {
+		const attr_def = attr_def_a[i]
+		if (typeof attr_def === 'string') {
+			a.push(attr_def)
+		} else if (isArray(attr_def)) {
+			a.push(...attr_def)
+		} else if (typeof attr_def === 'object') {
+			for (const key in attr_def) {
+				const val = attr_def[key]
+				if (val != null) {
+					a.push(html_attr_(key, attr_def[key]))
+				}
+			}
+		}
+	}
+	return a.join(' ')
+}
+export { html_attrs_ as attrs_, html_attrs_ as _attrs, }

package/all/html_attrs/index.test.ts

@@ -0,0 +1,36 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_attrs_ } from './index.js'
+test('html_attrs_', ()=>{
+	equal(
+		html_attrs_('id="foo"', 'class="bar"'),
+		'id="foo" class="bar"')
+	equal(
+		html_attrs_('id="foo" class="bar"'),
+		'id="foo" class="bar"')
+	equal(
+		html_attrs_('id="foo"', {
+			class: 'bar',
+			style: null,
+		}),
+		'id="foo" class="bar"')
+	equal(
+		html_attrs_({
+			id: 'foo',
+			style: null,
+		}, 'class="bar"'),
+		'id="foo" class="bar"')
+	equal(
+		html_attrs_({
+			id: 'foo',
+			style: null,
+		}, ['class="bar"']),
+		'id="foo" class="bar"')
+	equal(
+		html_attrs_({
+			id: 'foo',
+			style: null,
+		}, ['class="bar" style="top: 0;"']),
+		'id="foo" class="bar" style="top: 0;"')
+})
+test.run()

package/all/html_class/index.d.ts

@@ -0,0 +1,12 @@
+import { html_attr_def_T } from '../html_attr/index.js'
+/**
+ * Returns class html attribute from r
+ * @example
+ * class_({class_1: true, html_class__: false, class_3: true}) // returns 'class_1 class_3'
+ */
+export declare function html_class_(...class_def_a:html_attr_def_T[]):string
+export { html_class_ as class_, html_class_ as _class, }
+export declare function html_class__(
+	...memo_class_def_a:html_attr_def_T[]
+):(...class_def_a:html_attr_def_T[])=>string
+export { html_class__ as class__, html_class__ as class_2, }

package/all/html_class/index.js

@@ -0,0 +1,34 @@
+/// <reference types="../attr/index.d.ts" />
+import { isArray } from '../isArray/index.js'
+/**
+ * Returns class html attribute from r
+ * @param {attr_def_T}class_def_a
+ * @returns {string}
+ * @example
+ * class_({class_1: true, html_class__: false, class_3: true}) // returns 'class_1 class_3'
+ */
+export function html_class_(...class_def_a) {
+	const a = []
+	for (let i = 0; i < class_def_a.length; i++) {
+		const class_def = class_def_a[i]
+		if (typeof class_def === 'string') {
+			a.push(class_def)
+		} else if (isArray(class_def)) {
+			a.push(...class_def)
+		} else if (typeof class_def === 'object') {
+			for (let key in class_def) {
+				if (class_def[key]) a.push(key)
+			}
+		}
+	}
+	return a.join(' ')
+}
+export { html_class_ as class_, html_class_ as _class, }
+/**
+ * @param {attr_def_T}memo_class_def_a
+ * @returns {(...class_def_a:attr_def_T[])=>string}
+ */
+export function html_class__(...memo_class_def_a) {
+	return (...class_def_a)=>html_class_(...memo_class_def_a, ...class_def_a)
+}
+export { html_class__ as class__, html_class__ as class_2, }

package/all/html_class/index.test.ts

@@ -0,0 +1,32 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_class_, html_class__ } from './index.js'
+test('html_class_', ()=>{
+	equal(html_class_('foo', 'bar'), 'foo bar')
+	equal(html_class_('foo', {
+		bar: true,
+		baz: false,
+	}), 'foo bar')
+	equal(html_class_({
+		bar: true,
+		baz: false,
+	}, 'foo'), 'bar foo')
+	equal(html_class_({
+		bar: true,
+		baz: false,
+	}, ['foo']), 'bar foo')
+})
+test('html_class__', ()=>{
+	equal(html_class__('foo', 'bar')(), 'foo bar')
+	equal(html_class__('foo', {
+		bar: true,
+	})({ baz: false, }), 'foo bar')
+	equal(html_class__({
+		baz: false,
+	}, 'foo')({ bar: true }), 'foo bar')
+	equal(html_class__(['foo'])({
+		bar: true,
+		baz: false,
+	}), 'foo bar')
+})
+test.run()

package/all/html_dataset__data_attrs/index.d.ts

@@ -0,0 +1,2 @@
+export declare function html_dataset__data_attrs_<R extends Record<string, unknown>>(dataset:R):R
+export { html_dataset__data_attrs_ as dataset__data_attrs_ }

package/all/html_dataset__data_attrs/index.js

@@ -0,0 +1,12 @@
+/**
+ * @param {Record<string, any>}dataset
+ * @returns {Record<string, any>}
+ * @private
+ */
+export function html_dataset__data_attrs_(dataset) {
+	return Object.entries(dataset).reduce((o, [key, value])=>{
+		o[`data-${key}`] = value
+		return o
+	}, {})
+}
+export { html_dataset__data_attrs_ as dataset__data_attrs_ }

package/all/html_dataset__data_attrs/index.test.ts

@@ -0,0 +1,13 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_dataset__data_attrs_ } from './index.js'
+test('html_dataset__data_attrs_', ()=>{
+	equal(html_dataset__data_attrs_({
+		foo: 'bar',
+		baz: 123
+	}), {
+		'data-foo': 'bar',
+		'data-baz': 123,
+	})
+})
+test.run()

package/all/html_style/index.d.ts

@@ -0,0 +1,12 @@
+import type { html_attr_def_T } from '../html_attr/index.js'
+/**
+ * Returns class style attribute from obj
+ * @example
+ * style_({position: 'absolute, left: '5px'}) // returns 'position: absolute; left: 5px;'
+ */
+export declare function html_style_(...style_def_a:html_attr_def_T[]):string
+export { html_style_ as style_, html_style_ as _style, }
+export declare function html_style__(
+	...memo_style_def_a:html_attr_def_T[]
+):(...style_def_a:html_attr_def_T[])=>string
+export { html_style__ as style__, html_style__ as style_2, }

package/all/html_style/index.js

@@ -0,0 +1,49 @@
+/// <reference types="../attr/index.d.ts" />
+import { isArray } from '../isArray/index.js'
+const eol_semicolon_regex = /;\s*$/
+/**
+ * Returns class style attribute from obj
+ * @param {attr_def_T}style_def_a
+ * @returns {string}
+ * @example
+ * style_({position: 'absolute, left: '5px'}) // returns 'position: absolute; left: 5px;'
+ */
+export function html_style_(...style_def_a) {
+	const a = []
+	for (let i = 0; i < style_def_a.length; i++) {
+		const style_def = style_def_a[i]
+		if (typeof style_def === 'string') {
+			a.push(semicolon__style_(style_def))
+		} else if (isArray(style_def)) {
+			a.push(...style_def.map($=>semicolon__style_($)))
+		} else if (typeof style_def === 'object') {
+			for (let key in style_def) {
+				const val = style_def[key]
+				if (val != null) a.push(`${key}: ${val};`)
+			}
+		}
+	}
+	return a.join(' ')
+}
+export { html_style_ as style_, html_style_ as _style, }
+/**
+ * @param {string}style
+ * @returns {string}
+ * @private
+ */
+function semicolon__style_(style) {
+	return (
+		eol_semicolon_regex.test(style)
+			? style
+			: `${style};`
+	)
+}
+/**
+ * @param {attr_def_T}memo_style_def_a
+ * @returns {(...style_def_a:string[])=>string}
+ * @private
+ */
+export function html_style__(memo_style_def_a) {
+	return (...style_a)=>html_style_(memo_style_def_a, ...style_a)
+}
+export { html_style__ as style__, html_style__ as style_2, }

package/all/html_style/index.test.ts

@@ -0,0 +1,92 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_style_, html_style__ } from './index.js'
+test('html_style_', ()=>{
+	equal(
+		html_style_('display: block', 'position: absolute'),
+		'display: block; position: absolute;')
+	equal(
+		html_style_('display: block; position: absolute;'),
+		'display: block; position: absolute;')
+	equal(
+		html_style_('display: block', {
+			position: 'absolute',
+			top: null,
+		}),
+		'display: block; position: absolute;')
+	equal(
+		html_style_({
+			display: 'block',
+			top: null,
+		}, 'position: absolute'),
+		'display: block; position: absolute;')
+	equal(
+		html_style_({
+			display: 'block',
+			top: null,
+		}, ['position: absolute']),
+		'display: block; position: absolute;')
+	equal(
+		html_style_({
+			display: 'block',
+			top: null,
+		}, ['position: absolute; top: 0']),
+		'display: block; position: absolute; top: 0;')
+	equal(
+		html_style_({
+			display: 'block',
+			top: null,
+		}, ['position: absolute; top: 0']),
+		'display: block; position: absolute; top: 0;')
+	equal(
+		html_style_({
+			display: 'block',
+			top: null,
+		}, ['position: absolute; top: 0;']),
+		'display: block; position: absolute; top: 0;')
+})
+test('html_style__', ()=>{
+	equal(
+		html_style__('display: block')('position: absolute'),
+		'display: block; position: absolute;')
+	equal(
+		html_style__('display: block;')('position: absolute;'),
+		'display: block; position: absolute;')
+	equal(
+		html_style__('display: block')({
+			position: 'absolute',
+			top: null,
+		}),
+		'display: block; position: absolute;')
+	equal(
+		html_style__({
+			display: 'block',
+			top: null,
+		})('position: absolute'),
+		'display: block; position: absolute;')
+	equal(
+		html_style__({
+			display: 'block',
+			top: null,
+		})(['position: absolute']),
+		'display: block; position: absolute;')
+	equal(
+		html_style__({
+			display: 'block',
+			top: null,
+		})(['position: absolute; top: 0']),
+		'display: block; position: absolute; top: 0;')
+	equal(
+		html_style__({
+			display: 'block',
+			top: null,
+		})(['position: absolute; top: 0']),
+		'display: block; position: absolute; top: 0;')
+	equal(
+		html_style__({
+			display: 'block',
+			top: null,
+		})(['position: absolute; top: 0;']),
+		'display: block; position: absolute; top: 0;')
+})
+test.run()

package/all/html_style__assign/index.d.ts

@@ -0,0 +1,12 @@
+import type { html_attr_def_T } from '../html_attr/index.js'
+/**
+ * Assigns additional styles to the style attribute on the HTMLElement el.
+ */
+export declare function html_style__assign(
+	el:HTMLElement, ...style_def_a:html_attr_def_T[]
+):HTMLElement
+export {
+	html_style__assign as assign_style,
+	html_style__assign as assign__style,
+	html_style__assign as style__assign,
+}

package/all/html_style__assign/index.js

@@ -0,0 +1,20 @@
+/// <reference types="../attr/index.d.ts" />
+import { html_style_ } from '../html_style/index.js'
+import { html_styles_o_ } from '../html_styles_o/index.js'
+/**
+ * Assigns additional styles to the style attribute on the HTMLElement el.
+ * @param el{HTMLElement}
+ * @param {attr_def_T}style_def_a
+ * @returns {HTMLElement}
+ * */
+export function html_style__assign(el, ...style_def_a) {
+	const el_style = el.getAttribute('style') || ''
+	const styles_o = html_styles_o_(el_style)
+	el.setAttribute('style', html_style_(styles_o, ...style_def_a))
+	return el
+}
+export {
+	html_style__assign as assign_style,
+	html_style__assign as assign__style,
+	html_style__assign as style__assign,
+}

package/all/html_styles_o/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parses a style string & returns an object with each style
+ * @example
+ * html_styles_o_('position: absolute; left: 5px;') // returns {position: 'absolute, left: '5px'}
+ */
+export declare function html_styles_o_(style_str:string):Record<string, string>
+export {
+	html_styles_o_ as _styles_o,
+	html_styles_o_ as _OBJ__styles,
+	html_styles_o_ as styles_o_,
+}

package/all/html_styles_o/index.js

@@ -0,0 +1,23 @@
+/**
+ * Parses a style string & returns an object with each style
+ * @param {string}style_str
+ * @returns {Record<string, string>}
+ * @example
+ * html_styles_o_('position: absolute; left: 5px;') // returns {position: 'absolute, left: '5px'}
+ */
+export function html_styles_o_(style_str) {
+	const style_str_a = (style_str || '').split(/ *; */)
+	const styles_o = {}
+	for (let i = 0; i < style_str_a.length; i++) {
+		const i_style_str = style_str_a[i]
+		if (!i_style_str) continue
+		const [style_name, style_value] = i_style_str.split(/ *: */)
+		styles_o[style_name] = style_value
+	}
+	return styles_o
+}
+export {
+	html_styles_o_ as _styles_o,
+	html_styles_o_ as _OBJ__styles,
+	html_styles_o_ as styles_o_,
+}

package/all/html_styles_o/index.test.ts

@@ -0,0 +1,10 @@
+import { test } from 'uvu'
+import { equal } from 'uvu/assert'
+import { html_styles_o_ } from './index.js'
+test('html_styles_o_', ()=>{
+	equal(html_styles_o_('position: absolute;   top:   0;'), {
+		position: 'absolute',
+		top: '0'
+	})
+})
+test.run()

package/all/index.d.ts

@@ -101,6 +101,7 @@ export * from './day_seconds/index.js'
 export * from './debounce/index.js'
 export * from './debounce_mapreduce/index.js'
 export * from './deep_clone/index.js'
+export * from './deep_equal/index.js'
 export * from './defaults/index.js'
 export * from './deg_rad/index.js'
 export * from './diff_date/index.js'
@@ -166,6 +167,14 @@ export * from './hour/index.js'
 export * from './hour/index.js'
 export * from './hour_seconds/index.js'
 export * from './hour_seconds/index.js'
+export * from './html/index.js'
+export * from './html_attr/index.js'
+export * from './html_attrs/index.js'
+export * from './html_class/index.js'
+export * from './html_dataset__data_attrs/index.js'
+export * from './html_style/index.js'
+export * from './html_style__assign/index.js'
+export * from './html_styles_o/index.js'
 export * from './http__headers__assign/index.js'
 export * from './http_error/index.js'
 export * from './idx/index.js'
@@ -201,6 +210,7 @@ export * from './isObject/index.js'
 export * from './isPrimitive/index.js'
 export * from './isPromiseLike/index.js'
 export * from './item_r_idx/index.js'
+export * from './js_html/index.js'
 export * from './key_compare/index.js'
 export * from './key_r/index.js'
 export * from './key_r_a/index.js'
@@ -209,6 +219,7 @@ export * from './keys/index.js'
 export * from './last/index.js'
 export * from './left_and/index.js'
 export * from './left_or/index.js'
+export * from './links_html/index.js'
 export * from './lte_0_a/index.js'
 export * from './m_m_yyyy/index.js'
 export * from './m_yy/index.js'

package/all/index.js

@@ -101,6 +101,7 @@ export * from './day_seconds/index.js'
 export * from './debounce/index.js'
 export * from './debounce_mapreduce/index.js'
 export * from './deep_clone/index.js'
+export * from './deep_equal/index.js'
 export * from './defaults/index.js'
 export * from './deg_rad/index.js'
 export * from './diff_date/index.js'
@@ -166,6 +167,14 @@ export * from './hour/index.js'
 export * from './hour/index.js'
 export * from './hour_seconds/index.js'
 export * from './hour_seconds/index.js'
+export * from './html/index.js'
+export * from './html_attr/index.js'
+export * from './html_attrs/index.js'
+export * from './html_class/index.js'
+export * from './html_dataset__data_attrs/index.js'
+export * from './html_style/index.js'
+export * from './html_style__assign/index.js'
+export * from './html_styles_o/index.js'
 export * from './http__headers__assign/index.js'
 export * from './http_error/index.js'
 export * from './idx/index.js'
@@ -201,6 +210,7 @@ export * from './isObject/index.js'
 export * from './isPrimitive/index.js'
 export * from './isPromiseLike/index.js'
 export * from './item_r_idx/index.js'
+export * from './js_html/index.js'
 export * from './key_compare/index.js'
 export * from './key_r/index.js'
 export * from './key_r_a/index.js'
@@ -209,6 +219,7 @@ export * from './keys/index.js'
 export * from './last/index.js'
 export * from './left_and/index.js'
 export * from './left_or/index.js'
+export * from './links_html/index.js'
 export * from './lte_0_a/index.js'
 export * from './m_m_yyyy/index.js'
 export * from './m_yy/index.js'

package/all/js_html/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * html for js script tags
+ */
+export declare function js_html_(params:js_html__params_T):string
+export interface js_html__params_T {
+	js:string[]
+	script:string[]
+	indentation:string
+}
+export type js_html__opts_T = js_html__params_T
+export {
+	js_html_ as _js_html,
+	js_html_ as _html__js,
+}

package/all/js_html/index.js

@@ -0,0 +1,21 @@
+/// <reference types="index.d.ts" />
+/**
+ * html for js script tags
+ * @param {js_html__params_T}params
+ * @returns {string}
+ */
+export function js_html_(params) {
+	const indentation = params.indentation ?? ''
+	const script = params.script || params.js || []
+	let js_html_a = []
+	for (let i = 0; i < script.length; i++) {
+		const js_file = script[i]
+		js_html_a.push(
+			`${indentation}<script type="text/javascript" src="${js_file}"></script>`)
+	}
+	return js_html_a.join('\n')
+}
+export {
+	js_html_ as _js_html,
+	js_html_ as _html__js,
+}

package/all/links_html/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * html for css link tags
+ */
+export declare function links_html_(params:links_html__params_T):string
+export interface links_html__params_T {
+	css:string[]
+	indentation:string
+}
+export type links_html__opts_T = links_html__params_T
+export {
+	links_html_ as _links_html,
+	links_html_ as _html__links,
+}
+

package/all/links_html/index.js

@@ -0,0 +1,20 @@
+/// <reference types="./index.d.ts" />
+/**
+ * html for css link tags
+ * @param {links_html__params_T}params
+ * @returns {string}
+ */
+export function links_html_(params) {
+	const css = params.css ?? []
+	const indentation = params.indentation ?? ''
+	let links_html_a = []
+	for (let i = 0; i < css.length; i++) {
+		const css_file = css[i]
+		links_html_a.push(`${indentation}<link rel="stylesheet" type="text/css" href="${css_file}">`)
+	}
+	return links_html_a.join('\n')
+}
+export {
+	links_html_ as _links_html,
+	links_html_ as _html__links,
+}

package/all/map_apply/index.d.ts

@@ -3,7 +3,7 @@ import type { map_fn_T } from '../map_fn/index.js'
  * Returns function that returns map of calls to fn_a applying in_arg_a with ...arg_a_
  */
 export declare function map_apply_<Arg, O>(
-	fn_a:map_fn_T[],
+	fn_a:map_fn_T<Arg, O>[],
 	in_arg_a?:Arg[]
 ):(...fn_arg_a:Arg[])=>O[]
 export declare type map_apply_T<Arg, O> = (...fn_arg_a:Arg[])=>O[]

package/all/map_apply/index.js

@@ -6,7 +6,7 @@ import { concat } from '../concat/index.js'
  * @returns {(...fn_arg_a:unknown[])=>unknown[]}
  */
 export function map_apply_(fn_a, in_arg_a = []) {
-	return (...fn_arg_a)=>fn_a.map((fn)=>fn(...concat(in_arg_a, fn_arg_a)))
+	return (...fn_arg_a)=>fn_a.map(fn=>fn(...concat(in_arg_a, fn_arg_a)))
 }
 export {
 	map_apply_ as map_fn_apply_fn,

package/all/rank/index.d.ts

@@ -4,6 +4,6 @@ import type { compare_1_T } from '../array_types/index.js'
  */
 export declare function rank<I>(
 	a:readonly I[],
-	compare_1:compare_1_T
+	compare_1:compare_1_T<I>
 ):number
 export { rank as rank__a1, }

package/all/selector_splice/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * splice out any `array` elements matching `selector`
  */
-export declare function selector_splice<I, O extends unknown[] = readonly I[]>(
+export declare function selector_splice<I, O extends unknown[] = I[]>(
 	a:readonly I[],
 	selector:(v:I, i:number, a:readonly I[])=>I
 ):O

package/all/slice/index.d.ts

@@ -1,12 +1,12 @@
 /**
  * Calls slice on a
  */
-export declare function slice<I, O extends unknown[] = readonly I[]>(
+export declare function slice<I, O extends unknown[] = I[]>(
 	a:readonly I[],
 	begin_idx?:number,
 	end_idx?:number
 ):O
-export declare function maybe_slice<I, O extends unknown[] = readonly I[], Or = null>(
+export declare function maybe_slice<I, O extends unknown[] = I[], Or = null>(
 	maybe_a:readonly I[]|undefined,
 	begin_idx?:number,
 	end_idx?:number,

package/all/sort/index.d.ts

@@ -2,7 +2,7 @@ import type { compare_T } from '../array_types/index.js'
 /**
  * Sort items in `a` by the `compare` function
  */
-export declare function sort<I, O extends unknown[] = readonly I[]>(
+export declare function sort<I, O extends unknown[] = I[]>(
 	a:readonly I[], compare?:compare_T<I>
 ):O
 export declare function maybe_sort<I, O = readonly I[], Or = null>(

package/all/splice/index.d.ts

@@ -1,13 +1,13 @@
 /**
  * Calls splice on a
  */
-export declare function splice<I, O extends unknown[] = readonly I[]>(
+export declare function splice<I, O extends unknown[] = I[]>(
 	a:readonly I[],
 	start:number,
 	delete_count?:number,
 	...arg_a:readonly I[]
 ):O
-export declare function maybe_splice<I, O extends unknown[] = readonly I[]>(
+export declare function maybe_splice<I, O extends unknown[] = I[]>(
 	maybe_a:readonly I[]|undefined,
 	start:number,
 	delete_count?:number,

package/all/wrap_a/index.d.ts

@@ -15,8 +15,8 @@ export declare type wrap_a_T<I> =
 	I extends readonly unknown[]
 		? I
 		: readonly I[]
-export declare type wrap_a1_T = wrap_a_T
-export declare type wrap_a1_type = wrap_a_T
+export declare type wrap_a1_T<I> = wrap_a_T<I>
+export declare type wrap_a1_type<I> = wrap_a_T<I>
 export declare type wrap_a_T2<I> =
 	|readonly I[]
 	|readonly I[][]

package/all/wrap_a_item/index.d.ts

@@ -3,4 +3,4 @@ export declare type wrap_a_item_T<I> =
 	wrap_a_T<I> extends readonly (infer O)[][]
 		? O
 		: never
-export declare type wrap_a1_item_type = wrap_a_item_T
+export declare type wrap_a1_item_type<I> = wrap_a_item_T<I>

package/all/wrap_aa/index.d.ts

@@ -14,4 +14,4 @@ export declare type wrap_aa_T<I> = (
 		: I extends readonly unknown[]
 			? readonly I[]
 			: readonly I[][])
-export declare type wrap_aa_type = wrap_aa_T
+export declare type wrap_aa_type<I> = wrap_aa_T<I>

package/all/wrap_aa_item/index.d.ts

@@ -3,4 +3,4 @@ export declare type wrap_aa_item_T<I> =
 	wrap_aa_T<I> extends readonly (infer O)[][]
 		? O
 		: never
-export declare type wrapA2ItemT = wrap_aa_item_T
+export declare type wrapA2ItemT<I> = wrap_aa_item_T<I>

package/array/index.d.ts

@@ -21,6 +21,7 @@ export * from '../all/every/index.js'
 export * from '../all/filter/index.js'
 export * from '../all/find/index.js'
 export * from '../all/first/index.js'
+export * from '../all/flatten/index.js'
 export * from '../all/gte_0_a/index.js'
 export * from '../all/has_multiple/index.js'
 export * from '../all/idx/index.js'

package/array/index.js

@@ -21,6 +21,7 @@ export * from '../all/every/index.js'
 export * from '../all/filter/index.js'
 export * from '../all/find/index.js'
 export * from '../all/first/index.js'
+export * from '../all/flatten/index.js'
 export * from '../all/gte_0_a/index.js'
 export * from '../all/has_multiple/index.js'
 export * from '../all/idx/index.js'

package/deep_equal/index.d.ts

@@ -0,0 +1 @@
+export * from '../all/deep_equal/index.js'

package/deep_equal/index.js

@@ -0,0 +1 @@
+export * from '../all/deep_equal/index.js'

package/html/index.d.ts

@@ -0,0 +1,10 @@
+export * from '../all/html_attr/index.js'
+export * from '../all/html_attrs/index.js'
+export * from '../all/html_class/index.js'
+export * from '../all/html_dataset__data_attrs/index.js'
+export * from '../all/html/index.js'
+export * from '../all/js_html/index.js'
+export * from '../all/links_html/index.js'
+export * from '../all/html_style/index.js'
+export * from '../all/html_style__assign/index.js'
+export * from '../all/html_styles_o/index.js'

package/html/index.js

@@ -0,0 +1,10 @@
+export * from '../all/html_attr/index.js'
+export * from '../all/html_attrs/index.js'
+export * from '../all/html_class/index.js'
+export * from '../all/html_dataset__data_attrs/index.js'
+export * from '../all/html/index.js'
+export * from '../all/js_html/index.js'
+export * from '../all/links_html/index.js'
+export * from '../all/html_style/index.js'
+export * from '../all/html_style__assign/index.js'
+export * from '../all/html_styles_o/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctx-core",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "ctx-core core library",
   "keywords": [
     "ctx-core",
@@ -41,11 +41,13 @@
     "data",
     "date",
     "debounce",
+    "deep_equal",
     "error",
     "fetch",
     "fibonacci",
     "function",
     "functional",
+    "html",
     "http",
     "math",
     "matrix",
@@ -85,11 +87,13 @@
     "./data": "./data/index.js",
     "./date": "./date/index.js",
     "./debounce": "./debounce/index.js",
+    "./deep_equal": "./deep_equal/index.js",
     "./error": "./error/index.js",
     "./fetch": "./fetch/index.js",
     "./fibonacci": "./fibonacci/index.js",
     "./function": "./function/index.js",
     "./functional": "./functional/index.js",
+    "./html": "./html/index.js",
     "./http": "./http/index.js",
     "./math": "./math/index.js",
     "./matrix": "./matrix/index.js",
@@ -119,7 +123,7 @@
     "check-dts": "^0.7.2",
     "sinon": "^17.0.1",
     "size-limit": "^11.0.1",
-    "tsx": "^4.6.2",
+    "tsx": "^4.7.0",
     "typescript": "next",
     "uvu": "^0.5.6"
   },