@pristy/pristy-libvue 2.21.2 → 3.1.0

package/dist/stores/user.d.ts

@@ -0,0 +1,174 @@
+import { StoreDefinition, PiniaCustomStateProperties } from 'pinia';
+/**
+ * `useUserStore` is a Pinia store for managing user authentication, session, and related user data.
+ *
+ * The store includes state variables for managing user session details, actions for logging in and out,
+ * validating sessions, and interacting with the OIDC `AuthProvider` façade and Alfresco,
+ * as well as getters for computed properties like `displayName`.
+ *
+ * State:
+ * - `token` {string} - Stores the authentication token.
+ * - `isAdmin` {boolean} - Indicates whether the current user is an administrator.
+ * - `isLoggedIn` {boolean} - Tracks whether the user is currently logged in.
+ * - `person` {object|null} - Stores the person details of the logged-in user.
+ * - `homeFolder` {string|null} - Stores the user's home folder path.
+ *
+ * Getters:
+ * - `displayName` {string} - Returns the display name of the logged-in user, or an empty string if no user is logged in.
+ *
+ * Actions:
+ * - `logout` - Logs out the current user, clearing the local session and delegating to the auth provider.
+ * - `validateSession` - Checks if the client is logged in and retrieves the Alfresco ticket using the provider's Bearer token.
+ * - `connectKeycloak` - Redirects to the IdP via the auth provider for unauthenticated users, otherwise loads the current Person.
+ * - `completeLogin` - Consumes the IdP redirect via the auth provider and opens the Alfresco session.
+ * - `keycloakReady` - Subscribes to the auth provider's token-renewal and session-lost events, then retrieves the Alfresco ticket.
+ * - `getAlfTicket` - Logs into Alfresco with the Bearer token supplied by the auth provider and retrieves the Alfresco ticket.
+ * - `accountConsoleUrl` - Returns the IdP account console URL for a given section, via the auth provider.
+ * - `getPerson` - Retrieves the person details for the currently authenticated user.
+ * - `login` - Attempts to log in a user with a username and password.
+ * - `apiLogin` - Handles Basic Authentication with Alfresco.
+ * - `publiclogoff` - Logs off a public account if currently authenticated.
+ * - `publiclogin` - Logs in with a public account from a specified public workspace.
+ */
+export const useUserStore: StoreDefinition<"UserStore", {
+    token: string;
+    isAdmin: boolean;
+    isLoggedIn: boolean;
+    person: any;
+    homeFolder: any;
+    isPristyAdmin: any;
+}, {
+    displayName(state: {
+        token: string;
+        isAdmin: boolean;
+        isLoggedIn: boolean;
+        person: any;
+        homeFolder: any;
+        isPristyAdmin: any;
+    } & PiniaCustomStateProperties<{
+        token: string;
+        isAdmin: boolean;
+        isLoggedIn: boolean;
+        person: any;
+        homeFolder: any;
+        isPristyAdmin: any;
+    }>): any;
+}, {
+    /**
+     * Logout current user and stop auto-renew for oidc connection
+     * @return {Promise<void>}
+     */
+    logout(): Promise<void>;
+    /**
+     * Check whether the client is logged in and, when authentication is
+     * delegated to an OIDC provider via the AuthProvider façade, refresh the
+     * Alfresco ticket using its Bearer token.
+     * @return {Promise<{id:string}|undefined>} Current alf_token, or
+     *   undefined when the session cannot be validated
+     */
+    validateSession(): Promise<{
+        id: string;
+    } | undefined>;
+    /**
+     * Ensure the user is authenticated. Redirects to the IdP when they are not,
+     * otherwise loads their Person from Alfresco.
+     * @param {string} [returnTo] in-app path to return to after login
+     * @return {Promise<void>}
+     */
+    connectKeycloak: (returnTo?: string) => Promise<void>;
+    /**
+     * Consume the IdP redirect and open the Alfresco session.
+     * @return {Promise<string>} the in-app path to navigate to
+     */
+    completeLogin: () => Promise<string>;
+    /**
+     * @param {string} section "profile" or "password"
+     * @return {string|null} the IdP account console URL, when one is available
+     */
+    accountConsoleUrl(section: string): string | null;
+    /**
+     * Subscribe to the provider and open the Alfresco session. The Alfresco
+     * ticket is refreshed when the OIDC token is renewed, replacing the former
+     * unconditional 60 s poll.
+     *
+     * Does nothing beyond registering the two subscriptions when the provider
+     * has no session yet: `OidcAuthProvider.init()` resolves happily for an
+     * anonymous browser (unlike keycloak-js's `onLoad: "login-required"`), so
+     * requesting a ticket here would send `Authorization: Bearer null` and
+     * surface a misleading initialization error. A later login still
+     * refreshes the ticket via the `onTokenRenewed` subscription.
+     * @param {Object} provider the auth provider, already initialised
+     * @return {Promise<{id: string}|undefined>}
+     */
+    keycloakReady(provider: any): Promise<{
+        id: string;
+    } | undefined>;
+    /**
+     * Log to Alfresco with Bearer token and set alf_token.
+     *
+     * Retries exactly once on an HTTP 401, per the design spec ("single retry
+     * on 401 on `/tickets/-me-`"): this replaces the 60 s poller the migration
+     * deleted, since under an OIDC IdP (e.g. Entra) the token and the
+     * Alfresco ticket can have comparable lifetimes, so an idle tab may lose
+     * its ticket with nothing else scheduled to refresh it.
+     * @param {boolean} [isRetry] internal guard, never pass this explicitly
+     * @return {Promise<{id:string} | undefined>} Current alf_token or undefined if not using OIDC
+     */
+    getAlfTicket(isRetry?: boolean): Promise<{
+        id: string;
+    } | undefined>;
+    /**
+     * Get Person for user '-me-'. Help to check if we are always authenticate.
+     * The home folder is looked up only once per person.
+     * @return {Promise<void>}
+     */
+    getPerson(): Promise<void>;
+    /**
+     * Ask Alfresco whether the session is still open. Concurrent calls share
+     * one request. A refused session clears the person and marks the user
+     * logged out.
+     * @return {Promise<boolean>} whether the session is still open
+     */
+    confirmSession(): Promise<boolean>;
+    /**
+     * Watch every Alfresco API answer for a `401` and call `onSessionLost`
+     * once the session is confirmed closed. A `401` does not always mean an
+     * expired session (a webscript reserved to administrators answers `401`
+     * to other users), hence the confirmation. Ignored before login and under
+     * OIDC, whose ticket is renewed by the auth provider. The listener is
+     * installed once; a later call only replaces `onSessionLost`.
+     * @param {Function} onSessionLost called when the session is closed
+     */
+    watchSession(onSessionLost: Function): void;
+    /**
+     * Checks if the current user is a Pristy admin.
+     * The result is cached in the `isPristyAdmin` state.
+     */
+    checkPristyAdminStatus(): Promise<void>;
+    /**
+     * Attempt to login a user
+     * @param {string} user Username
+     * @param {string} password User password
+     * @return {Promise<boolean | void>} Returns false if credentials are missing, void otherwise
+     */
+    login(user: string, password: string): Promise<boolean | void>;
+    /**
+     * Do a Basic Authent to Alfresco
+     * @param {string} a Username
+     * @param {string} p Password
+     * @return {Promise<any>} Promise resolving to person data
+     */
+    apiLogin(a: string, p: string): Promise<any>;
+    /**
+     * Log Off Public Account ("user_publication_*")
+     * @return {Promise<void>}
+     */
+    publiclogoff(): Promise<void>;
+    /**
+     * Log In with the Public Account from a Public workspace.
+     * @param {string} espace_id Workspace ID that have a Public Account
+     * @return {Promise<string>} alf_ticket
+     */
+    publiclogin(espace_id: string): Promise<string>;
+}>;
+//# sourceMappingURL=user.d.ts.map

package/dist/stores/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/stores/user.js"],"names":[],"mappings":";AAwDA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH;;;;;;;;;;;;;;;;;;;;;;;;IAgBI;;;OAGG;cADS,OAAO,CAAC,IAAI,CAAC;IAwBzB;;;;;;OAMG;uBAFS,OAAO,CAAC;QAAC,EAAE,EAAC,MAAM,CAAA;KAAC,GAAC,SAAS,CAAC;IAsB1C;;;;;OAKG;iCAFQ,MAAM,KACL,OAAO,CAAC,IAAI,CAAC;IAmBzB;;;OAGG;yBADS,OAAO,CAAC,MAAM,CAAC;IAiB3B;;;OAGG;+BAFQ,MAAM,GACL,MAAM,GAAC,IAAI;IAMvB;;;;;;;;;;;;;OAaG;kCADS,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAAC,SAAS,CAAC;IAkB3C;;;;;;;;;;OAUG;2BAFQ,OAAO,GACN,OAAO,CAAC;QAAC,EAAE,EAAC,MAAM,CAAA;KAAC,GAAG,SAAS,CAAC;IAqC5C;;;;OAIG;iBADS,OAAO,CAAC,IAAI,CAAC;IA6CzB;;;;;OAKG;sBADS,OAAO,CAAC,OAAO,CAAC;IAkB5B;;;;;;;;OAQG;;IA8BH;;;OAGG;;IAoBH;;;;;OAKG;gBAHQ,MAAM,YACN,MAAM,GACL,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IASnC;;;;;OAKG;gBAHQ,MAAM,KACN,MAAM,GACL,OAAO,CAAC,GAAG,CAAC;IAcxB;;;OAGG;oBADS,OAAO,CAAC,IAAI,CAAC;IAUzB;;;;OAIG;2BAFQ,MAAM,GACL,OAAO,CAAC,MAAM,CAAC;GAwB5B"}

package/dist/stores/userPreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPreferences.d.ts","sourceRoot":"","sources":["../../src/stores/userPreferences.js"],"names":[],"mappings":";AAkBA;;;;;;;;;;;;GAYG;AACH;;WAKG"}

package/dist/stores/userView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"userView.d.ts","sourceRoot":"","sources":["../../src/stores/userView.js"],"names":[],"mappings":";AAGA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH;eAIkB,YAAY,EAAE;oBACT,cAAc;gBAClB,SAAS,GAAC,IAAI;yBACL,OAAO;;IA0B/B;;;;OAIG;mCADU,OAAO;IAKpB;;;;OAIG;0BADU,YAAY,GAAC;QAAC,IAAI,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC;IAQrD;;;;OAIG;6BADU,aAAa,EAAE;IAK5B;;;;OAIG;0BADU,aAAa,EAAE;;IAU5B;;;;OAIG;wBADQ,SAAS;IA2EpB;;;OAGG;qBADQ,YAAY;IAQvB;;;OAGG;0BADQ,MAAM;IAKjB;;;;OAIG;6BADQ,YAAY;IAiBvB;;;;OAIG;6BADQ,aAAa,EAAE;IAe1B;;;OAGG;wBADQ,KAAK,GAAC,IAAI;IASrB;;;OAGG;4BADQ,MAAM;IAKjB;;;OAGG;8BADQ,KAAK,GAAC,IAAI;IAKrB;;;;;;OAMG;qCAHQ,MAAM,kBACN,MAAM,YACN,KAAK,GAAC,IAAI;IAQrB;;;;OAIG;oCAFQ,MAAM,aACN,aAAa;IAUxB;;;;OAIG;yCAFQ,MAAM,kBACN,MAAM;IAUjB;;;;;OAKG;uCAHQ,MAAM,kBACN,MAAM,WACN,aAAa;IAWxB;;;;OAIG;4BADQ,aAAa;IAQxB;;;;OAIG;2BADQ,MAAM;IAYjB;;OAEG;;IAMH;;;OAGG;gCADQ,SAAS;IAYpB;;;OAGG;oCADQ,SAAS;IAWpB;;;OAGG;yBADU,OAAO,CAAC,IAAI,CAAC;IAe1B;;;;OAIG;6BAFQ,SAAS,GACP,OAAO,CAAC,IAAI,CAAC;IAe1B;;OAEG;;;GA8DJ;;;;;QA3eW,MAAM;;;;;;;;cAEN,OAAO;;;;cACP,MAAM;;;;WACN,GAAC;;;;eACD,GAAC,GAAC,IAAI;;;;;;QAKN,MAAM;;;;UACN,MAAM,GAAC,QAAQ,GAAC,IAAI;;;;WACpB,MAAM;;;;cACN,OAAO;;;;WACP,MAAM;;;;;;QAKN,MAAM;;;;cACN,KAAK,GAAC,IAAI;;;;cACV,aAAa,EAAE;;;;;;kBAKf,KAAK,GAAC,IAAI;;;;YACV,aAAa,EAAE;;;;;;QAKf,MAAM;;;;UACN,MAAM;;;;kBACN,MAAM;;;;WACN,MAAM,GAAC,QAAQ;;;;iBACf,OAAO;;;;YAElB;QAAkC,SAAS,EAAhC,YAAY,EAAE;QACU,cAAc,GAAtC,cAAc;QACW,QAAQ,GAAjC,aAAa,EAAE;KAC5B"}

package/dist/stores/zipShare.d.ts

@@ -0,0 +1,54 @@
+import { StoreDefinition, PiniaCustomStateProperties } from 'pinia';
+export const ZIP_SHARE_STATUS: Readonly<{
+    PREPARING: "preparing";
+    DONE: "done";
+    FAILED: "failed";
+}>;
+/**
+ * Zip shares under preparation and just finished, kept outside any dialog so
+ * that closing it lets the preparation go on. See `docs/ZipShare.md`.
+ */
+export const useZipShareStore: StoreDefinition<"zipShare", {
+    jobs: any[];
+    displayedJobId: any;
+}, {
+    preparing: (state: {
+        jobs: any[];
+        displayedJobId: any;
+    } & PiniaCustomStateProperties<{
+        jobs: any[];
+        displayedJobId: any;
+    }>) => any[];
+}, {
+    /**
+     * @param {string[]} nodeIds
+     * @param {{name: string, title?: string, description?: string, password?: string, expiresAt: Date}} options
+     *   with a `password`, the Pristy Core writes an encrypted zip
+     * @returns {Promise<Object>} the job, settled with `status` done or failed
+     */
+    start(nodeIds: string[], options: {
+        name: string;
+        title?: string;
+        description?: string;
+        password?: string;
+        expiresAt: Date;
+    }): Promise<any>;
+    /**
+     * Cancels the zip of a job still being built; later steps cannot be cancelled.
+     *
+     * @param {number} jobId
+     * @returns {Promise<void>}
+     */
+    cancel(jobId: number): Promise<void>;
+    /**
+     * Marks the job a dialog shows, so that its outcome is not notified twice.
+     *
+     * @param {?number} jobId
+     */
+    display(jobId: number | null): void;
+    /**
+     * @param {number} jobId
+     */
+    dismiss(jobId: number): void;
+}>;
+//# sourceMappingURL=zipShare.d.ts.map

package/dist/stores/zipShare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipShare.d.ts","sourceRoot":"","sources":["../../src/stores/zipShare.js"],"names":[],"mappings":";AAyBA;;;;GAIG;AAIH;;;GAGG;AACH;;;;;;;;;;;;IAUI;;;;;OAKG;mBAJQ,MAAM,EAAE,WACR;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,CAAA;KAAC,GAEtF,OAAO,KAAQ;IA0C5B;;;;;OAKG;kBAFQ,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC;IAU1B;;;;OAIG;mBADS,MAAM,OAAA;IAMlB;;OAEG;mBADQ,MAAM;GAMlB"}

package/dist/typedef.d.ts.map

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

package/dist/utils/classificationPlanUtils.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Parse a number format code, modelled on LibreOffice Calc format codes.
+ * `0` is a mandatory digit (padding), `#` an optional one, a space, dot or
+ * apostrophe between placeholders groups thousands, and the decimal separator
+ * is a comma, or a dot when the code holds no comma. Text around the number,
+ * optionally quoted, is rendered before or after it.
+ * @param {string} code - e.g. "000" or "# ##0,00 €"
+ * @returns {{minIntegerDigits: number, thousandsSeparator: string|null, decimals: number, decimalSeparator: string|null, before: string, after: string}|null}
+ *   null when the code is blank or invalid
+ */
+export function parseNumberFormat(code: string): {
+    minIntegerDigits: number;
+    thousandsSeparator: string | null;
+    decimals: number;
+    decimalSeparator: string | null;
+    before: string;
+    after: string;
+} | null;
+/**
+ * Render a number with a format returned by parseNumberFormat.
+ * Rounding is half away from zero.
+ * @param {number|string} value - a number or a numeric string
+ * @param {Object} format - a parsed number format
+ * @returns {string|null} null when the value is not a finite number
+ */
+export function formatNumber(value: number | string, format: any): string | null;
+/**
+ * Read back a number rendered by formatNumber with the same format.
+ * @param {string} text - e.g. "1 234,50 €"
+ * @param {Object} format - a parsed number format
+ * @returns {number|null} null when the text does not follow the format
+ */
+export function parseFormattedNumber(text: string, format: any): number | null;
+/**
+ * Parse a field value into a Date expressed in the browser's own time zone.
+ * @param {*} value - a Date, or a string to be validated by re-parsing
+ * @returns {Date|null} null when the value is not a usable date
+ */
+export function parseLocalDate(value: any): Date | null;
+/**
+ * Format a field value for use inside a generated name (file or folder).
+ * A date field is rendered with its `format`, falling back to an ISO-like
+ * default that contains no character forbidden by the Alfresco cm:name
+ * constraint. Any other field type is stringified unchanged.
+ * @param {*} value - raw field value
+ * @param {Object} [fieldDef] - field definition from the plan's FIELDS
+ * @returns {string}
+ */
+export function formatFieldValue(value: any, fieldDef?: any): string;
+/**
+ * Number of decimals a numeric plan field accepts in the input. A `double`
+ * field takes its `fractionDigits`, two by default; other fields take none.
+ * @param {Object} [fieldDef] - field definition from the plan's FIELDS
+ * @returns {number|undefined}
+ */
+export function fieldFractionDigits(fieldDef?: any): number | undefined;
+/**
+ * Effective default value of a plan field. A date field whose `default` is
+ * "today" defaults to the current day.
+ * @param {Object} [fieldDef] - field definition from the plan's FIELDS
+ * @returns {*} undefined when the field has no default
+ */
+export function resolveFieldDefault(fieldDef?: any): any;
+/**
+ * Extract variable names from a template string.
+ * Supports ${var} and ${var:filter} syntax.
+ * @param {string} template
+ * @returns {string[]}
+ */
+export function extractVariables(template: string): string[];
+/**
+ * Resolve a template string by replacing ${var} placeholders with values.
+ * Supports the :upper filter, and the :year and :month filters which keep
+ * the four-digit year or the two-digit month of a date value (empty when the
+ * value is not a date).
+ * When a variable has no value, uses the field's default if available.
+ * Applies prefix/suffix around the resolved value (only if non-empty).
+ * @param {string} template
+ * @param {Object} values - key/value map of field values
+ * @param {Array} [fields] - optional array of field definitions (with default, prefix, suffix)
+ * @returns {string}
+ */
+export function resolveTemplate(template: string, values: any, fields?: any[]): string;
+/**
+ * Parse a filename to extract the base name, increment, and extension.
+ * "rapport (3).pdf" → { baseName: "rapport", increment: 3, extension: ".pdf" }
+ * "rapport.pdf" → { baseName: "rapport", increment: 0, extension: ".pdf" }
+ * "rapport" → { baseName: "rapport", increment: 0, extension: "" }
+ * @param {string} fileName
+ * @returns {{ baseName: string, increment: number, extension: string }}
+ */
+export function parseFileName(fileName: string): {
+    baseName: string;
+    increment: number;
+    extension: string;
+};
+/**
+ * Build an incremented filename.
+ * ("rapport", 3, ".pdf") → "rapport (3).pdf"
+ * ("rapport", 0, ".pdf") → "rapport.pdf"
+ * @param {string} baseName
+ * @param {number} increment
+ * @param {string} extension
+ * @returns {string}
+ */
+export function buildIncrementedName(baseName: string, increment: number, extension: string): string;
+/**
+ * Deduplicate a list of filenames against each other and against existing names.
+ * @param {string[]} newNames - the names to deduplicate
+ * @param {string[]} existingNames - the names already present in the folder
+ * @returns {string[]} - deduplicated names, in the same order
+ */
+export function deduplicateFileNames(newNames: string[], existingNames: string[]): string[];
+/**
+ * Build a regex from a nature's cm:name template string.
+ * Each ${field} placeholder becomes a named capture group.
+ * @param {string} template - e.g. "${NUMMARCHE}_${NATURE}"
+ * @param {Map<string, Object>} fieldMap - Map of field name → field definition
+ * @returns {{ regex: RegExp, fieldNames: Array<{groupName: string, fieldName: string}> } | null}
+ */
+export function buildTemplateRegex(template: string, fieldMap: Map<string, any>): {
+    regex: RegExp;
+    fieldNames: Array<{
+        groupName: string;
+        fieldName: string;
+    }>;
+} | null;
+/**
+ * Compute the specificity score of a template string.
+ * Specificity = length of static text (everything outside ${…}) after removing underscores.
+ * @param {string} template - e.g. "${NUM}-FAC-${NATURE}"
+ * @returns {number}
+ */
+export function computeTemplateSpecificity(template: string): number;
+/**
+ * Detect a document nature by matching a filename against nature templates.
+ * @param {string} filename - filename with extension
+ * @param {Array} natures - array of nature definitions (with metadata["cm:name"].template)
+ * @param {Array} fields - array of field definitions
+ * @returns {{ nature: Object, extractedMetadata: Object } | null}
+ */
+export function detectNatureFromFilename(filename: string, natures: any[], fields: any[]): {
+    nature: any;
+    extractedMetadata: any;
+} | null;
+/**
+ * Views of a plan category, in the order the category lists them.
+ *
+ * @param {Array<{filename: string}>} views loaded view definitions
+ * @param {string[]} [filenames] view files of the category, in display order
+ * @returns {Array} the matching views, each listed once
+ */
+export function selectCategoryViews(views: Array<{
+    filename: string;
+}>, filenames?: string[]): any[];
+/**
+ * Checks the id typed for a new plan category.
+ *
+ * @param {string} id the id to create
+ * @param {Array<{id: string}>} [categories] existing categories of the plan
+ * @returns {"required"|"duplicate"|null} the reason for refusing it, or null
+ */
+export function validateNewCategoryId(id: string, categories?: Array<{
+    id: string;
+}>): "required" | "duplicate" | null;
+/**
+ * Views of each plan category, with the name and description read from each
+ * view file.
+ *
+ * @param {Array<{id: string, label: string, views?: string[]}>} [categories] the plan's VIEW_CATEGORIES
+ * @param {Array<{name: string, viewName: string, viewDescription: string}>} [viewEntries] view files found in the configuration folder
+ * @returns {Array<{id: string, label: string, views: Array<{filename: string, name: string, description: string, missing: boolean}>}>}
+ */
+export function describePlanViews(categories?: Array<{
+    id: string;
+    label: string;
+    views?: string[];
+}>, viewEntries?: Array<{
+    name: string;
+    viewName: string;
+    viewDescription: string;
+}>): Array<{
+    id: string;
+    label: string;
+    views: Array<{
+        filename: string;
+        name: string;
+        description: string;
+        missing: boolean;
+    }>;
+}>;
+export const TODAY_DEFAULT: "today";
+//# sourceMappingURL=classificationPlanUtils.d.ts.map

package/dist/utils/classificationPlanUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classificationPlanUtils.d.ts","sourceRoot":"","sources":["../../src/utils/classificationPlanUtils.js"],"names":[],"mappings":"AAiEA;;;;;;;;;GASG;AACH,wCAJW,MAAM,GACJ;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,GAAC,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,GAAC,IAAI,CA+D5J;AA8BD;;;;;;GAMG;AACH,oCAJW,MAAM,GAAC,MAAM,gBAEX,MAAM,GAAC,IAAI,CAkBvB;AAYD;;;;;GAKG;AACH,2CAJW,MAAM,gBAEJ,MAAM,GAAC,IAAI,CAoBvB;AAED;;;;GAIG;AACH,sCAHW,GAAC,GACC,IAAI,GAAC,IAAI,CA8BrB;AAED;;;;;;;;GAQG;AACH,wCAJW,GAAC,mBAEC,MAAM,CAqBlB;AAID;;;;;GAKG;AACH,qDAFa,MAAM,GAAC,SAAS,CAS5B;AAID;;;;;GAKG;AACH,qDAFa,GAAC,CAcb;AAED;;;;;GAKG;AACH,2CAHW,MAAM,GACJ,MAAM,EAAE,CASpB;AA4BD;;;;;;;;;;;GAWG;AACH,0CALW,MAAM,gCAGJ,MAAM,CAqClB;AAED;;;;;;;GAOG;AACH,wCAHW,MAAM,GACJ;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAYtE;AAED;;;;;;;;GAQG;AACH,+CALW,MAAM,aACN,MAAM,aACN,MAAM,GACJ,MAAM,CAOlB;AAED;;;;;GAKG;AACH,+CAJW,MAAM,EAAE,iBACR,MAAM,EAAE,GACN,MAAM,EAAE,CA4CpB;AAkBD;;;;;;GAMG;AACH,6CAJW,MAAM,YACN,GAAG,CAAC,MAAM,MAAS,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAAE,GAAG,IAAI,CAiE/F;AAED;;;;;GAKG;AACH,qDAHW,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;GAMG;AACH,mDALW,MAAM,kCAGJ;IAAE,MAAM,MAAS;IAAC,iBAAiB,MAAQ;CAAE,GAAG,IAAI,CAuDhE;AAED;;;;;;GAMG;AACH,2CAJW,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,CAAC,cACzB,MAAM,EAAE,SASlB;AAED;;;;;;GAMG;AACH,0CAJW,MAAM,eACN,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAAC,GACjB,UAAU,GAAC,WAAW,GAAC,IAAI,CAWvC;AAED;;;;;;;GAOG;AACH,+CAJW,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,gBACpD,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAC,CAAC,GAC9D,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAC,CAAC,CAAA;CAAC,CAAC,CAiBrI;AA/ZD,4BAA6B,OAAO,CAAC"}

package/dist/utils/indexAwaitReducer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @param {string[]} nodeIds the ids of one await request
+ * @returns {Object} the state before any server message
+ */
+export function initialAwaitState(nodeIds: string[]): any;
+/**
+ * @param {*} data the `data` of a WebSocket message event
+ * @returns {?Object} the message, or null when it is not a JSON object with a string `type`
+ */
+export function parseAwaitMessage(data: any): any | null;
+/**
+ * @param {Object} state
+ * @returns {number} how many nodes got `searchable`, `error` or `rejected`
+ */
+export function releasedCount(state: any): number;
+/**
+ * @param {Object} state
+ * @returns {Object} the state finished as `unavailable`, or the same state when already finished
+ */
+export function finishUnavailable(state: any): any;
+/**
+ * @param {Object} state
+ * @param {?Object} message a parsed server message
+ * @returns {Object} the next state
+ */
+export function reduceAwaitMessage(state: any, message: any | null): any;
+/**
+ * @param {Object} state
+ * @returns {{status: ?string, searchable: string[], errors: Array<{nodeId: string, verdict: ?string}>, rejected: string[], pending: string[]}}
+ */
+export function awaitResult(state: any): {
+    status: string | null;
+    searchable: string[];
+    errors: Array<{
+        nodeId: string;
+        verdict: string | null;
+    }>;
+    rejected: string[];
+    pending: string[];
+};
+export const INDEX_AWAIT_STATUS: Readonly<{
+    DONE: "done";
+    TIMEOUT: "timeout";
+    UNAVAILABLE: "unavailable";
+    SKIPPED: "skipped";
+    BACKGROUND: "background";
+}>;
+export const AWAIT_MESSAGE: Readonly<{
+    SEARCHABLE: "searchable";
+    ERROR: "error";
+    REJECTED: "rejected";
+    END: "end";
+    INVALID: "invalid";
+    UNAVAILABLE: "unavailable";
+}>;
+//# sourceMappingURL=indexAwaitReducer.d.ts.map

package/dist/utils/indexAwaitReducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexAwaitReducer.d.ts","sourceRoot":"","sources":["../../src/utils/indexAwaitReducer.js"],"names":[],"mappings":"AAiCA;;;GAGG;AACH,2CAHW,MAAM,EAAE,OAYlB;AAED;;;GAGG;AACH,wCAHW,GAAC,GACC,UAAO,CAgBnB;AAkBD;;;GAGG;AACH,2CAFa,MAAM,CAIlB;AAED;;;GAGG;AACH,mDAUC;AAED;;;;GAIG;AACH,wDAHW,UAAO,OAiDjB;AAED;;;GAGG;AACH,yCAFa;IAAC,MAAM,EAAG,MAAM,OAAA,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAG,MAAM,OAAA,CAAA;KAAC,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAC,CAU7I;AA7JD;;;;;;GAMG;AAEH;;;;;;;GAOG"}

package/dist/utils/overflowUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overflowUtils.d.ts","sourceRoot":"","sources":["../../src/utils/overflowUtils.js"],"names":[],"mappings":"AAmBA;;;;;;;;;;GAUG;AACH,0CARW,MAAM,EAAE,aACR,MAAM,OACN,MAAM,aACN,MAAM,aACN,MAAM,GACJ,MAAM,CA6BlB;AAED;;;;;;;;GAQG;AACH,8DALW,MAAM,eACN,GAAC,qBAEC;IAAC,OAAO,QAAQ;IAAC,MAAM,QAAO;CAAC,CAsB3C"}

package/dist/utils/planTree.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @param {Object|undefined} emplacement a plan `EMPLACEMENT` entry
+ * @param {string} code the code a nature refers to it by
+ * @returns {{label: string, dynamic: boolean, missing: boolean}} the folder
+ *   name this location creates: its fixed name, its template, or the field
+ *   it is named after; `dynamic` when the name depends on the document,
+ *   `missing` when the plan defines no such location
+ */
+export function emplacementLabel(emplacement: any | undefined, code: string): {
+    label: string;
+    dynamic: boolean;
+    missing: boolean;
+};
+/**
+ * @param {Object} plan a filing plan, with `NATURES` and `EMPLACEMENT`
+ * @returns {Array<Object>} PrimeVue Tree nodes: the locations the natures go
+ *   to, nested as their `emplacement` paths, each holding the natures filed
+ *   there; folders come before natures, both in plan order. A nature without
+ *   location sits at the root.
+ */
+export function buildPlanTree(plan: any): Array<any>;
+/**
+ * @param {Array<Object>} nodes as returned by `buildPlanTree`
+ * @returns {Object} the expanded keys opening every location
+ */
+export function allPlanFolderKeys(nodes: Array<any>): any;
+/**
+ * @param {Array<Object>} nodes as returned by `buildPlanTree`
+ * @returns {Array<Object>} every location and nature in reading order, each
+ *   with its `depth`, whatever is open in the displayed tree
+ */
+export function planTreeLines(nodes: Array<any>): Array<any>;
+export const PLAN_FOLDER: "folder";
+export const PLAN_NATURE: "nature";
+//# sourceMappingURL=planTree.d.ts.map

package/dist/utils/planTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planTree.d.ts","sourceRoot":"","sources":["../../src/utils/planTree.js"],"names":[],"mappings":"AAqBA;;;;;;;GAOG;AACH,8CAPW,MAAO,SAAS,QAChB,MAAM,GACJ;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,CAoB/D;AAWD;;;;;;GAMG;AACH,0CALa,KAAK,KAAQ,CAqDzB;AAED;;;GAGG;AACH,yCAHW,KAAK,KAAQ,OAevB;AAED;;;;GAIG;AACH,qCAJW,KAAK,KAAQ,GACX,KAAK,KAAQ,CAezB;AAlID,0BAA2B,QAAQ,CAAC;AAEpC,0BAA2B,QAAQ,CAAC"}

package/dist/utils/treeA11y.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @param {{context: {leaf: boolean, expanded: boolean}}} options the context
+ *   PrimeVue hands to the `node` pass-through of a Tree
+ * @returns {Object} the treeitem attributes overriding PrimeVue's: no
+ *   `aria-expanded` on a leaf, and no `aria-setsize`, which PrimeVue fills
+ *   with the number of children instead of the number of siblings
+ */
+export function treeItemAttributes({ context }: {
+    context: {
+        leaf: boolean;
+        expanded: boolean;
+    };
+}): any;
+export namespace accessibleTreePt {
+    export { treeItemAttributes as node };
+}
+//# sourceMappingURL=treeA11y.d.ts.map

package/dist/utils/treeA11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeA11y.d.ts","sourceRoot":"","sources":["../../src/utils/treeA11y.js"],"names":[],"mappings":"AAiBA;;;;;;GAMG;AACH,gDANW;IAAC,OAAO,EAAE;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAC,CAAA;CAAC,OAWvD"}

package/dist/utils/workspaceAppearance.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @param {string} name workspace short name
+ * @returns {string} a color of `WORKSPACE_COLORS`, always the same for a name
+ */
+export function workspaceColorOf(name: string): string;
+/**
+ * @param {string} title workspace title
+ * @returns {string} the first letter of its first and last words, upper case
+ */
+export function workspaceInitialsOf(title: string): string;
+/**
+ * PrimeVue palette names a workspace color is picked from; each resolves to
+ * `var(--p-<name>-<shade>)`.
+ */
+export const WORKSPACE_COLORS: string[];
+//# sourceMappingURL=workspaceAppearance.d.ts.map

package/dist/utils/workspaceAppearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceAppearance.d.ts","sourceRoot":"","sources":["../../src/utils/workspaceAppearance.js"],"names":[],"mappings":"AA+BA;;;GAGG;AACH,uCAHW,MAAM,GACJ,MAAM,CAQlB;AAED;;;GAGG;AACH,2CAHW,MAAM,GACJ,MAAM,CAalB;AAzCD;;;GAGG;AACH,wCAQE"}

package/dist/workers/upload.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.worker.d.ts","sourceRoot":"","sources":["../../src/workers/upload.worker.js"],"names":[],"mappings":""}