npm - @charcoal-ui/utils - Versions diffs - 4.2.1 → 4.3.0-beta.1 - Mend

@charcoal-ui/utils 4.2.1 → 4.3.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/dist/index.cjs.js CHANGED Viewed

@@ -18,6 +18,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));

package/dist/index.cjs.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import rgba from 'polished/lib/color/rgba'\nimport rgbToColorString from 'polished/lib/color/rgbToColorString'\nimport parseToRgb from 'polished/lib/color/parseToRgb'\nimport linearGradient from 'polished/lib/mixins/linearGradient'\nimport { type RgbColor } from 'polished/lib/types/color'\n\nimport {\n type AlphaEffect,\n type Effect,\n type Effects,\n type GradientMaterial,\n type OpacityEffect,\n type ReplaceEffect,\n type TypographyDescriptor,\n} from '@charcoal-ui/foundation'\n\nexport const GRADIENT_DIRECTIONS = [\n 'to top',\n 'to bottom',\n 'to left',\n 'to right',\n] as const\n\nexport type GradientDirection = (typeof GRADIENT_DIRECTIONS)[number]\n\nexport function transparentGradient(\n color: string,\n defaultDirection: GradientDirection = 'to bottom'\n) {\n return function transparentGradient(\n direction: GradientDirection \| object = defaultDirection\n ) {\n const transparent = rgba(color, 0)\n return linearGradient({\n colorStops: [color, transparent],\n fallback: transparent,\n toDirection: typeof direction === 'object' ? defaultDirection : direction,\n })\n }\n}\n\nexport function gradient(toDirection: GradientDirection = 'to bottom') {\n return function toLinearGradient(value: GradientMaterial) {\n return linearGradient({\n colorStops: value.map(({ color, ratio }) => `${color} ${ratio}%`),\n fallback: value[0]?.color,\n toDirection,\n })\n }\n}\n\nexport function applyEffectToGradient(effect: Effects) {\n return function toGradient(value: GradientMaterial): GradientMaterial {\n return value.map(({ color, ratio }) => ({\n color: applyEffect(color, effect),\n ratio,\n }))\n }\n}\n\ninterface RgbaColor extends RgbColor {\n alpha?: number\n}\n\ninterface ReadonlyArrayConstructor {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n isArray(value: any): value is readonly any[]\n}\n\nexport function applyEffect(\n baseColor: string \| null,\n effects: Effects\n): string {\n const color = baseColor ?? '#00000000'\n if ((Array as ReadonlyArrayConstructor).isArray(effects)) {\n return effects.reduce(applySingleEffect, color)\n }\n return applySingleEffect(color, effects)\n}\n\nfunction applySingleEffect(baseColor: string, effect: Effect): string {\n switch (effect.type) {\n case 'alpha':\n return applyAlpha(baseColor, effect)\n case 'opacity':\n return applyOpacity(baseColor, effect)\n case 'replace':\n return applyReplace(baseColor, effect)\n default:\n throw new RangeError(\n `Unknown effect type ${\n (effect as Effect).type\n }, upgrade @charcoal-ui/utils`\n )\n }\n}\n\nfunction applyAlpha(baseColor: string, { color, opacity }: AlphaEffect) {\n const base: RgbaColor = parseToRgb(baseColor)\n const effect: RgbaColor = parseToRgb(color)\n const src = [base.red, base.green, base.blue, base.alpha ?? 1.0] as const\n const dst = [\n effect.red,\n effect.green,\n effect.blue,\n clamp(0, 1, (effect.alpha ?? 1.0) * (opacity ?? 1.0)),\n ] as const\n return rgba(...alphaBlend(src, dst))\n}\n\nfunction applyOpacity(baseColor: string, { opacity }: OpacityEffect) {\n const parsed: RgbaColor = parseToRgb(baseColor)\n parsed.alpha = clamp(0, 1, (parsed.alpha ?? 1.0) * opacity)\n return rgbToColorString(parsed)\n}\n\nfunction applyReplace(\n baseColor: string,\n { color = baseColor, opacity }: ReplaceEffect\n) {\n if (opacity === undefined) {\n return color\n }\n const parsed: RgbaColor = parseToRgb(color)\n // NOTE: intentionally ignores any alpha value in the baseColor\n parsed.alpha = opacity\n return rgbToColorString(parsed)\n}\n\ntype Color4 = readonly [number, number, number, number]\n\n/*\n NOTE: alpha component must be in range from 0.0 to 1.0. (0.0 represents a fully transparent)\n \n @param src `[r, g, b, alpha]` Background\n * @param dst `[r, g, b, alpha]` Foreground\n /\nfunction alphaBlend(src: Color4, dst: Color4): Color4 {\n const srcA = src[3]\n const dstA = dst[3]\n const outA = srcA + dstA (1 - srcA)\n if (outA < EPS) {\n // blending 0% alpha with 0% alpha\n return [0, 0, 0, 0]\n }\n return [\n Math.round((src[0] * srcA * (1 - dstA) + dst[0] * dstA) / outA),\n Math.round((src[1] * srcA * (1 - dstA) + dst[1] * dstA) / outA),\n Math.round((src[2] * srcA * (1 - dstA) + dst[2] * dstA) / outA),\n outA,\n ]\n}\nconst EPS = 1e-6\n\nfunction clamp(min: number, max: number, value: number) {\n return Math.min(Math.max(value, min), max)\n}\n\n/*\n affix `px` unit\n \n @param value pixel\n /\nexport function px(value: number) {\n return `${value}px`\n}\n\n/\n affix `s` unit\n \n @param value second\n /\nexport function dur(value: number) {\n return `${value}s`\n}\n\nexport const notDisabledSelector = `&:not(:disabled):not([aria-disabled]), &[aria-disabled=false]`\n\nexport const disabledSelector = `&:disabled, &[aria-disabled]:not([aria-disabled=false])`\n\n/\n Construct media query from breakpoint\n /\nexport function maxWidth(breakpoint: number) {\n return `(max-width: ${breakpoint - 1}px)`\n}\n\n/\n Derive half-leading from typography size\n /\nexport const halfLeading = ({ fontSize, lineHeight }: TypographyDescriptor) =>\n (lineHeight - fontSize) / 2\n\n/\n Namespaced custom property\n /\nexport const customPropertyToken = (\n id: string,\n modifiers: readonly string[] = []\n): `--charcoal-${string}` =>\n `--charcoal-${id}${modifiers.length === 0 ? '' : ['', modifiers].join('-')}`\n\n/\n @example\n * ```js\n * mapKeys({ a: 'aa', b: 'bb' }, (key) => key.toUpperCase()) // => { A: \"aa\", B: \"bb\" }\n * ````\n /\nexport function mapKeys<V, K extends string>(\n object: Record<string, V>,\n callback: (key: string) => K\n) {\n return Object.fromEntries(\n Object.entries(object).map(([key, value]) => [callback(key), value])\n ) as Record<K, V>\n}\n\n/\n @example\n * ```js\n * mapObject({ a: 'aa', b: 'bb', c: 'cc' }, (key, value) =>\n * key === 'b' ? undefined : [key + '1', value.toUpperCase()]\n * ) // => { a1: \"AA\", c1: \"CC\" }\n * ```\n /\nexport function mapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (\n key: SourceKey,\n value: SourceValue\n ) => [DestKey, DestValue] \| null \| undefined\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n const entry = callback(key as SourceKey, value as SourceValue)\n if (entry) {\n return [entry]\n } else {\n return []\n }\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```js\n * flatMapObject({ a: 'aa', b: 'bb' }, (key, value) => [\n * [key + '1', value + '1'],\n * [key + '2', value + '2'],\n * ]) // => { a1: \"aa1\", a2: \"aa2\", b1: \"bb1\", b2: \"bb2\" }\n * ```\n /\nexport function flatMapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (key: SourceKey, value: SourceValue) => [DestKey, DestValue][]\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n return callback(key as SourceKey, value as SourceValue)\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```ts\n * filterObject(\n * { a: 'aa', b: 'bb', c: 'cc' },\n * (value): value is string => value !== 'bb'\n * ) // => { a: \"aa\", c: \"cc\" }\n * ```\n */\nexport function filterObject<Source, Dest extends Source>(\n source: Record<string, Source>,\n fn: (value: Source) => value is Dest\n) {\n return mapObject(source, (key, value) => {\n if (fn(value) === true) {\n return [key, value]\n } else {\n return null\n }\n }) as Record<string, Dest>\n}\n"],"mappings":"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","names":["transparentGradient","rgba","linearGradient","parseToRgb","rgbToColorString"]}
1	+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import rgba from 'polished/lib/color/rgba'\nimport rgbToColorString from 'polished/lib/color/rgbToColorString'\nimport parseToRgb from 'polished/lib/color/parseToRgb'\nimport linearGradient from 'polished/lib/mixins/linearGradient'\nimport { type RgbColor } from 'polished/lib/types/color'\n\nimport {\n type AlphaEffect,\n type Effect,\n type Effects,\n type GradientMaterial,\n type OpacityEffect,\n type ReplaceEffect,\n type TypographyDescriptor,\n} from '@charcoal-ui/foundation'\n\nexport const GRADIENT_DIRECTIONS = [\n 'to top',\n 'to bottom',\n 'to left',\n 'to right',\n] as const\n\nexport type GradientDirection = (typeof GRADIENT_DIRECTIONS)[number]\n\nexport function transparentGradient(\n color: string,\n defaultDirection: GradientDirection = 'to bottom'\n) {\n return function transparentGradient(\n direction: GradientDirection \| object = defaultDirection\n ) {\n const transparent = rgba(color, 0)\n return linearGradient({\n colorStops: [color, transparent],\n fallback: transparent,\n toDirection: typeof direction === 'object' ? defaultDirection : direction,\n })\n }\n}\n\nexport function gradient(toDirection: GradientDirection = 'to bottom') {\n return function toLinearGradient(value: GradientMaterial) {\n return linearGradient({\n colorStops: value.map(({ color, ratio }) => `${color} ${ratio}%`),\n fallback: value[0]?.color,\n toDirection,\n })\n }\n}\n\nexport function applyEffectToGradient(effect: Effects) {\n return function toGradient(value: GradientMaterial): GradientMaterial {\n return value.map(({ color, ratio }) => ({\n color: applyEffect(color, effect),\n ratio,\n }))\n }\n}\n\ninterface RgbaColor extends RgbColor {\n alpha?: number\n}\n\ninterface ReadonlyArrayConstructor {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n isArray(value: any): value is readonly any[]\n}\n\nexport function applyEffect(\n baseColor: string \| null,\n effects: Effects\n): string {\n const color = baseColor ?? '#00000000'\n if ((Array as ReadonlyArrayConstructor).isArray(effects)) {\n return effects.reduce(applySingleEffect, color)\n }\n return applySingleEffect(color, effects)\n}\n\nfunction applySingleEffect(baseColor: string, effect: Effect): string {\n switch (effect.type) {\n case 'alpha':\n return applyAlpha(baseColor, effect)\n case 'opacity':\n return applyOpacity(baseColor, effect)\n case 'replace':\n return applyReplace(baseColor, effect)\n default:\n throw new RangeError(\n `Unknown effect type ${\n (effect as Effect).type\n }, upgrade @charcoal-ui/utils`\n )\n }\n}\n\nfunction applyAlpha(baseColor: string, { color, opacity }: AlphaEffect) {\n const base: RgbaColor = parseToRgb(baseColor)\n const effect: RgbaColor = parseToRgb(color)\n const src = [base.red, base.green, base.blue, base.alpha ?? 1.0] as const\n const dst = [\n effect.red,\n effect.green,\n effect.blue,\n clamp(0, 1, (effect.alpha ?? 1.0) * (opacity ?? 1.0)),\n ] as const\n return rgba(...alphaBlend(src, dst))\n}\n\nfunction applyOpacity(baseColor: string, { opacity }: OpacityEffect) {\n const parsed: RgbaColor = parseToRgb(baseColor)\n parsed.alpha = clamp(0, 1, (parsed.alpha ?? 1.0) * opacity)\n return rgbToColorString(parsed)\n}\n\nfunction applyReplace(\n baseColor: string,\n { color = baseColor, opacity }: ReplaceEffect\n) {\n if (opacity === undefined) {\n return color\n }\n const parsed: RgbaColor = parseToRgb(color)\n // NOTE: intentionally ignores any alpha value in the baseColor\n parsed.alpha = opacity\n return rgbToColorString(parsed)\n}\n\ntype Color4 = readonly [number, number, number, number]\n\n/*\n NOTE: alpha component must be in range from 0.0 to 1.0. (0.0 represents a fully transparent)\n \n @param src `[r, g, b, alpha]` Background\n * @param dst `[r, g, b, alpha]` Foreground\n /\nfunction alphaBlend(src: Color4, dst: Color4): Color4 {\n const srcA = src[3]\n const dstA = dst[3]\n const outA = srcA + dstA (1 - srcA)\n if (outA < EPS) {\n // blending 0% alpha with 0% alpha\n return [0, 0, 0, 0]\n }\n return [\n Math.round((src[0] * srcA * (1 - dstA) + dst[0] * dstA) / outA),\n Math.round((src[1] * srcA * (1 - dstA) + dst[1] * dstA) / outA),\n Math.round((src[2] * srcA * (1 - dstA) + dst[2] * dstA) / outA),\n outA,\n ]\n}\nconst EPS = 1e-6\n\nfunction clamp(min: number, max: number, value: number) {\n return Math.min(Math.max(value, min), max)\n}\n\n/*\n affix `px` unit\n \n @param value pixel\n /\nexport function px(value: number) {\n return `${value}px`\n}\n\n/\n affix `s` unit\n \n @param value second\n /\nexport function dur(value: number) {\n return `${value}s`\n}\n\nexport const notDisabledSelector = `&:not(:disabled):not([aria-disabled]), &[aria-disabled=false]`\n\nexport const disabledSelector = `&:disabled, &[aria-disabled]:not([aria-disabled=false])`\n\n/\n Construct media query from breakpoint\n /\nexport function maxWidth(breakpoint: number) {\n return `(max-width: ${breakpoint - 1}px)`\n}\n\n/\n Derive half-leading from typography size\n /\nexport const halfLeading = ({ fontSize, lineHeight }: TypographyDescriptor) =>\n (lineHeight - fontSize) / 2\n\n/\n Namespaced custom property\n /\nexport const customPropertyToken = (\n id: string,\n modifiers: readonly string[] = []\n): `--charcoal-${string}` =>\n `--charcoal-${id}${modifiers.length === 0 ? '' : ['', modifiers].join('-')}`\n\n/\n @example\n * ```js\n * mapKeys({ a: 'aa', b: 'bb' }, (key) => key.toUpperCase()) // => { A: \"aa\", B: \"bb\" }\n * ````\n /\nexport function mapKeys<V, K extends string>(\n object: Record<string, V>,\n callback: (key: string) => K\n) {\n return Object.fromEntries(\n Object.entries(object).map(([key, value]) => [callback(key), value])\n ) as Record<K, V>\n}\n\n/\n @example\n * ```js\n * mapObject({ a: 'aa', b: 'bb', c: 'cc' }, (key, value) =>\n * key === 'b' ? undefined : [key + '1', value.toUpperCase()]\n * ) // => { a1: \"AA\", c1: \"CC\" }\n * ```\n /\nexport function mapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (\n key: SourceKey,\n value: SourceValue\n ) => [DestKey, DestValue] \| null \| undefined\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n const entry = callback(key as SourceKey, value as SourceValue)\n if (entry) {\n return [entry]\n } else {\n return []\n }\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```js\n * flatMapObject({ a: 'aa', b: 'bb' }, (key, value) => [\n * [key + '1', value + '1'],\n * [key + '2', value + '2'],\n * ]) // => { a1: \"aa1\", a2: \"aa2\", b1: \"bb1\", b2: \"bb2\" }\n * ```\n /\nexport function flatMapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (key: SourceKey, value: SourceValue) => [DestKey, DestValue][]\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n return callback(key as SourceKey, value as SourceValue)\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```ts\n * filterObject(\n * { a: 'aa', b: 'bb', c: 'cc' },\n * (value): value is string => value !== 'bb'\n * ) // => { a: \"aa\", c: \"cc\" }\n * ```\n */\nexport function filterObject<Source, Dest extends Source>(\n source: Record<string, Source>,\n fn: (value: Source) => value is Dest\n) {\n return mapObject(source, (key, value) => {\n if (fn(value) === true) {\n return [key, value]\n } else {\n return null\n }\n }) as Record<string, Dest>\n}\n"],"mappings":"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","names":["transparentGradient","rgba","linearGradient","parseToRgb","rgbToColorString"]}

package/dist/index.esm.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import rgba from 'polished/lib/color/rgba'\nimport rgbToColorString from 'polished/lib/color/rgbToColorString'\nimport parseToRgb from 'polished/lib/color/parseToRgb'\nimport linearGradient from 'polished/lib/mixins/linearGradient'\nimport { type RgbColor } from 'polished/lib/types/color'\n\nimport {\n type AlphaEffect,\n type Effect,\n type Effects,\n type GradientMaterial,\n type OpacityEffect,\n type ReplaceEffect,\n type TypographyDescriptor,\n} from '@charcoal-ui/foundation'\n\nexport const GRADIENT_DIRECTIONS = [\n 'to top',\n 'to bottom',\n 'to left',\n 'to right',\n] as const\n\nexport type GradientDirection = (typeof GRADIENT_DIRECTIONS)[number]\n\nexport function transparentGradient(\n color: string,\n defaultDirection: GradientDirection = 'to bottom'\n) {\n return function transparentGradient(\n direction: GradientDirection \| object = defaultDirection\n ) {\n const transparent = rgba(color, 0)\n return linearGradient({\n colorStops: [color, transparent],\n fallback: transparent,\n toDirection: typeof direction === 'object' ? defaultDirection : direction,\n })\n }\n}\n\nexport function gradient(toDirection: GradientDirection = 'to bottom') {\n return function toLinearGradient(value: GradientMaterial) {\n return linearGradient({\n colorStops: value.map(({ color, ratio }) => `${color} ${ratio}%`),\n fallback: value[0]?.color,\n toDirection,\n })\n }\n}\n\nexport function applyEffectToGradient(effect: Effects) {\n return function toGradient(value: GradientMaterial): GradientMaterial {\n return value.map(({ color, ratio }) => ({\n color: applyEffect(color, effect),\n ratio,\n }))\n }\n}\n\ninterface RgbaColor extends RgbColor {\n alpha?: number\n}\n\ninterface ReadonlyArrayConstructor {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n isArray(value: any): value is readonly any[]\n}\n\nexport function applyEffect(\n baseColor: string \| null,\n effects: Effects\n): string {\n const color = baseColor ?? '#00000000'\n if ((Array as ReadonlyArrayConstructor).isArray(effects)) {\n return effects.reduce(applySingleEffect, color)\n }\n return applySingleEffect(color, effects)\n}\n\nfunction applySingleEffect(baseColor: string, effect: Effect): string {\n switch (effect.type) {\n case 'alpha':\n return applyAlpha(baseColor, effect)\n case 'opacity':\n return applyOpacity(baseColor, effect)\n case 'replace':\n return applyReplace(baseColor, effect)\n default:\n throw new RangeError(\n `Unknown effect type ${\n (effect as Effect).type\n }, upgrade @charcoal-ui/utils`\n )\n }\n}\n\nfunction applyAlpha(baseColor: string, { color, opacity }: AlphaEffect) {\n const base: RgbaColor = parseToRgb(baseColor)\n const effect: RgbaColor = parseToRgb(color)\n const src = [base.red, base.green, base.blue, base.alpha ?? 1.0] as const\n const dst = [\n effect.red,\n effect.green,\n effect.blue,\n clamp(0, 1, (effect.alpha ?? 1.0) * (opacity ?? 1.0)),\n ] as const\n return rgba(...alphaBlend(src, dst))\n}\n\nfunction applyOpacity(baseColor: string, { opacity }: OpacityEffect) {\n const parsed: RgbaColor = parseToRgb(baseColor)\n parsed.alpha = clamp(0, 1, (parsed.alpha ?? 1.0) * opacity)\n return rgbToColorString(parsed)\n}\n\nfunction applyReplace(\n baseColor: string,\n { color = baseColor, opacity }: ReplaceEffect\n) {\n if (opacity === undefined) {\n return color\n }\n const parsed: RgbaColor = parseToRgb(color)\n // NOTE: intentionally ignores any alpha value in the baseColor\n parsed.alpha = opacity\n return rgbToColorString(parsed)\n}\n\ntype Color4 = readonly [number, number, number, number]\n\n/*\n NOTE: alpha component must be in range from 0.0 to 1.0. (0.0 represents a fully transparent)\n \n @param src `[r, g, b, alpha]` Background\n * @param dst `[r, g, b, alpha]` Foreground\n /\nfunction alphaBlend(src: Color4, dst: Color4): Color4 {\n const srcA = src[3]\n const dstA = dst[3]\n const outA = srcA + dstA (1 - srcA)\n if (outA < EPS) {\n // blending 0% alpha with 0% alpha\n return [0, 0, 0, 0]\n }\n return [\n Math.round((src[0] * srcA * (1 - dstA) + dst[0] * dstA) / outA),\n Math.round((src[1] * srcA * (1 - dstA) + dst[1] * dstA) / outA),\n Math.round((src[2] * srcA * (1 - dstA) + dst[2] * dstA) / outA),\n outA,\n ]\n}\nconst EPS = 1e-6\n\nfunction clamp(min: number, max: number, value: number) {\n return Math.min(Math.max(value, min), max)\n}\n\n/*\n affix `px` unit\n \n @param value pixel\n /\nexport function px(value: number) {\n return `${value}px`\n}\n\n/\n affix `s` unit\n \n @param value second\n /\nexport function dur(value: number) {\n return `${value}s`\n}\n\nexport const notDisabledSelector = `&:not(:disabled):not([aria-disabled]), &[aria-disabled=false]`\n\nexport const disabledSelector = `&:disabled, &[aria-disabled]:not([aria-disabled=false])`\n\n/\n Construct media query from breakpoint\n /\nexport function maxWidth(breakpoint: number) {\n return `(max-width: ${breakpoint - 1}px)`\n}\n\n/\n Derive half-leading from typography size\n /\nexport const halfLeading = ({ fontSize, lineHeight }: TypographyDescriptor) =>\n (lineHeight - fontSize) / 2\n\n/\n Namespaced custom property\n /\nexport const customPropertyToken = (\n id: string,\n modifiers: readonly string[] = []\n): `--charcoal-${string}` =>\n `--charcoal-${id}${modifiers.length === 0 ? '' : ['', modifiers].join('-')}`\n\n/\n @example\n * ```js\n * mapKeys({ a: 'aa', b: 'bb' }, (key) => key.toUpperCase()) // => { A: \"aa\", B: \"bb\" }\n * ````\n /\nexport function mapKeys<V, K extends string>(\n object: Record<string, V>,\n callback: (key: string) => K\n) {\n return Object.fromEntries(\n Object.entries(object).map(([key, value]) => [callback(key), value])\n ) as Record<K, V>\n}\n\n/\n @example\n * ```js\n * mapObject({ a: 'aa', b: 'bb', c: 'cc' }, (key, value) =>\n * key === 'b' ? undefined : [key + '1', value.toUpperCase()]\n * ) // => { a1: \"AA\", c1: \"CC\" }\n * ```\n /\nexport function mapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (\n key: SourceKey,\n value: SourceValue\n ) => [DestKey, DestValue] \| null \| undefined\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n const entry = callback(key as SourceKey, value as SourceValue)\n if (entry) {\n return [entry]\n } else {\n return []\n }\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```js\n * flatMapObject({ a: 'aa', b: 'bb' }, (key, value) => [\n * [key + '1', value + '1'],\n * [key + '2', value + '2'],\n * ]) // => { a1: \"aa1\", a2: \"aa2\", b1: \"bb1\", b2: \"bb2\" }\n * ```\n /\nexport function flatMapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (key: SourceKey, value: SourceValue) => [DestKey, DestValue][]\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n return callback(key as SourceKey, value as SourceValue)\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```ts\n * filterObject(\n * { a: 'aa', b: 'bb', c: 'cc' },\n * (value): value is string => value !== 'bb'\n * ) // => { a: \"aa\", c: \"cc\" }\n * ```\n */\nexport function filterObject<Source, Dest extends Source>(\n source: Record<string, Source>,\n fn: (value: Source) => value is Dest\n) {\n return mapObject(source, (key, value) => {\n if (fn(value) === true) {\n return [key, value]\n } else {\n return null\n }\n }) as Record<string, Dest>\n}\n"],"mappings":"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","names":["transparentGradient"]}
1	+ {"version":3,"sources":["../src/index.ts"],"sourcesContent":["import rgba from 'polished/lib/color/rgba'\nimport rgbToColorString from 'polished/lib/color/rgbToColorString'\nimport parseToRgb from 'polished/lib/color/parseToRgb'\nimport linearGradient from 'polished/lib/mixins/linearGradient'\nimport { type RgbColor } from 'polished/lib/types/color'\n\nimport {\n type AlphaEffect,\n type Effect,\n type Effects,\n type GradientMaterial,\n type OpacityEffect,\n type ReplaceEffect,\n type TypographyDescriptor,\n} from '@charcoal-ui/foundation'\n\nexport const GRADIENT_DIRECTIONS = [\n 'to top',\n 'to bottom',\n 'to left',\n 'to right',\n] as const\n\nexport type GradientDirection = (typeof GRADIENT_DIRECTIONS)[number]\n\nexport function transparentGradient(\n color: string,\n defaultDirection: GradientDirection = 'to bottom'\n) {\n return function transparentGradient(\n direction: GradientDirection \| object = defaultDirection\n ) {\n const transparent = rgba(color, 0)\n return linearGradient({\n colorStops: [color, transparent],\n fallback: transparent,\n toDirection: typeof direction === 'object' ? defaultDirection : direction,\n })\n }\n}\n\nexport function gradient(toDirection: GradientDirection = 'to bottom') {\n return function toLinearGradient(value: GradientMaterial) {\n return linearGradient({\n colorStops: value.map(({ color, ratio }) => `${color} ${ratio}%`),\n fallback: value[0]?.color,\n toDirection,\n })\n }\n}\n\nexport function applyEffectToGradient(effect: Effects) {\n return function toGradient(value: GradientMaterial): GradientMaterial {\n return value.map(({ color, ratio }) => ({\n color: applyEffect(color, effect),\n ratio,\n }))\n }\n}\n\ninterface RgbaColor extends RgbColor {\n alpha?: number\n}\n\ninterface ReadonlyArrayConstructor {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n isArray(value: any): value is readonly any[]\n}\n\nexport function applyEffect(\n baseColor: string \| null,\n effects: Effects\n): string {\n const color = baseColor ?? '#00000000'\n if ((Array as ReadonlyArrayConstructor).isArray(effects)) {\n return effects.reduce(applySingleEffect, color)\n }\n return applySingleEffect(color, effects)\n}\n\nfunction applySingleEffect(baseColor: string, effect: Effect): string {\n switch (effect.type) {\n case 'alpha':\n return applyAlpha(baseColor, effect)\n case 'opacity':\n return applyOpacity(baseColor, effect)\n case 'replace':\n return applyReplace(baseColor, effect)\n default:\n throw new RangeError(\n `Unknown effect type ${\n (effect as Effect).type\n }, upgrade @charcoal-ui/utils`\n )\n }\n}\n\nfunction applyAlpha(baseColor: string, { color, opacity }: AlphaEffect) {\n const base: RgbaColor = parseToRgb(baseColor)\n const effect: RgbaColor = parseToRgb(color)\n const src = [base.red, base.green, base.blue, base.alpha ?? 1.0] as const\n const dst = [\n effect.red,\n effect.green,\n effect.blue,\n clamp(0, 1, (effect.alpha ?? 1.0) * (opacity ?? 1.0)),\n ] as const\n return rgba(...alphaBlend(src, dst))\n}\n\nfunction applyOpacity(baseColor: string, { opacity }: OpacityEffect) {\n const parsed: RgbaColor = parseToRgb(baseColor)\n parsed.alpha = clamp(0, 1, (parsed.alpha ?? 1.0) * opacity)\n return rgbToColorString(parsed)\n}\n\nfunction applyReplace(\n baseColor: string,\n { color = baseColor, opacity }: ReplaceEffect\n) {\n if (opacity === undefined) {\n return color\n }\n const parsed: RgbaColor = parseToRgb(color)\n // NOTE: intentionally ignores any alpha value in the baseColor\n parsed.alpha = opacity\n return rgbToColorString(parsed)\n}\n\ntype Color4 = readonly [number, number, number, number]\n\n/*\n NOTE: alpha component must be in range from 0.0 to 1.0. (0.0 represents a fully transparent)\n \n @param src `[r, g, b, alpha]` Background\n * @param dst `[r, g, b, alpha]` Foreground\n /\nfunction alphaBlend(src: Color4, dst: Color4): Color4 {\n const srcA = src[3]\n const dstA = dst[3]\n const outA = srcA + dstA (1 - srcA)\n if (outA < EPS) {\n // blending 0% alpha with 0% alpha\n return [0, 0, 0, 0]\n }\n return [\n Math.round((src[0] * srcA * (1 - dstA) + dst[0] * dstA) / outA),\n Math.round((src[1] * srcA * (1 - dstA) + dst[1] * dstA) / outA),\n Math.round((src[2] * srcA * (1 - dstA) + dst[2] * dstA) / outA),\n outA,\n ]\n}\nconst EPS = 1e-6\n\nfunction clamp(min: number, max: number, value: number) {\n return Math.min(Math.max(value, min), max)\n}\n\n/*\n affix `px` unit\n \n @param value pixel\n /\nexport function px(value: number) {\n return `${value}px`\n}\n\n/\n affix `s` unit\n \n @param value second\n /\nexport function dur(value: number) {\n return `${value}s`\n}\n\nexport const notDisabledSelector = `&:not(:disabled):not([aria-disabled]), &[aria-disabled=false]`\n\nexport const disabledSelector = `&:disabled, &[aria-disabled]:not([aria-disabled=false])`\n\n/\n Construct media query from breakpoint\n /\nexport function maxWidth(breakpoint: number) {\n return `(max-width: ${breakpoint - 1}px)`\n}\n\n/\n Derive half-leading from typography size\n /\nexport const halfLeading = ({ fontSize, lineHeight }: TypographyDescriptor) =>\n (lineHeight - fontSize) / 2\n\n/\n Namespaced custom property\n /\nexport const customPropertyToken = (\n id: string,\n modifiers: readonly string[] = []\n): `--charcoal-${string}` =>\n `--charcoal-${id}${modifiers.length === 0 ? '' : ['', modifiers].join('-')}`\n\n/\n @example\n * ```js\n * mapKeys({ a: 'aa', b: 'bb' }, (key) => key.toUpperCase()) // => { A: \"aa\", B: \"bb\" }\n * ````\n /\nexport function mapKeys<V, K extends string>(\n object: Record<string, V>,\n callback: (key: string) => K\n) {\n return Object.fromEntries(\n Object.entries(object).map(([key, value]) => [callback(key), value])\n ) as Record<K, V>\n}\n\n/\n @example\n * ```js\n * mapObject({ a: 'aa', b: 'bb', c: 'cc' }, (key, value) =>\n * key === 'b' ? undefined : [key + '1', value.toUpperCase()]\n * ) // => { a1: \"AA\", c1: \"CC\" }\n * ```\n /\nexport function mapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (\n key: SourceKey,\n value: SourceValue\n ) => [DestKey, DestValue] \| null \| undefined\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n const entry = callback(key as SourceKey, value as SourceValue)\n if (entry) {\n return [entry]\n } else {\n return []\n }\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```js\n * flatMapObject({ a: 'aa', b: 'bb' }, (key, value) => [\n * [key + '1', value + '1'],\n * [key + '2', value + '2'],\n * ]) // => { a1: \"aa1\", a2: \"aa2\", b1: \"bb1\", b2: \"bb2\" }\n * ```\n /\nexport function flatMapObject<\n SourceKey extends string,\n SourceValue,\n DestKey extends string,\n DestValue\n>(\n source: Record<SourceKey, SourceValue>,\n callback: (key: SourceKey, value: SourceValue) => [DestKey, DestValue][]\n) {\n return Object.fromEntries(\n Object.entries(source).flatMap(([key, value]) => {\n return callback(key as SourceKey, value as SourceValue)\n })\n ) as Record<DestKey, DestValue>\n}\n\n/\n @example\n * ```ts\n * filterObject(\n * { a: 'aa', b: 'bb', c: 'cc' },\n * (value): value is string => value !== 'bb'\n * ) // => { a: \"aa\", c: \"cc\" }\n * ```\n */\nexport function filterObject<Source, Dest extends Source>(\n source: Record<string, Source>,\n fn: (value: Source) => value is Dest\n) {\n return mapObject(source, (key, value) => {\n if (fn(value) === true) {\n return [key, value]\n } else {\n return null\n }\n }) as Record<string, Dest>\n}\n"],"mappings":"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","names":["transparentGradient"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@charcoal-ui/utils",
-  "version": "4.2.1",
+  "version": "4.3.0-beta.1",
   "license": "Apache-2.0",
   "main": "./dist/index.cjs.js",
   "module": "./dist/index.esm.js",
@@ -27,7 +27,7 @@
     "vitest": "^2.0.2"
   },
   "dependencies": {
-    "@charcoal-ui/foundation": "^4.2.1",
+    "@charcoal-ui/foundation": "4.3.0-beta.1",
     "polished": "^4.1.4"
   },
   "files": [
@@ -42,5 +42,5 @@
     "url": "https://github.com/pixiv/charcoal.git",
     "directory": "packages/utils"
   },
-  "gitHead": "9a017d7e402dfcf371a5ca9a2b61bcd095467d89"
+  "gitHead": "534223f15a5711138d9197945cadddd29dd8ad89"
 }