@apvee/spfx-react-toolkit 1.0.0

package/lib/core/atoms.internal.d.ts

@@ -0,0 +1,53 @@
+import type { DisplayMode } from '@microsoft/sp-core-library';
+import type { IReadonlyTheme } from '@microsoft/sp-component-base';
+import type { ContainerSize } from './types';
+/**
+ * Collection of Jotai atoms for SPFx state
+ *
+ * These atoms are isolated per Provider instance through separate stores.
+ * Each SPFxProvider creates its own store, ensuring complete isolation
+ * between multiple instances on the same page.
+ *
+ * Usage in hooks:
+ *   const theme = useAtomValue(spfxAtoms.theme);
+ *   const setDisplayMode = useSetAtom(spfxAtoms.displayMode);
+ *
+ * Benefits:
+ * - Simple atom definitions (no scoping complexity)
+ * - Automatic isolation via Provider store
+ * - Automatic cleanup when Provider unmounts
+ * - Type-safe and follows Jotai best practices
+ *
+ * @internal
+ */
+export declare const spfxAtoms: {
+    readonly theme: import("jotai").PrimitiveAtom<IReadonlyTheme | undefined> & {
+        init: IReadonlyTheme | undefined;
+    };
+    readonly displayMode: import("jotai").PrimitiveAtom<DisplayMode | undefined> & {
+        init: DisplayMode | undefined;
+    };
+    readonly properties: import("jotai").PrimitiveAtom<unknown> & {
+        init: unknown;
+    };
+    readonly containerEl: import("jotai").PrimitiveAtom<HTMLElement | undefined> & {
+        init: HTMLElement | undefined;
+    };
+    readonly containerSize: import("jotai").PrimitiveAtom<ContainerSize | undefined> & {
+        init: ContainerSize | undefined;
+    };
+    readonly teams: import("jotai").PrimitiveAtom<{
+        supported: boolean;
+        context?: unknown;
+        theme?: "default" | "dark" | "highContrast" | undefined;
+        initialized: boolean;
+    }> & {
+        init: {
+            supported: boolean;
+            context?: unknown;
+            theme?: "default" | "dark" | "highContrast" | undefined;
+            initialized: boolean;
+        };
+    };
+};
+//# sourceMappingURL=atoms.internal.d.ts.map

package/lib/core/atoms.internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atoms.internal.d.ts","sourceRoot":"","sources":["../../src/core/atoms.internal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;mBAeP,OAAO;kBACR,OAAO;;qBAEJ,OAAO;;;uBAHT,OAAO;sBACR,OAAO;;yBAEJ,OAAO;;;CAEd,CAAC"}

package/lib/core/atoms.internal.js

@@ -0,0 +1,35 @@
+// atoms.ts
+// Jotai atoms for SPFx state management
+// Each Provider instance gets its own isolated store
+import { atom } from 'jotai';
+/**
+ * Collection of Jotai atoms for SPFx state
+ *
+ * These atoms are isolated per Provider instance through separate stores.
+ * Each SPFxProvider creates its own store, ensuring complete isolation
+ * between multiple instances on the same page.
+ *
+ * Usage in hooks:
+ *   const theme = useAtomValue(spfxAtoms.theme);
+ *   const setDisplayMode = useSetAtom(spfxAtoms.displayMode);
+ *
+ * Benefits:
+ * - Simple atom definitions (no scoping complexity)
+ * - Automatic isolation via Provider store
+ * - Automatic cleanup when Provider unmounts
+ * - Type-safe and follows Jotai best practices
+ *
+ * @internal
+ */
+export var spfxAtoms = {
+    // Core state atoms
+    theme: atom(undefined),
+    displayMode: atom(undefined),
+    properties: atom(undefined),
+    // Container state atoms
+    containerEl: atom(undefined),
+    containerSize: atom(undefined),
+    // Teams context state (async initialized)
+    teams: atom({ supported: false, initialized: false }),
+};
+//# sourceMappingURL=atoms.internal.js.map

package/lib/core/atoms.internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atoms.internal.js","sourceRoot":"","sources":["../../src/core/atoms.internal.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,wCAAwC;AACxC,qDAAqD;AAErD,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAK7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,IAAM,SAAS,GAAG;IACvB,mBAAmB;IACnB,KAAK,EAAE,IAAI,CAA6B,SAAS,CAAC;IAElD,WAAW,EAAE,IAAI,CAA0B,SAAS,CAAC;IAErD,UAAU,EAAE,IAAI,CAAU,SAAS,CAAC;IAEpC,wBAAwB;IACxB,WAAW,EAAE,IAAI,CAA0B,SAAS,CAAC;IAErD,aAAa,EAAE,IAAI,CAA4B,SAAS,CAAC;IAEzD,0CAA0C;IAC1C,KAAK,EAAE,IAAI,CAKR,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;CACpC,CAAC"}

package/lib/core/context.internal.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import type { SPFxContextValue } from './types';
+/**
+ * React Context for SPFx metadata
+ * Contains only static reference data:
+ * - instanceId: Unique identifier for this SPFx instance
+ * - spfxContext: The SPFx context object (WebPartContext, etc.)
+ * - kind: Type of host component
+ *
+ * This context does NOT contain reactive state.
+ * State is managed via Jotai atoms in isolated stores per Provider instance.
+ *
+ * @internal
+ */
+export declare const SPFxContext: React.Context<SPFxContextValue | null>;
+/**
+ * Internal hook to access SPFx context
+ * Throws error if used outside SPFxProvider
+ *
+ * @internal
+ */
+export declare function useSPFxContext(): SPFxContextValue;
+//# sourceMappingURL=context.internal.d.ts.map

package/lib/core/context.internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.internal.d.ts","sourceRoot":"","sources":["../../src/core/context.internal.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,wCAAqD,CAAC;AAM9E;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAWjD"}

package/lib/core/context.internal.js

@@ -0,0 +1,34 @@
+// context.tsx
+// React Context for SPFx metadata (static, non-reactive)
+import * as React from 'react';
+/**
+ * React Context for SPFx metadata
+ * Contains only static reference data:
+ * - instanceId: Unique identifier for this SPFx instance
+ * - spfxContext: The SPFx context object (WebPartContext, etc.)
+ * - kind: Type of host component
+ *
+ * This context does NOT contain reactive state.
+ * State is managed via Jotai atoms in isolated stores per Provider instance.
+ *
+ * @internal
+ */
+export var SPFxContext = React.createContext(null);
+if (process.env.NODE_ENV !== 'production') {
+    SPFxContext.displayName = 'SPFxContext';
+}
+/**
+ * Internal hook to access SPFx context
+ * Throws error if used outside SPFxProvider
+ *
+ * @internal
+ */
+export function useSPFxContext() {
+    var context = React.useContext(SPFxContext);
+    if (!context) {
+        throw new Error('useSPFxContext must be used within SPFxProvider. ' +
+            'Make sure your component is wrapped with <SPFxProvider>.');
+    }
+    return context;
+}
+//# sourceMappingURL=context.internal.js.map

package/lib/core/context.internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.internal.js","sourceRoot":"","sources":["../../src/core/context.internal.tsx"],"names":[],"mappings":"AAAA,cAAc;AACd,yDAAyD;AAEzD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,IAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAA0B,IAAI,CAAC,CAAC;AAE9E,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;IAC1C,WAAW,CAAC,WAAW,GAAG,aAAa,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,mDAAmD;YACnD,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/lib/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './provider-application-customizer';
+export * from './provider-field-customizer';
+export * from './provider-listview-commandset';
+export * from './provider-webpart';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/lib/core/index.js

@@ -0,0 +1,6 @@
+export * from './provider-application-customizer';
+export * from './provider-field-customizer';
+export * from './provider-listview-commandset';
+export * from './provider-webpart';
+export * from './types';
+//# sourceMappingURL=index.js.map

package/lib/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/lib/core/provider-application-customizer.d.ts

@@ -0,0 +1,57 @@
+import * as React from 'react';
+import type { BaseApplicationCustomizer } from '@microsoft/sp-application-base';
+/**
+ * Props for the SPFx Application Customizer-specific provider component.
+ *
+ * @template TProps - The properties type for the Application Customizer.
+ * @public
+ */
+export interface SPFxApplicationCustomizerProviderProps<TProps extends {} = {}> {
+    /**
+     * The SPFx Application Customizer instance.
+     */
+    instance: BaseApplicationCustomizer<TProps>;
+    /**
+     * The children to render within the provider.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * SPFx context provider specifically for Application Customizers.
+ *
+ * This is a type-safe wrapper around the base provider that accepts an Application Customizer instance
+ * directly without requiring type casting. Use this provider in Application Customizers instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxApplicationCustomizerProvider } from 'spfx-react-toolkit';
+ *
+ * export default class MyApplicationCustomizer extends BaseApplicationCustomizer<IMyProps> {
+ *   public onInit(): Promise<void> {
+ *     // Create a placeholder for your customizer
+ *     const placeholder = this.context.placeholderProvider.tryCreateContent(
+ *       PlaceholderName.Top
+ *     );
+ *
+ *     if (placeholder) {
+ *       const element = React.createElement(
+ *         SPFxApplicationCustomizerProvider,
+ *         { instance: this },
+ *         React.createElement(MyComponent)
+ *       );
+ *       ReactDom.render(element, placeholder.domElement);
+ *     }
+ *
+ *     return Promise.resolve();
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function SPFxApplicationCustomizerProvider<TProps extends {} = {}>(props: SPFxApplicationCustomizerProviderProps<TProps>): JSX.Element;
+//# sourceMappingURL=provider-application-customizer.d.ts.map

package/lib/core/provider-application-customizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-application-customizer.d.ts","sourceRoot":"","sources":["../../src/core/provider-application-customizer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAGhF;;;;;GAKG;AACH,MAAM,WAAW,sCAAsC,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE;IAC5E;;OAEG;IACH,QAAQ,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAC;IAE5C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACtE,KAAK,EAAE,sCAAsC,CAAC,MAAM,CAAC,GACpD,GAAG,CAAC,OAAO,CAEb"}

package/lib/core/provider-application-customizer.js

@@ -0,0 +1,45 @@
+// provider-application-customizer.tsx
+// Type-safe provider for Application Customizers
+import * as React from 'react';
+import { SPFxProviderBase } from './provider-base.internal';
+/**
+ * SPFx context provider specifically for Application Customizers.
+ *
+ * This is a type-safe wrapper around the base provider that accepts an Application Customizer instance
+ * directly without requiring type casting. Use this provider in Application Customizers instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxApplicationCustomizerProvider } from 'spfx-react-toolkit';
+ *
+ * export default class MyApplicationCustomizer extends BaseApplicationCustomizer<IMyProps> {
+ *   public onInit(): Promise<void> {
+ *     // Create a placeholder for your customizer
+ *     const placeholder = this.context.placeholderProvider.tryCreateContent(
+ *       PlaceholderName.Top
+ *     );
+ *
+ *     if (placeholder) {
+ *       const element = React.createElement(
+ *         SPFxApplicationCustomizerProvider,
+ *         { instance: this },
+ *         React.createElement(MyComponent)
+ *       );
+ *       ReactDom.render(element, placeholder.domElement);
+ *     }
+ *
+ *     return Promise.resolve();
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export function SPFxApplicationCustomizerProvider(props) {
+    return React.createElement(SPFxProviderBase, { instance: props.instance }, props.children);
+}
+//# sourceMappingURL=provider-application-customizer.js.map

package/lib/core/provider-application-customizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-application-customizer.js","sourceRoot":"","sources":["../../src/core/provider-application-customizer.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iDAAiD;AAEjD,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAoB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,iCAAiC,CAC/C,KAAqD;IAErD,OAAO,oBAAC,gBAAgB,IAAC,QAAQ,EAAE,KAAK,CAAC,QAAiB,IAAG,KAAK,CAAC,QAAQ,CAAoB,CAAC;AAClG,CAAC"}

package/lib/core/provider-base.internal.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="react" />
+import type { SPFxProviderProps } from './types';
+/**
+ * SPFxProviderBase - Internal base provider with shared logic
+ *
+ * Creates an isolated Jotai store for each instance, ensuring complete
+ * state isolation between multiple SPFx components on the same page.
+ *
+ * DO NOT use directly - use type-specific providers instead:
+ * - SPFxWebPartProvider
+ * - SPFxApplicationCustomizerProvider
+ * - SPFxListViewCommandSetProvider
+ * - SPFxFieldCustomizerProvider
+ *
+ * Or use the generic SPFxProvider for backward compatibility.
+ *
+ * @internal
+ */
+export declare function SPFxProviderBase<TProps extends {} = {}>(props: SPFxProviderProps<TProps>): JSX.Element;
+//# sourceMappingURL=provider-base.internal.d.ts.map

package/lib/core/provider-base.internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-base.internal.d.ts","sourceRoot":"","sources":["../../src/core/provider-base.internal.tsx"],"names":[],"mappings":";AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,SAAS,CAAC;AAOnE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACrD,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAC/B,GAAG,CAAC,OAAO,CAgIb"}

package/lib/core/provider-base.internal.js

@@ -0,0 +1,126 @@
+// provider-base.tsx
+// SPFxProviderBase - Internal base implementation with shared logic
+import * as React from 'react';
+import { Provider, createStore, useSetAtom, useAtomValue } from 'jotai';
+import { SPFxContext } from './context.internal';
+import { spfxAtoms } from './atoms.internal';
+import { detectComponentKind, isWebPart, } from '../utils/type-guards.internal';
+import { useThemeSubscription } from '../utils/theme-subscription.internal';
+/**
+ * SPFxProviderBase - Internal base provider with shared logic
+ *
+ * Creates an isolated Jotai store for each instance, ensuring complete
+ * state isolation between multiple SPFx components on the same page.
+ *
+ * DO NOT use directly - use type-specific providers instead:
+ * - SPFxWebPartProvider
+ * - SPFxApplicationCustomizerProvider
+ * - SPFxListViewCommandSetProvider
+ * - SPFxFieldCustomizerProvider
+ *
+ * Or use the generic SPFxProvider for backward compatibility.
+ *
+ * @internal
+ */
+export function SPFxProviderBase(props) {
+    var instance = props.instance, children = props.children;
+    // Cast to 'any' to access protected/private properties
+    // This is safe because we're inside the provider and know the structure
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    var instanceAny = instance;
+    // Detect component kind (WebPart, AppCustomizer, etc.)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    var kind = React.useMemo(function () { return detectComponentKind(instance); }, [instance]);
+    // Extract context (BaseComponentContext - has instanceId)
+    var context = instanceAny.context;
+    // Extract instanceId type-safe (all SPFx contexts extend BaseComponentContext)
+    var instanceId = React.useMemo(function () { return context.instanceId; }, [context]);
+    // Create isolated Jotai store for this Provider instance
+    // Each store is independent, ensuring complete state isolation
+    var store = React.useMemo(function () { return createStore(); }, []);
+    // Get atom setters (using the isolated store)
+    var setProperties = useSetAtom(spfxAtoms.properties, { store: store });
+    var setDisplayMode = useSetAtom(spfxAtoms.displayMode, { store: store });
+    var setContainerEl = useSetAtom(spfxAtoms.containerEl, { store: store });
+    var setTheme = useSetAtom(spfxAtoms.theme, { store: store });
+    // Ref to track last known properties value (prevents loop)
+    var lastPropertiesRef = React.useRef(instanceAny.properties);
+    // Subscribe to theme changes (single subscription per instance)
+    useThemeSubscription(context, setTheme);
+    // Initialize atoms based on component type
+    React.useEffect(function () {
+        // Properties (common to all)
+        setProperties(instanceAny.properties);
+        lastPropertiesRef.current = instanceAny.properties;
+        // WebPart-specific
+        if (isWebPart(instance)) {
+            setDisplayMode(instanceAny.displayMode);
+            setContainerEl(instanceAny.domElement);
+        }
+    }, [
+        instance,
+        instanceAny,
+        setProperties,
+        setDisplayMode,
+        setContainerEl,
+    ]);
+    // Sync properties when they change (SPFx → Atom)
+    // Property Pane changes will trigger this via instance.properties reference change
+    React.useEffect(function () {
+        if (instanceAny.properties !== lastPropertiesRef.current) {
+            setProperties(instanceAny.properties);
+            lastPropertiesRef.current = instanceAny.properties;
+        }
+    }, [instanceAny.properties, setProperties, instanceAny]);
+    // Sync properties when atom changes (Atom → SPFx)
+    // Hook updates will trigger this via atom subscription
+    var properties = useAtomValue(spfxAtoms.properties, { store: store });
+    React.useEffect(function () {
+        // Guard: Don't sync if atom is still undefined (initial state before initialization)
+        // This prevents race condition where useAtomValue reads before initialization useEffect runs
+        if (properties === undefined) {
+            return;
+        }
+        // Only sync if atom value is different from last known value
+        if (properties !== lastPropertiesRef.current) {
+            // Mutate SPFx properties object (copy all properties from atom to instance)
+            var target = instanceAny.properties;
+            var source = properties;
+            // Clear existing properties
+            for (var key in target) {
+                if (Object.prototype.hasOwnProperty.call(target, key)) {
+                    delete target[key];
+                }
+            }
+            // Copy new properties
+            for (var key in source) {
+                if (Object.prototype.hasOwnProperty.call(source, key)) {
+                    target[key] = source[key];
+                }
+            }
+            lastPropertiesRef.current = properties;
+            // Refresh Property Pane for WebParts (if propertyPane exists)
+            if (isWebPart(instance)) {
+                var ctx = instanceAny.context;
+                if (ctx.propertyPane && typeof ctx.propertyPane.refresh === 'function') {
+                    ctx.propertyPane.refresh();
+                }
+            }
+        }
+    }, [properties, instance, instanceAny]);
+    // WebPart: Sync displayMode when it changes
+    React.useEffect(function () {
+        if (isWebPart(instance)) {
+            setDisplayMode(instanceAny.displayMode);
+        }
+    }, [instance, instanceAny, setDisplayMode]);
+    // Create context value (memoized to prevent re-renders)
+    var contextValue = React.useMemo(function () { return ({
+        instanceId: instanceId,
+        spfxContext: context,
+        kind: kind,
+    }); }, [instanceId, context, kind]);
+    return (React.createElement(Provider, { store: store },
+        React.createElement(SPFxContext.Provider, { value: contextValue }, children)));
+}
+//# sourceMappingURL=provider-base.internal.js.map

package/lib/core/provider-base.internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-base.internal.js","sourceRoot":"","sources":["../../src/core/provider-base.internal.tsx"],"names":[],"mappings":"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"}

package/lib/core/provider-field-customizer.d.ts

@@ -0,0 +1,58 @@
+import * as React from 'react';
+import type { BaseFieldCustomizer } from '@microsoft/sp-listview-extensibility';
+/**
+ * Props for the SPFx Field Customizer-specific provider component.
+ *
+ * @template TProps - The properties type for the Field Customizer.
+ * @public
+ */
+export interface SPFxFieldCustomizerProviderProps<TProps extends {} = {}> {
+    /**
+     * The SPFx Field Customizer instance.
+     */
+    instance: BaseFieldCustomizer<TProps>;
+    /**
+     * The children to render within the provider.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * SPFx context provider specifically for Field Customizers.
+ *
+ * This is a type-safe wrapper around the base provider that accepts a Field Customizer instance
+ * directly without requiring type casting. Use this provider in Field Customizers instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxFieldCustomizerProvider } from 'spfx-react-toolkit';
+ * import * as ReactDom from 'react-dom';
+ *
+ * export default class MyFieldCustomizer extends BaseFieldCustomizer<IMyProps> {
+ *   public onRenderCell(event: IFieldCustomizerCellEventParameters): void {
+ *     const element = React.createElement(
+ *       SPFxFieldCustomizerProvider,
+ *       { instance: this },
+ *       React.createElement(MyFieldRenderer, {
+ *         value: event.fieldValue,
+ *         listItem: event.listItem
+ *       })
+ *     );
+ *
+ *     ReactDom.render(element, event.domElement);
+ *   }
+ *
+ *   public onDisposeCell(event: IFieldCustomizerCellEventParameters): void {
+ *     ReactDom.unmountComponentAtNode(event.domElement);
+ *     super.onDisposeCell(event);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function SPFxFieldCustomizerProvider<TProps extends {} = {}>(props: SPFxFieldCustomizerProviderProps<TProps>): JSX.Element;
+//# sourceMappingURL=provider-field-customizer.d.ts.map

package/lib/core/provider-field-customizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-field-customizer.d.ts","sourceRoot":"","sources":["../../src/core/provider-field-customizer.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAGhF;;;;;GAKG;AACH,MAAM,WAAW,gCAAgC,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE;IACtE;;OAEG;IACH,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EAChE,KAAK,EAAE,gCAAgC,CAAC,MAAM,CAAC,GAC9C,GAAG,CAAC,OAAO,CAEb"}

package/lib/core/provider-field-customizer.js

@@ -0,0 +1,46 @@
+// provider-field-customizer.tsx
+// Type-safe provider for Field Customizers
+import * as React from 'react';
+import { SPFxProviderBase } from './provider-base.internal';
+/**
+ * SPFx context provider specifically for Field Customizers.
+ *
+ * This is a type-safe wrapper around the base provider that accepts a Field Customizer instance
+ * directly without requiring type casting. Use this provider in Field Customizers instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxFieldCustomizerProvider } from 'spfx-react-toolkit';
+ * import * as ReactDom from 'react-dom';
+ *
+ * export default class MyFieldCustomizer extends BaseFieldCustomizer<IMyProps> {
+ *   public onRenderCell(event: IFieldCustomizerCellEventParameters): void {
+ *     const element = React.createElement(
+ *       SPFxFieldCustomizerProvider,
+ *       { instance: this },
+ *       React.createElement(MyFieldRenderer, {
+ *         value: event.fieldValue,
+ *         listItem: event.listItem
+ *       })
+ *     );
+ *
+ *     ReactDom.render(element, event.domElement);
+ *   }
+ *
+ *   public onDisposeCell(event: IFieldCustomizerCellEventParameters): void {
+ *     ReactDom.unmountComponentAtNode(event.domElement);
+ *     super.onDisposeCell(event);
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export function SPFxFieldCustomizerProvider(props) {
+    return React.createElement(SPFxProviderBase, { instance: props.instance }, props.children);
+}
+//# sourceMappingURL=provider-field-customizer.js.map

package/lib/core/provider-field-customizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-field-customizer.js","sourceRoot":"","sources":["../../src/core/provider-field-customizer.tsx"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,2CAA2C;AAE3C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAoB5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAA+C;IAE/C,OAAO,oBAAC,gBAAgB,IAAC,QAAQ,EAAE,KAAK,CAAC,QAAiB,IAAG,KAAK,CAAC,QAAQ,CAAoB,CAAC;AAClG,CAAC"}

package/lib/core/provider-listview-commandset.d.ts

@@ -0,0 +1,60 @@
+import * as React from 'react';
+import type { BaseListViewCommandSet } from '@microsoft/sp-listview-extensibility';
+/**
+ * Props for the SPFx ListView Command Set-specific provider component.
+ *
+ * @template TProps - The properties type for the ListView Command Set.
+ * @public
+ */
+export interface SPFxListViewCommandSetProviderProps<TProps extends {} = {}> {
+    /**
+     * The SPFx ListView Command Set instance.
+     */
+    instance: BaseListViewCommandSet<TProps>;
+    /**
+     * The children to render within the provider.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * SPFx context provider specifically for ListView Command Sets.
+ *
+ * This is a type-safe wrapper around the base provider that accepts a ListView Command Set instance
+ * directly without requiring type casting. Use this provider in ListView Command Sets instead of the
+ * generic `SPFxProvider`.
+ *
+ * @param props - The component props.
+ * @returns The provider component.
+ *
+ * @example
+ * ```tsx
+ * import { SPFxListViewCommandSetProvider } from 'spfx-react-toolkit';
+ * import { Dialog } from '@microsoft/sp-dialog';
+ *
+ * export default class MyCommandSet extends BaseListViewCommandSet<IMyProps> {
+ *   public onExecute(event: IListViewCommandSetExecuteEventParameters): void {
+ *     switch (event.itemId) {
+ *       case 'COMMAND_1':
+ *         // Create a dialog container
+ *         const dialog = Dialog.alert({
+ *           title: 'Custom Dialog',
+ *           message: this._renderDialog()
+ *         });
+ *         break;
+ *     }
+ *   }
+ *
+ *   private _renderDialog(): React.ReactElement {
+ *     return React.createElement(
+ *       SPFxListViewCommandSetProvider,
+ *       { instance: this },
+ *       React.createElement(MyComponent)
+ *     );
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function SPFxListViewCommandSetProvider<TProps extends {} = {}>(props: SPFxListViewCommandSetProviderProps<TProps>): JSX.Element;
+//# sourceMappingURL=provider-listview-commandset.d.ts.map

package/lib/core/provider-listview-commandset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-listview-commandset.d.ts","sourceRoot":"","sources":["../../src/core/provider-listview-commandset.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAGnF;;;;;GAKG;AACH,MAAM,WAAW,mCAAmC,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE;IACzE;;OAEG;IACH,QAAQ,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,SAAS,EAAE,GAAG,EAAE,EACnE,KAAK,EAAE,mCAAmC,CAAC,MAAM,CAAC,GACjD,GAAG,CAAC,OAAO,CAEb"}