@womp/kookie-ui 0.17.0 → 0.19.0

package/dist/cjs/helpers/theme-size.d.ts

@@ -0,0 +1,41 @@
+import * as React from 'react';
+type ThemeSize = '1' | '2' | '3' | '4';
+/** The rest of the 1-4 index when no Theme states a size. */
+declare const THEME_SIZE_DEFAULT: ThemeSize;
+/**
+ * The app-wide size index, provided by `Theme` beside `ThemeContext`.
+ *
+ * It is its own context, holding one string, so a component that only needs
+ * the size does not re-render when the accent colour or appearance changes.
+ */
+declare const ThemeSizeContext: React.Context<ThemeSize>;
+interface SizePropDef {
+    values: readonly string[];
+    default?: string;
+}
+/**
+ * Maps the theme size onto a component's own range: the value itself when the
+ * component has it, otherwise the nearest end of the range (`4` on a 1-3 scale
+ * is `3`, on a 1-2 scale it is `2`).
+ */
+declare function clampSize(size: ThemeSize, values: readonly string[]): string;
+/**
+ * The size a component on the 1-4 index takes: what the caller said, else the
+ * nearest Theme's size, mapped into the component's range.
+ */
+declare function useThemeSize<V>(explicit: V | undefined, propDef: SizePropDef): V;
+/**
+ * Fills `size` from the nearest Theme when the caller left it unset, so the
+ * result can go straight into `extractProps`. An explicit size, responsive
+ * object included, wins.
+ *
+ * Returns the same props object when there is nothing to fill: when a size is
+ * set, or when the theme size resolves to the prop def's own default (the
+ * common case, a Theme with no size), so `extractProps` applies it as before.
+ */
+declare function useThemeSizeProps<P extends {
+    size?: unknown;
+}>(props: P, propDef: SizePropDef): P;
+export { ThemeSizeContext, THEME_SIZE_DEFAULT, clampSize, useThemeSize, useThemeSizeProps };
+export type { ThemeSize };
+//# sourceMappingURL=theme-size.d.ts.map

package/dist/cjs/helpers/theme-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-size.d.ts","sourceRoot":"","sources":["../../../src/helpers/theme-size.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEvC,6DAA6D;AAC7D,QAAA,MAAM,kBAAkB,EAAE,SAAe,CAAC;AAE1C;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,0BAAqD,CAAC;AAG5E,UAAU,WAAW;IACnB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,iBAAS,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAarE;AAED;;;GAGG;AACH,iBAAS,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,CAKzE;AAED;;;;;;;;GAQG;AACH,iBAAS,iBAAiB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,CAM1F;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAC5F,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/cjs/helpers/theme-size.js

@@ -0,0 +1,2 @@
+"use strict";"use client";var S=Object.create;var s=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty;var x=(e,t)=>{for(var n in t)s(e,n,{get:t[n],enumerable:!0})},m=(e,t,n,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of h(t))!l.call(e,r)&&r!==n&&s(e,r,{get:()=>t[r],enumerable:!(i=d(t,r))||i.enumerable});return e};var P=(e,t,n)=>(n=e!=null?S(T(e)):{},m(t||!e||!e.__esModule?s(n,"default",{value:e,enumerable:!0}):n,e)),y=e=>m(s({},"__esModule",{value:!0}),e);var E={};x(E,{THEME_SIZE_DEFAULT:()=>z,ThemeSizeContext:()=>c,clampSize:()=>f,useThemeSize:()=>g,useThemeSizeProps:()=>C});module.exports=y(E);var o=P(require("react")),z="2",c=o.createContext(z);c.displayName="ThemeSizeContext";function f(e,t){if(t.includes(e))return e;let n=Number(e),i=t[0],r=1/0;for(let u=0;u<t.length;u++){let a=Math.abs(Number(t[u])-n);a<r&&(r=a,i=t[u])}return i}function g(e,t){let n=o.useContext(c);return e!==void 0?e:f(n,t.values)}function C(e,t){let n=o.useContext(c);if(e.size!==void 0)return e;let i=f(n,t.values);return i===t.default?e:{...e,size:i}}
+//# sourceMappingURL=theme-size.js.map

package/dist/cjs/helpers/theme-size.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/helpers/theme-size.ts"],
+  "sourcesContent": ["'use client';\n\nimport * as React from 'react';\n\ntype ThemeSize = '1' | '2' | '3' | '4';\n\n/** The rest of the 1-4 index when no Theme states a size. */\nconst THEME_SIZE_DEFAULT: ThemeSize = '2';\n\n/**\n * The app-wide size index, provided by `Theme` beside `ThemeContext`.\n *\n * It is its own context, holding one string, so a component that only needs\n * the size does not re-render when the accent colour or appearance changes.\n */\nconst ThemeSizeContext = React.createContext<ThemeSize>(THEME_SIZE_DEFAULT);\nThemeSizeContext.displayName = 'ThemeSizeContext';\n\ninterface SizePropDef {\n  values: readonly string[];\n  default?: string;\n}\n\n/**\n * Maps the theme size onto a component's own range: the value itself when the\n * component has it, otherwise the nearest end of the range (`4` on a 1-3 scale\n * is `3`, on a 1-2 scale it is `2`).\n */\nfunction clampSize(size: ThemeSize, values: readonly string[]): string {\n  if (values.includes(size)) return size;\n  const n = Number(size);\n  let nearest = values[0];\n  let distance = Infinity;\n  for (let i = 0; i < values.length; i++) {\n    const d = Math.abs(Number(values[i]) - n);\n    if (d < distance) {\n      distance = d;\n      nearest = values[i];\n    }\n  }\n  return nearest;\n}\n\n/**\n * The size a component on the 1-4 index takes: what the caller said, else the\n * nearest Theme's size, mapped into the component's range.\n */\nfunction useThemeSize<V>(explicit: V | undefined, propDef: SizePropDef): V {\n  const themeSize = React.useContext(ThemeSizeContext);\n  if (explicit !== undefined) return explicit;\n  // The clamped value is one of `propDef.values`, which is what `V` ranges over.\n  return clampSize(themeSize, propDef.values) as V;\n}\n\n/**\n * Fills `size` from the nearest Theme when the caller left it unset, so the\n * result can go straight into `extractProps`. An explicit size, responsive\n * object included, wins.\n *\n * Returns the same props object when there is nothing to fill: when a size is\n * set, or when the theme size resolves to the prop def's own default (the\n * common case, a Theme with no size), so `extractProps` applies it as before.\n */\nfunction useThemeSizeProps<P extends { size?: unknown }>(props: P, propDef: SizePropDef): P {\n  const themeSize = React.useContext(ThemeSizeContext);\n  if (props.size !== undefined) return props;\n  const size = clampSize(themeSize, propDef.values);\n  if (size === propDef.default) return props;\n  return { ...props, size };\n}\n\nexport { ThemeSizeContext, THEME_SIZE_DEFAULT, clampSize, useThemeSize, useThemeSizeProps };\nexport type { ThemeSize };\n"],
+  "mappings": "ukBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,wBAAAE,EAAA,qBAAAC,EAAA,cAAAC,EAAA,iBAAAC,EAAA,sBAAAC,IAAA,eAAAC,EAAAP,GAEA,IAAAQ,EAAuB,oBAKjBN,EAAgC,IAQhCC,EAAyB,gBAAyBD,CAAkB,EAC1EC,EAAiB,YAAc,mBAY/B,SAASC,EAAUK,EAAiBC,EAAmC,CACrE,GAAIA,EAAO,SAASD,CAAI,EAAG,OAAOA,EAClC,IAAM,EAAI,OAAOA,CAAI,EACjBE,EAAUD,EAAO,CAAC,EAClBE,EAAW,IACf,QAASC,EAAI,EAAGA,EAAIH,EAAO,OAAQG,IAAK,CACtC,IAAMC,EAAI,KAAK,IAAI,OAAOJ,EAAOG,CAAC,CAAC,EAAI,CAAC,EACpCC,EAAIF,IACNA,EAAWE,EACXH,EAAUD,EAAOG,CAAC,EAEtB,CACA,OAAOF,CACT,CAMA,SAASN,EAAgBU,EAAyBC,EAAyB,CACzE,IAAMC,EAAkB,aAAWd,CAAgB,EACnD,OAAIY,IAAa,OAAkBA,EAE5BX,EAAUa,EAAWD,EAAQ,MAAM,CAC5C,CAWA,SAASV,EAAgDY,EAAUF,EAAyB,CAC1F,IAAMC,EAAkB,aAAWd,CAAgB,EACnD,GAAIe,EAAM,OAAS,OAAW,OAAOA,EACrC,IAAMT,EAAOL,EAAUa,EAAWD,EAAQ,MAAM,EAChD,OAAIP,IAASO,EAAQ,QAAgBE,EAC9B,CAAE,GAAGA,EAAO,KAAAT,CAAK,CAC1B",
+  "names": ["theme_size_exports", "__export", "THEME_SIZE_DEFAULT", "ThemeSizeContext", "clampSize", "useThemeSize", "useThemeSizeProps", "__toCommonJS", "React", "size", "values", "nearest", "distance", "i", "d", "explicit", "propDef", "themeSize", "props"]
+}