@wssto2/vue-core 0.4.28 → 0.5.1

package/dist/identity/index.d.ts

@@ -3,13 +3,15 @@ export type * as Inputs from "../modules/identity/schemas";
 export { identityRoutes } from "../modules/identity/routes";
 export { identityFeature } from "./feature";
 export type { IdentityFeatureOptions } from "./feature";
-export { identityPlatform, identitySessionAdapter, renewIdentityTokens } from "./session";
+export { identityPlatform, identitySessionAdapter } from "./session";
 export type { IdentityPlatformOptions } from "./session";
 export { usersFeature } from "./users/feature";
 export type { UsersFeatureOptions } from "./users/feature";
 export type { PersonSection } from "./users/personSections";
+export type { ProfilePanel, ProfileSection } from "./profile/profileSections";
 export { profileRoutes } from "./profile/routes";
 export { usersRoutes } from "./users/routes";
+export { default as ActionRow } from "./shared/ActionRow.vue";
 export { default as SignInAsButton } from "./SignInAsButton.vue";
 export { isSessionEnded, lockedUntil, returnToOwnAccount, signIn, signInAs } from "./signIn";
 export { parseIdentityUser } from "./user";

package/dist/identity/index.js

@@ -1,5 +1,7 @@
-import { _ as t, h as n, j as a, i, k as o, d as r, l as d, m as u, n as y, r as l, o as I, s as f, q as p, t as A, f as c } from "../index-BhtJR4c_.js";
+import { _ as t, h as n, j as a, i, k as o, d as r, l as d, m as u, n as f, r as l, s as p, o as y, q as A, f as c } from "../index-auJqVMWC.js";
+import { _ as I } from "../ActionRow.vue_vue_type_script_setup_true_lang-BCgKzUvG.js";
 export {
+  I as ActionRow,
   t as SignInAsButton,
   n as identityFeature,
   a as identityPlatform,
@@ -8,11 +10,10 @@ export {
   r as isSessionEnded,
   d as lockedUntil,
   u as parseIdentityUser,
-  y as profileRoutes,
-  l as renewIdentityTokens,
-  I as returnToOwnAccount,
-  f as signIn,
-  p as signInAs,
+  f as profileRoutes,
+  l as returnToOwnAccount,
+  p as signIn,
+  y as signInAs,
   A as usersFeature,
   c as usersRoutes
 };

package/dist/identity/profile/DetailsFields.vue.d.ts

@@ -0,0 +1,8 @@
+import { type FieldBinding } from "../../form";
+/** The details group, written once: the page reads it, and the sheet shows this same markup with its group alone. */
+type __VLS_Props = {
+    bind: (field: "name" | "phone") => FieldBinding<string>;
+    login: string;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/identity/profile/{DetailsPanel.vue.d.ts → DetailsGroup.vue.d.ts}

@@ -1,5 +1,8 @@
 import type { ProfileResponse } from "../../modules/identity/entities";
-/** The person's own name and phone; the username is shown, never edited here (an administrator changes it). */
+/**
+ * The person's own name and phone, read on the page and changed in a sheet (one save, the page has none). The username is
+ * shown with its note, never edited here (an administrator changes it).
+ */
 type __VLS_Props = {
     profile: ProfileResponse;
 };

package/dist/identity/profile/{EmailPanel.vue.d.ts → EmailGroup.vue.d.ts}

@@ -1,5 +1,5 @@
 import type { ProfileResponse } from "../../modules/identity/entities";
-/** The current address, "Change e-mail address", and a change that waits for its code, to resume or cancel. */
+/** The current address with "Change", and below it a change that waits for its code, to resume or cancel. */
 type __VLS_Props = {
     profile: ProfileResponse;
 };

package/dist/identity/profile/SignInsGroup.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/identity/profile/profileSections.d.ts

@@ -0,0 +1,37 @@
+import type { Component } from "vue";
+import type { ProfileResponse } from "../../modules/identity/entities";
+/** The groups "My profile" ships, in page order, by the id a section positions itself against. */
+export declare const PROFILE_PANELS: readonly ["details", "email", "password", "sessions", "signins"];
+export type ProfilePanel = (typeof PROFILE_PANELS)[number];
+/**
+ * A group the application adds to "My profile" (its mobile phone, dealer and location, preferences). The component renders
+ * its own `FormGroup`s (rows, a header, a footer; `ActionRow` for a row that opens something), so it reads like the built-in
+ * ones; it gets the loaded `profile` as a prop and may emit `updated` with a changed `ProfileResponse`, as they do. Place it
+ * `after` or `before` one of the built-in groups (the default is the end of the page); sections with the same position keep
+ * the order they were given in.
+ *
+ *   usersFeature({ profileSections: [{ id: "preferences", component: PreferencesGroup, after: "password", visible: (p) => p.id !== 0 }] })
+ */
+export type ProfileSection = {
+    /** Unique among the sections, one lowercase word (it is the section's `data-profile-section`). */
+    readonly id: string;
+    readonly component: Component;
+    /** Whether to show it for this person; default always. */
+    readonly visible?: (profile: ProfileResponse) => boolean;
+} & ({
+    readonly after?: ProfilePanel;
+    readonly before?: never;
+} | {
+    readonly before?: ProfilePanel;
+    readonly after?: never;
+});
+/** One entry of the page: a built-in group or an application's section. */
+export type ProfileEntry = {
+    readonly kind: "panel";
+    readonly id: ProfilePanel;
+} | {
+    readonly kind: "section";
+    readonly section: ProfileSection;
+};
+/** The page's groups in order, with the visible sections slotted in. */
+export declare function layoutProfile(sections: readonly ProfileSection[], profile: ProfileResponse): readonly ProfileEntry[];

package/dist/identity/session.d.ts

@@ -8,7 +8,14 @@ import { type IdentityUser } from "./user";
  */
 export declare function identitySessionAdapter<U extends SessionUser>(http: HttpClient, parseUser: UserParser<U>): SessionAdapter<U>;
 /** What `createPlatform` is given to run on go-core's identity module. */
-export type IdentityPlatformOptions<U extends SessionUser> = Required<Pick<PlatformOptions<U, BootstrapConfig>, "session" | "renewSession">>;
+export type IdentityPlatformOptions<U extends SessionUser> = Required<Pick<PlatformOptions<U, BootstrapConfig>, "session" | "renewSession">> & Pick<PlatformOptions<U, BootstrapConfig>, "renewable">;
+/** What `identityPlatform` takes. */
+export interface IdentityPlatformInput<U extends SessionUser> {
+    /** The application's own user projection; see `identityPlatform`. */
+    parseUser?: UserParser<U>;
+    /** False while the session has no refresh token (an embed bearer session): nothing renews it, a 401 ends it. See `PlatformOptions.renewable`. */
+    renewable?: () => boolean;
+}
 /**
  * The platform options that wire the session to go-core's identity routes: reading it (`/auth/me`, with one
  * refresh when the access token ran out), ending it, and renewing it when a request is answered 401.
@@ -18,13 +25,9 @@ export type IdentityPlatformOptions<U extends SessionUser> = Required<Pick<Platf
  * The user is go-core's default projection (`IdentityUser`); an application that projects its own passes
  * `parseUser`, which must keep the `id` and the `login` (the prompt for an expired session shows it).
  */
-export declare function identityPlatform(): IdentityPlatformOptions<IdentityUser>;
+export declare function identityPlatform(options?: Omit<IdentityPlatformInput<IdentityUser>, "parseUser">): IdentityPlatformOptions<IdentityUser>;
 export declare function identityPlatform<U extends SessionUser & {
     readonly login: string;
-}>(options: {
+}>(options: IdentityPlatformInput<U> & {
     parseUser: UserParser<U>;
 }): IdentityPlatformOptions<U>;
-/** Renews the tokens, for `keepSessionAlive({ renew })`: the session is read again afterwards. */
-export declare const renewIdentityTokens: (platform: {
-    readonly http: HttpClient;
-}) => Promise<void>;

package/dist/identity/shared/SignInList.vue.d.ts

@@ -0,0 +1,22 @@
+import type { SignInRow } from "../../modules/identity/entities";
+/**
+ * A person's sign-in history as a grouped list, one row per sign-in: the device as sessions name it ("Chrome · Linux"), when
+ * and from which address, and what happened as a badge (with who did it, for the events somebody else does). The raw
+ * User-Agent is the row's tooltip.
+ */
+type __VLS_Props = {
+    rows: readonly SignInRow[];
+    header?: string;
+    footer?: string;
+};
+type __VLS_Slots = {
+    "header-trailing"?: () => unknown;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/identity/shared/deviceLabel.d.ts

@@ -0,0 +1,7 @@
+/**
+ * "Browser · OS" from a User-Agent, as go-core names a session's device (`account.DeviceLabel`): Chrome, Safari, Edge or
+ * Firefox on macOS, Windows, iPhone, iPad, Android or Linux; anything else is the raw string, trimmed to 80 characters.
+ * Sign-in rows carry the raw User-Agent (go-core labels only sessions), so the screens that list them label it here; a
+ * string that already is a label comes out unchanged.
+ */
+export declare function deviceLabel(userAgent: string): string;

package/dist/identity/useReturnToOwnAccount.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Leaving an impersonation, for the banner and the account menu row: `impersonating` says whether the session is somebody
+ * else's, `leave()` returns to one's own account and lands on the home page (what was on screen belonged to the other
+ * person). A refusal is said in a toast and the session is read again, since the impersonation may have ended elsewhere.
+ */
+export declare function useReturnToOwnAccount(): {
+    impersonating: import("vue").ComputedRef<boolean>;
+    returning: import("vue").Ref<boolean, boolean>;
+    leave: () => Promise<void>;
+};

package/dist/identity/users/context.d.ts

@@ -1,3 +1,4 @@
+import type { ProfileSection } from "../profile/profileSections";
 import { type Permission } from "../../platform";
 /** What the screens of `usersFeature` need from the feature that installed them. */
 export interface UsersContext {
@@ -5,5 +6,7 @@ export interface UsersContext {
     readonly signInAs: Permission | false;
     /** The application's areas for the Activity section: an area key of the server's audit, and the i18n key that names it. */
     readonly activityAreas: Readonly<Record<string, string>>;
+    /** The panels the application adds to "My profile". */
+    readonly profileSections: readonly ProfileSection[];
 }
 export declare const usersContextKey: import("vue").InjectionKey<UsersContext>, useUsersContext: () => UsersContext;

package/dist/identity/users/feature.d.ts

@@ -1,6 +1,7 @@
 import { type Feature } from "../../app";
 import type { Permission } from "../../platform";
 import type { Destination } from "../../router";
+import type { ProfileSection } from "../profile/profileSections";
 import { type PersonSection } from "./personSections";
 export interface UsersFeatureOptions {
     /** The users list and a person's record (`/users`), for whoever holds `iam.user:view`. Default true. */
@@ -13,6 +14,8 @@ export interface UsersFeatureOptions {
     activityAreas?: Readonly<Record<string, string>>;
     /** Sections the application adds to a person's record after the feature's own (their roles); each is a child route `users.record.<path>`. */
     sections?: readonly PersonSection[];
+    /** Panels the application adds to "My profile" (mobile phone, dealer and location, preferences), each placed after or before a built-in panel. */
+    profileSections?: readonly ProfileSection[];
     /** The destination of the backend's menu that opens the users list. Without it the application binds the list itself. */
     destination?: Destination;
 }