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

package/dist/utils/processCollectionLinks.js

@@ -0,0 +1,38 @@
+import { isBlankLink } from '@se-studio/core-data-types';
+/**
+ * Automatically configures links with no target based on context.
+ * If on an article page, blank/empty links will be configured using the provided callback.
+ *
+ * @param links - Array of links to process
+ * @param contentContext - Context containing page information
+ * @returns Processed array of links
+ */
+export function processCollectionLinks(links, contentContext) {
+    if (links.length === 0) {
+        return links;
+    }
+    const currentArticle = contentContext.pageContext.article;
+    if (!currentArticle) {
+        return links;
+    }
+    const hasBlankLinks = links.some((link) => isBlankLink(link));
+    if (!hasBlankLinks) {
+        return links;
+    }
+    const articleTypeLink = currentArticle.articleType;
+    if (!articleTypeLink) {
+        return links;
+    }
+    return links.map((link) => {
+        if (isBlankLink(link)) {
+            const linkWithExistingText = {
+                ...articleTypeLink,
+                text: link.text,
+                id: link.id,
+            };
+            return linkWithExistingText;
+        }
+        return link;
+    });
+}
+//# sourceMappingURL=processCollectionLinks.js.map

package/dist/utils/processCollectionLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processCollectionLinks.js","sourceRoot":"","sources":["../../src/utils/processCollectionLinks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEhG;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAgC,EAChC,cAA+B;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,cAAc,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC;IAC1D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC;IACnD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,MAAM,oBAAoB,GAAG;gBAC3B,GAAG,eAAe;gBAClB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;aACZ,CAAC;YACF,OAAO,oBAAoB,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/processTextContent.d.ts

@@ -0,0 +1,18 @@
+import type { IContentContext } from '@se-studio/core-data-types';
+import type { ReactNode } from 'react';
+/**
+ * Renders text content with optional custom processing (e.g. {{phone}} placeholders).
+ * Uses contentContext.processText when available, otherwise falls back to convertText.
+ *
+ * @param text - The text to render (may contain placeholders)
+ * @param contentContext - Optional content context with processText from renderer config
+ * @returns React node (string, span, fragment, etc.)
+ *
+ * @example
+ * ```tsx
+ * // In a component renderer with contentContext
+ * {processTextContent(heading, contentContext)}
+ * ```
+ */
+export declare function processTextContent(text: string, contentContext?: IContentContext): ReactNode;
+//# sourceMappingURL=processTextContent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processTextContent.d.ts","sourceRoot":"","sources":["../../src/utils/processTextContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,eAAe,GAAG,SAAS,CAS5F"}

package/dist/utils/processTextContent.js

@@ -0,0 +1,24 @@
+import { interpolateMetaTokens, resolveMetaFromPageContext } from '@se-studio/core-data-types';
+import { convertText } from './convertText';
+/**
+ * Renders text content with optional custom processing (e.g. {{phone}} placeholders).
+ * Uses contentContext.processText when available, otherwise falls back to convertText.
+ *
+ * @param text - The text to render (may contain placeholders)
+ * @param contentContext - Optional content context with processText from renderer config
+ * @returns React node (string, span, fragment, etc.)
+ *
+ * @example
+ * ```tsx
+ * // In a component renderer with contentContext
+ * {processTextContent(heading, contentContext)}
+ * ```
+ */
+export function processTextContent(text, contentContext) {
+    if (contentContext?.processText) {
+        return contentContext.processText(text, contentContext);
+    }
+    const interpolated = interpolateMetaTokens(text, resolveMetaFromPageContext(contentContext?.pageContext));
+    return convertText(interpolated);
+}
+//# sourceMappingURL=processTextContent.js.map

package/dist/utils/processTextContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processTextContent.js","sourceRoot":"","sources":["../../src/utils/processTextContent.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE/F,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,cAAgC;IAC/E,IAAI,cAAc,EAAE,WAAW,EAAE,CAAC;QAChC,OAAO,cAAc,CAAC,WAAW,CAAC,IAAI,EAAE,cAAc,CAAc,CAAC;IACvE,CAAC;IACD,MAAM,YAAY,GAAG,qBAAqB,CACxC,IAAI,EACJ,0BAA0B,CAAC,cAAc,EAAE,WAAW,CAAC,CACxD,CAAC;IACF,OAAO,WAAW,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC"}

package/dist/utils/reactNodeText.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+/**
+ * Recursively extract visible text from React children (strings, numbers, nested elements).
+ * Used by TrackedLink when CMS/RTF does not pass an explicit `linkText`.
+ */
+export declare function extractTextFromReactNode(node: ReactNode, maxDepth?: number): string;
+//# sourceMappingURL=reactNodeText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reactNodeText.d.ts","sourceRoot":"","sources":["../../src/utils/reactNodeText.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIjE;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAIR"}

package/dist/utils/reactNodeText.js

@@ -0,0 +1,43 @@
+import { Children, isValidElement } from 'react';
+const DEFAULT_MAX_DEPTH = 8;
+/**
+ * Recursively extract visible text from React children (strings, numbers, nested elements).
+ * Used by TrackedLink when CMS/RTF does not pass an explicit `linkText`.
+ */
+export function extractTextFromReactNode(node, maxDepth = DEFAULT_MAX_DEPTH) {
+    const parts = [];
+    walk(node, parts, 0, maxDepth);
+    return parts.join('').replace(/\s+/g, ' ').trim();
+}
+function walk(node, parts, depth, maxDepth) {
+    if (node == null || typeof node === 'boolean' || depth > maxDepth) {
+        return;
+    }
+    if (typeof node === 'string' || typeof node === 'number') {
+        parts.push(String(node));
+        return;
+    }
+    if (Array.isArray(node)) {
+        for (const child of node) {
+            walk(child, parts, depth, maxDepth);
+        }
+        return;
+    }
+    if (isValidElement(node)) {
+        const props = node.props;
+        if (props?.children != null) {
+            walk(props.children, parts, depth + 1, maxDepth);
+        }
+        return;
+    }
+    // Iterable children (e.g. some Fragment edge cases)
+    try {
+        Children.forEach(node, (child) => {
+            walk(child, parts, depth + 1, maxDepth);
+        });
+    }
+    catch {
+        // ignore non-children values
+    }
+}
+//# sourceMappingURL=reactNodeText.js.map

package/dist/utils/reactNodeText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactNodeText.js","sourceRoot":"","sources":["../../src/utils/reactNodeText.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAkB,MAAM,OAAO,CAAC;AAEjE,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAe,EACf,WAAmB,iBAAiB;IAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,IAAI,CAAC,IAAe,EAAE,KAAe,EAAE,KAAa,EAAE,QAAgB;IAC7E,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,SAAS,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QAClE,OAAO;IACT,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAiC,CAAC;QACrD,IAAI,KAAK,EAAE,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QACD,OAAO;IACT,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,IAAiB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5C,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;AACH,CAAC"}

package/dist/utils/richTextNodeText.d.ts

@@ -0,0 +1,13 @@
+import type { Block, Inline, Text } from '@contentful/rich-text-types';
+type RichTextLikeNode = Block | Inline | Text | {
+    nodeType?: string;
+    value?: string;
+    content?: unknown[];
+};
+/**
+ * Flatten plain text from a Contentful rich-text node (hyperlink, paragraph, etc.).
+ * Concatenates all `text` node values under `content`, ignoring marks and nested structure.
+ */
+export declare function extractRichTextNodeText(node: RichTextLikeNode | null | undefined): string;
+export {};
+//# sourceMappingURL=richTextNodeText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"richTextNodeText.d.ts","sourceRoot":"","sources":["../../src/utils/richTextNodeText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAEvE,KAAK,gBAAgB,GACjB,KAAK,GACL,MAAM,GACN,IAAI,GACJ;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAUzF"}

package/dist/utils/richTextNodeText.js

@@ -0,0 +1,29 @@
+/**
+ * Flatten plain text from a Contentful rich-text node (hyperlink, paragraph, etc.).
+ * Concatenates all `text` node values under `content`, ignoring marks and nested structure.
+ */
+export function extractRichTextNodeText(node) {
+    if (!node)
+        return '';
+    if (typeof node.value === 'string' && node.nodeType === 'text') {
+        return (node.value ?? '').trim();
+    }
+    const parts = [];
+    walk(node, parts);
+    return parts.join('').replace(/\s+/g, ' ').trim();
+}
+function walk(node, parts) {
+    if (!node || typeof node !== 'object')
+        return;
+    if (node.nodeType === 'text' && typeof node.value === 'string') {
+        parts.push(node.value);
+        return;
+    }
+    const content = node.content;
+    if (!Array.isArray(content))
+        return;
+    for (const child of content) {
+        walk(child, parts);
+    }
+}
+//# sourceMappingURL=richTextNodeText.js.map

package/dist/utils/richTextNodeText.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"richTextNodeText.js","sourceRoot":"","sources":["../../src/utils/richTextNodeText.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAyC;IAC/E,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IAErB,IAAI,OAAQ,IAAa,CAAC,KAAK,KAAK,QAAQ,IAAK,IAAa,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACnF,OAAO,CAAE,IAAa,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,IAAI,CAAC,IAAsB,EAAE,KAAe;IACnD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO;IAE9C,IAAK,IAAa,CAAC,QAAQ,KAAK,MAAM,IAAI,OAAQ,IAAa,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACnF,KAAK,CAAC,IAAI,CAAE,IAAa,CAAC,KAAK,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAI,IAAuB,CAAC,OAAO,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO;IAEpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAyB,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/utils/robots.d.ts

@@ -0,0 +1,115 @@
+import type { MetadataRoute } from 'next';
+/** Default production disallow paths for SE Studio marketing sites. */
+export declare const DEFAULT_ROBOTS_DISALLOW: readonly ["/*?_rsc=*", "/_next/data/", "/api/", "/preview/", "/page-test/", "/cms/", "/og/"];
+/**
+ * Optional tracking-param crawl traps (e.g. Point Me SEO audit).
+ * Note: Google applies robots.txt to the path only, not query strings — these rules
+ * help other crawlers and audit tooling but are not a complete Google fix.
+ */
+export declare const TRACKING_QUERY_ROBOTS_DISALLOW: readonly ["/*?_gl=*", "/*?nnerid=*", "/*?ref=*"];
+/** Yes/no preference for Content Signals (contentsignals.org). */
+export type ContentSignalPreference = 'yes' | 'no';
+/**
+ * AI usage preferences for robots.txt Content-Signal directives.
+ * @see https://contentsignals.org/
+ */
+export interface ContentSignals {
+    /** Building a search index / classic search results. */
+    search: ContentSignalPreference;
+    /** Training or fine-tuning AI models. */
+    aiTrain: ContentSignalPreference;
+    /** Using content as AI input (RAG, grounding, inference). */
+    aiInput: ContentSignalPreference;
+}
+export interface CreateRobotsConfigOptions {
+    isProduction: boolean;
+    baseUrl: string;
+    /** Default: `${baseUrl}/sitemap.xml` */
+    sitemapUrl?: string;
+    /** Replace the built-in list entirely (production only). */
+    disallow?: readonly string[];
+    /** Merged after defaults (production only). */
+    disallowExtra?: readonly string[];
+    /** Removed from defaults (production only). e.g. `['/page-test/']` when no A/B routes. */
+    disallowOmit?: readonly string[];
+    /**
+     * Asset path prefix (Point Me `SITE_PREFIX`, e.g. `/marketing`).
+     * Rewrites `/og/` → `${pathPrefix}/og/` in the built list.
+     */
+    pathPrefix?: string;
+    /**
+     * API prefixes to block. Default: `['/api/']`.
+     * Point Me passes `['/api/', '/marketing-api/']`.
+     */
+    apiPrefixes?: readonly string[];
+    /** Append tracking query disallow rules. */
+    blockTrackingQueryParams?: boolean;
+    /**
+     * Extra staging rules after blanket `Disallow: /`.
+     * Brightlife Kids: SiteimproveBot allowlist.
+     */
+    stagingAllowRules?: Array<{
+        userAgent: string;
+        allow: string;
+    }>;
+    /**
+     * Extra production `Allow:` paths (emitted after `Allow: /`, before Disallow).
+     * Use for public agent/API surfaces under a broad disallowed prefix, e.g.
+     * `['/api/mcp', '/api/search']` while still `Disallow: /api/`.
+     * Google: more specific Allow can win over broader Disallow.
+     */
+    allowExtra?: readonly string[];
+}
+/** Options for plain-text robots.txt (supports Content-Signal). */
+export interface FormatRobotsTxtOptions extends CreateRobotsConfigOptions {
+    /**
+     * When set (production only), emit a Content-Signal line under `User-agent: *`.
+     * Next.js `MetadataRoute.Robots` cannot express this — use `formatRobotsTxt` /
+     * `createRobotsTxtResponse` in `src/app/robots.txt/route.ts` instead of `robots.ts`.
+     */
+    contentSignals?: ContentSignals;
+}
+/**
+ * Builds the production disallow path list from options.
+ * Exported for tests and sites that render plain-text robots (e.g. Brightline Content-Signal).
+ */
+export declare function buildRobotsDisallow(options: CreateRobotsConfigOptions): string[];
+/**
+ * Creates a Next.js `MetadataRoute.Robots` config for `src/app/robots.ts`.
+ *
+ * In production: allows `/` and disallows internal/infrastructure paths.
+ * In non-production: disallows all crawlers (with optional staging bot allowlist).
+ *
+ * **Content-Signal:** not supported here (Next metadata type). Use
+ * {@link formatRobotsTxt} / {@link createRobotsTxtResponse} in a route handler.
+ */
+export declare function createRobotsConfig(options: CreateRobotsConfigOptions): MetadataRoute.Robots;
+/**
+ * Formats a single Content-Signal directive line (no trailing newline).
+ *
+ * @example
+ * formatContentSignalLine({ search: 'yes', aiTrain: 'no', aiInput: 'yes' })
+ * // → 'Content-Signal: search=yes, ai-train=no, ai-input=yes'
+ */
+export declare function formatContentSignalLine(signals: ContentSignals): string;
+/**
+ * Builds a full plain-text robots.txt body, including optional Content-Signal.
+ *
+ * Prefer this over `createRobotsConfig` when you need Content Signals or other
+ * non-standard directives. Serve from `src/app/robots.txt/route.ts`.
+ */
+export declare function formatRobotsTxt(options: FormatRobotsTxtOptions): string;
+/**
+ * Returns a `text/plain` Response for `src/app/robots.txt/route.ts`.
+ *
+ * @example
+ * export function GET() {
+ *   return createRobotsTxtResponse({
+ *     isProduction,
+ *     baseUrl,
+ *     contentSignals: { search: 'yes', aiTrain: 'no', aiInput: 'yes' },
+ *   });
+ * }
+ */
+export declare function createRobotsTxtResponse(options: FormatRobotsTxtOptions): Response;
+//# sourceMappingURL=robots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../../src/utils/robots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAE1C,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,8FAQ1B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,kDAAmD,CAAC;AAE/F,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG,KAAK,GAAG,IAAI,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,MAAM,EAAE,uBAAuB,CAAC;IAChC,yCAAyC;IACzC,OAAO,EAAE,uBAAuB,CAAC;IACjC,6DAA6D;IAC7D,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0FAA0F;IAC1F,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,4CAA4C;IAC5C,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE;;;;;OAKG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,mEAAmE;AACnE,MAAM,WAAW,sBAAuB,SAAQ,yBAAyB;IACvE;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AA2CD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAwBhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,aAAa,CAAC,MAAM,CAoC3F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAoCvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,sBAAsB,GAAG,QAAQ,CAIjF"}

package/dist/utils/robots.js

@@ -0,0 +1,174 @@
+/** Default production disallow paths for SE Studio marketing sites. */
+export const DEFAULT_ROBOTS_DISALLOW = [
+    '/*?_rsc=*',
+    '/_next/data/',
+    '/api/',
+    '/preview/',
+    '/page-test/',
+    '/cms/',
+    '/og/',
+];
+/**
+ * Optional tracking-param crawl traps (e.g. Point Me SEO audit).
+ * Note: Google applies robots.txt to the path only, not query strings — these rules
+ * help other crawlers and audit tooling but are not a complete Google fix.
+ */
+export const TRACKING_QUERY_ROBOTS_DISALLOW = ['/*?_gl=*', '/*?nnerid=*', '/*?ref=*'];
+function normalizePathPrefix(prefix) {
+    if (!prefix) {
+        return undefined;
+    }
+    const trimmed = prefix.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    const withLeading = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    return withLeading.replace(/\/+$/, '');
+}
+function applyPathPrefix(path, pathPrefix) {
+    if (path === '/og/' && pathPrefix) {
+        return `${pathPrefix}/og/`;
+    }
+    return path;
+}
+function replaceApiPrefixes(paths, apiPrefixes) {
+    const result = [];
+    let apiInserted = false;
+    for (const path of paths) {
+        if (path === '/api/') {
+            if (!apiInserted) {
+                result.push(...apiPrefixes);
+                apiInserted = true;
+            }
+            continue;
+        }
+        result.push(path);
+    }
+    if (!apiInserted) {
+        result.push(...apiPrefixes);
+    }
+    return result;
+}
+/**
+ * Builds the production disallow path list from options.
+ * Exported for tests and sites that render plain-text robots (e.g. Brightline Content-Signal).
+ */
+export function buildRobotsDisallow(options) {
+    if (options.disallow) {
+        return [...options.disallow];
+    }
+    const omit = new Set(options.disallowOmit ?? []);
+    const pathPrefix = normalizePathPrefix(options.pathPrefix);
+    const apiPrefixes = options.apiPrefixes ?? ['/api/'];
+    let paths = DEFAULT_ROBOTS_DISALLOW.filter((path) => !omit.has(path)).map((path) => applyPathPrefix(path, pathPrefix));
+    paths = replaceApiPrefixes(paths, apiPrefixes);
+    if (options.disallowExtra?.length) {
+        paths.push(...options.disallowExtra);
+    }
+    if (options.blockTrackingQueryParams) {
+        paths.push(...TRACKING_QUERY_ROBOTS_DISALLOW);
+    }
+    return paths;
+}
+/**
+ * Creates a Next.js `MetadataRoute.Robots` config for `src/app/robots.ts`.
+ *
+ * In production: allows `/` and disallows internal/infrastructure paths.
+ * In non-production: disallows all crawlers (with optional staging bot allowlist).
+ *
+ * **Content-Signal:** not supported here (Next metadata type). Use
+ * {@link formatRobotsTxt} / {@link createRobotsTxtResponse} in a route handler.
+ */
+export function createRobotsConfig(options) {
+    const sitemap = options.sitemapUrl ?? `${options.baseUrl}/sitemap.xml`;
+    if (!options.isProduction) {
+        const rules = [
+            {
+                userAgent: '*',
+                disallow: '/',
+            },
+        ];
+        if (options.stagingAllowRules?.length) {
+            for (const rule of options.stagingAllowRules) {
+                rules.push({
+                    userAgent: rule.userAgent,
+                    allow: rule.allow,
+                });
+            }
+        }
+        return { rules, sitemap };
+    }
+    const allow = options.allowExtra && options.allowExtra.length > 0 ? ['/', ...options.allowExtra] : '/';
+    return {
+        rules: [
+            {
+                userAgent: '*',
+                allow,
+                disallow: buildRobotsDisallow(options),
+            },
+        ],
+        sitemap,
+    };
+}
+/**
+ * Formats a single Content-Signal directive line (no trailing newline).
+ *
+ * @example
+ * formatContentSignalLine({ search: 'yes', aiTrain: 'no', aiInput: 'yes' })
+ * // → 'Content-Signal: search=yes, ai-train=no, ai-input=yes'
+ */
+export function formatContentSignalLine(signals) {
+    return `Content-Signal: search=${signals.search}, ai-train=${signals.aiTrain}, ai-input=${signals.aiInput}`;
+}
+/**
+ * Builds a full plain-text robots.txt body, including optional Content-Signal.
+ *
+ * Prefer this over `createRobotsConfig` when you need Content Signals or other
+ * non-standard directives. Serve from `src/app/robots.txt/route.ts`.
+ */
+export function formatRobotsTxt(options) {
+    const sitemap = options.sitemapUrl ?? `${options.baseUrl}/sitemap.xml`;
+    if (!options.isProduction) {
+        const lines = ['User-agent: *', 'Disallow: /'];
+        if (options.stagingAllowRules?.length) {
+            for (const rule of options.stagingAllowRules) {
+                lines.push('', `User-agent: ${rule.userAgent}`, `Allow: ${rule.allow}`);
+            }
+        }
+        lines.push('', `Sitemap: ${sitemap}`, '');
+        return lines.join('\n');
+    }
+    const lines = ['User-agent: *'];
+    if (options.contentSignals) {
+        lines.push(formatContentSignalLine(options.contentSignals));
+    }
+    lines.push('Allow: /');
+    if (options.allowExtra?.length) {
+        for (const path of options.allowExtra) {
+            lines.push(`Allow: ${path}`);
+        }
+    }
+    for (const path of buildRobotsDisallow(options)) {
+        lines.push(`Disallow: ${path}`);
+    }
+    lines.push('', `Sitemap: ${sitemap}`, '');
+    return lines.join('\n');
+}
+/**
+ * Returns a `text/plain` Response for `src/app/robots.txt/route.ts`.
+ *
+ * @example
+ * export function GET() {
+ *   return createRobotsTxtResponse({
+ *     isProduction,
+ *     baseUrl,
+ *     contentSignals: { search: 'yes', aiTrain: 'no', aiInput: 'yes' },
+ *   });
+ * }
+ */
+export function createRobotsTxtResponse(options) {
+    return new Response(formatRobotsTxt(options), {
+        headers: { 'Content-Type': 'text/plain; charset=utf-8' },
+    });
+}
+//# sourceMappingURL=robots.js.map

package/dist/utils/robots.js.map

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

package/dist/utils/scopeCss.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Scopes CSS to a specific element by prefixing all selectors with a [data-hc-id] attribute selector.
+ *
+ * Handles:
+ * - Normal rules: `h2 { ... }` → `[data-hc-id="x"] h2 { ... }`
+ * - @media / @supports / @layer / @container: prefixes inner selectors
+ * - @keyframes / @font-face: passed through unchanged
+ * - :root rules: passed through unchanged (intentionally global)
+ * - Comma-separated selectors: each part is prefixed individually
+ * - Block comments, line comments, and strings (', ", `) when scanning for `{` / `}`
+ */
+export declare function scopeCss(css: string, scopeId: string): string;
+/** @internal */
+export declare function clearScopeCssCacheForTests(): void;
+//# sourceMappingURL=scopeCss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scopeCss.d.ts","sourceRoot":"","sources":["../../src/utils/scopeCss.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAe7D;AAED,gBAAgB;AAChB,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}