@apvee/spfx-react-toolkit 1.2.0 → 1.3.0

package/lib/utils/resize-observer.internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resize-observer.internal.d.ts","sourceRoot":"","sources":["../../src/utils/resize-observer.internal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,GAClD,IAAI,CAwBN"}
+{"version":3,"file":"resize-observer.internal.d.ts","sourceRoot":"","sources":["../../src/utils/resize-observer.internal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,GAClD,IAAI,CAwBN"}

package/lib/utils/resize-observer.internal.js

@@ -4,8 +4,18 @@ import { useEffect } from 'react';
 /**
  * Hook to observe element size changes using ResizeObserver
  *
- * @param element - DOM element to observe
- * @param onResize - Callback when size changes
+ * Automatically sets up and cleans up ResizeObserver subscription.
+ * Calls onResize with undefined if element is undefined or ResizeObserver is not supported.
+ *
+ * @param element - DOM element to observe, or undefined to clear observation
+ * @param onResize - Callback invoked with {width, height} on size changes, or undefined when element is unavailable
+ * @returns void - Hook manages subscription lifecycle internally
+ *
+ * @remarks
+ * - Cleanup is handled automatically on unmount or when element changes
+ * - ResizeObserver polyfill is NOT included - requires browser support
+ * - Initial size is reported immediately after observation starts
+ *
  * @internal
  */
 export function useResizeObserver(element, onResize) {

package/lib/utils/resize-observer.internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"resize-observer.internal.js","sourceRoot":"","sources":["../../src/utils/resize-observer.internal.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,+CAA+C;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgC,EAChC,QAAmD;IAEnD,SAAS,CAAC;QACR,4DAA4D;QAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,cAAc,KAAK,WAAW,EAAE,CAAC;YACtD,QAAQ,CAAC,SAAS,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,IAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,UAAC,OAAO;YAC1C,KAAoB,UAAO,EAAP,mBAAO,EAAP,qBAAO,EAAP,IAAO,EAAE,CAAC;gBAAzB,IAAM,KAAK,gBAAA;gBACR,IAAA,KAAoB,KAAK,CAAC,WAAW,EAAnC,KAAK,WAAA,EAAE,MAAM,YAAsB,CAAC;gBAC5C,QAAQ,CAAC,EAAE,KAAK,OAAA,EAAE,MAAM,QAAA,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,kBAAkB;QAClB,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1B,qBAAqB;QACrB,OAAO;YACL,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"resize-observer.internal.js","sourceRoot":"","sources":["../../src/utils/resize-observer.internal.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,+CAA+C;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgC,EAChC,QAAmD;IAEnD,SAAS,CAAC;QACR,4DAA4D;QAC5D,IAAI,CAAC,OAAO,IAAI,OAAO,cAAc,KAAK,WAAW,EAAE,CAAC;YACtD,QAAQ,CAAC,SAAS,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,wBAAwB;QACxB,IAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,UAAC,OAAO;YAC1C,KAAoB,UAAO,EAAP,mBAAO,EAAP,qBAAO,EAAP,IAAO,EAAE,CAAC;gBAAzB,IAAM,KAAK,gBAAA;gBACR,IAAA,KAAoB,KAAK,CAAC,WAAW,EAAnC,KAAK,WAAA,EAAE,MAAM,YAAsB,CAAC;gBAC5C,QAAQ,CAAC,EAAE,KAAK,OAAA,EAAE,MAAM,QAAA,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,kBAAkB;QAClB,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1B,qBAAqB;QACrB,OAAO;YACL,QAAQ,CAAC,UAAU,EAAE,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/lib/utils/theme-subscription.internal.d.ts

@@ -1,10 +1,19 @@
 import type { IReadonlyTheme } from '@microsoft/sp-component-base';
 /**
  * Hook to subscribe to SPFx theme changes
- * Automatically updates the provided setter when theme changes
  *
- * @param spfxContext - SPFx context object
- * @param setTheme - Setter function to update theme state
+ * Automatically updates the provided setter when theme changes.
+ * Sets initial theme on mount and subscribes to themeChangedEvent.
+ *
+ * @param spfxContext - SPFx context object with serviceScope
+ * @param setTheme - Setter function to update theme state (receives IReadonlyTheme or undefined)
+ * @returns void - Hook manages subscription lifecycle internally
+ *
+ * @remarks
+ * - Initial theme is set synchronously on mount if available
+ * - Cleanup removes event listener automatically on unmount
+ * - Uses SPFx observer pattern for event subscription
+ *
  * @internal
  */
 export declare function useThemeSubscription(spfxContext: unknown, setTheme: (theme: IReadonlyTheme | undefined) => void): void;

package/lib/utils/theme-subscription.internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-subscription.internal.d.ts","sourceRoot":"","sources":["../../src/utils/theme-subscription.internal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAuBnE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,GACpD,IAAI,CAmCN"}
+{"version":3,"file":"theme-subscription.internal.d.ts","sourceRoot":"","sources":["../../src/utils/theme-subscription.internal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA8BnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,GACpD,IAAI,CAmCN"}

package/lib/utils/theme-subscription.internal.js

@@ -4,7 +4,14 @@ import { useEffect } from 'react';
 import { ThemeProvider } from '@microsoft/sp-component-base';
 /**
  * Extract ThemeProvider from SPFx context
+ *
  * Works with any SPFx context type (WebPart, ApplicationCustomizer, etc.)
+ * by consuming ThemeProvider service from the ServiceScope.
+ *
+ * @param spfxContext - Any SPFx context object (WebPartContext, ApplicationCustomizerContext, etc.)
+ * @returns ThemeProvider service instance from SPFx ServiceScope
+ * @throws Error if context does not have serviceScope
+ *
  * @internal
  */
 function getThemeProvider(spfxContext) {
@@ -18,10 +25,19 @@ function getThemeProvider(spfxContext) {
 }
 /**
  * Hook to subscribe to SPFx theme changes
- * Automatically updates the provided setter when theme changes
  *
- * @param spfxContext - SPFx context object
- * @param setTheme - Setter function to update theme state
+ * Automatically updates the provided setter when theme changes.
+ * Sets initial theme on mount and subscribes to themeChangedEvent.
+ *
+ * @param spfxContext - SPFx context object with serviceScope
+ * @param setTheme - Setter function to update theme state (receives IReadonlyTheme or undefined)
+ * @returns void - Hook manages subscription lifecycle internally
+ *
+ * @remarks
+ * - Initial theme is set synchronously on mount if available
+ * - Cleanup removes event listener automatically on unmount
+ * - Uses SPFx observer pattern for event subscription
+ *
  * @internal
  */
 export function useThemeSubscription(spfxContext, setTheme) {

package/lib/utils/theme-subscription.internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-subscription.internal.js","sourceRoot":"","sources":["../../src/utils/theme-subscription.internal.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,kDAAkD;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,WAAoB;IAC5C,IAAM,GAAG,GAAG,WAEX,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,2CAA2C;IAC3C,yDAAyD;IACzD,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAoB,EACpB,QAAqD;IAErD,SAAS,CAAC;QACR,IAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEpD,oBAAoB;QACpB,IAAM,YAAY,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC;QAED,uBAAuB;QACvB,IAAM,OAAO,GAAG,UAAC,IAAgC;YAC/C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,+CAA+C;QAC/C,IAAM,QAAQ,GAAG;YACf,UAAU,EAAE,oBAAoB;YAChC,WAAW,EAAE,oBAAoB;YACjC,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE;gBACP,sCAAsC;YACxC,CAAC;YACD,MAAM,EAAE,OAAO;SAChB,CAAC;QAEF,6BAA6B;QAC7B,aAAa,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEvD,qBAAqB;QACrB,OAAO;YACL,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;YAC3B,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"theme-subscription.internal.js","sourceRoot":"","sources":["../../src/utils/theme-subscription.internal.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,kDAAkD;AAElD,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CAAC,WAAoB;IAC5C,IAAM,GAAG,GAAG,WAEX,CAAC;IAEF,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,2CAA2C;IAC3C,yDAAyD;IACzD,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAoB,EACpB,QAAqD;IAErD,SAAS,CAAC;QACR,IAAM,aAAa,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEpD,oBAAoB;QACpB,IAAM,YAAY,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QACjD,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC;QAED,uBAAuB;QACvB,IAAM,OAAO,GAAG,UAAC,IAAgC;YAC/C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,+CAA+C;QAC/C,IAAM,QAAQ,GAAG;YACf,UAAU,EAAE,oBAAoB;YAChC,WAAW,EAAE,oBAAoB;YACjC,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE;gBACP,sCAAsC;YACxC,CAAC;YACD,MAAM,EAAE,OAAO;SAChB,CAAC;QAEF,6BAA6B;QAC7B,aAAa,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEvD,qBAAqB;QACrB,OAAO;YACL,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;YAC3B,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC5D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/lib/utils/type-guards.internal.d.ts

@@ -4,31 +4,104 @@ import type { BaseListViewCommandSet, BaseFieldCustomizer } from '@microsoft/sp-
 import type { SPFxComponent, HostKind } from '../core/types';
 /**
  * Type guard: Check if instance is a WebPart
- * Uses duck typing - checks for WebPart-specific properties
+ *
+ * Uses duck typing (structural typing) to detect WebPart instances
+ * by checking for WebPart-specific properties: displayMode, domElement, render, context, properties.
+ *
+ * @template TProps - WebPart properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseClientSideWebPart, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isWebPart(instance)) {
+ *   // instance is now typed as BaseClientSideWebPart<TProps>
+ *   console.log(instance.displayMode);
+ * }
+ * ```
+ *
  * @internal
  */
 export declare function isWebPart<TProps extends {} = {}>(instance: unknown): instance is BaseClientSideWebPart<TProps>;
 /**
  * Type guard: Check if instance is an ApplicationCustomizer
- * Uses duck typing - checks for ApplicationCustomizer-specific properties
+ *
+ * Uses duck typing (structural typing) to detect ApplicationCustomizer instances
+ * by checking for placeholderProvider in context and absence of displayMode.
+ *
+ * @template TProps - ApplicationCustomizer properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseApplicationCustomizer, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isApplicationCustomizer(instance)) {
+ *   // instance is now typed as BaseApplicationCustomizer<TProps>
+ *   console.log(instance.context.placeholderProvider);
+ * }
+ * ```
+ *
  * @internal
  */
 export declare function isApplicationCustomizer<TProps extends {} = {}>(instance: unknown): instance is BaseApplicationCustomizer<TProps>;
 /**
  * Type guard: Check if instance is a ListViewCommandSet
- * Uses duck typing - checks for CommandSet-specific properties
+ *
+ * Uses duck typing (structural typing) to detect ListViewCommandSet instances
+ * by checking for onExecute and tryGetCommand methods.
+ *
+ * @template TProps - ListViewCommandSet properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseListViewCommandSet, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isListViewCommandSet(instance)) {
+ *   // instance is now typed as BaseListViewCommandSet<TProps>
+ *   instance.tryGetCommand('COMMAND_ID');
+ * }
+ * ```
+ *
  * @internal
  */
 export declare function isListViewCommandSet<TProps extends {} = {}>(instance: unknown): instance is BaseListViewCommandSet<TProps>;
 /**
  * Type guard: Check if instance is a FieldCustomizer
- * Uses duck typing - checks for FieldCustomizer-specific properties
+ *
+ * Uses duck typing (structural typing) to detect FieldCustomizer instances
+ * by checking for field in context and onRenderCell method.
+ *
+ * @template TProps - FieldCustomizer properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseFieldCustomizer, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isFieldCustomizer(instance)) {
+ *   // instance is now typed as BaseFieldCustomizer<TProps>
+ *   console.log(instance.context.field);
+ * }
+ * ```
+ *
  * @internal
  */
 export declare function isFieldCustomizer<TProps extends {} = {}>(instance: unknown): instance is BaseFieldCustomizer<TProps>;
 /**
  * Detect the kind of SPFx component from an instance
- * Throws if unable to detect
+ *
+ * Checks the instance against all known SPFx component types and returns
+ * the corresponding HostKind discriminator.
+ *
+ * @template TProps - SPFx component properties type
+ * @param instance - SPFx component instance to detect
+ * @returns HostKind ('WebPart' | 'AppCustomizer' | 'CommandSet' | 'FieldCustomizer')
+ * @throws Error if unable to detect component type
+ *
+ * @example
+ * ```typescript
+ * const kind = detectComponentKind(this); // 'WebPart'
+ * ```
+ *
  * @internal
  */
 export declare function detectComponentKind<TProps extends {} = {}>(instance: SPFxComponent<TProps>): HostKind;

package/lib/utils/type-guards.internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.internal.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.internal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACxG,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACT,MAAM,eAAe,CAAC;AAEvB;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EAC9C,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAa3C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EAC5D,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAgB/C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACzD,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAa5C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACtD,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAiBzC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACxD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,QAAQ,CAUV"}
+{"version":3,"file":"type-guards.internal.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.internal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACxG,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACT,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EAC9C,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,qBAAqB,CAAC,MAAM,CAAC,CAa3C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EAC5D,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAgB/C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACzD,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAa5C;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACtD,QAAQ,EAAE,OAAO,GAChB,QAAQ,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAiBzC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACxD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,QAAQ,CAUV"}

package/lib/utils/type-guards.internal.js

@@ -2,7 +2,22 @@
 // Type guards for SPFx component detection using structural typing (duck typing)
 /**
  * Type guard: Check if instance is a WebPart
- * Uses duck typing - checks for WebPart-specific properties
+ *
+ * Uses duck typing (structural typing) to detect WebPart instances
+ * by checking for WebPart-specific properties: displayMode, domElement, render, context, properties.
+ *
+ * @template TProps - WebPart properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseClientSideWebPart, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isWebPart(instance)) {
+ *   // instance is now typed as BaseClientSideWebPart<TProps>
+ *   console.log(instance.displayMode);
+ * }
+ * ```
+ *
  * @internal
  */
 export function isWebPart(instance) {
@@ -18,7 +33,22 @@ export function isWebPart(instance) {
 }
 /**
  * Type guard: Check if instance is an ApplicationCustomizer
- * Uses duck typing - checks for ApplicationCustomizer-specific properties
+ *
+ * Uses duck typing (structural typing) to detect ApplicationCustomizer instances
+ * by checking for placeholderProvider in context and absence of displayMode.
+ *
+ * @template TProps - ApplicationCustomizer properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseApplicationCustomizer, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isApplicationCustomizer(instance)) {
+ *   // instance is now typed as BaseApplicationCustomizer<TProps>
+ *   console.log(instance.context.placeholderProvider);
+ * }
+ * ```
+ *
  * @internal
  */
 export function isApplicationCustomizer(instance) {
@@ -36,7 +66,22 @@ export function isApplicationCustomizer(instance) {
 }
 /**
  * Type guard: Check if instance is a ListViewCommandSet
- * Uses duck typing - checks for CommandSet-specific properties
+ *
+ * Uses duck typing (structural typing) to detect ListViewCommandSet instances
+ * by checking for onExecute and tryGetCommand methods.
+ *
+ * @template TProps - ListViewCommandSet properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseListViewCommandSet, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isListViewCommandSet(instance)) {
+ *   // instance is now typed as BaseListViewCommandSet<TProps>
+ *   instance.tryGetCommand('COMMAND_ID');
+ * }
+ * ```
+ *
  * @internal
  */
 export function isListViewCommandSet(instance) {
@@ -52,7 +97,22 @@ export function isListViewCommandSet(instance) {
 }
 /**
  * Type guard: Check if instance is a FieldCustomizer
- * Uses duck typing - checks for FieldCustomizer-specific properties
+ *
+ * Uses duck typing (structural typing) to detect FieldCustomizer instances
+ * by checking for field in context and onRenderCell method.
+ *
+ * @template TProps - FieldCustomizer properties type
+ * @param instance - SPFx component instance to check
+ * @returns True if instance is a BaseFieldCustomizer, narrowing the type
+ *
+ * @example
+ * ```typescript
+ * if (isFieldCustomizer(instance)) {
+ *   // instance is now typed as BaseFieldCustomizer<TProps>
+ *   console.log(instance.context.field);
+ * }
+ * ```
+ *
  * @internal
  */
 export function isFieldCustomizer(instance) {
@@ -70,7 +130,20 @@ export function isFieldCustomizer(instance) {
 }
 /**
  * Detect the kind of SPFx component from an instance
- * Throws if unable to detect
+ *
+ * Checks the instance against all known SPFx component types and returns
+ * the corresponding HostKind discriminator.
+ *
+ * @template TProps - SPFx component properties type
+ * @param instance - SPFx component instance to detect
+ * @returns HostKind ('WebPart' | 'AppCustomizer' | 'CommandSet' | 'FieldCustomizer')
+ * @throws Error if unable to detect component type
+ *
+ * @example
+ * ```typescript
+ * const kind = detectComponentKind(this); // 'WebPart'
+ * ```
+ *
  * @internal
  */
 export function detectComponentKind(instance) {

package/lib/utils/type-guards.internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-guards.internal.js","sourceRoot":"","sources":["../../src/utils/type-guards.internal.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,iFAAiF;AAUjF;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,OAAO,CACL,aAAa,IAAI,GAAG;QACpB,YAAY,IAAI,GAAG;QACnB,QAAQ,IAAI,GAAG;QACf,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU;QAChC,SAAS,IAAI,GAAG;QAChB,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAM,OAAO,GAAG,GAAG,CAAC,OAAkC,CAAC;IAEvD,OAAO,CACL,qBAAqB,IAAI,OAAO;QAChC,YAAY,IAAI,GAAG;QACnB,CAAC,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC,gBAAgB;KACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,OAAO,CACL,WAAW,IAAI,GAAG;QAClB,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU;QACnC,eAAe,IAAI,GAAG;QACtB,OAAO,GAAG,CAAC,aAAa,KAAK,UAAU;QACvC,SAAS,IAAI,GAAG;QAChB,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAM,OAAO,GAAG,GAAG,CAAC,OAAkC,CAAC;IAEvD,OAAO,CACL,OAAO,IAAI,OAAO;QAClB,cAAc,IAAI,GAAG;QACrB,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU;QACtC,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA+B;IAE/B,IAAI,SAAS,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,uBAAuB,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IAC9D,IAAI,oBAAoB,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC;IACxD,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAE1D,MAAM,IAAI,KAAK,CACb,uDAAuD;QACvD,oFAAoF,CACrF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"type-guards.internal.js","sourceRoot":"","sources":["../../src/utils/type-guards.internal.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,iFAAiF;AAUjF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,SAAS,CACvB,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,OAAO,CACL,aAAa,IAAI,GAAG;QACpB,YAAY,IAAI,GAAG;QACnB,QAAQ,IAAI,GAAG;QACf,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU;QAChC,SAAS,IAAI,GAAG;QAChB,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAM,OAAO,GAAG,GAAG,CAAC,OAAkC,CAAC;IAEvD,OAAO,CACL,qBAAqB,IAAI,OAAO;QAChC,YAAY,IAAI,GAAG;QACnB,CAAC,CAAC,aAAa,IAAI,GAAG,CAAC,CAAC,gBAAgB;KACzC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,OAAO,CACL,WAAW,IAAI,GAAG;QAClB,OAAO,GAAG,CAAC,SAAS,KAAK,UAAU;QACnC,eAAe,IAAI,GAAG;QACtB,OAAO,GAAG,CAAC,aAAa,KAAK,UAAU;QACvC,SAAS,IAAI,GAAG;QAChB,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5D,IAAM,GAAG,GAAG,QAAmC,CAAC;IAEhD,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAM,OAAO,GAAG,GAAG,CAAC,OAAkC,CAAC;IAEvD,OAAO,CACL,OAAO,IAAI,OAAO;QAClB,cAAc,IAAI,GAAG;QACrB,OAAO,GAAG,CAAC,YAAY,KAAK,UAAU;QACtC,YAAY,IAAI,GAAG,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA+B;IAE/B,IAAI,SAAS,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,uBAAuB,CAAC,QAAQ,CAAC;QAAE,OAAO,eAAe,CAAC;IAC9D,IAAI,oBAAoB,CAAC,QAAQ,CAAC;QAAE,OAAO,YAAY,CAAC;IACxD,IAAI,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAE1D,MAAM,IAAI,KAAK,CACb,uDAAuD;QACvD,oFAAoF,CACrF,CAAC;AACJ,CAAC"}

package/lib/webparts/spFxReactToolkitTest/components/SpFxReactToolkitTest.d.ts

@@ -1,8 +1,4 @@
 import * as React from 'react';
-import '@pnp/sp/webs';
-import '@pnp/sp/lists';
-import '@pnp/sp/items';
-import '@pnp/sp/site-users';
 declare const SpFxReactToolkitTest: React.FC;
 export default SpFxReactToolkitTest;
 //# sourceMappingURL=SpFxReactToolkitTest.d.ts.map

package/lib/webparts/spFxReactToolkitTest/components/SpFxReactToolkitTest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpFxReactToolkitTest.d.ts","sourceRoot":"","sources":["../../../../src/webparts/spFxReactToolkitTest/components/SpFxReactToolkitTest.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAyD/B,OAAO,cAAc,CAAC;AACtB,OAAO,eAAe,CAAC;AACvB,OAAO,eAAe,CAAC;AACvB,OAAO,oBAAoB,CAAC;AA6+B5B,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EA8/BjC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"SpFxReactToolkitTest.d.ts","sourceRoot":"","sources":["../../../../src/webparts/spFxReactToolkitTest/components/SpFxReactToolkitTest.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AA0F/B,QAAA,MAAM,oBAAoB,EAAE,KAAK,CAAC,EA6/BjC,CAAC;AAEF,eAAe,oBAAoB,CAAC"}