@pontive/pontkit-core 1.0.0

package/dist/components/renderers/navigation/index.d.ts

@@ -0,0 +1 @@
+export * from './link';

package/dist/components/renderers/navigation/link/_link.d.ts

@@ -0,0 +1,76 @@
+import { LitElement } from '../../../../../node_modules/lit';
+import { LinkPart, LinkService, PontLinkProps as Props } from './link.types';
+/**
+ * Link button with an optional inline prompt, for navigational and
+ * action-driven UI flows.
+ *
+ * @part link - div: root, contains both subparts
+ * @part link-button - pont-button: main clickable element
+ * @part link-prompt - p: optional inline text, preceding the button part
+ *
+ * @event pont-link:click - Fired when the link button is clicked, before any auth call.
+ *  Detail: `{ id: string; buttonId: string; service: "auth" | "other"; event?: string }`
+ * @event pont-link:success - Fired after the auth call resolves successfully (only when `service="auth"`).
+ *  Detail: `{ id: string; buttonId: string; event: string; result: ProcessEventResponse }`
+ * @event pont-link:error - Fired when the auth call fails (only when `service="auth"`).
+ *  Detail: `{ id: string; buttonId: string; event: string; message: string }`
+ */
+export declare class PontLink extends LitElement implements Props {
+    static readonly ROOT = "link";
+    static readonly BUTTON = "button";
+    static readonly PROMPT = "prompt";
+    static readonly TAG: string;
+    static readonly CLICK_EVENT: string;
+    static readonly SUCCESS_EVENT: string;
+    static readonly ERROR_EVENT: string;
+    static readonly PARTS: Record<LinkPart, string>;
+    /**
+     * Substring used in generated part IDs.
+     */
+    seed: string;
+    /**
+     * Custom ID used as the root part ID and as the base of subpart IDs.
+     */
+    customId?: string;
+    /**
+     * Text used as the label of the link button part.
+     */
+    private _label;
+    get label(): string;
+    set label(value: string);
+    /**
+     * Helper text rendered before and inline with the button.
+     */
+    prompt?: string;
+    /**
+     * Service which handles the `event` (if provided) on click.
+     */
+    service: LinkService;
+    /**
+     * Event identifier forwarded to the specified `service` on click.
+     * Certain services may not handle events.
+     */
+    event?: string;
+    /**
+     * Disables the link button, preventing interaction.
+     */
+    disabled?: boolean;
+    /**
+     * Manual alternative to the private `_loading` state.
+     */
+    loading?: boolean;
+    /**
+     * Indicates whether the component is dispatching or emitting an event.
+     */
+    private _loading;
+    protected createRenderRoot(): this;
+    get rootId(): string;
+    get buttonId(): string;
+    get promptId(): string;
+    get isLoading(): boolean;
+    get isDisabled(): boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _handleClick;
+    render(): import('../../../../../node_modules/lit-html').TemplateResult<1>;
+}

package/dist/components/renderers/navigation/link/index.d.ts

@@ -0,0 +1,7 @@
+import { PontLink } from './_link';
+export { PontLink };
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-link": PontLink;
+    }
+}

package/dist/components/renderers/navigation/link/link.defs.d.ts

@@ -0,0 +1,3 @@
+import { LinkService, PontLinkProps } from './link.types';
+export declare const DEFAULT_LINK_PROPS: Omit<PontLinkProps, "seed">;
+export declare const LINK_SERVICES: LinkService[];

package/dist/components/renderers/navigation/link/link.stories.d.ts

@@ -0,0 +1,9 @@
+import { Meta, StoryObj } from '@storybook/web-components-vite';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Basic: Story;
+export declare const Label: Story;
+export declare const Prompt: Story;
+export declare const Disabled: Story;
+export declare const Loading: Story;

package/dist/components/renderers/navigation/link/link.types.d.ts

@@ -0,0 +1,12 @@
+export type LinkPart = "root" | "button" | "prompt";
+export type LinkService = "auth" | "other";
+export type PontLinkProps = {
+    seed: string;
+    customId?: string;
+    label: string;
+    prompt?: string;
+    service: LinkService;
+    event?: string;
+    disabled?: boolean;
+    loading?: boolean;
+};

package/dist/components/renderers/typography/index.d.ts

@@ -0,0 +1,2 @@
+export * from './subtitle';
+export * from './title';

package/dist/components/renderers/typography/subtitle/_subtitle.d.ts

@@ -0,0 +1,8 @@
+import { BaseElement } from '../../..';
+export declare class PontSubtitle extends BaseElement {
+    get _containerElement(): HTMLLIElement | null;
+    id: string;
+    content: string;
+    protected createRenderRoot(): this;
+    render(): import('../../../../../node_modules/lit-html').TemplateResult<1>;
+}

package/dist/components/renderers/typography/subtitle/index.d.ts

@@ -0,0 +1,7 @@
+import { PontSubtitle } from './_subtitle';
+export { PontSubtitle };
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-subtitle": PontSubtitle;
+    }
+}

package/dist/components/renderers/typography/subtitle/subtitle.stories.d.ts

@@ -0,0 +1,6 @@
+import { Meta, StoryObj } from '@storybook/web-components-vite';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Basic: Story;
+export declare const LongContent: Story;

package/dist/components/renderers/typography/subtitle/subtitle.types.d.ts

@@ -0,0 +1,4 @@
+export type SubtitleProps = {
+    content?: string;
+    id?: string;
+};

package/dist/components/renderers/typography/title/_title.d.ts

@@ -0,0 +1,13 @@
+import { BaseElement } from '../../..';
+export declare class PontTitle extends BaseElement {
+    get _containerElement(): HTMLLIElement | null;
+    id: string;
+    content: string;
+    protected createRenderRoot(): this;
+    render(): import('../../../../../node_modules/lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-title": PontTitle;
+    }
+}

package/dist/components/renderers/typography/title/index.d.ts

@@ -0,0 +1,7 @@
+import { PontTitle } from './_title';
+export { PontTitle };
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-title": PontTitle;
+    }
+}

package/dist/components/renderers/typography/title/title.stories.d.ts

@@ -0,0 +1,6 @@
+import { Meta, StoryObj } from '@storybook/web-components-vite';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Basic: Story;
+export declare const PageTitle: Story;

package/dist/components/renderers/typography/title/title.types.d.ts

@@ -0,0 +1,4 @@
+export type TitleProps = {
+    content?: string;
+    id?: string;
+};

package/dist/components/renderers/visuals/index.d.ts

@@ -0,0 +1,2 @@
+export * from './logo';
+export * from './watermark';

package/dist/components/renderers/visuals/logo/_logo.d.ts

@@ -0,0 +1,21 @@
+import { BaseElement } from '../../..';
+import { LogoProps } from './logo.types';
+export declare class PontLogo extends BaseElement implements LogoProps {
+    id: string;
+    imageUrl: string;
+    align: string;
+    width: string;
+    height: string;
+    private theme;
+    private isSvg;
+    private design;
+    private observer?;
+    get _containerElement(): HTMLElement | null;
+    connectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    private updateLayoutFromProps;
+    disconnectedCallback(): void;
+    private getTheme;
+    protected createRenderRoot(): this;
+    render(): import('../../../../../node_modules/lit-html').TemplateResult<1>;
+}

package/dist/components/renderers/visuals/logo/index.d.ts

@@ -0,0 +1,7 @@
+import { PontLogo } from './_logo';
+export { PontLogo };
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-logo": PontLogo;
+    }
+}

package/dist/components/renderers/visuals/logo/logo.stories.d.ts

@@ -0,0 +1,17 @@
+import { Meta, StoryObj } from '@storybook/web-components-vite';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Basic: Story;
+export declare const ImageLogo: Story;
+export declare const SvgLogo: Story;
+/**
+ * In the screen designer an author places `pont-logo` before any brand logo is
+ * configured. At runtime that bare element is either injected with the brand
+ * logo or pruned — but the designer resolves nothing, so untreated it renders
+ * `<img src="">`: a broken-image icon where the author expects their logo.
+ *
+ * Design mode substitutes a placeholder mark instead. See
+ * pontive-spec/17-authflow-screen-resolution.md §1.
+ */
+export declare const DesignMode: Story;

package/dist/components/renderers/visuals/logo/logo.types.d.ts

@@ -0,0 +1,5 @@
+export type LogoTheme = "dark" | "light" | string;
+export type LogoProps = {
+    imageUrl?: string;
+    id?: string;
+};

package/dist/components/renderers/visuals/watermark/_watermark.d.ts

@@ -0,0 +1,47 @@
+import { LitElement } from '../../../../../node_modules/lit';
+import { PontWatermarkProps as Props, WatermarkLogoAlign, WatermarkPart, WatermarkVariant } from './watermark.types';
+/**
+ * Branded watermark that displays a label alongside the Pontive logo.
+ *
+ * @part watermark - span: root
+ * @part watermark-label - span: label text
+ * @part watermark-logo - svg: pontive logo
+ */
+export declare class PontWatermark extends LitElement implements Props {
+    static readonly ROOT = "watermark";
+    static readonly LABEL = "label";
+    static readonly LOGO = "logo";
+    static readonly TAG: string;
+    static readonly PARTS: Record<WatermarkPart, string>;
+    /**
+     * Substring used in generated part IDs.
+     */
+    seed: string;
+    /**
+     * Custom ID used as the root part ID and as the base of subpart IDs.
+     */
+    customId?: string;
+    /**
+     * Visual variant of the watermark component.
+     * Determines logo color variations and badge font styles.
+     */
+    variant: WatermarkVariant;
+    /**
+     * Alignment of the logo within the component.
+     * When `"start"`/`"end"`, the logo is rendered before/after the label.
+     */
+    logoAlign: WatermarkLogoAlign;
+    /**
+     * Text used as the label of the watermark.
+     */
+    private _label;
+    get label(): string;
+    set label(value: string);
+    protected createRenderRoot(): this;
+    get rootId(): string;
+    get labelId(): string;
+    get logoId(): string;
+    private _renderLabel;
+    private _renderLogo;
+    render(): import('../../../../../node_modules/lit-html').TemplateResult<1>;
+}

package/dist/components/renderers/visuals/watermark/index.d.ts

@@ -0,0 +1,7 @@
+import { PontWatermark } from './_watermark';
+export { PontWatermark };
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-watermark": PontWatermark;
+    }
+}

package/dist/components/renderers/visuals/watermark/watermark.defs.d.ts

@@ -0,0 +1,4 @@
+import { PontWatermarkProps, WatermarkLogoAlign, WatermarkVariant } from './watermark.types';
+export declare const DEFAULT_WATERMARK_PROPS: Omit<PontWatermarkProps, "seed">;
+export declare const WATERMARK_VARIANTS: WatermarkVariant[];
+export declare const WATERMARK_LOGO_ALIGNS: WatermarkLogoAlign[];

package/dist/components/renderers/visuals/watermark/watermark.stories.d.ts

@@ -0,0 +1,8 @@
+import { Meta, StoryObj } from '@storybook/web-components-vite';
+declare const meta: Meta;
+export default meta;
+type Story = StoryObj;
+export declare const Basic: Story;
+export declare const Variant: Story;
+export declare const LogoAlign: Story;
+export declare const Label: Story;

package/dist/components/renderers/visuals/watermark/watermark.types.d.ts

@@ -0,0 +1,11 @@
+import { IconAlign } from '../../../../types';
+export type WatermarkPart = "root" | "label" | "logo";
+export type WatermarkVariant = "brand" | "theme" | "muted";
+export type WatermarkLogoAlign = IconAlign;
+export type PontWatermarkProps = {
+    seed: string;
+    customId?: string;
+    variant: WatermarkVariant;
+    logoAlign: WatermarkLogoAlign;
+    label: string;
+};

package/dist/components/ui/badge-selector/badge-selector.d.ts

@@ -0,0 +1,44 @@
+import { LitElement } from '../../../../node_modules/lit';
+export interface BadgeOption {
+    value: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    disabled?: boolean;
+}
+export declare class BadgeSelector extends LitElement {
+    options: BadgeOption[];
+    value: string[];
+    onChange?: (values: string[]) => void;
+    placeholder: string;
+    label: string;
+    disabled: boolean;
+    maxSelections?: number;
+    className: string;
+    private inputValue;
+    private isOpen;
+    private highlightedIndex;
+    private blurTimeout;
+    private dropdownRef;
+    protected createRenderRoot(): this;
+    private get filteredOptions();
+    private get maxReached();
+    private isOptionDisabled;
+    private handleInput;
+    private handleInputClick;
+    private handleKeyDown;
+    private selectOption;
+    private removeLast;
+    private removeBadge;
+    private handleFocus;
+    private handleBlur;
+    private handleOptionMouseDown;
+    private clearBlurTimeout;
+    private notifyChange;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-badge-selector": BadgeSelector;
+    }
+}

package/dist/components/ui/hint/index.d.ts

@@ -0,0 +1,6 @@
+import { LitElement } from '../../../../node_modules/lit';
+export declare class PontHint extends LitElement {
+    createRenderRoot(): this;
+    content: string;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1>;
+}

package/dist/components/ui/index.d.ts

@@ -0,0 +1,7 @@
+export * from './hint';
+export * from './modal';
+export * from './paginator/paginator';
+export * from './multi-email-input/multi-email-input';
+export * from './badge-selector/badge-selector';
+export * from './pont-sidedrawer/pont-sidedrawer';
+export * from './multi-select-filter/pont-multi-select-filter';

package/dist/components/ui/modal/index.d.ts

@@ -0,0 +1,12 @@
+import { LitElement, nothing } from '../../../../node_modules/lit';
+export declare class PontModal extends LitElement {
+    private _cachedChildren;
+    createRenderRoot(): this;
+    connectedCallback(): void;
+    isOpen: boolean;
+    showClose: boolean;
+    layoutClass: string;
+    private _handleClose;
+    private _handleOutsideClick;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1> | typeof nothing;
+}

package/dist/components/ui/multi-email-input/multi-email-input.d.ts

@@ -0,0 +1,32 @@
+import { LitElement } from '../../../../node_modules/lit';
+export declare class MultiEmailInput extends LitElement {
+    label: string;
+    /** Array of valid email strings currently in the input. */
+    value: string[];
+    /** Called whenever the emails array changes. */
+    onChange?: (emails: string[]) => void;
+    /** Placeholder text when no emails are present. */
+    placeholder: string;
+    /** Disable the entire input. */
+    disabled: boolean;
+    /** Maximum number of emails allowed. */
+    maxEmails: number;
+    /** Additional CSS class(es) to apply to the outer wrapper. */
+    className: string;
+    private inputValue;
+    private error;
+    protected createRenderRoot(): this;
+    private validateEmail;
+    private addEmails;
+    private notifyChange;
+    private handleKeyDown;
+    private handlePaste;
+    private handleBlur;
+    private removeEmail;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-multi-email-input": MultiEmailInput;
+    }
+}

package/dist/components/ui/multi-select-filter/pont-multi-select-filter.d.ts

@@ -0,0 +1,18 @@
+import { LitElement } from '../../../../node_modules/lit';
+export declare class PontMultiSelectFilter extends LitElement {
+    options: {
+        value: string;
+        label: string;
+    }[];
+    selected: string[];
+    placeholder: string;
+    label: string;
+    private _handleToggle;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1>;
+    createRenderRoot(): this;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-multi-select-filter": PontMultiSelectFilter;
+    }
+}

package/dist/components/ui/paginator/paginator.d.ts

@@ -0,0 +1,16 @@
+import { LitElement } from '../../../../node_modules/lit';
+export declare class PontPaginator extends LitElement {
+    totalPages: number;
+    currentPage: number;
+    hideGoTo: boolean;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    private get visiblePages();
+    private goTo;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1>;
+    static styles: import('../../../../node_modules/lit').CSSResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-paginator": PontPaginator;
+    }
+}

package/dist/components/ui/pont-sidedrawer/pont-sidedrawer.d.ts

@@ -0,0 +1,23 @@
+import { LitElement } from '../../../../node_modules/lit';
+export declare class PontSideDrawer extends LitElement {
+    drawer_id: string | undefined;
+    inplace: boolean;
+    side: "left" | "right";
+    open: boolean;
+    closeOnOverlay: boolean;
+    private _cachedChildren;
+    private _mounted;
+    protected createRenderRoot(): HTMLElement | DocumentFragment;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private _handleOpen;
+    private _handleClose;
+    private _onOverlayClick;
+    render(): import('../../../../node_modules/lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "pont-sidedrawer": PontSideDrawer;
+    }
+}

package/dist/components/widgets/index.d.ts

@@ -0,0 +1,6 @@
+export * from './pont-account-settings';
+export * from './pont-member-management';
+export * from './pont-preview/pont-preview';
+export * from './pont-signin/pont-signin';
+export * from './pont-signup/pont-signup';
+export * from './pont-nav-user';

package/dist/components/widgets/pont-account-settings/index.d.ts

@@ -0,0 +1,3 @@
+export * from './pont-account-settings';
+export * from './profile';
+export * from './security-settings';

package/dist/components/widgets/pont-account-settings/pont-account-settings.d.ts

@@ -0,0 +1,63 @@
+import { LitElement } from '../../../../node_modules/lit';
+import { USER_ACCOUNT_SETTINGS_MODE, USER_ACCOUNT_SETTINGS_ORIENTATION, USER_ACCOUNT_SETTINGS_SIDEBAR_DISPLAY_TYPE, USER_ACCOUNT_SETTINGS_WIDGETS_LAYOUT, IProfileContentCustomizations } from '../../../types';
+import { AuthState } from '../../../context';
+export declare class PontAccountSettings extends LitElement {
+    showAvatarMenu: boolean;
+    orientation: USER_ACCOUNT_SETTINGS_ORIENTATION;
+    mobileDisplay: USER_ACCOUNT_SETTINGS_SIDEBAR_DISPLAY_TYPE;
+    mode: USER_ACCOUNT_SETTINGS_MODE;
+    widgetsLayout: USER_ACCOUNT_SETTINGS_WIDGETS_LAYOUT;
+    content: IProfileContentCustomizations | null;
+    private isOpen;
+    private currentBreakpoint;
+    private activeTab;
+    /**
+     * The provider's answer, subscribed rather than sampled.
+     *
+     * loadUser reads Auth.getAuthenticatedUser() and gives up when it finds no
+     * identifier. On a fresh page that is every signed-in user, because the
+     * session is rebuilt from the refresh cookie a network round trip after this
+     * element first renders — so sampling once in firstUpdated meant the settings
+     * never loaded for anyone who arrived by reload or redirect.
+     */
+    auth?: AuthState;
+    private _userLoaded;
+    private _userLoading;
+    private userContextValue;
+    private __initialized;
+    private account;
+    private personal;
+    private location;
+    private urls;
+    private get isModal();
+    private get isVerticalOrientation();
+    private get isHorizontalOrientation();
+    get isBurger(): boolean;
+    private get sidebarDisplayType();
+    private get layoutKey();
+    private get containerClasses();
+    private get contentClasses();
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    protected firstUpdated(): void;
+    private fillProfileData;
+    private loadUser;
+    private tryRemoveFallback;
+    private _handleResize;
+    private _updateBreakpoint;
+    private _handleCloseProfile;
+    private _handleOpenProfile;
+    private _toggleAvatarMenu;
+    private _handleAvatarChange;
+    private _handleAvatarRemove;
+    private _handleClickOutside;
+    private renderWatermark;
+    private renderMainContent;
+    private renderTabContent;
+    render(): import('../../../../node_modules/lit-html/directive.js').DirectiveResult<{
+        new (_partInfo: import('../../../../node_modules/lit-html/directive.js').PartInfo): import('../../../../node_modules/lit-html/directives/keyed.js').Keyed<import('../../../../node_modules/lit-html').TemplateResult<1>>;
+    }>;
+    createRenderRoot(): this;
+}

package/dist/components/widgets/pont-account-settings/profile/classes.d.ts

@@ -0,0 +1,9 @@
+export declare const CARD_HEADER_CONTAINER_CLASS = "pont-account-settings-card-header-container";
+export declare const CARD_HEADER_TITLE_CLASS = "pont-account-settings-card-title";
+export declare const CARD_INPUT_LABEL_CLASS = "pont-account-settings-input-label pont-shrink-0 md:pont-block";
+export declare const CARD_INPUT_FIELD_CLASS = "pont-account-settings-input-field pont-border-none !pont-shadow-none disabled:!pont-opacity-100";
+export declare const CARD_CONTAINER_CLASS = "pont-account-settings-card-container";
+export declare const CARD_EDITABLE_INPUT_CLASS = "pont-account-settings-card-edit-input";
+export declare const CARD_DEFAULT_BUTTON = "pont-account-settings-card-button-full";
+export declare const CARD_OUTLINE_BUTTON = "pont-account-settings-card-button-full";
+export declare const CARD_EDIT_BUTTON = "pont-account-settings-card-edit-button pont-text-muted-foreground pont-flex pont-items-center";