valtech-components 2.0.784 → 2.0.786

package/lib/components/molecules/action-header/action-header.component.d.ts

@@ -1,5 +1,25 @@
 import { ActionHeaderMetadata } from './types';
 import * as i0 from "@angular/core";
+/**
+ * `val-action-header` — heading with a right-aligned action button.
+ *
+ * By default renders the heading via `val-display` (hero size). Set
+ * `headingKind: 'title'` to render via `val-title` (section size) so it
+ * matches `val-title` section labels elsewhere on the same screen.
+ *
+ * @example Section heading (matches `val-title size='medium'` on the page):
+ * <val-action-header [props]="{
+ *   headingKind: 'title',
+ *   title: { size: 'medium', color: 'dark', bold: true, content: 'Active sessions' },
+ *   action: { text: 'Sign out all', color: 'dark', fill: 'outline', size: 'small', ... },
+ * }"></val-action-header>
+ *
+ * @example Page hero (default):
+ * <val-action-header [props]="{
+ *   title: { size: 'large', color: 'dark', content: 'Settings' },
+ *   action: { ... },
+ * }"></val-action-header>
+ */
 export declare class ActionHeaderComponent {
     props: ActionHeaderMetadata;
     static ɵfac: i0.ɵɵFactoryDeclaration<ActionHeaderComponent, never>;

package/lib/components/molecules/action-header/types.d.ts

@@ -1,6 +1,27 @@
 import { DisplayMetadata } from '../../atoms/display/types';
+import { TitleMetadata } from '../../atoms/title/types';
 import { ButtonMetadata } from '../../types';
+/**
+ * Determines how the heading is rendered.
+ *
+ * - `'display'` (default) — uses `val-display`. Very large (40px medium, 48px large).
+ *   Ideal for page-level hero headers.
+ * - `'title'` — uses `val-title`. Smaller (18px medium, 24px large). Ideal for
+ *   section-level headings inside a page, so they match other `val-title`
+ *   section labels on the same screen.
+ */
+export type ActionHeaderHeadingKind = 'display' | 'title';
+/**
+ * Configuration for `val-action-header` — a section title with a right-aligned
+ * action button. Use `headingKind: 'title'` when this lives inside a page that
+ * already has `val-title` section labels (so sizes stay coherent).
+ */
 export type ActionHeaderMetadata = {
-    title: DisplayMetadata;
+    /** Heading props. Use `DisplayMetadata` shape when `headingKind === 'display'`,
+     *  `TitleMetadata` shape when `headingKind === 'title'`. Both accept
+     *  `size`, `color`, `content`. */
+    title: DisplayMetadata | TitleMetadata;
     action: ButtonMetadata;
+    /** Default `'display'` for back-compat. */
+    headingKind?: ActionHeaderHeadingKind;
 };

package/lib/components/molecules/page-links/page-links.component.d.ts

@@ -0,0 +1,29 @@
+import { PageLink, PageLinksMetadata } from './types';
+import * as i0 from "@angular/core";
+/**
+ * `val-page-links` — stacked list of navigational links with optional dividers.
+ * Used for legal/policies, footer link columns, "about" sections, etc.
+ *
+ * Each item can navigate via Angular `routerLink` (SPA) or external `href`.
+ * Detects absolute URLs (`http(s)://`) to apply `target="_blank"` by default.
+ *
+ * @example
+ * <val-page-links [props]="{
+ *   links: [
+ *     { label: 'Terms', routerLink: '/legal/terms' },
+ *     { label: 'Privacy', routerLink: '/legal/privacy' },
+ *     { label: 'Visit main site', href: 'https://myvaltech.com', icon: 'open-outline' },
+ *   ],
+ * }"></val-page-links>
+ */
+export declare class PageLinksComponent {
+    /** Page links configuration object. */
+    set props(value: PageLinksMetadata);
+    get props(): PageLinksMetadata;
+    private _props;
+    protected links: import("@angular/core").Signal<PageLink[]>;
+    constructor();
+    protected isExternal(link: PageLink): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PageLinksComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PageLinksComponent, "val-page-links", never, { "props": { "alias": "props"; "required": true; }; }, {}, never, never, true, never>;
+}

package/lib/components/molecules/page-links/types.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Single entry of a `val-page-links` list.
+ *
+ * Pass EITHER `routerLink` (Angular SPA navigation) OR `href` (external URL).
+ * If both are present, `routerLink` wins.
+ */
+export interface PageLink {
+    /** Visible text. */
+    label: string;
+    /** Angular router path (e.g. `/legal/terms`). */
+    routerLink?: string;
+    /** External URL (e.g. `https://myvaltech.com/legal/terms`). */
+    href?: string;
+    /**
+     * Force opens in a new tab. Defaults to `true` when `href` looks absolute
+     * (starts with `http://` or `https://`).
+     */
+    external?: boolean;
+    /**
+     * Optional Ionic icon name shown after the label (e.g. `arrow-forward-outline`,
+     * `open-outline` for external). When omitted, no icon is rendered.
+     */
+    icon?: string;
+    /** Optional tooltip / aria-label override. */
+    ariaLabel?: string;
+}
+/**
+ * Config for `val-page-links` — stacked list of navigational links.
+ * Used for legal/policies, footer link columns, "About" sections, etc.
+ */
+export interface PageLinksMetadata {
+    /** Items to render in order. */
+    links: PageLink[];
+    /** Show a divider line between items. Default `true`. */
+    showDividers?: boolean;
+    /** Visual size preset. Default `'medium'`. */
+    size?: 'small' | 'medium' | 'large';
+}

package/lib/version.d.ts

@@ -2,4 +2,4 @@
  * Current version of valtech-components.
  * This is automatically updated during the publish process.
  */
-export declare const VERSION = "2.0.784";
+export declare const VERSION = "2.0.786";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valtech-components",
-  "version": "2.0.784",
+  "version": "2.0.786",
   "private": false,
   "bin": {
     "valtech-firebase-config": "./src/lib/services/firebase/scripts/generate-sw-config.js"

package/public-api.d.ts

@@ -79,6 +79,8 @@ export * from './lib/components/molecules/links-cake/links-cake.component';
 export * from './lib/components/molecules/links-cake/types';
 export * from './lib/components/molecules/notes-box/notes-box.component';
 export * from './lib/components/molecules/notes-box/types';
+export * from './lib/components/molecules/page-links/page-links.component';
+export * from './lib/components/molecules/page-links/types';
 export * from './lib/components/molecules/number-input/number-input.component';
 export * from './lib/components/molecules/number-from-to/number-from-to.component';
 export * from './lib/components/molecules/number-from-to/types';