@se-studio/core-ui 0.0.0-next16-20260822103555

package/dist/utils/structuredDataUtils.d.ts

@@ -0,0 +1,158 @@
+import { type IBaseModel } from '@se-studio/core-data-types';
+import type { BreadcrumbSegment } from './breadcrumbUtils';
+import type { IBuildInformation } from './buildPageMetadata';
+/**
+ * @fileoverview Structured Data Context Builder
+ *
+ * This module builds minimal context objects for structured data (Schema.org JSON-LD) templates.
+ *
+ * ## Design Philosophy: Minimal Context
+ *
+ * This implementation follows a "minimal context" approach where:
+ * - **Static data lives in CMS templates** (organization name, address, contact info)
+ * - **Dynamic data lives in this context** (URLs, page titles, dates)
+ *
+ * ### Why This Approach?
+ *
+ * 1. **Separation of Concerns**: Content editors control static organizational data in the CMS,
+ *    while deployment-specific values (like baseUrl) are injected at runtime.
+ *
+ * 2. **Simpler Templates**: Content editors work with straightforward variables like
+ *    `{{baseUrl}}` and `{{page.title}}` rather than deeply nested objects.
+ *
+ * 3. **Easier Maintenance**: When organization details change, update the CMS template once
+ *    rather than changing code and redeploying.
+ *
+ * 4. **Deployment Flexibility**: The same CMS templates work across dev/staging/prod with
+ *    only the baseUrl changing.
+ *
+ * ### Example CMS Template
+ *
+ * ```json
+ * {
+ *   "@context": "https://schema.org",
+ *   "@type": "Organization",
+ *   "name": "OM1",
+ *   "url": "{{baseUrl}}",
+ *   "logo": "{{baseUrl}}/logo.svg",
+ *   "description": "Predict What's Next. Improve Outcomes.",
+ *   "address": {
+ *     "@type": "PostalAddress",
+ *     "streetAddress": "31 St. James Ave Suite #1010",
+ *     "addressLocality": "Boston"
+ *   }
+ * }
+ * ```
+ *
+ * ### Available Context Variables
+ *
+ * - `baseUrl` - Site base URL (environment-specific)
+ * - `currentUrl` - Full URL of current page
+ * - `page.title` - Page title
+ * - `page.description` - Page description
+ * - `page.slug` - Page slug
+ * - `page.imageUrl` - Featured image URL (if available)
+ * - `page.breadcrumbs` - Array of breadcrumb objects. Each has position, name, last; url is optional.
+ *   When a segment has no link (e.g. path in breadcrumbNoLinkPaths), url is omitted. BreadcrumbList
+ *   templates in the CMS must output the ListItem "item" only when url is present (e.g. Mustache:
+ *   {{#url}}"item": {"@id": "{{{url}}}"}{{/url}}) so non-link segments get only name and position.
+ * - `article.*` - Article-specific fields (only for Article pages)
+ * - `person.*` - Person-specific fields (only for Person pages)
+ * - `listing.items` - ItemList entries (position, name, url, last) when provided
+ *
+ * @see {@link StructuredDataContext} for complete context interface
+ */
+/**
+ * Minimal context object for Mustache templates in structured data.
+ *
+ * Philosophy: Only truly dynamic values that change per page/deployment should be in this context.
+ * Static organizational data (company name, address, etc.) should be hardcoded in CMS templates.
+ *
+ * This keeps templates simpler and separates concerns:
+ * - Static data (organization details) → CMS templates
+ * - Dynamic data (URLs, page-specific info) → This context
+ */
+export interface StructuredDataContext {
+    baseUrl: string;
+    currentUrl: string;
+    page: {
+        title: string;
+        description: string;
+        slug: string;
+        imageUrl?: string;
+        breadcrumbs: Array<{
+            position: number;
+            name: string;
+            url?: string;
+            last: boolean;
+        }>;
+    };
+    article?: {
+        title: string;
+        description: string;
+        datePublished: string;
+        dateModified: string;
+        authorName?: string;
+        authorUrl?: string;
+        /** All authors in order (for multi-author JSON-LD). */
+        authors?: Array<{
+            name: string;
+            url?: string;
+        }>;
+        imageUrl?: string;
+    };
+    person?: {
+        name: string;
+        jobTitle?: string;
+        imageUrl?: string;
+    };
+    /** ItemList context for hub/index pages (article type, tag, person). */
+    listing?: {
+        items: Array<{
+            position: number;
+            name: string;
+            url: string;
+            last: boolean;
+        }>;
+    };
+    [key: string]: unknown;
+}
+/**
+ * Extracts entity nodes from a parsed JSON-LD object for merging into a flat @graph.
+ * CMS templates often render as `{ @context, @graph: [entity] }`; merging multiple
+ * templates must flatten inner @graph arrays, not nest them.
+ */
+export declare function graphNodesFromParsed(obj: unknown): unknown[];
+/**
+ * Builds the final JSON-LD object from one or more parsed schema templates.
+ * Always emits a top-level `@context`. Single entity → context + entity fields;
+ * multiple → one document with a flat `@graph`.
+ */
+export declare function buildMergedStructuredDataJson(parsedSchemas: unknown[]): unknown;
+/**
+ * Options for buildStructuredDataContext.
+ */
+export interface BuildStructuredDataContextOptions {
+    /** Pre-resolved breadcrumb segments from resolveBreadcrumbSegments. When provided, used for Schema.org instead of slug-derived labels. */
+    resolvedBreadcrumbs?: BreadcrumbSegment[] | null;
+    /** Pre-built ItemList entries for hub/index pages. */
+    listing?: StructuredDataContext['listing'];
+    [key: string]: unknown;
+}
+/**
+ * Builds a minimal context object for structured data templates.
+ *
+ * Only includes truly dynamic values that change per page or deployment:
+ * - URLs (baseUrl varies by environment)
+ * - Page-specific content (title, description, images)
+ * - Content-type specific data (article dates, person info)
+ *
+ * Static organizational data (company name, address, etc.) should be
+ * hardcoded in CMS templates, not injected here.
+ *
+ * @param model - The CMS content model (Page, Article, Person, etc.)
+ * @param config - Build configuration (baseUrl and customerName)
+ * @param extraContextOrOptions - Optional extra context or options (resolvedBreadcrumbs)
+ */
+export declare function buildStructuredDataContext(model: IBaseModel, config: IBuildInformation, extraContextOrOptions?: Record<string, unknown> | BuildStructuredDataContextOptions): StructuredDataContext;
+//# sourceMappingURL=structuredDataUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structuredDataUtils.d.ts","sourceRoot":"","sources":["../../src/utils/structuredDataUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EAIhB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IAEpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IAGnB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KACrF,CAAC;IAGF,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uDAAuD;QACvD,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,wEAAwE;IACxE,OAAO,CAAC,EAAE;QACR,KAAK,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAC9E,CAAC;IAGF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAUD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,EAAE,CAY5D;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,OAAO,EAAE,GAAG,OAAO,CAkB/E;AAyGD;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,0IAA0I;IAC1I,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACjD,sDAAsD;IACtD,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC3C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,iBAAiB,EACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iCAAiC,GAClF,qBAAqB,CA0FvB"}

package/dist/utils/structuredDataUtils.js

@@ -0,0 +1,225 @@
+import { getArticleAuthors, getPrimaryArticleAuthor, mergeMeta, parseMeta, } from '@se-studio/core-data-types';
+function stripDocumentContext(node) {
+    if (typeof node !== 'object' || node === null || !('@context' in node)) {
+        return node;
+    }
+    const { '@context': _, ...rest } = node;
+    return rest;
+}
+/**
+ * Extracts entity nodes from a parsed JSON-LD object for merging into a flat @graph.
+ * CMS templates often render as `{ @context, @graph: [entity] }`; merging multiple
+ * templates must flatten inner @graph arrays, not nest them.
+ */
+export function graphNodesFromParsed(obj) {
+    if (typeof obj !== 'object' || obj === null) {
+        return [obj];
+    }
+    const record = obj;
+    if (Array.isArray(record['@graph'])) {
+        return record['@graph'].map(stripDocumentContext);
+    }
+    if ('@context' in record) {
+        return [stripDocumentContext(record)];
+    }
+    return [obj];
+}
+/**
+ * Builds the final JSON-LD object from one or more parsed schema templates.
+ * Always emits a top-level `@context`. Single entity → context + entity fields;
+ * multiple → one document with a flat `@graph`.
+ */
+export function buildMergedStructuredDataJson(parsedSchemas) {
+    const nodes = parsedSchemas.flatMap(graphNodesFromParsed);
+    if (nodes.length === 0) {
+        return {
+            '@context': 'https://schema.org',
+            '@graph': [],
+        };
+    }
+    if (nodes.length === 1) {
+        return {
+            '@context': 'https://schema.org',
+            ...nodes[0],
+        };
+    }
+    return {
+        '@context': 'https://schema.org',
+        '@graph': nodes,
+    };
+}
+/**
+ * Helper to build the breadcrumbs array for structured data.
+ * Splits the path and creates breadcrumb entries with positions.
+ *
+ * @param path - Current page path (e.g., '/about/team')
+ * @param baseUrl - Base URL for the site
+ * @param currentTitle - Title of the current page
+ * @param breadcrumbTitleOverride - Optional override for the last breadcrumb title
+ */
+function buildBreadcrumbs(path, baseUrl, currentTitle, breadcrumbTitleOverride) {
+    const segments = path.split('/').filter(Boolean);
+    const breadcrumbs = [];
+    // Home
+    breadcrumbs.push({
+        position: 1,
+        name: 'Home',
+        url: `${baseUrl}/`,
+        last: segments.length === 0,
+    });
+    let currentPath = '';
+    segments.forEach((segment, index) => {
+        currentPath += `/${segment}`;
+        const isLast = index === segments.length - 1;
+        // For intermediate segments, capitalize the slug
+        // For the last segment, use the page title or override
+        let name = segment.charAt(0).toUpperCase() + segment.slice(1).replace(/-/g, ' ');
+        if (isLast) {
+            name = breadcrumbTitleOverride || currentTitle;
+        }
+        breadcrumbs.push({
+            position: index + 2,
+            name: name,
+            url: `${baseUrl}${currentPath}/`,
+            last: isLast,
+        });
+    });
+    return breadcrumbs;
+}
+/**
+ * Converts pre-resolved breadcrumb segments to Schema.org format.
+ * Non-last segments without seg.href get no url (for BreadcrumbList templates that use {{#url}}).
+ *
+ * @param segments - Pre-resolved segments from resolveBreadcrumbSegments
+ * @param baseUrl - Base URL for the site
+ * @param currentPath - Full path of current page (for last segment URL)
+ */
+function segmentsToStructuredData(segments, baseUrl, currentPath) {
+    const breadcrumbs = [
+        { position: 1, name: 'Home', url: `${baseUrl}/`, last: false },
+    ];
+    segments.forEach((seg, index) => {
+        const isLast = index === segments.length - 1;
+        if (isLast) {
+            breadcrumbs.push({
+                position: index + 2,
+                name: seg.label,
+                url: `${baseUrl}${currentPath}`,
+                last: true,
+            });
+        }
+        else if (seg.href) {
+            breadcrumbs.push({
+                position: index + 2,
+                name: seg.label,
+                url: `${baseUrl}${seg.href}`,
+                last: false,
+            });
+        }
+        else {
+            breadcrumbs.push({
+                position: index + 2,
+                name: seg.label,
+                last: false,
+            });
+        }
+    });
+    return breadcrumbs;
+}
+/**
+ * Builds a minimal context object for structured data templates.
+ *
+ * Only includes truly dynamic values that change per page or deployment:
+ * - URLs (baseUrl varies by environment)
+ * - Page-specific content (title, description, images)
+ * - Content-type specific data (article dates, person info)
+ *
+ * Static organizational data (company name, address, etc.) should be
+ * hardcoded in CMS templates, not injected here.
+ *
+ * @param model - The CMS content model (Page, Article, Person, etc.)
+ * @param config - Build configuration (baseUrl and customerName)
+ * @param extraContextOrOptions - Optional extra context or options (resolvedBreadcrumbs)
+ */
+export function buildStructuredDataContext(model, config, extraContextOrOptions) {
+    const { baseUrl } = config;
+    const path = model.href;
+    const currentUrl = `${baseUrl}${path}`;
+    const featuredImageId = model.featuredImage?.id;
+    const ogBase = config.ogImagePath ?? '/og';
+    const imageUrl = featuredImageId ? `${baseUrl}${ogBase}/${featuredImageId}.jpg` : undefined;
+    const opts = extraContextOrOptions;
+    const resolvedBreadcrumbs = opts?.resolvedBreadcrumbs;
+    const extraContext = { ...opts };
+    delete extraContext.resolvedBreadcrumbs;
+    delete extraContext.listing;
+    const extraMeta = extraContext.meta;
+    delete extraContext.meta;
+    const breadcrumbs = resolvedBreadcrumbs && resolvedBreadcrumbs.length > 0
+        ? segmentsToStructuredData(resolvedBreadcrumbs, baseUrl, path)
+        : buildBreadcrumbs(path, baseUrl, model.title, model.breadcrumbTitle);
+    // Base context with page information
+    const context = {
+        baseUrl: `${baseUrl}/`,
+        currentUrl,
+        page: {
+            title: model.title,
+            description: model.description,
+            slug: model.slug,
+            imageUrl,
+            breadcrumbs,
+        },
+        ...(opts?.listing ? { listing: opts.listing } : {}),
+        ...extraContext,
+    };
+    const meta = mergeMeta(parseMeta(model.meta), parseMeta(extraMeta));
+    if (Object.keys(meta).length > 0) {
+        context.meta = meta;
+    }
+    // Article-specific context
+    if (model.type === 'Article') {
+        const article = model;
+        const primaryAuthor = getPrimaryArticleAuthor(article);
+        const primaryAuthorName = primaryAuthor?.name ?? primaryAuthor?.title;
+        const authors = getArticleAuthors(article).flatMap((person) => {
+            const name = person.name ?? person.title;
+            if (!name)
+                return [];
+            return [
+                {
+                    name,
+                    url: person.href ? `${baseUrl}${person.href}` : undefined,
+                },
+            ];
+        });
+        context.article = {
+            title: article.title,
+            description: article.description,
+            datePublished: article.date
+                ? new Date(article.date).toISOString()
+                : article.lastUpdated
+                    ? new Date(article.lastUpdated).toISOString()
+                    : new Date().toISOString(),
+            dateModified: article.lastUpdated
+                ? new Date(article.lastUpdated).toISOString()
+                : article.date
+                    ? new Date(article.date).toISOString()
+                    : new Date().toISOString(),
+            imageUrl,
+            authorName: primaryAuthorName,
+            authorUrl: primaryAuthor?.href ? `${baseUrl}${primaryAuthor.href}` : undefined,
+            authors,
+        };
+    }
+    // Person-specific context
+    if (model.type === 'Person') {
+        const person = model;
+        context.person = {
+            name: person.title,
+            jobTitle: person.jobTitle || undefined,
+            imageUrl,
+        };
+    }
+    return context;
+}
+//# sourceMappingURL=structuredDataUtils.js.map

package/dist/utils/structuredDataUtils.js.map

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

package/dist/utils/urlUtils.d.ts

@@ -0,0 +1,30 @@
+export declare function isAbsoluteUrl(url: string): boolean;
+/**
+ * Ensure page-like internal paths use a trailing slash (SE Studio `trailingSlash: true`).
+ *
+ * - Preserves query string and hash (`/drive#x` → `/drive/#x`, `/drive?q=1` → `/drive/?q=1`).
+ * - Leaves `/`, already-slashed paths, hash-only, and non-path hrefs unchanged.
+ * - Skips file-like last segments (contain a `.`) so download/asset paths stay bare.
+ */
+export declare function ensureInternalPageTrailingSlash(href: string): string;
+/**
+ * Resolve a hyperlink href for navigation + external treatment.
+ *
+ * - Relative / hash / protocol-relative-handled-as-absolute paths stay as-is (not external
+ *   unless absolute http(s) to another origin).
+ * - Absolute same-site URLs (matching `siteBaseUrl` origin, or `window.location.origin`
+ *   when no base is provided) are stripped to path + search + hash and treated as internal.
+ * - Absolute other-origin URLs stay absolute and are external (typically target=_blank).
+ * - Internal page paths are normalized to trailing-slash form (SE Studio convention) so
+ *   plain RTF hyperlinks like `/drive` do not force a 308 redirect.
+ */
+export declare function resolveTrackedHref(href: string, siteBaseUrl?: string | null): {
+    href: string;
+    isExternal: boolean;
+};
+/**
+ * Utility function to get the current page URL safely.
+ * Returns an empty string when running on the server.
+ */
+export declare function getCurrentPageUrl(): string;
+//# sourceMappingURL=urlUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"urlUtils.d.ts","sourceRoot":"","sources":["../../src/utils/urlUtils.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOlD;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAsCvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}

package/dist/utils/urlUtils.js

@@ -0,0 +1,100 @@
+export function isAbsoluteUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'http:' || parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Ensure page-like internal paths use a trailing slash (SE Studio `trailingSlash: true`).
+ *
+ * - Preserves query string and hash (`/drive#x` → `/drive/#x`, `/drive?q=1` → `/drive/?q=1`).
+ * - Leaves `/`, already-slashed paths, hash-only, and non-path hrefs unchanged.
+ * - Skips file-like last segments (contain a `.`) so download/asset paths stay bare.
+ */
+export function ensureInternalPageTrailingSlash(href) {
+    if (!href || href === '#' || href.startsWith('#') || !href.startsWith('/')) {
+        return href;
+    }
+    let path = href;
+    let search = '';
+    let hash = '';
+    const hashIdx = path.indexOf('#');
+    if (hashIdx >= 0) {
+        hash = path.slice(hashIdx);
+        path = path.slice(0, hashIdx);
+    }
+    const qIdx = path.indexOf('?');
+    if (qIdx >= 0) {
+        search = path.slice(qIdx);
+        path = path.slice(0, qIdx);
+    }
+    if (path === '/' || path.endsWith('/')) {
+        return `${path}${search}${hash}`;
+    }
+    const lastSegment = path.split('/').filter(Boolean).pop() ?? '';
+    if (lastSegment.includes('.')) {
+        return `${path}${search}${hash}`;
+    }
+    return `${path}/${search}${hash}`;
+}
+/**
+ * Resolve a hyperlink href for navigation + external treatment.
+ *
+ * - Relative / hash / protocol-relative-handled-as-absolute paths stay as-is (not external
+ *   unless absolute http(s) to another origin).
+ * - Absolute same-site URLs (matching `siteBaseUrl` origin, or `window.location.origin`
+ *   when no base is provided) are stripped to path + search + hash and treated as internal.
+ * - Absolute other-origin URLs stay absolute and are external (typically target=_blank).
+ * - Internal page paths are normalized to trailing-slash form (SE Studio convention) so
+ *   plain RTF hyperlinks like `/drive` do not force a 308 redirect.
+ */
+export function resolveTrackedHref(href, siteBaseUrl) {
+    if (!href || href === '#' || href.startsWith('#')) {
+        return { href, isExternal: false };
+    }
+    if (href.startsWith('/')) {
+        return { href: ensureInternalPageTrailingSlash(href), isExternal: false };
+    }
+    if (!isAbsoluteUrl(href)) {
+        return { href, isExternal: false };
+    }
+    try {
+        const url = new URL(href);
+        const candidates = [];
+        if (siteBaseUrl) {
+            try {
+                candidates.push(new URL(siteBaseUrl).origin);
+            }
+            catch {
+                // ignore invalid base
+            }
+        }
+        if (typeof window !== 'undefined' && window.location?.origin) {
+            candidates.push(window.location.origin);
+        }
+        if (candidates.some((origin) => origin === url.origin)) {
+            return {
+                href: ensureInternalPageTrailingSlash(`${url.pathname}${url.search}${url.hash}`),
+                isExternal: false,
+            };
+        }
+        return { href, isExternal: true };
+    }
+    catch {
+        return { href, isExternal: false };
+    }
+}
+/**
+ * Utility function to get the current page URL safely.
+ * Returns an empty string when running on the server.
+ */
+export function getCurrentPageUrl() {
+    if (typeof window !== 'undefined') {
+        return window.location.href;
+    }
+    return '';
+}
+//# sourceMappingURL=urlUtils.js.map

package/dist/utils/urlUtils.js.map

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

package/dist/utils/visualPositions.d.ts

@@ -0,0 +1,3 @@
+import { type IVisual } from '@se-studio/core-data-types';
+export declare function calculateHorizontalPositionClassName(visual?: IVisual): "laptop:mr-auto" | "laptop:ml-auto" | "laptop:mx-auto";
+//# sourceMappingURL=visualPositions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualPositions.d.ts","sourceRoot":"","sources":["../../src/utils/visualPositions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAEvF,wBAAgB,oCAAoC,CAAC,MAAM,CAAC,EAAE,OAAO,0DAUpE"}

package/dist/utils/visualPositions.js

@@ -0,0 +1,13 @@
+import { getVisualHorizontalPosition } from '@se-studio/core-data-types';
+export function calculateHorizontalPositionClassName(visual) {
+    const horizontalPosition = getVisualHorizontalPosition(visual);
+    switch (horizontalPosition) {
+        case 'Left':
+            return 'laptop:mr-auto';
+        case 'Right':
+            return 'laptop:ml-auto';
+        default:
+            return 'laptop:mx-auto';
+    }
+}
+//# sourceMappingURL=visualPositions.js.map

package/dist/utils/visualPositions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualPositions.js","sourceRoot":"","sources":["../../src/utils/visualPositions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAgB,MAAM,4BAA4B,CAAC;AAEvF,MAAM,UAAU,oCAAoC,CAAC,MAAgB;IACnE,MAAM,kBAAkB,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC/D,QAAQ,kBAAkB,EAAE,CAAC;QAC3B,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC;QAC1B,KAAK,OAAO;YACV,OAAO,gBAAgB,CAAC;QAC1B;YACE,OAAO,gBAAgB,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/utils/visualSizes.d.ts

@@ -0,0 +1,5 @@
+import type { IVisualSizes } from '@se-studio/core-data-types';
+export declare function calculateVisualSizes(defaultRatio: number, breakpointRatios?: Partial<Record<string, number>>, sizes?: Record<string, {
+    breakpoint: number;
+}>): IVisualSizes;
+//# sourceMappingURL=visualSizes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualSizes.d.ts","sourceRoot":"","sources":["../../src/utils/visualSizes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAQ/D,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,gBAuB/C"}

package/dist/utils/visualSizes.js

@@ -0,0 +1,27 @@
+const DEFAULT_BREAKPOINTS = {
+    tablet: { breakpoint: 768 },
+    laptop: { breakpoint: 1024 },
+    desktop: { breakpoint: 1440 },
+};
+export function calculateVisualSizes(defaultRatio, breakpointRatios, sizes) {
+    const effectiveSizes = sizes || DEFAULT_BREAKPOINTS;
+    const visualSizes = {
+        defaultSize: `${Math.round(defaultRatio * 100)}vw`,
+        breakpoints: breakpointRatios
+            ? Object.entries(breakpointRatios).map(([size, ratio]) => {
+                const info = effectiveSizes[size];
+                if (!info || ratio === undefined) {
+                    throw new Error(`Size ${size} not found in configuration or ratio is undefined`);
+                }
+                return {
+                    minWidth: info.breakpoint,
+                    proportion: ratio,
+                    pixels: Math.round(info.breakpoint * ratio),
+                    size: `${Math.round(ratio * 100)}vw`,
+                };
+            })
+            : undefined,
+    };
+    return visualSizes;
+}
+//# sourceMappingURL=visualSizes.js.map

package/dist/utils/visualSizes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualSizes.js","sourceRoot":"","sources":["../../src/utils/visualSizes.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAA2C;IAClE,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE;IAC3B,MAAM,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;IAC5B,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;CAC9B,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAClC,YAAoB,EACpB,gBAAkD,EAClD,KAA8C;IAE9C,MAAM,cAAc,GAAG,KAAK,IAAI,mBAAmB,CAAC;IAEpD,MAAM,WAAW,GAAiB;QAChC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,IAAI;QAClD,WAAW,EAAE,gBAAgB;YAC3B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;gBACrD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,mDAAmD,CAAC,CAAC;gBACnF,CAAC;gBACD,OAAO;oBACL,QAAQ,EAAE,IAAI,CAAC,UAAU;oBACzB,UAAU,EAAE,KAAK;oBACjB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;oBAC3C,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI;iBACrC,CAAC;YACJ,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/utils/wcagRelativeLuminanceFromHex.d.ts

@@ -0,0 +1,8 @@
+/**
+ * WCAG 2.1 relative luminance (0 = black, 1 = white) for an sRGB hex string.
+ *
+ * Accepts `#RGB` or `#RRGGBB` (case-insensitive hex digits). Trims surrounding whitespace.
+ * Returns `null` if the string is not a valid hex color.
+ */
+export declare function wcagRelativeLuminanceFromHex(hex: string): number | null;
+//# sourceMappingURL=wcagRelativeLuminanceFromHex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wcagRelativeLuminanceFromHex.d.ts","sourceRoot":"","sources":["../../src/utils/wcagRelativeLuminanceFromHex.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBvE"}

package/dist/utils/wcagRelativeLuminanceFromHex.js

@@ -0,0 +1,30 @@
+const HEX_COLOR_REGEX = /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/;
+function expandShortHex(hex) {
+    if (hex.length !== 4) {
+        return hex;
+    }
+    return `#${hex[1]}${hex[1]}${hex[2]}${hex[2]}${hex[3]}${hex[3]}`;
+}
+/**
+ * WCAG 2.1 relative luminance (0 = black, 1 = white) for an sRGB hex string.
+ *
+ * Accepts `#RGB` or `#RRGGBB` (case-insensitive hex digits). Trims surrounding whitespace.
+ * Returns `null` if the string is not a valid hex color.
+ */
+export function wcagRelativeLuminanceFromHex(hex) {
+    const trimmed = hex.trim();
+    if (!HEX_COLOR_REGEX.test(trimmed)) {
+        return null;
+    }
+    const full = expandShortHex(trimmed);
+    const n = Number.parseInt(full.slice(1), 16);
+    if (!Number.isFinite(n)) {
+        return null;
+    }
+    const toLinear = (c) => (c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4);
+    const r = toLinear(((n >> 16) & 0xff) / 255);
+    const g = toLinear(((n >> 8) & 0xff) / 255);
+    const b = toLinear((n & 0xff) / 255);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+//# sourceMappingURL=wcagRelativeLuminanceFromHex.js.map