@pnp/spfx-controls-react 3.25.0 → 3.26.0-beta.3380159

package/lib/controls/SPFilePicker/ISPFilePickerProps.d.ts

@@ -0,0 +1,80 @@
+import type { MouseEventHandler, ReactElement } from 'react';
+import type { WebPartContext } from '@microsoft/sp-webpart-base';
+import type { ISPFilePickerEntry, ISPFilePickerError, ISPFilePickerItem, SPFilePickerAuthMode, SPFilePickerItemsMode, SPFilePickerSelectionMode, SPFilePickerTarget, SPFilePickerTokenResolver } from './ISPFilePicker.types';
+export interface ISPFilePickerTriggerProps {
+    'aria-disabled'?: boolean;
+    className?: string;
+    onClick?: MouseEventHandler<HTMLElement>;
+}
+/**
+ * Props for the ready-to-use {@link SPFilePicker} component.
+ *
+ * The component renders a trigger button that opens the SharePoint / OneDrive
+ * File Picker (v8) inside a modal dialog (iframe) or a popup window. For full
+ * control over the surface, use the {@link useSPFilePicker} hook directly.
+ */
+export interface ISPFilePickerProps {
+    /**
+     * The SPFx web part context. Used to resolve the default `baseUrl` from
+     * `pageContext.web.absoluteUrl` and to acquire SharePoint access tokens via
+     * the `aadTokenProviderFactory` when no custom `getToken` is supplied.
+     */
+    context: WebPartContext;
+    /**
+     * SharePoint web URL used as the picker host and token resource. When omitted,
+     * the component falls back to `context.pageContext.web.absoluteUrl`.
+     */
+    baseUrl?: string;
+    /** Picker entry point. Defaults to `{ sharePoint: {} }`. */
+    entry?: ISPFilePickerEntry;
+    /** Selection mode. Defaults to `single`. */
+    selectionMode?: SPFilePickerSelectionMode;
+    /** Kind of items that can be picked. Defaults to `files`. */
+    itemsMode?: SPFilePickerItemsMode;
+    /** Allowed file extensions (without the dot), e.g. `['docx', 'pdf']`. */
+    fileTypes?: string[];
+    /** Locale / LCID for the picker UI. Defaults to `en-us`. */
+    locale?: string;
+    /**
+     * How the picker authenticates. Defaults to `token` (SharePoint bearer tokens
+     * via the SPFx `aadTokenProviderFactory` or a custom `getToken`), which is
+     * REQUIRED for the iframe target and is the correct mode for SPFx web parts.
+     * Use `cookie` only with the popup window target (`target: 'window'`).
+     */
+    authMode?: SPFilePickerAuthMode;
+    /** Hosting app identifier (query string `app`). Not set by default. */
+    app?: string;
+    /** Picker scenario (query string `scenario`). Not set by default. */
+    scenario?: string;
+    /** Where the picker is hosted. Defaults to `iframe` (rendered in a dialog). */
+    target?: SPFilePickerTarget;
+    /**
+     * Custom token resolver. When omitted, the SPFx `aadTokenProviderFactory`
+     * from `context` is used to acquire a token for the SharePoint resource.
+     */
+    getToken?: SPFilePickerTokenResolver;
+    /** Fired with the picked items when the user confirms a selection. */
+    onPicked: (items: ISPFilePickerItem[]) => void;
+    /** Fired when the picker is cancelled / closed without a selection. */
+    onCancel?: () => void;
+    /** Fired when an error occurs during the picker workflow. */
+    onError?: (error: ISPFilePickerError) => void;
+    /**
+     * Custom interactive trigger element. When provided it replaces the default
+     * button and receives an `onClick` handler that opens the picker.
+     */
+    trigger?: ReactElement<ISPFilePickerTriggerProps>;
+    /** Text for the default trigger button. Defaults to `Select from SharePoint`. */
+    buttonText?: string;
+    /** Accessible title applied to the picker iframe. Defaults to `Select a file`. */
+    dialogTitle?: string;
+    /** Disable the trigger. */
+    disabled?: boolean;
+    /** Dialog width in px (iframe target). Defaults to `1080`. */
+    dialogWidth?: number;
+    /** Dialog / iframe height in px (iframe target). Defaults to `680`. */
+    dialogHeight?: number;
+    /** Additional CSS class applied to the trigger element. */
+    className?: string;
+}
+//# sourceMappingURL=ISPFilePickerProps.d.ts.map

package/lib/controls/SPFilePicker/ISPFilePickerProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISPFilePickerProps.d.ts","sourceRoot":"","sources":["../../../src/controls/SPFilePicker/ISPFilePickerProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,yBAAyB;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAE3B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAE1C,6DAA6D;IAC7D,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAElC,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAGrC,sEAAsE;IACtE,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;IAE/C,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAG9C;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,yBAAyB,CAAC,CAAC;IAElD,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/lib/controls/SPFilePicker/ISPFilePickerProps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ISPFilePickerProps.js.map

package/lib/controls/SPFilePicker/ISPFilePickerProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISPFilePickerProps.js","sourceRoot":"","sources":["../../../src/controls/SPFilePicker/ISPFilePickerProps.ts"],"names":[],"mappings":""}

package/lib/controls/SPFilePicker/SPFilePicker.d.ts

@@ -0,0 +1,22 @@
+import * as React from 'react';
+import type { ISPFilePickerProps } from './ISPFilePickerProps';
+/**
+ * Ready-to-use SharePoint / OneDrive File Picker (SDK v8) control.
+ *
+ * Renders a trigger button that opens the Microsoft-hosted file picker inside a
+ * modal dialog (iframe) or a popup window, and returns the selected items via
+ * `onPicked`. Tokens are resolved through the SPFx `context`
+ * (`aadTokenProviderFactory`) or a custom `getToken`.
+ *
+ * @example
+ * ```tsx
+ * <SPFilePicker
+ *   context={this.context}
+ *   selectionMode="multiple"
+ *   fileTypes={['docx', 'pdf']}
+ *   onPicked={(items) => setFiles(items)}
+ * />
+ * ```
+ */
+export declare const SPFilePicker: React.FunctionComponent<ISPFilePickerProps>;
+//# sourceMappingURL=SPFilePicker.d.ts.map

package/lib/controls/SPFilePicker/SPFilePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SPFilePicker.d.ts","sourceRoot":"","sources":["../../../src/controls/SPFilePicker/SPFilePicker.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM/D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,kBAAkB,CAoHpE,CAAC"}

package/lib/controls/SPFilePicker/SPFilePicker.js

@@ -0,0 +1,83 @@
+import * as React from 'react';
+import { Button, Dialog, DialogSurface, mergeClasses, Spinner, } from '@fluentui/react-components';
+import { useSPFilePicker } from './hooks/useSPFilePicker';
+import { useSPFilePickerStyles } from './useSPFilePickerStyles';
+import * as strings from 'ControlStrings';
+var DEFAULT_WIDTH = 1080;
+var DEFAULT_HEIGHT = 680;
+/**
+ * Ready-to-use SharePoint / OneDrive File Picker (SDK v8) control.
+ *
+ * Renders a trigger button that opens the Microsoft-hosted file picker inside a
+ * modal dialog (iframe) or a popup window, and returns the selected items via
+ * `onPicked`. Tokens are resolved through the SPFx `context`
+ * (`aadTokenProviderFactory`) or a custom `getToken`.
+ *
+ * @example
+ * ```tsx
+ * <SPFilePicker
+ *   context={this.context}
+ *   selectionMode="multiple"
+ *   fileTypes={['docx', 'pdf']}
+ *   onPicked={(items) => setFiles(items)}
+ * />
+ * ```
+ */
+export var SPFilePicker = function (props) {
+    var _a;
+    var context = props.context, baseUrl = props.baseUrl, entry = props.entry, _b = props.selectionMode, selectionMode = _b === void 0 ? 'single' : _b, _c = props.itemsMode, itemsMode = _c === void 0 ? 'files' : _c, fileTypes = props.fileTypes, locale = props.locale, authMode = props.authMode, app = props.app, scenario = props.scenario, _d = props.target, target = _d === void 0 ? 'iframe' : _d, getToken = props.getToken, onPicked = props.onPicked, onCancel = props.onCancel, onError = props.onError, trigger = props.trigger, _e = props.buttonText, buttonText = _e === void 0 ? strings.SPFilePickerButtonText : _e, _f = props.dialogTitle, dialogTitle = _f === void 0 ? strings.SPFilePickerDialogTitle : _f, _g = props.disabled, disabled = _g === void 0 ? false : _g, _h = props.dialogWidth, dialogWidth = _h === void 0 ? DEFAULT_WIDTH : _h, _j = props.dialogHeight, dialogHeight = _j === void 0 ? DEFAULT_HEIGHT : _j, className = props.className;
+    var resolvedBaseUrl = (_a = baseUrl !== null && baseUrl !== void 0 ? baseUrl : context.pageContext.web.absoluteUrl) !== null && _a !== void 0 ? _a : '';
+    var styles = useSPFilePickerStyles(dialogHeight);
+    var _k = useSPFilePicker({
+        context: context,
+        baseUrl: resolvedBaseUrl,
+        entry: entry,
+        selectionMode: selectionMode,
+        itemsMode: itemsMode,
+        fileTypes: fileTypes,
+        locale: locale,
+        authMode: authMode,
+        app: app,
+        scenario: scenario,
+        target: target,
+        getToken: getToken,
+        onPicked: onPicked,
+        onCancel: onCancel,
+        onError: onError,
+    }), isOpen = _k.isOpen, isLoading = _k.isLoading, iframeRef = _k.iframeRef, open = _k.open, close = _k.close, markLoaded = _k.markLoaded;
+    var renderTrigger = function () {
+        if (trigger) {
+            var triggerOnClick_1 = trigger.props.onClick;
+            return React.cloneElement(trigger, {
+                'aria-disabled': disabled || undefined,
+                className: mergeClasses(trigger.props.className, className),
+                onClick: function (event) {
+                    if (disabled) {
+                        event.preventDefault();
+                        return;
+                    }
+                    triggerOnClick_1 === null || triggerOnClick_1 === void 0 ? void 0 : triggerOnClick_1(event);
+                    if (!event.defaultPrevented) {
+                        open();
+                    }
+                },
+            });
+        }
+        return (React.createElement(Button, { className: className, appearance: "primary", disabled: disabled || !resolvedBaseUrl, onClick: open }, buttonText));
+    };
+    return (React.createElement(React.Fragment, null,
+        renderTrigger(),
+        target === 'iframe' && (React.createElement(Dialog, { open: isOpen, modalType: "modal", onOpenChange: function (_event, data) {
+                if (!data.open) {
+                    onCancel === null || onCancel === void 0 ? void 0 : onCancel();
+                    close();
+                }
+            } },
+            React.createElement(DialogSurface, { className: styles.dialogSurface, style: { maxWidth: dialogWidth, width: dialogWidth } },
+                React.createElement("div", { className: styles.iframeWrapper },
+                    isLoading && (React.createElement("div", { className: styles.spinnerOverlay },
+                        React.createElement(Spinner, { size: "large" }))),
+                    React.createElement("iframe", { ref: iframeRef, className: styles.iframe, title: dialogTitle, onLoad: markLoaded })))))));
+};
+SPFilePicker.displayName = 'SPFilePicker';
+//# sourceMappingURL=SPFilePicker.js.map

package/lib/controls/SPFilePicker/SPFilePicker.js.map

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

package/lib/controls/SPFilePicker/hooks/SPFilePicker.helpers.d.ts

@@ -0,0 +1,20 @@
+import type { ISPFilePickerEntry, ISPFilePickerRawConfiguration, SPFilePickerAuthMode, SPFilePickerItemsMode, SPFilePickerSelectionMode } from '../ISPFilePicker.types';
+export interface IBuildSPFilePickerConfigurationOptions {
+    channelId: string;
+    parentOrigin: string;
+    entry?: ISPFilePickerEntry;
+    selectionMode: SPFilePickerSelectionMode;
+    itemsMode: SPFilePickerItemsMode;
+    fileTypes?: string[];
+    authMode: SPFilePickerAuthMode;
+    raw?: Partial<ISPFilePickerRawConfiguration>;
+}
+export interface ISPFilePickerInitializeEvent {
+    data: unknown;
+    origin: string;
+    source: MessageEvent['source'];
+}
+export declare function buildSPFilePickerConfiguration(options: IBuildSPFilePickerConfigurationOptions): ISPFilePickerRawConfiguration;
+export declare function isExpectedPickerInitializeEvent(event: ISPFilePickerInitializeEvent, pickerWindow: Window, channelId: string, expectedOrigin: string): boolean;
+export declare function requireAccessToken(accessToken: string, errorMessage: string): string;
+//# sourceMappingURL=SPFilePicker.helpers.d.ts.map

package/lib/controls/SPFilePicker/hooks/SPFilePicker.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SPFilePicker.helpers.d.ts","sourceRoot":"","sources":["../../../../src/controls/SPFilePicker/hooks/SPFilePicker.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,sCAAsC;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,aAAa,EAAE,yBAAyB,CAAC;IACzC,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,CAAC,EAAE,OAAO,CAAC,6BAA6B,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CAChC;AAQD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,sCAAsC,GAC9C,6BAA6B,CA6B/B;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,4BAA4B,EACnC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAWT;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAMpF"}

package/lib/controls/SPFilePicker/hooks/SPFilePicker.helpers.js

@@ -0,0 +1,27 @@
+import { __assign } from "tslib";
+var SDK_VERSION = '8.0';
+function isInitializeMessageData(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function buildSPFilePickerConfiguration(options) {
+    var channelId = options.channelId, parentOrigin = options.parentOrigin, entry = options.entry, selectionMode = options.selectionMode, itemsMode = options.itemsMode, fileTypes = options.fileTypes, authMode = options.authMode, raw = options.raw;
+    var useCookies = authMode === 'cookie';
+    var configuration = __assign(__assign({ sdk: SDK_VERSION, entry: entry !== null && entry !== void 0 ? entry : { sharePoint: {} } }, (useCookies ? {} : { authentication: {} })), { messaging: __assign({ origin: parentOrigin, channelId: channelId }, (useCookies ? { identifyParent: true } : {})), selection: { mode: selectionMode }, typesAndSources: __assign({ mode: itemsMode }, (fileTypes && fileTypes.length > 0 ? { filters: fileTypes } : {})) });
+    return Object.assign(configuration, raw !== null && raw !== void 0 ? raw : {});
+}
+export function isExpectedPickerInitializeEvent(event, pickerWindow, channelId, expectedOrigin) {
+    if (!isInitializeMessageData(event.data)) {
+        return false;
+    }
+    return (event.origin === expectedOrigin &&
+        event.source === pickerWindow &&
+        event.data.type === 'initialize' &&
+        event.data.channelId === channelId);
+}
+export function requireAccessToken(accessToken, errorMessage) {
+    if (!accessToken) {
+        throw new Error(errorMessage);
+    }
+    return accessToken;
+}
+//# sourceMappingURL=SPFilePicker.helpers.js.map

package/lib/controls/SPFilePicker/hooks/SPFilePicker.helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SPFilePicker.helpers.js","sourceRoot":"","sources":["../../../../src/controls/SPFilePicker/hooks/SPFilePicker.helpers.ts"],"names":[],"mappings":";AAQA,IAAM,WAAW,GAAG,KAAK,CAAC;AAmB1B,SAAS,uBAAuB,CAC9B,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,OAA+C;IAG7C,IAAA,SAAS,GAQP,OAAO,UARA,EACT,YAAY,GAOV,OAAO,aAPG,EACZ,KAAK,GAMH,OAAO,MANJ,EACL,aAAa,GAKX,OAAO,cALI,EACb,SAAS,GAIP,OAAO,UAJA,EACT,SAAS,GAGP,OAAO,UAHA,EACT,QAAQ,GAEN,OAAO,SAFD,EACR,GAAG,GACD,OAAO,IADN,CACO;IACZ,IAAM,UAAU,GAAG,QAAQ,KAAK,QAAQ,CAAC;IACzC,IAAM,aAAa,uBACjB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAC/B,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,KAC7C,SAAS,aACP,MAAM,EAAE,YAAY,EACpB,SAAS,WAAA,IACN,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAEjD,SAAS,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,EAClC,eAAe,aACb,IAAI,EAAE,SAAS,IACZ,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAEvE,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,KAAmC,EACnC,YAAoB,EACpB,SAAiB,EACjB,cAAsB;IAEtB,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,cAAc;QAC/B,KAAK,CAAC,MAAM,KAAK,YAAY;QAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,YAAY;QAChC,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,YAAoB;IAC1E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/lib/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SPFilePicker.helpers.test.d.ts.map

package/lib/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SPFilePicker.helpers.test.d.ts","sourceRoot":"","sources":["../../../../src/controls/SPFilePicker/hooks/SPFilePicker.helpers.test.ts"],"names":[],"mappings":""}

package/lib/controls/SPFilePicker/hooks/useLogging.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Return value of {@link useLogging}.
+ */
+export interface IUseLoggingReturn {
+    /** Logs an informational message. */
+    info: (message: string) => void;
+    /** Logs a warning message. */
+    warn: (message: string) => void;
+    /** Logs an error (string message or `Error`). */
+    error: (message: string | Error) => void;
+    /** Logs a verbose/debug message. */
+    verbose: (message: string) => void;
+}
+/**
+ * Thin logging hook built on the SPFx {@link Log} API. It provides a stable,
+ * memoized logger scoped to a source name, with no external dependencies.
+ *
+ * @param source - Log source shown in the SPFx diagnostics. Defaults to `SPFilePicker`.
+ *
+ * @example
+ * ```ts
+ * const { info, error } = useLogging();
+ * info('picker launched');
+ * error(new Error('token failed'));
+ * ```
+ */
+export declare function useLogging(source?: string): IUseLoggingReturn;
+//# sourceMappingURL=useLogging.d.ts.map

package/lib/controls/SPFilePicker/hooks/useLogging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogging.d.ts","sourceRoot":"","sources":["../../../../src/controls/SPFilePicker/hooks/useLogging.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,8BAA8B;IAC9B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC,iDAAiD;IACjD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,KAAK,IAAI,CAAC;IAEzC,oCAAoC;IACpC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,MAAuB,GAAG,iBAAiB,CAW7E"}

package/lib/controls/SPFilePicker/hooks/useLogging.js

@@ -0,0 +1,28 @@
+import { useMemo } from 'react';
+import { Log } from '@microsoft/sp-core-library';
+var DEFAULT_SOURCE = 'SPFilePicker';
+/**
+ * Thin logging hook built on the SPFx {@link Log} API. It provides a stable,
+ * memoized logger scoped to a source name, with no external dependencies.
+ *
+ * @param source - Log source shown in the SPFx diagnostics. Defaults to `SPFilePicker`.
+ *
+ * @example
+ * ```ts
+ * const { info, error } = useLogging();
+ * info('picker launched');
+ * error(new Error('token failed'));
+ * ```
+ */
+export function useLogging(source) {
+    if (source === void 0) { source = DEFAULT_SOURCE; }
+    return useMemo(function () { return ({
+        info: function (message) { return Log.info(source, message); },
+        warn: function (message) { return Log.warn(source, message); },
+        error: function (message) {
+            return Log.error(source, message instanceof Error ? message : new Error(message));
+        },
+        verbose: function (message) { return Log.verbose(source, message); },
+    }); }, [source]);
+}
+//# sourceMappingURL=useLogging.js.map

package/lib/controls/SPFilePicker/hooks/useLogging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogging.js","sourceRoot":"","sources":["../../../../src/controls/SPFilePicker/hooks/useLogging.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAEjD,IAAM,cAAc,GAAG,cAAc,CAAC;AAmBtC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,MAA+B;IAA/B,uBAAA,EAAA,uBAA+B;IACxD,OAAO,OAAO,CACZ,cAAM,OAAA,CAAC;QACL,IAAI,EAAE,UAAC,OAAe,IAAK,OAAA,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAzB,CAAyB;QACpD,IAAI,EAAE,UAAC,OAAe,IAAK,OAAA,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAzB,CAAyB;QACpD,KAAK,EAAE,UAAC,OAAuB;YAC7B,OAAA,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QAA1E,CAA0E;QAC5E,OAAO,EAAE,UAAC,OAAe,IAAK,OAAA,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAA5B,CAA4B;KAC3D,CAAC,EANI,CAMJ,EACF,CAAC,MAAM,CAAC,CACT,CAAC;AACJ,CAAC"}

package/lib/controls/SPFilePicker/hooks/useSPFilePicker.d.ts

@@ -0,0 +1,68 @@
+import type { WebPartContext } from '@microsoft/sp-webpart-base';
+import type { ISPFilePickerConfig, ISPFilePickerError, ISPFilePickerItem, SPFilePickerTarget, SPFilePickerTokenResolver } from '../ISPFilePicker.types';
+/**
+ * Options accepted by {@link useSPFilePicker}.
+ */
+export interface IUseSPFilePickerOptions extends ISPFilePickerConfig {
+    /** The SPFx web part context used for token acquisition. */
+    context: WebPartContext;
+    /** Where the picker is hosted. Defaults to `iframe`. */
+    target?: SPFilePickerTarget;
+    /**
+     * Optional custom token resolver. When omitted, the hook uses the SPFx
+     * `aadTokenProviderFactory` from `context` to acquire a token for the
+     * SharePoint host origin.
+     */
+    getToken?: SPFilePickerTokenResolver;
+    /** Fired with the picked items when the user confirms a selection. */
+    onPicked?: (items: ISPFilePickerItem[]) => void;
+    /** Fired when the picker is cancelled / closed without a selection. */
+    onCancel?: () => void;
+    /** Fired when an error occurs during the picker workflow. */
+    onError?: (error: ISPFilePickerError) => void;
+}
+/**
+ * Return value of {@link useSPFilePicker}.
+ */
+export interface IUseSPFilePickerReturn {
+    /** Whether the picker surface is currently open. */
+    isOpen: boolean;
+    /** Whether the picker is currently being launched / loading. */
+    isLoading: boolean;
+    /** The last error, if any. */
+    error: ISPFilePickerError | undefined;
+    /**
+     * Ref to attach to the hosting `<iframe>` element when `target === 'iframe'`.
+     * The consumer must render the iframe (e.g. inside a dialog) while `isOpen`.
+     */
+    iframeRef: React.RefObject<HTMLIFrameElement>;
+    /** Opens the picker. */
+    open: () => void;
+    /** Closes the picker and tears down messaging. */
+    close: () => void;
+    /**
+     * Clears the loading state. Attach to the hosting `<iframe onLoad>` so the
+     * loading overlay is removed once the picker page has loaded.
+     */
+    markLoaded: () => void;
+}
+/**
+ * Reusable engine hook that drives the SharePoint / OneDrive File Picker (v8).
+ *
+ * It encapsulates the full workflow — building the configuration, POSTing the
+ * form into the iframe (or popup), establishing the `MessageChannel`, and
+ * responding to the `authenticate`, `pick` and `close` commands — so any
+ * control can offer a SharePoint file picker with just a few lines.
+ *
+ * @example
+ * ```tsx
+ * const { isOpen, open, close, iframeRef } = useSPFilePicker({
+ *   baseUrl: context.pageContext.web.absoluteUrl,
+ *   selectionMode: 'multiple',
+ *   fileTypes: ['docx', 'pdf'],
+ *   onPicked: (items) => console.info(items),
+ * });
+ * ```
+ */
+export declare function useSPFilePicker(options: IUseSPFilePickerOptions): IUseSPFilePickerReturn;
+//# sourceMappingURL=useSPFilePicker.d.ts.map

package/lib/controls/SPFilePicker/hooks/useSPFilePicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSPFilePicker.d.ts","sourceRoot":"","sources":["../../../../src/controls/SPFilePicker/hooks/useSPFilePicker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAShC;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,mBAAmB;IAClE,4DAA4D;IAC5D,OAAO,EAAE,cAAc,CAAC;IAExB,wDAAwD;IACxD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IAErC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;IAEhD,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAEhB,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAC;IAEnB,8BAA8B;IAC9B,KAAK,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAEtC;;;OAGG;IACH,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAE9C,wBAAwB;IACxB,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,kDAAkD;IAClD,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB;;;OAGG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAoBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CAiWxF"}