valtech-components 2.0.730 → 2.0.731

package/lib/components/organisms/bottom-nav/types.d.ts

@@ -109,7 +109,7 @@ export interface BottomNavMetadata {
     safeArea?: boolean;
     /** Animation style */
     animation?: 'fade' | 'scale' | 'slide' | 'none';
-    /** Cap del ancho de la barra. Token sm|md|lg|xl|full o valor CSS crudo. Default: 'xl' (1100px) — alinea con `--val-container-xl` del repo */
+    /** Cap del ancho de la barra. Token sm|md|lg|xl|full o valor CSS crudo. Default: 'md' (720px) — bottom-nav típicamente tiene pocos tabs y se ve mejor estrecho aunque el contenido use 'xl' */
     maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full' | string;
 }
 /**

package/lib/config/company-footer.config.d.ts

@@ -31,9 +31,19 @@ export declare const VALTECH_FOOTER_LOGO: {
 export interface CompanyLink {
     /** i18n key for the link text */
     key: string;
-    /** URL path or external URL */
+    /** URL path (relative) or absolute URL */
     url: string;
-    /** Whether the link opens in a new tab */
+    /**
+     * Hint for `LegalLinkService` about which app owns this link in a multi-app factory:
+     * - `'legal'` — canonical legal content (terms, privacy, …) — lives on main site
+     * - `'site'`  — marketing/info pages (about, blog, …) — lives on main site
+     * - `'support'` — support/help — typically per-app (each product has own support)
+     *
+     * In satellite apps with `provideValtechLegal({ baseUrl })`, links with kind
+     * `'legal'` or `'site'` get rewritten to the main site URL.
+     */
+    kind?: 'legal' | 'site' | 'support';
+    /** Force opens in a new tab. Resolver may also set this when rewriting cross-origin. */
     external?: boolean;
 }
 /**
@@ -82,12 +92,22 @@ export declare const VALTECH_LANGUAGE_SELECTOR: {
     size: "default";
 };
 /**
- * Helper to build footer links from company links config
+ * Optional URL resolver applied per link (e.g. `LegalLinkService.resolve.bind(svc)`).
+ * Returns `{ url, external? }` to allow cross-origin rewrites.
+ */
+export type CompanyLinkResolver = (link: CompanyLink) => {
+    url: string;
+    external?: boolean;
+};
+/**
+ * Helper to build footer links from company links config.
+ *
  * @param links - Array of company links
  * @param t - Translation function (key: string) => string
+ * @param resolver - Optional resolver — typically `(link) => ({ url: legalLink.resolve(link.url), external: legalLink.isExternal(link.url) && (link.kind === 'legal' || link.kind === 'site') })` to point cross-app legal/site links to the main site.
  * @returns Array of link objects ready for FooterLinksMetadata
  */
-export declare function buildFooterLinks(links: CompanyLink[], t: (key: string) => string): Array<{
+export declare function buildFooterLinks(links: CompanyLink[], t: (key: string) => string, resolver?: CompanyLinkResolver): Array<{
     url: string;
     text: string;
     color: string;

package/lib/services/legal-link/legal-link.service.d.ts

@@ -0,0 +1,59 @@
+import { InjectionToken, Provider } from '@angular/core';
+import * as i0 from "@angular/core";
+/**
+ * Config for cross-app legal/site link resolution.
+ *
+ * Used by satellite apps (showcase, sigify, admin-portal, …) to point their legal
+ * and site links (terms, privacy, about, contact, …) to the main marketing site,
+ * which owns the canonical legal content. The main site itself does NOT call
+ * `provideValtechLegal` — its links stay relative.
+ */
+export interface ValtechLegalConfig {
+    /**
+     * Absolute base URL of the main site (no trailing slash).
+     * @example 'https://myvaltech.com'
+     */
+    baseUrl?: string;
+    /** Open resolved external links in a new tab. Defaults to `true` when `baseUrl` is set. */
+    openInNewTab?: boolean;
+}
+export declare const VALTECH_LEGAL_CONFIG: InjectionToken<ValtechLegalConfig>;
+/**
+ * Resolves legal/site paths against a configurable main-site base URL.
+ *
+ * - **Main site mode**: no `provideValtechLegal` called → `resolve('/legal/terms')` returns `/legal/terms` (relative).
+ * - **Satellite mode**: `provideValtechLegal({ baseUrl: 'https://myvaltech.com' })` → `resolve('/legal/terms')` returns `'https://myvaltech.com/legal/terms'` and `isExternal('/legal/terms')` returns `true`.
+ *
+ * Absolute URLs passed in are returned unchanged (no double-prefix).
+ */
+export declare class LegalLinkService {
+    private readonly config;
+    /** Effective base URL (null if running as main site). */
+    get baseUrl(): string | null;
+    /** Whether resolved external links should open in a new tab. */
+    get openInNewTab(): boolean;
+    /**
+     * Returns the URL to use for a given internal path. Absolute URLs pass through.
+     * @example
+     * resolve('/legal/terms')  // main site:    '/legal/terms'
+     *                          // satellite:    'https://myvaltech.com/legal/terms'
+     * resolve('https://x.com/y') // unchanged
+     */
+    resolve(path: string): string;
+    /** `true` if the path would be resolved to a cross-origin URL. */
+    isExternal(path: string): boolean;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LegalLinkService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LegalLinkService>;
+}
+/**
+ * Wires `LegalLinkService` for satellite apps. Omit in the main site (the one
+ * that hosts the canonical /legal/* routes) so links stay relative.
+ *
+ * @example
+ * // main.ts of showcase / sigify / etc.
+ * provideValtechLegal({
+ *   baseUrl: 'https://myvaltech.com',
+ *   openInNewTab: true,
+ * }),
+ */
+export declare function provideValtechLegal(config: ValtechLegalConfig): Provider;

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.730";
+export declare const VERSION = "2.0.731";

package/package.json

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

package/public-api.d.ts

@@ -242,6 +242,7 @@ export * from './lib/services/meta';
 export * from './lib/services/markdown-article/markdown-article-parser';
 export * from './lib/services/markdown-article/markdown-article-parser.service';
 export * from './lib/services/markdown-article/legal-content.service';
+export * from './lib/services/legal-link/legal-link.service';
 export * from './lib/services/firebase';
 export * from './lib/services/auth';
 export * from './lib/services/i18n';