igniteui-webcomponents 7.3.2 → 7.4.1

package/internals/utils/strings.d.ts

@@ -1,6 +1,5 @@
 /**
  * Builds a string from format specifiers and replacement parameters.
- * Will coerce non-string parameters to their string representations.
  *
  * @example
  * ```typescript
@@ -10,24 +9,23 @@
  */
 export declare function formatString(template: string, ...params: unknown[]): string;
 /**
- * Splits a string into its words, treating whitespace, `-`, `_` and
- * camelCase boundaries as separators.
+ * Splits a string into words at whitespace, `-`, `_` and camelCase
+ * boundaries.
  */
 export declare function splitToWords(text: string): string[];
 /** Converts a string to kebab-case. */
 export declare function toKebabCase(text: string): string;
 /**
- *  Escapes any potential regex syntax characters in a string, and returns a new string
- *  that can be safely used as a literal pattern for the `RegExp()` constructor.
- *
- *  @remarks
- *  Substitute with `RegExp.escape` once it has enough support:
+ * Escapes each regular expression character in a string, so that `RegExp()`
+ * reads it as a literal pattern.
  *
+ * @remarks
+ * Replace with `RegExp.escape` once browser support is sufficient:
  * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape#browser_compatibility
  */
 export declare function escapeRegex(value: string): string;
 /**
- * Creates a generator of monotonically increasing DOM ids based on the given prefix.
+ * Creates a function that returns DOM ids with the given prefix.
  *
  * @example
  * ```typescript
@@ -38,7 +36,7 @@ export declare function escapeRegex(value: string): string;
  */
 export declare function createIdGenerator(prefix: string): () => string;
 /**
- * Generates a unique string ID of the specified size using a URL-friendly alphabet.
- * The default size is 21 characters, which provides a very low probability of collisions.
+ * Generates a unique string id of the given size, from a URL-safe alphabet.
+ * The default of 21 characters makes a collision very unlikely.
  */
 export declare function nanoid(size?: number): string;

package/internals/utils/strings.js.map

@@ -1 +1 @@
-{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/internals/utils/strings.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAG,MAAiB;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CACnE,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC;AAGD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAWD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,IAAI,IAA6B,CAAC;AAClC,IAAI,UAAkB,CAAC;AACvB,MAAM,WAAW,GACf,kEAAkE,CAAC;AAErE,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;SAAM,IAAI,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,UAAU,IAAI,KAAK,CAAC;AACtB,CAAC;AAMD,MAAM,UAAU,MAAM,CAAC,IAAI,GAAG,EAAE;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,KAAK,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Builds a string from format specifiers and replacement parameters.\n * Will coerce non-string parameters to their string representations.\n *\n * @example\n * ```typescript\n * formatString('{0} says \"{1}\".', 'John', 'Hello'); // 'John says \"Hello\".'\n * formatString('{1} is greater than {0}', 0, 1); // '1 is greater than 0'\n * ```\n */\nexport function formatString(template: string, ...params: unknown[]): string {\n  const length = params.length;\n\n  return template.replace(/{(\\d+)}/g, (match: string, index: number) =>\n    index >= length ? match : `${params[index]}`\n  );\n}\n\n/**\n * Splits a string into its words, treating whitespace, `-`, `_` and\n * camelCase boundaries as separators.\n */\nexport function splitToWords(text: string) {\n  const input = text.replaceAll(/[^a-zA-Z0-9\\s-_]/g, '');\n  if (/[\\s-_]+/.test(input)) return input.split(/[\\s-_]+/);\n  return input.split(/(?=[A-Z])+/);\n}\n\n/** Converts a string to kebab-case. */\nexport function toKebabCase(text: string): string {\n  const input = text.trim();\n  return splitToWords(input).join('-').toLowerCase();\n}\n\n/**\n *  Escapes any potential regex syntax characters in a string, and returns a new string\n *  that can be safely used as a literal pattern for the `RegExp()` constructor.\n *\n *  @remarks\n *  Substitute with `RegExp.escape` once it has enough support:\n *\n * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape#browser_compatibility\n */\nexport function escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Creates a generator of monotonically increasing DOM ids based on the given prefix.\n *\n * @example\n * ```typescript\n * const nextId = createIdGenerator('radio');\n * nextId(); // 'radio-1'\n * nextId(); // 'radio-2'\n * ```\n */\nexport function createIdGenerator(prefix: string): () => string {\n  let id = 0;\n  return () => `${prefix}-${++id}`;\n}\n\nlet pool: Uint8Array<ArrayBuffer>;\nlet poolOffset: number;\nconst urlAlphabet =\n  'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';\n\nfunction fillPool(bytes: number): void {\n  if (!pool || pool.length < bytes) {\n    pool = new Uint8Array(new ArrayBuffer(bytes * 128));\n    crypto.getRandomValues(pool);\n    poolOffset = 0;\n  } else if (poolOffset + bytes > pool.length) {\n    crypto.getRandomValues(pool);\n    poolOffset = 0;\n  }\n  poolOffset += bytes;\n}\n\n/**\n * Generates a unique string ID of the specified size using a URL-friendly alphabet.\n * The default size is 21 characters, which provides a very low probability of collisions.\n */\nexport function nanoid(size = 21): string {\n  const bytes = size | 0;\n  fillPool(bytes);\n\n  let id = '';\n  for (let i = poolOffset - bytes; i < poolOffset; i++) {\n    id += urlAlphabet[pool[i] & 63];\n  }\n\n  return id;\n}\n"]}
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/internals/utils/strings.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,GAAG,MAAiB;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CACnE,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAC7C,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC;AAGD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AACrD,CAAC;AAUD,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,EAAE,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,IAAI,IAA6B,CAAC;AAClC,IAAI,UAAkB,CAAC;AACvB,MAAM,WAAW,GACf,kEAAkE,CAAC;AAErE,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,WAAW,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;SAAM,IAAI,UAAU,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC7B,UAAU,GAAG,CAAC,CAAC;IACjB,CAAC;IACD,UAAU,IAAI,KAAK,CAAC;AACtB,CAAC;AAMD,MAAM,UAAU,MAAM,CAAC,IAAI,GAAG,EAAE;IAC9B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,UAAU,GAAG,KAAK,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACrD,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["/**\n * Builds a string from format specifiers and replacement parameters.\n *\n * @example\n * ```typescript\n * formatString('{0} says \"{1}\".', 'John', 'Hello'); // 'John says \"Hello\".'\n * formatString('{1} is greater than {0}', 0, 1); // '1 is greater than 0'\n * ```\n */\nexport function formatString(template: string, ...params: unknown[]): string {\n  const length = params.length;\n\n  return template.replace(/{(\\d+)}/g, (match: string, index: number) =>\n    index >= length ? match : `${params[index]}`\n  );\n}\n\n/**\n * Splits a string into words at whitespace, `-`, `_` and camelCase\n * boundaries.\n */\nexport function splitToWords(text: string) {\n  const input = text.replaceAll(/[^a-zA-Z0-9\\s-_]/g, '');\n  if (/[\\s-_]+/.test(input)) return input.split(/[\\s-_]+/);\n  return input.split(/(?=[A-Z])+/);\n}\n\n/** Converts a string to kebab-case. */\nexport function toKebabCase(text: string): string {\n  const input = text.trim();\n  return splitToWords(input).join('-').toLowerCase();\n}\n\n/**\n * Escapes each regular expression character in a string, so that `RegExp()`\n * reads it as a literal pattern.\n *\n * @remarks\n * Replace with `RegExp.escape` once browser support is sufficient:\n * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape#browser_compatibility\n */\nexport function escapeRegex(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Creates a function that returns DOM ids with the given prefix.\n *\n * @example\n * ```typescript\n * const nextId = createIdGenerator('radio');\n * nextId(); // 'radio-1'\n * nextId(); // 'radio-2'\n * ```\n */\nexport function createIdGenerator(prefix: string): () => string {\n  let id = 0;\n  return () => `${prefix}-${++id}`;\n}\n\nlet pool: Uint8Array<ArrayBuffer>;\nlet poolOffset: number;\nconst urlAlphabet =\n  'useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict';\n\nfunction fillPool(bytes: number): void {\n  if (!pool || pool.length < bytes) {\n    pool = new Uint8Array(new ArrayBuffer(bytes * 128));\n    crypto.getRandomValues(pool);\n    poolOffset = 0;\n  } else if (poolOffset + bytes > pool.length) {\n    crypto.getRandomValues(pool);\n    poolOffset = 0;\n  }\n  poolOffset += bytes;\n}\n\n/**\n * Generates a unique string id of the given size, from a URL-safe alphabet.\n * The default of 21 characters makes a collision very unlikely.\n */\nexport function nanoid(size = 21): string {\n  const bytes = size | 0;\n  fillPool(bytes);\n\n  let id = '';\n  for (let i = poolOffset - bytes; i < poolOffset; i++) {\n    id += urlAlphabet[pool[i] & 63];\n  }\n\n  return id;\n}\n"]}

package/internals/utils/types.d.ts

@@ -1,13 +1,26 @@
-/** Returns whether the value is not `undefined`. Note that `null` is considered defined. */
+/** Returns whether the value is not `undefined`. `null` counts as defined. */
 export declare function isDefined<T = unknown>(value: T): value is T & ({} | null);
 export declare function isFunction(value: unknown): value is CallableFunction;
 export declare function isString(value: unknown): value is string;
 export declare function isObject(value: unknown): value is object;
-/** Returns whether the value is a plain object (POJO) - created via `{}`, `new Object()` or `Object.create(null)`. */
+/**
+ * Returns whether the value is a plain object from `{}`, `new Object()` or
+ * `Object.create(null)`.
+ */
 export declare function isPlainObject(value: unknown): value is Record<PropertyKey, unknown>;
+/**
+ * Resolves a value that the caller gives either directly or as a factory.
+ *
+ * @example
+ * ```typescript
+ * resolveValue(element); // element
+ * resolveValue(() => element); // element
+ * ```
+ */
+export declare function resolveValue<T>(source: T | (() => T)): T;
 export declare function isRegExp(value: unknown): value is RegExp;
 export declare function isEventListenerObject(x: unknown): x is EventListenerObject;
-/** Required utility type for specific props */
+/** Makes the given keys `K` of the type `T` required. */
 export type RequiredProps<T, K extends keyof T> = T & {
     [P in K]-?: T[P];
 };

package/internals/utils/types.js

@@ -22,6 +22,9 @@ export function isPlainObject(value) {
         ? Object.prototype.toString.call(value) === '[object Object]'
         : false;
 }
+export function resolveValue(source) {
+    return isFunction(source) ? source() : source;
+}
 export function isRegExp(value) {
     return value instanceof RegExp;
 }

package/internals/utils/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internals/utils/types.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,SAAS,CAAc,KAAQ;IAC7C,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC;AAGD,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAmC,CAAC;IAE7E,MAAM,kBAAkB,GACtB,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,MAAM,CAAC,SAAS;QAC1B,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,kBAAkB;QACvB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB;QAC7D,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAU;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/** Returns whether the value is not `undefined`. Note that `null` is considered defined. */\nexport function isDefined<T = unknown>(value: T) {\n  return value !== undefined;\n}\n\nexport function isFunction(value: unknown): value is CallableFunction {\n  return typeof value === 'function';\n}\n\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\nexport function isObject(value: unknown): value is object {\n  return value != null && typeof value === 'object';\n}\n\n/** Returns whether the value is a plain object (POJO) - created via `{}`, `new Object()` or `Object.create(null)`. */\nexport function isPlainObject(\n  value: unknown\n): value is Record<PropertyKey, unknown> {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  const proto = Object.getPrototypeOf(value) as typeof Object.prototype | null;\n\n  const hasObjectPrototype =\n    proto === null ||\n    proto === Object.prototype ||\n    Object.getPrototypeOf(proto) === null;\n\n  return hasObjectPrototype\n    ? Object.prototype.toString.call(value) === '[object Object]'\n    : false;\n}\n\nexport function isRegExp(value: unknown): value is RegExp {\n  return value instanceof RegExp;\n}\n\nexport function isEventListenerObject(x: unknown): x is EventListenerObject {\n  return isObject(x) && 'handleEvent' in x;\n}\n\n/** Required utility type for specific props */\nexport type RequiredProps<T, K extends keyof T> = T & {\n  [P in K]-?: T[P];\n};\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internals/utils/types.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,SAAS,CAAc,KAAQ;IAC7C,OAAO,KAAK,KAAK,SAAS,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC;AAMD,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAmC,CAAC;IAE7E,MAAM,kBAAkB,GACtB,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,MAAM,CAAC,SAAS;QAC1B,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAExC,OAAO,kBAAkB;QACvB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB;QAC7D,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAWD,MAAM,UAAU,YAAY,CAAI,MAAqB;IACnD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAkB,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,YAAY,MAAM,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,CAAU;IAC9C,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,aAAa,IAAI,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/** Returns whether the value is not `undefined`. `null` counts as defined. */\nexport function isDefined<T = unknown>(value: T) {\n  return value !== undefined;\n}\n\nexport function isFunction(value: unknown): value is CallableFunction {\n  return typeof value === 'function';\n}\n\nexport function isString(value: unknown): value is string {\n  return typeof value === 'string';\n}\n\nexport function isObject(value: unknown): value is object {\n  return value != null && typeof value === 'object';\n}\n\n/**\n * Returns whether the value is a plain object from `{}`, `new Object()` or\n * `Object.create(null)`.\n */\nexport function isPlainObject(\n  value: unknown\n): value is Record<PropertyKey, unknown> {\n  if (!isObject(value)) {\n    return false;\n  }\n\n  const proto = Object.getPrototypeOf(value) as typeof Object.prototype | null;\n\n  const hasObjectPrototype =\n    proto === null ||\n    proto === Object.prototype ||\n    Object.getPrototypeOf(proto) === null;\n\n  return hasObjectPrototype\n    ? Object.prototype.toString.call(value) === '[object Object]'\n    : false;\n}\n\n/**\n * Resolves a value that the caller gives either directly or as a factory.\n *\n * @example\n * ```typescript\n * resolveValue(element); // element\n * resolveValue(() => element); // element\n * ```\n */\nexport function resolveValue<T>(source: T | (() => T)): T {\n  return isFunction(source) ? (source as () => T)() : source;\n}\n\nexport function isRegExp(value: unknown): value is RegExp {\n  return value instanceof RegExp;\n}\n\nexport function isEventListenerObject(x: unknown): x is EventListenerObject {\n  return isObject(x) && 'handleEvent' in x;\n}\n\n/** Makes the given keys `K` of the type `T` required. */\nexport type RequiredProps<T, K extends keyof T> = T & {\n  [P in K]-?: T[P];\n};\n"]}

package/internals/validators.d.ts

@@ -53,25 +53,26 @@ export declare const maxDateValidator: Validator<{
     value?: Date | null;
     max?: Date | null;
 }>;
-/** A host whose bound comparisons follow the parts present in its format. */
+/** A host that compares bounds at the granularity of its own format. */
 interface DatePartsHost {
     hasDateParts(): boolean;
     hasTimeParts(): boolean;
 }
 /**
- * Creates a `rangeUnderflow` validator for hosts whose `min` comparison must
- * respect the parts of the host's format - day granularity when the format has
- * no time parts, time-of-day granularity when it has no date parts.
+ * Creates a `rangeUnderflow` validator for the `min` bound of a host.
  *
- * `resolveValues` returns the dates checked against the bound; empty slots
- * are skipped, so a partial range validates only its present ends.
+ * @remarks
+ * The comparison follows the host format: day granularity without time
+ * parts, time-of-day granularity without date parts. `resolveValues` gives
+ * the dates to compare, and empty slots are skipped, so a partial range
+ * validates only the ends it has.
  */
 export declare function createMinDateTimeValidator<T extends DatePartsHost & {
     min?: Date | null;
 }>(resolveValues: (host: T) => (Date | null | undefined)[]): Validator<T>;
 /**
- * Creates a `rangeOverflow` validator for hosts whose `max` comparison must
- * respect the parts of the host's format. See {@link createMinDateTimeValidator}.
+ * Creates a `rangeOverflow` validator for the `max` bound of a host.
+ * See {@link createMinDateTimeValidator}.
  */
 export declare function createMaxDateTimeValidator<T extends DatePartsHost & {
     max?: Date | null;

package/internals/validators.js

@@ -4,6 +4,12 @@ import { CalendarDay } from './date/model.js';
 import { asNumber, numberOfDecimals, roundPrecise } from './utils/math.js';
 import { formatString } from './utils/strings.js';
 import { isDefined } from './utils/types.js';
+function minBoundMessage(min) {
+    return formatString(ValidationResourceStringsEN.min_validation_error, min);
+}
+function maxBoundMessage(max) {
+    return formatString(ValidationResourceStringsEN.max_validation_error, max);
+}
 const emailRegex = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;
 export const requiredValidator = {
     key: 'valueMissing',
@@ -32,14 +38,14 @@ export const patternValidator = {
 };
 export const minValidator = {
     key: 'rangeUnderflow',
-    message: ({ min }) => formatString(ValidationResourceStringsEN.min_validation_error, min),
+    message: ({ min }) => minBoundMessage(min),
     isValid: ({ min, value }) => isDefined(value) && value !== '' && isDefined(min)
         ? asNumber(value) >= asNumber(min)
         : true,
 };
 export const maxValidator = {
     key: 'rangeOverflow',
-    message: ({ max }) => formatString(ValidationResourceStringsEN.max_validation_error, max),
+    message: ({ max }) => maxBoundMessage(max),
     isValid: ({ max, value }) => isDefined(value) && value !== '' && isDefined(max)
         ? asNumber(value) <= asNumber(max)
         : true,
@@ -70,12 +76,12 @@ export const urlValidator = {
 };
 export const minDateValidator = {
     key: 'rangeUnderflow',
-    message: ({ min }) => formatString(ValidationResourceStringsEN.min_validation_error, min),
+    message: ({ min }) => minBoundMessage(min),
     isValid: ({ value, min }) => value && min ? CalendarDay.compare(value, min) >= 0 : true,
 };
 export const maxDateValidator = {
     key: 'rangeOverflow',
-    message: ({ max }) => formatString(ValidationResourceStringsEN.max_validation_error, max),
+    message: ({ max }) => maxBoundMessage(max),
     isValid: ({ value, max }) => value && max ? CalendarDay.compare(value, max) <= 0 : true,
 };
 function isWithinBound(host, bound, values, exceeds) {
@@ -87,14 +93,14 @@ function isWithinBound(host, bound, values, exceeds) {
 export function createMinDateTimeValidator(resolveValues) {
     return {
         key: 'rangeUnderflow',
-        message: ({ min }) => formatString(ValidationResourceStringsEN.min_validation_error, min),
+        message: (host) => minBoundMessage(host.min),
         isValid: (host) => isWithinBound(host, host.min, resolveValues(host), isDateLessThanMin),
     };
 }
 export function createMaxDateTimeValidator(resolveValues) {
     return {
         key: 'rangeOverflow',
-        message: ({ max }) => formatString(ValidationResourceStringsEN.max_validation_error, max),
+        message: (host) => maxBoundMessage(host.max),
         isValid: (host) => isWithinBound(host, host.max, resolveValues(host), isDateExceedingMax),
     };
 }

package/internals/validators.js.map

@@ -1 +1 @@
-{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/internals/validators.ts"],"names":[],"mappings":"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","sourcesContent":["import { ValidationResourceStringsEN } from 'igniteui-i18n-core';\nimport { isDateExceedingMax, isDateLessThanMin } from './date/compare.js';\nimport { CalendarDay } from './date/model.js';\nimport { asNumber, numberOfDecimals, roundPrecise } from './utils/math.js';\nimport { formatString } from './utils/strings.js';\nimport { isDefined } from './utils/types.js';\n\ntype ValidatorHandler<T> = (host: T) => boolean;\ntype ValidatorMessageFormat<T> = (host: T) => string;\n\n/** @hidden */\nexport interface Validator<T = any> {\n  key: keyof ValidityStateFlags;\n  message: string | ValidatorMessageFormat<T>;\n  isValid: ValidatorHandler<T>;\n}\n\nconst emailRegex =\n  /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;\n\nexport const requiredValidator: Validator<{\n  required: boolean;\n  value?: unknown;\n}> = {\n  key: 'valueMissing',\n  message: ValidationResourceStringsEN.required_validation_error!,\n  isValid: ({ required, value }) => (required ? !!value : true),\n};\n\nexport const requiredBooleanValidator: Validator<{\n  required: boolean;\n  checked: boolean;\n}> = {\n  key: 'valueMissing',\n  message: ValidationResourceStringsEN.required_validation_error!,\n  isValid: ({ required, checked }) => (required ? checked : true),\n};\n\nexport const minLengthValidator: Validator<{\n  minLength?: number;\n  value: string;\n}> = {\n  key: 'tooShort',\n  message: ({ minLength }) =>\n    formatString(\n      ValidationResourceStringsEN.min_length_validation_error!,\n      minLength\n    ),\n  isValid: ({ minLength, value }) =>\n    minLength && value ? value.length >= asNumber(minLength) : true,\n};\n\nexport const maxLengthValidator: Validator<{\n  maxLength?: number;\n  value: string;\n}> = {\n  key: 'tooLong',\n  message: ({ maxLength }) =>\n    formatString(\n      ValidationResourceStringsEN.max_length_validation_error!,\n      maxLength\n    ),\n  isValid: ({ maxLength, value }) =>\n    maxLength && value ? value.length <= asNumber(maxLength) : true,\n};\n\nexport const patternValidator: Validator<{ pattern?: string; value: string }> =\n  {\n    key: 'patternMismatch',\n    message: ValidationResourceStringsEN.pattern_validation_error!,\n    isValid: ({ pattern, value }) =>\n      pattern && value ? new RegExp(pattern, 'u').test(value) : true,\n  };\n\nexport const minValidator: Validator<{\n  min?: number;\n  value: number | string;\n}> = {\n  key: 'rangeUnderflow',\n  message: ({ min }) =>\n    formatString(ValidationResourceStringsEN.min_validation_error!, min),\n  isValid: ({ min, value }) =>\n    isDefined(value) && value !== '' && isDefined(min)\n      ? asNumber(value) >= asNumber(min)\n      : true,\n};\n\nexport const maxValidator: Validator<{\n  max?: number;\n  value: number | string;\n}> = {\n  key: 'rangeOverflow',\n  message: ({ max }) =>\n    formatString(ValidationResourceStringsEN.max_validation_error!, max),\n  isValid: ({ max, value }) =>\n    isDefined(value) && value !== '' && isDefined(max)\n      ? asNumber(value) <= asNumber(max)\n      : true,\n};\n\nexport const stepValidator: Validator<{\n  min?: number;\n  step?: number;\n  value: number | string;\n}> = {\n  key: 'stepMismatch',\n  message: 'Value does not conform to step constraint',\n  isValid: ({ min, step, value }) => {\n    if (isDefined(value) && value !== '' && isDefined(step)) {\n      const _value = asNumber(value) - asNumber(min);\n      const _step = asNumber(step);\n      const magnitude = numberOfDecimals(_step) + 1;\n      const rem = roundPrecise(\n        Math.abs(_value - _step * Math.round(_value / _step)),\n        magnitude\n      );\n\n      return !rem;\n    }\n    return true;\n  },\n};\n\nexport const emailValidator: Validator<{ value: string }> = {\n  key: 'typeMismatch',\n  message: ValidationResourceStringsEN.email_validation_error!,\n  isValid: ({ value }) => (value ? emailRegex.test(value) : true),\n};\n\nexport const urlValidator: Validator<{ value: string }> = {\n  key: 'typeMismatch',\n  message: ValidationResourceStringsEN.url_validation_error!,\n  isValid: ({ value }) => (value ? URL.canParse(value) : true),\n};\n\nexport const minDateValidator: Validator<{\n  value?: Date | null;\n  min?: Date | null;\n}> = {\n  key: 'rangeUnderflow',\n  message: ({ min }) =>\n    formatString(ValidationResourceStringsEN.min_validation_error!, min),\n  isValid: ({ value, min }) =>\n    value && min ? CalendarDay.compare(value, min) >= 0 : true,\n};\n\nexport const maxDateValidator: Validator<{\n  value?: Date | null;\n  max?: Date | null;\n}> = {\n  key: 'rangeOverflow',\n  message: ({ max }) =>\n    formatString(ValidationResourceStringsEN.max_validation_error!, max),\n  isValid: ({ value, max }) =>\n    value && max ? CalendarDay.compare(value, max) <= 0 : true,\n};\n\n/** A host whose bound comparisons follow the parts present in its format. */\ninterface DatePartsHost {\n  hasDateParts(): boolean;\n  hasTimeParts(): boolean;\n}\n\n/** Compares a date against a bound at the granularity of the host's format. */\ntype DateBoundComparer = (\n  date: Date,\n  bound: Date,\n  hasTimeParts: boolean,\n  hasDateParts: boolean\n) => boolean;\n\n/** Whether no value of the host exceeds `bound`. An absent bound holds. */\nfunction isWithinBound<T extends DatePartsHost>(\n  host: T,\n  bound: Date | null | undefined,\n  values: (Date | null | undefined)[],\n  exceeds: DateBoundComparer\n): boolean {\n  return bound\n    ? values.every(\n        (date) =>\n          !date ||\n          !exceeds(date, bound, host.hasTimeParts(), host.hasDateParts())\n      )\n    : true;\n}\n\n/**\n * Creates a `rangeUnderflow` validator for hosts whose `min` comparison must\n * respect the parts of the host's format - day granularity when the format has\n * no time parts, time-of-day granularity when it has no date parts.\n *\n * `resolveValues` returns the dates checked against the bound; empty slots\n * are skipped, so a partial range validates only its present ends.\n */\nexport function createMinDateTimeValidator<\n  T extends DatePartsHost & { min?: Date | null },\n>(resolveValues: (host: T) => (Date | null | undefined)[]): Validator<T> {\n  return {\n    key: 'rangeUnderflow',\n    message: ({ min }) =>\n      formatString(ValidationResourceStringsEN.min_validation_error!, min),\n    isValid: (host) =>\n      isWithinBound(host, host.min, resolveValues(host), isDateLessThanMin),\n  };\n}\n\n/**\n * Creates a `rangeOverflow` validator for hosts whose `max` comparison must\n * respect the parts of the host's format. See {@link createMinDateTimeValidator}.\n */\nexport function createMaxDateTimeValidator<\n  T extends DatePartsHost & { max?: Date | null },\n>(resolveValues: (host: T) => (Date | null | undefined)[]): Validator<T> {\n  return {\n    key: 'rangeOverflow',\n    message: ({ max }) =>\n      formatString(ValidationResourceStringsEN.max_validation_error!, max),\n    isValid: (host) =>\n      isWithinBound(host, host.max, resolveValues(host), isDateExceedingMax),\n  };\n}\n"]}
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/internals/validators.ts"],"names":[],"mappings":"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","sourcesContent":["import { ValidationResourceStringsEN } from 'igniteui-i18n-core';\nimport { isDateExceedingMax, isDateLessThanMin } from './date/compare.js';\nimport { CalendarDay } from './date/model.js';\nimport { asNumber, numberOfDecimals, roundPrecise } from './utils/math.js';\nimport { formatString } from './utils/strings.js';\nimport { isDefined } from './utils/types.js';\n\ntype ValidatorHandler<T> = (host: T) => boolean;\ntype ValidatorMessageFormat<T> = (host: T) => string;\n\n/** @hidden */\nexport interface Validator<T = any> {\n  key: keyof ValidityStateFlags;\n  message: string | ValidatorMessageFormat<T>;\n  isValid: ValidatorHandler<T>;\n}\n\n/** Formats the `rangeUnderflow` message with the `min` bound. */\nfunction minBoundMessage(min: unknown): string {\n  return formatString(ValidationResourceStringsEN.min_validation_error!, min);\n}\n\n/** Formats the `rangeOverflow` message with the `max` bound. */\nfunction maxBoundMessage(max: unknown): string {\n  return formatString(ValidationResourceStringsEN.max_validation_error!, max);\n}\n\nconst emailRegex =\n  /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/;\n\nexport const requiredValidator: Validator<{\n  required: boolean;\n  value?: unknown;\n}> = {\n  key: 'valueMissing',\n  message: ValidationResourceStringsEN.required_validation_error!,\n  isValid: ({ required, value }) => (required ? !!value : true),\n};\n\nexport const requiredBooleanValidator: Validator<{\n  required: boolean;\n  checked: boolean;\n}> = {\n  key: 'valueMissing',\n  message: ValidationResourceStringsEN.required_validation_error!,\n  isValid: ({ required, checked }) => (required ? checked : true),\n};\n\nexport const minLengthValidator: Validator<{\n  minLength?: number;\n  value: string;\n}> = {\n  key: 'tooShort',\n  message: ({ minLength }) =>\n    formatString(\n      ValidationResourceStringsEN.min_length_validation_error!,\n      minLength\n    ),\n  isValid: ({ minLength, value }) =>\n    minLength && value ? value.length >= asNumber(minLength) : true,\n};\n\nexport const maxLengthValidator: Validator<{\n  maxLength?: number;\n  value: string;\n}> = {\n  key: 'tooLong',\n  message: ({ maxLength }) =>\n    formatString(\n      ValidationResourceStringsEN.max_length_validation_error!,\n      maxLength\n    ),\n  isValid: ({ maxLength, value }) =>\n    maxLength && value ? value.length <= asNumber(maxLength) : true,\n};\n\nexport const patternValidator: Validator<{ pattern?: string; value: string }> =\n  {\n    key: 'patternMismatch',\n    message: ValidationResourceStringsEN.pattern_validation_error!,\n    isValid: ({ pattern, value }) =>\n      pattern && value ? new RegExp(pattern, 'u').test(value) : true,\n  };\n\nexport const minValidator: Validator<{\n  min?: number;\n  value: number | string;\n}> = {\n  key: 'rangeUnderflow',\n  message: ({ min }) => minBoundMessage(min),\n  isValid: ({ min, value }) =>\n    isDefined(value) && value !== '' && isDefined(min)\n      ? asNumber(value) >= asNumber(min)\n      : true,\n};\n\nexport const maxValidator: Validator<{\n  max?: number;\n  value: number | string;\n}> = {\n  key: 'rangeOverflow',\n  message: ({ max }) => maxBoundMessage(max),\n  isValid: ({ max, value }) =>\n    isDefined(value) && value !== '' && isDefined(max)\n      ? asNumber(value) <= asNumber(max)\n      : true,\n};\n\nexport const stepValidator: Validator<{\n  min?: number;\n  step?: number;\n  value: number | string;\n}> = {\n  key: 'stepMismatch',\n  message: 'Value does not conform to step constraint',\n  isValid: ({ min, step, value }) => {\n    if (isDefined(value) && value !== '' && isDefined(step)) {\n      const _value = asNumber(value) - asNumber(min);\n      const _step = asNumber(step);\n      const magnitude = numberOfDecimals(_step) + 1;\n      const rem = roundPrecise(\n        Math.abs(_value - _step * Math.round(_value / _step)),\n        magnitude\n      );\n\n      return !rem;\n    }\n    return true;\n  },\n};\n\nexport const emailValidator: Validator<{ value: string }> = {\n  key: 'typeMismatch',\n  message: ValidationResourceStringsEN.email_validation_error!,\n  isValid: ({ value }) => (value ? emailRegex.test(value) : true),\n};\n\nexport const urlValidator: Validator<{ value: string }> = {\n  key: 'typeMismatch',\n  message: ValidationResourceStringsEN.url_validation_error!,\n  isValid: ({ value }) => (value ? URL.canParse(value) : true),\n};\n\nexport const minDateValidator: Validator<{\n  value?: Date | null;\n  min?: Date | null;\n}> = {\n  key: 'rangeUnderflow',\n  message: ({ min }) => minBoundMessage(min),\n  isValid: ({ value, min }) =>\n    value && min ? CalendarDay.compare(value, min) >= 0 : true,\n};\n\nexport const maxDateValidator: Validator<{\n  value?: Date | null;\n  max?: Date | null;\n}> = {\n  key: 'rangeOverflow',\n  message: ({ max }) => maxBoundMessage(max),\n  isValid: ({ value, max }) =>\n    value && max ? CalendarDay.compare(value, max) <= 0 : true,\n};\n\n/** A host that compares bounds at the granularity of its own format. */\ninterface DatePartsHost {\n  hasDateParts(): boolean;\n  hasTimeParts(): boolean;\n}\n\n/** Compares a date with a bound at the granularity of the host format. */\ntype DateBoundComparer = (\n  date: Date,\n  bound: Date,\n  hasTimeParts: boolean,\n  hasDateParts: boolean\n) => boolean;\n\n/**\n * Returns `true` when no value of the host exceeds `bound`. An unset bound\n * and an empty value both pass.\n */\nfunction isWithinBound<T extends DatePartsHost>(\n  host: T,\n  bound: Date | null | undefined,\n  values: (Date | null | undefined)[],\n  exceeds: DateBoundComparer\n): boolean {\n  return bound\n    ? values.every(\n        (date) =>\n          !date ||\n          !exceeds(date, bound, host.hasTimeParts(), host.hasDateParts())\n      )\n    : true;\n}\n\n/**\n * Creates a `rangeUnderflow` validator for the `min` bound of a host.\n *\n * @remarks\n * The comparison follows the host format: day granularity without time\n * parts, time-of-day granularity without date parts. `resolveValues` gives\n * the dates to compare, and empty slots are skipped, so a partial range\n * validates only the ends it has.\n */\nexport function createMinDateTimeValidator<\n  T extends DatePartsHost & { min?: Date | null },\n>(resolveValues: (host: T) => (Date | null | undefined)[]): Validator<T> {\n  return {\n    key: 'rangeUnderflow',\n    message: (host) => minBoundMessage(host.min),\n    isValid: (host) =>\n      isWithinBound(host, host.min, resolveValues(host), isDateLessThanMin),\n  };\n}\n\n/**\n * Creates a `rangeOverflow` validator for the `max` bound of a host.\n * See {@link createMinDateTimeValidator}.\n */\nexport function createMaxDateTimeValidator<\n  T extends DatePartsHost & { max?: Date | null },\n>(resolveValues: (host: T) => (Date | null | undefined)[]): Validator<T> {\n  return {\n    key: 'rangeOverflow',\n    message: (host) => maxBoundMessage(host.max),\n    isValid: (host) =>\n      isWithinBound(host, host.max, resolveValues(host), isDateExceedingMax),\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "igniteui-webcomponents",
-  "version": "7.3.2",
+  "version": "7.4.1",
   "description": "Ignite UI for Web Components is a complete library of UI components, giving you the ability to build modern web applications using encapsulation and the concept of reusable components in a dependency-free approach.",
   "author": "Infragistics",
   "license": "MIT",

package/skills/README.md

@@ -14,8 +14,10 @@ Skills are structured instructions that help AI agents understand and execute co
 | [igniteui-wc-integrate-with-framework](./igniteui-wc-integrate-with-framework/SKILL.md)     | Integrate components into React, Angular, Vue, or vanilla JS applications          | Setting up components in your project |
 | [igniteui-wc-customize-component-theme](./igniteui-wc-customize-component-theme/SKILL.md)   | Customize styling using CSS custom properties, parts, and theming system           | Applying custom brand colors/styles   |
 | [igniteui-wc-generate-from-image-design](./igniteui-wc-generate-from-image-design/SKILL.md) | Implement a view from a screenshot or mockup using Ignite UI Web Components        | Converting a design image into UI     |
+| [igniteui-wc-figma-to-app](./igniteui-wc-figma-to-app/SKILL.md)                             | Translate Figma screens from any UI kit (Indigo.Design, third-party, or plain frames) into a working app | Implementing a design from a Figma file |
 | [igniteui-wc-optimize-bundle-size](./igniteui-wc-optimize-bundle-size/SKILL.md)             | Reduce bundle size by importing only needed components and lazy loading            | Optimizing production performance     |
 | [igniteui-wc-migrate-grid-lite-to-premium](./igniteui-wc-migrate-grid-lite-to-premium/SKILL.md) | Migrate from Grid Lite to the premium Data Grid                                 | Adopting enterprise grid features     |
+| [igniteui-wc-grids](./igniteui-wc-grids/SKILL.md)                               | Set up a grid: package choice, theming, Shadow DOM, layout, sorting/filtering       | Adding or debugging a grid in an app   |
 
 ## How to Use
 
@@ -25,6 +27,7 @@ When working with an AI agent like GitHub Copilot, reference skills by name or a
 - "How do I integrate igniteui-webcomponents with React?"
 - "Help me customize the button colors to match my brand"
 - "Build this screenshot with Ignite UI Web Components"
+- "Implement this Figma design with Ignite UI Web Components"
 - "My bundle size is too large, how can I reduce it?"
 - "Show me how to use these components in Vue"
 
@@ -32,6 +35,7 @@ When working with an AI agent like GitHub Copilot, reference skills by name or a
 - "Follow the integrate-with-framework skill for my Angular app"
 - "Use the customize-component-theme skill to help me style components"
 - "Use the generate-from-image-design skill to implement this mockup"
+- "Use the figma-to-app skill to build this artboard"
 - "Apply the optimize-bundle-size skill to reduce my bundle"
 
 ## Skill Structure
@@ -53,9 +57,6 @@ If you identify gaps in the skills or have suggestions for improvements:
 
 1. [Open an issue](https://github.com/IgniteUI/igniteui-webcomponents/issues) describing the improvement
 2. Submit a pull request with the proposed changes
-3. Follow the skill format and structure of existing skills
-
-For skills related to **contributing to the library itself** (creating components, reviewing PRs, etc.), see [`.github/skills/`](../.github/skills/).
 
 ## Additional Resources
 

package/skills/igniteui-wc-choose-components/SKILL.md

@@ -1,6 +1,7 @@
 ---
+license: MIT
 name: igniteui-wc-choose-components
-description: Identify and select the right Ignite UI Web Components for your app UI, then navigate to official docs, usage examples, and API references
+description: "Identify the right Ignite UI Web Components (igniteui-webcomponents, grids, charts, dock manager, React wrappers) for a UI requirement and point to official docs, examples, and API references. WHEN TO USE: the user asks which component fits a UI pattern (form, table, dashboard, navigation, chat, etc.), needs to compare options (e.g. Grid Lite vs. premium Grid), wants a component list for a screen, or asks which package a component lives in. WHEN NOT TO USE: implementing a view from a design image or Figma file (use generate-from-image-design or figma-to-app), installing/wiring packages into a framework (use integrate-with-framework), styling/theming (use customize-component-theme), reducing bundle size (use optimize-bundle-size), or migrating Grid Lite to the premium grid (use migrate-grid-lite-to-premium)."
 user-invocable: true
 ---
 

package/skills/igniteui-wc-customize-component-theme/SKILL.md

@@ -1,6 +1,7 @@
 ---
+license: MIT
 name: igniteui-wc-customize-component-theme
-description: Customize Ignite UI Web Components styling using CSS custom properties, optional Sass, and the igniteui-theming MCP server for AI-assisted theming
+description: "Theme and style Ignite UI Web Components (and igniteui-react) apps using CSS custom properties, optional Sass, and the igniteui-theming MCP server. WHEN TO USE: the user wants to apply or switch a pre-built theme (Material, Fluent, Bootstrap, Indigo, light/dark), create a custom palette or global theme, restyle a specific component via design tokens or ::part, scope a theme to a container, adjust sizing/spacing/roundness, or toggle light/dark mode. WHEN NOT TO USE: choosing which component to use (use choose-components), building a full view from a design image or Figma file (use generate-from-image-design or figma-to-app, which include theming), installing packages or framework setup (use integrate-with-framework), or styling non-Ignite UI elements or libraries."
 user-invocable: true
 ---