@hanzogui/create-theme 2.0.0

package/types/createThemeTypes.d.ts

@@ -0,0 +1,67 @@
+import type { Variable } from "@hanzogui/web";
+export type CreateThemePalette = (string | Variable)[];
+export type ThemeMask = Record<string, string | number>;
+export type MaskOptions = {
+	palette?: CreateThemePalette;
+	override?: Partial<ThemeMask>;
+	overrideStrategy?: "shift" | "swap";
+	overrideSwap?: Partial<ThemeMask>;
+	overrideShift?: Partial<ThemeMask>;
+	skip?: Partial<ThemeMask>;
+	strength?: number;
+	max?: number;
+	min?: number;
+	parentName?: string;
+};
+export type GenericTheme = {
+	[key: string]: string | Variable;
+};
+export type MaskFunction = <A extends ThemeMask>(template: A, options: MaskOptions) => A;
+export type CreateMask = {
+	name: string;
+	mask: MaskFunction;
+};
+export type CreateThemeOptions = {
+	nonInheritedValues?: GenericTheme;
+};
+export type Palette = string[];
+export type Template = {
+	[key: string]: number | string;
+};
+export type ThemeUsingMask<Masks = string> = MaskOptions & {
+	mask: Masks;
+	avoidNestingWithin?: string[];
+	childOptions?: MaskOptions & {
+		mask?: Masks;
+	};
+};
+export type ThemeUsingTemplate = CreateThemeOptions & {
+	palette?: string;
+	template: string;
+};
+type ThemePreDefined = {
+	theme: {
+		[key: string]: string;
+	};
+};
+export type Theme<Masks = string> = ThemePreDefined | ThemeUsingTemplate | ThemeUsingMask<Masks>;
+export type ThemeWithParent<Masks = string> = Theme<Masks> & {
+	parent: string;
+};
+export type PaletteDefinitions = {
+	[key: string]: Palette;
+};
+export type ThemeDefinition<Masks extends string = string> = Theme<Masks> | ThemeWithParent<Masks>[];
+type UnionableString = string & {};
+export type ThemeDefinitions<Masks extends string = string> = {
+	[key: string]: ThemeDefinition<Masks | UnionableString>;
+};
+export type TemplateDefinitions = {
+	[key: string]: Template;
+};
+export type MaskDefinitions = {
+	[key: string]: CreateMask | CreateMask["mask"];
+};
+export {};
+
+//# sourceMappingURL=createThemeTypes.d.ts.map

package/types/createThemeTypes.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,cAAc,gBAAgB;AAE9B,YAAY,+BAA+B;AAE3C,YAAY,YAAY;AAExB,YAAY,cAAc;CACxB,UAAU;CACV,WAAW,QAAQ;CACnB,mBAAmB,UAAU;CAC7B,eAAe,QAAQ;CACvB,gBAAgB,QAAQ;CACxB,OAAO,QAAQ;CACf;CACA;CACA;CACA;;AAGF,YAAY,eAAe;yBAA0B;;AAErD,YAAY,gBAAgB,UAAU,WAAW,UAAU,GAAG,SAAS,gBAAgB;AAEvF,YAAY,aAAa;CACvB;CACA,MAAM;;AAGR,YAAY,qBAAqB;CAC/B,qBAAqB;;AAGvB,YAAY;AAEZ,YAAY,WAAW;;;AAIvB,YAAY,eAAe,kBAAkB,cAAc;CACzD,MAAM;CACN;CACA,eAAe,cAAc;EAC3B,OAAO;;;AAIX,YAAY,qBAAqB,qBAAqB;CACpD;CACA;;KAGG,kBAAkB;CACrB,OAAO;;;;AAGT,YAAY,MAAM,kBACd,kBACA,qBACA,eAAe;AAEnB,YAAY,gBAAgB,kBAAkB,MAAM,SAAS;CAC3D;;AAGF,YAAY,qBAAqB;gBAChB;;AAGjB,YAAY,gBAAgB,iCACxB,MAAM,SACN,gBAAgB;KAEf,2BAA2B;AAEhC,YAAY,iBAAiB,iCAAiC;gBAC7C,gBAAgB,QAAQ;;AAGzC,YAAY,sBAAsB;gBACjB;;AAGjB,YAAY,kBAAkB;gBACb,aAAa,WAAW",
+  "names": [],
+  "sources": [
+    "src/createThemeTypes.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "import type { Variable } from '@hanzogui/web'\n\nexport type CreateThemePalette = (string | Variable)[]\n\nexport type ThemeMask = Record<string, string | number>\n\nexport type MaskOptions = {\n  palette?: CreateThemePalette\n  override?: Partial<ThemeMask>\n  overrideStrategy?: 'shift' | 'swap'\n  overrideSwap?: Partial<ThemeMask>\n  overrideShift?: Partial<ThemeMask>\n  skip?: Partial<ThemeMask>\n  strength?: number\n  max?: number\n  min?: number\n  parentName?: string\n}\n\nexport type GenericTheme = { [key: string]: string | Variable }\n\nexport type MaskFunction = <A extends ThemeMask>(template: A, options: MaskOptions) => A\n\nexport type CreateMask = {\n  name: string\n  mask: MaskFunction\n}\n\nexport type CreateThemeOptions = {\n  nonInheritedValues?: GenericTheme\n}\n\nexport type Palette = string[]\n\nexport type Template = {\n  [key: string]: number | string\n}\n\nexport type ThemeUsingMask<Masks = string> = MaskOptions & {\n  mask: Masks\n  avoidNestingWithin?: string[]\n  childOptions?: MaskOptions & {\n    mask?: Masks\n  }\n}\n\nexport type ThemeUsingTemplate = CreateThemeOptions & {\n  palette?: string\n  template: string\n}\n\ntype ThemePreDefined = {\n  theme: { [key: string]: string }\n}\n\nexport type Theme<Masks = string> =\n  | ThemePreDefined\n  | ThemeUsingTemplate\n  | ThemeUsingMask<Masks>\n\nexport type ThemeWithParent<Masks = string> = Theme<Masks> & {\n  parent: string\n}\n\nexport type PaletteDefinitions = {\n  [key: string]: Palette\n}\n\nexport type ThemeDefinition<Masks extends string = string> =\n  | Theme<Masks>\n  | ThemeWithParent<Masks>[]\n\ntype UnionableString = string & {}\n\nexport type ThemeDefinitions<Masks extends string = string> = {\n  [key: string]: ThemeDefinition<Masks | UnionableString>\n}\n\nexport type TemplateDefinitions = {\n  [key: string]: Template\n}\n\nexport type MaskDefinitions = {\n  [key: string]: CreateMask | CreateMask['mask']\n}\n"
+  ]
+}

package/types/helpers.d.ts

@@ -0,0 +1,18 @@
+type ObjectType = Record<PropertyKey, unknown>;
+type PickByValue<
+	OBJ_T,
+	VALUE_T
+> = Pick<OBJ_T, { [K in keyof OBJ_T] : OBJ_T[K] extends VALUE_T ? K : never }[keyof OBJ_T]>;
+type ObjectEntries<OBJ_T> = { [K in keyof OBJ_T] : [keyof PickByValue<OBJ_T, OBJ_T[K]>, OBJ_T[K]] }[keyof OBJ_T][];
+export declare const objectKeys: <O extends object>(obj: O) => Array<keyof O>;
+export declare function objectEntries<OBJ_T extends ObjectType>(obj: OBJ_T): ObjectEntries<OBJ_T>;
+type EntriesType = [PropertyKey, unknown][] | ReadonlyArray<readonly [PropertyKey, unknown]>;
+type DeepWritable<OBJ_T> = { -readonly [P in keyof OBJ_T] : DeepWritable<OBJ_T[P]> };
+type UnionToIntersection<UNION_T> = (UNION_T extends any ? (k: UNION_T) => void : never) extends (k: infer I) => void ? I : never;
+type UnionObjectFromArrayOfPairs<ARR_T extends EntriesType> = DeepWritable<ARR_T> extends (infer R)[] ? R extends [infer key, infer val] ? { [prop in key & PropertyKey] : val } : never : never;
+type MergeIntersectingObjects<ObjT> = { [key in keyof ObjT] : ObjT[key] };
+type EntriesToObject<ARR_T extends EntriesType> = MergeIntersectingObjects<UnionToIntersection<UnionObjectFromArrayOfPairs<ARR_T>>>;
+export declare function objectFromEntries<ARR_T extends EntriesType>(arr: ARR_T): EntriesToObject<ARR_T>;
+export {};
+
+//# sourceMappingURL=helpers.d.ts.map

package/types/helpers.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "KAAK,aAAa,OAAO;KAEpB;CAAY;CAAO;IACtB,KAAK,UAAU,WAAW,SAAQ,MAAM,WAAW,UAAU,kBAAkB;KAE5E,cAAc,YACd,WAAW,gBAAe,YAAY,OAAO,MAAM,KAAK,MAAM,YAAY;AAE/E,OAAO,cAAM,aAAc,kBAAkB,KAAK,MAA0B,YAAY;AAExF,OAAO,iBAAS,cAAc,cAAc,YAC1C,KAAK,QACJ,cAAc;KAIZ,eACA,0BACD,wBAAwB;KAGvB,aAAa,sBAAsB,WAAW,SAAQ,aAAa,MAAM;KACzE,oBAAoB,YACtB,uBAAuB,GAAG,mCAAmC,SAAS,aACnE;KAID,4BAA4B,cAAc,eAC7C,aAAa,sBAAsB,OAC/B,iBAAiB,WAAW,UACvB,QAAQ,MAAM,eAAc;KAGlC,yBAAyB,WAAW,aAAa,QAAO,KAAK;KAC7D,gBAAgB,cAAc,eAAe,yBAChD,oBAAoB,4BAA4B;AAGlD,OAAO,iBAAS,kBAAkB,cAAc,aAC9C,KAAK,QACJ,gBAAgB",
+  "names": [],
+  "sources": [
+    "src/helpers.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "type ObjectType = Record<PropertyKey, unknown>\n\ntype PickByValue<OBJ_T, VALUE_T> = // From https://stackoverflow.com/a/55153000\n  Pick<OBJ_T, { [K in keyof OBJ_T]: OBJ_T[K] extends VALUE_T ? K : never }[keyof OBJ_T]>\n\ntype ObjectEntries<OBJ_T> = // From https://stackoverflow.com/a/60142095\n  { [K in keyof OBJ_T]: [keyof PickByValue<OBJ_T, OBJ_T[K]>, OBJ_T[K]] }[keyof OBJ_T][]\n\nexport const objectKeys = <O extends object>(obj: O) => Object.keys(obj) as Array<keyof O>\n\nexport function objectEntries<OBJ_T extends ObjectType>(\n  obj: OBJ_T\n): ObjectEntries<OBJ_T> {\n  return Object.entries(obj) as ObjectEntries<OBJ_T>\n}\n\ntype EntriesType =\n  | [PropertyKey, unknown][]\n  | ReadonlyArray<readonly [PropertyKey, unknown]>\n\n// Existing Utils\ntype DeepWritable<OBJ_T> = { -readonly [P in keyof OBJ_T]: DeepWritable<OBJ_T[P]> }\ntype UnionToIntersection<UNION_T> = // From https://stackoverflow.com/a/50375286\n  (UNION_T extends any ? (k: UNION_T) => void : never) extends (k: infer I) => void\n    ? I\n    : never\n\n// New Utils\ntype UnionObjectFromArrayOfPairs<ARR_T extends EntriesType> =\n  DeepWritable<ARR_T> extends (infer R)[]\n    ? R extends [infer key, infer val]\n      ? { [prop in key & PropertyKey]: val }\n      : never\n    : never\ntype MergeIntersectingObjects<ObjT> = { [key in keyof ObjT]: ObjT[key] }\ntype EntriesToObject<ARR_T extends EntriesType> = MergeIntersectingObjects<\n  UnionToIntersection<UnionObjectFromArrayOfPairs<ARR_T>>\n>\n\nexport function objectFromEntries<ARR_T extends EntriesType>(\n  arr: ARR_T\n): EntriesToObject<ARR_T> {\n  return Object.fromEntries(arr) as EntriesToObject<ARR_T>\n}\n"
+  ]
+}

package/types/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./createTheme";
+export * from "./masks";
+export * from "./combineMasks";
+export * from "./applyMask";
+export * from "./createThemeTypes";
+export * from "./helpers";
+
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc",
+  "names": [],
+  "sources": [
+    "src/index.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "export * from './createTheme'\nexport * from './masks'\nexport * from './combineMasks'\nexport * from './applyMask'\nexport * from './createThemeTypes'\nexport * from './helpers'\n"
+  ]
+}

package/types/isMinusZero.d.ts

@@ -0,0 +1,3 @@
+export declare function isMinusZero(value: number): boolean;
+
+//# sourceMappingURL=isMinusZero.d.ts.map

package/types/isMinusZero.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,OAAO,iBAAS,YAAY",
+  "names": [],
+  "sources": [
+    "src/isMinusZero.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "export function isMinusZero(value: number): boolean {\n  return 1 / value === Number.NEGATIVE_INFINITY\n}\n"
+  ]
+}

package/types/masks.d.ts

@@ -0,0 +1,15 @@
+import type { CreateMask, MaskFunction, MaskOptions } from "./createThemeTypes";
+export declare const createMask: <C extends CreateMask | MaskFunction>(createMask: C) => CreateMask;
+export declare const skipMask: CreateMask;
+export declare const createIdentityMask: () => CreateMask;
+export declare const createInverseMask: () => CreateMask;
+type ShiftMaskOptions = {
+	inverse?: boolean;
+};
+export declare const createShiftMask: ({ inverse }?: ShiftMaskOptions, defaultOptions?: MaskOptions) => CreateMask;
+export declare const createWeakenMask: (defaultOptions?: MaskOptions) => CreateMask;
+export declare const createSoftenMask: (defaultOptions?: MaskOptions) => CreateMask;
+export declare const createStrengthenMask: (defaultOptions?: MaskOptions) => CreateMask;
+export {};
+
+//# sourceMappingURL=masks.d.ts.map

package/types/masks.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,cAAc,YAAY,cAAc,mBAAmB;AAI3D,OAAO,cAAM,aAAc,UAAU,aAAa,cAChD,YAAY,MACX;AAKH,OAAO,cAAM,UAAU;AA8CvB,OAAO,cAAM,0BAAyB;AAKtC,OAAO,cAAM,yBAAwB;KAahC,mBAAmB;CAAE;;AAE1B,OAAO,cAAM,kBACX,EAAE,YAAW,kBACb,iBAAiB,gBAChB;AA6CH,OAAO,cAAM,mBAAoB,iBAAiB,gBAAc;AAKhE,OAAO,cAAM,mBAAmB,iBAAiB,gBAAgB;AAGjE,OAAO,cAAM,uBAAwB,iBAAiB,gBAAc",
+  "names": [],
+  "sources": [
+    "src/masks.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "import type { CreateMask, MaskFunction, MaskOptions } from './createThemeTypes'\nimport { objectEntries, objectFromEntries } from './helpers'\nimport { isMinusZero } from './isMinusZero'\n\nexport const createMask = <C extends CreateMask | MaskFunction>(\n  createMask: C\n): CreateMask =>\n  typeof createMask === 'function'\n    ? { name: createMask.name || 'unnamed', mask: createMask }\n    : createMask\n\nexport const skipMask: CreateMask = {\n  name: 'skip-mask',\n  mask: (template, opts) => {\n    const { skip } = opts\n    const result = Object.fromEntries(\n      Object.entries(template)\n        .filter(([k]) => !skip || !(k in skip))\n        .map(([k, v]) => [k, applyOverrides(k, v, opts)])\n    ) as typeof template\n\n    return result\n  },\n}\n\nfunction applyOverrides(key: string, value: number | string, opts: MaskOptions) {\n  let override: string | number | undefined\n  let strategy = opts.overrideStrategy\n\n  const overrideSwap = opts.overrideSwap?.[key]\n  if (typeof overrideSwap !== 'undefined') {\n    override = overrideSwap\n    strategy = 'swap'\n  } else {\n    const overrideShift = opts.overrideShift?.[key]\n    if (typeof overrideShift !== 'undefined') {\n      override = overrideShift\n      strategy = 'shift'\n    } else {\n      const overrideDefault = opts.override?.[key]\n      if (typeof overrideDefault !== 'undefined') {\n        override = overrideDefault\n        strategy = opts.overrideStrategy\n      }\n    }\n  }\n\n  if (typeof override === 'undefined') return value\n  if (typeof override === 'string') return value\n\n  if (strategy === 'swap') {\n    return override\n  }\n\n  return value\n}\n\nexport const createIdentityMask = (): CreateMask => ({\n  name: 'identity-mask',\n  mask: (template, opts) => skipMask.mask(template, opts),\n})\n\nexport const createInverseMask = (): CreateMask => {\n  const mask: CreateMask = {\n    name: 'inverse-mask',\n    mask: (template, opts) => {\n      const inversed = objectFromEntries(\n        objectEntries(template).map(([k, v]) => [k, -v])\n      ) as any\n      return skipMask.mask(inversed, opts)\n    },\n  }\n  return mask\n}\n\ntype ShiftMaskOptions = { inverse?: boolean }\n\nexport const createShiftMask = (\n  { inverse }: ShiftMaskOptions = {},\n  defaultOptions?: MaskOptions\n): CreateMask => {\n  const mask: CreateMask = {\n    name: 'shift-mask',\n    mask: (template, opts) => {\n      const {\n        override,\n        overrideStrategy = 'shift',\n        max: maxIn,\n        palette,\n        min = 0,\n        strength = 1,\n      } = { ...defaultOptions, ...opts }\n      const values = Object.entries(template)\n      const max =\n        maxIn ?? (palette ? Object.values(palette).length - 1 : Number.POSITIVE_INFINITY)\n      const out = {}\n      for (const [key, value] of values) {\n        if (typeof value === 'string') continue\n        if (typeof override?.[key] === 'number') {\n          const overrideVal = override[key] as number\n          out[key] = overrideStrategy === 'shift' ? value + overrideVal : overrideVal\n          continue\n        }\n        if (typeof override?.[key] === 'string') {\n          out[key] = override[key]\n          continue\n        }\n        const isPositive = value === 0 ? !isMinusZero(value) : value >= 0\n        const direction = isPositive ? 1 : -1\n        const invert = inverse ? -1 : 1\n        const next = value + strength * direction * invert\n        const clamped = isPositive\n          ? Math.max(min, Math.min(max, next))\n          : Math.min(-min, Math.max(-max, next))\n\n        out[key] = clamped\n      }\n\n      const skipped = skipMask.mask(out, opts) as typeof template\n      return skipped\n    },\n  }\n  return mask\n}\n\nexport const createWeakenMask = (defaultOptions?: MaskOptions): CreateMask => ({\n  name: 'soften-mask',\n  mask: createShiftMask({}, defaultOptions).mask,\n})\n\nexport const createSoftenMask: (defaultOptions?: MaskOptions) => CreateMask =\n  createWeakenMask\n\nexport const createStrengthenMask = (defaultOptions?: MaskOptions): CreateMask => ({\n  name: 'strengthen-mask',\n  mask: createShiftMask({ inverse: true }, defaultOptions).mask,\n})\n"
+  ]
+}

package/types/tests.d.ts

@@ -0,0 +1,3 @@
+export {};
+
+//# sourceMappingURL=tests.d.ts.map

package/types/tests.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "",
+  "names": [],
+  "sources": [
+    "src/tests.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "import { applyMask } from './applyMask'\nimport { createTheme } from './createTheme'\nimport { createStrengthenMask, createWeakenMask } from './masks'\n\n// --- tests ---\nif (process.env.NODE_ENV === 'development') {\n  const palette = ['0', '1', '2', '3', '-3', '-2', '-1', '-0']\n  const template = { bg: 1, fg: -1 }\n\n  const stongerMask = createStrengthenMask()\n  const weakerMask = createWeakenMask()\n\n  const theme = createTheme(palette, template)\n  if (theme.bg !== '1') throw `❌`\n  if (theme.fg !== '-1') throw `❌`\n\n  const str = applyMask(theme, stongerMask)\n  if (str.bg !== '0') throw `❌`\n  if (str.fg !== '-0') throw `❌`\n\n  const weak = applyMask(theme, weakerMask)\n  if (weak.bg !== '2') throw `❌`\n  if (weak.fg !== '-2') throw `❌`\n\n  const weak2 = applyMask(theme, weakerMask, { strength: 2 })\n  if (weak2.bg !== '3') throw `❌`\n  if (weak2.fg !== '-3') throw `❌`\n}\n"
+  ]
+}

package/types/themeInfo.d.ts

@@ -0,0 +1,13 @@
+import type { CreateThemeOptions, CreateThemePalette, GenericTheme, ThemeMask } from "./createThemeTypes";
+export type ThemeInfo = {
+	palette: CreateThemePalette;
+	definition: ThemeMask;
+	options?: CreateThemeOptions;
+	cache: Map<any, any>;
+};
+export declare const getThemeInfo: (theme: GenericTheme | ThemeMask, name?: string) => ThemeInfo | undefined;
+export declare const setThemeInfo: (theme: GenericTheme | ThemeMask, info: Pick<ThemeInfo, "palette" | "definition" | "options"> & {
+	name?: string;
+}) => void;
+
+//# sourceMappingURL=themeInfo.d.ts.map

package/types/themeInfo.d.ts.map

@@ -0,0 +1,11 @@
+{
+  "mappings": "AAAA,cACE,oBACA,oBACA,cACA,iBACK;AAEP,YAAY,YAAY;CACtB,SAAS;CACT,YAAY;CACZ,UAAU;CACV,OAAO;;AAKT,OAAO,cAAM,eACX,OAAO,eAAe,WACtB,kBACC;AAIH,OAAO,cAAM,eACX,OAAO,eAAe,WACtB,MAAM,KAAK,WAAW,YAAY,eAAe,aAAa;CAC5D",
+  "names": [],
+  "sources": [
+    "src/themeInfo.tsx"
+  ],
+  "version": 3,
+  "sourcesContent": [
+    "import type {\n  CreateThemeOptions,\n  CreateThemePalette,\n  GenericTheme,\n  ThemeMask,\n} from './createThemeTypes'\n\nexport type ThemeInfo = {\n  palette: CreateThemePalette\n  definition: ThemeMask\n  options?: CreateThemeOptions\n  cache: Map<any, any>\n}\n\nconst THEME_INFO = new Map<string, ThemeInfo>()\n\nexport const getThemeInfo = (\n  theme: GenericTheme | ThemeMask,\n  name?: string\n): ThemeInfo | undefined => {\n  return THEME_INFO.get(name || JSON.stringify(theme))\n}\n\nexport const setThemeInfo = (\n  theme: GenericTheme | ThemeMask,\n  info: Pick<ThemeInfo, 'palette' | 'definition' | 'options'> & {\n    name?: string\n  }\n): void => {\n  const next = {\n    ...info,\n    cache: new Map(),\n  }\n  THEME_INFO.set(info.name || JSON.stringify(theme), next)\n  THEME_INFO.set(JSON.stringify(info.definition), next)\n}\n"
+  ]
+}