@aglyn/plugins-data 1.0.0-beta.221 → 1.0.0-beta.222

package/src/lib/record-pages/record-pages.d.ts

@@ -0,0 +1,218 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { RepeatRowsModel } from '@aglyn/aglyn/app-utils/expand-repeatables';
+import type { CustomFieldType } from '@aglyn/aglyn/plugin-manager/custom-fields';
+import type { DatasetFieldDefinition, DatasetModel } from '../model/dataset-models';
+/** This plugin's host subcollection the bindings live in. Persisted — never rename. */
+export declare const DATASET_RECORD_PAGES_COLLECTION = "recordPages";
+/**
+ * The custom field type a record's page address rides (`text` storage).
+ * Persisted on field definitions — never rename.
+ */
+export declare const RECORD_PAGE_ADDRESS_FIELD_TYPE = "pageAddress";
+/**
+ * The longest page address, in characters. It is the length a plain text
+ * value's `filterValues` entry is clipped to (`DATASET_FILTER_VALUE_MAX`), so
+ * every address a record can hold is one the indexed lookup can find whole.
+ */
+export declare const RECORD_PAGE_ADDRESS_MAX = 64;
+/** The most path segments a base may have: `services/residential/roofing`. */
+export declare const RECORD_PAGE_BASE_MAX_SEGMENTS = 4;
+/** The longest single base segment. */
+export declare const RECORD_PAGE_BASE_SEGMENT_MAX = 60;
+/** How many record templates one site may hold. */
+export declare const RECORD_PAGES_MAX_PER_SITE = 50;
+/**
+ * A site's record template, as `hosts/{hostId}/recordPages/{screenId}` holds
+ * it. The document id is the template screen's id, so a page is the template
+ * of at most one dataset.
+ */
+export interface DatasetRecordPageBinding {
+    /** The template screen — also the document id. */
+    screenId: string;
+    /** The organization dataset whose records the pages render. */
+    datasetId: string;
+    /**
+     * The path the pages are served under, without slashes at either end: one
+     * or more segments (`services`, `services/residential`).
+     */
+    base: string;
+    /** The record's page-address field. */
+    slugField: string;
+    /**
+     * The field that NAMES a record page — the tab title's first half, the
+     * breadcrumb, the sitemap's view of it. Absent, the dataset's first text
+     * field does.
+     */
+    titleField?: string;
+    /** A field whose value is the search title, used verbatim. */
+    seoTitleField?: string;
+    /** A field whose value is the search description. */
+    seoDescriptionField?: string;
+    /** A field holding the sharing image: a media reference or a URL. */
+    seoImageField?: string;
+}
+/**
+ * A record's page address from any text: the platform's URL segment
+ * (`urlSlugSegment`, the rule category and author pages use) of the text with
+ * its accents folded first, so `Café` is `cafe` rather than `caf`, and at most
+ * {@link RECORD_PAGE_ADDRESS_MAX} characters. Idempotent, so an address that
+ * is already one comes back unchanged — `Kitchen Remodeling` →
+ * `kitchen-remodeling` → `kitchen-remodeling`. `''` for text with nothing
+ * addressable in it.
+ */
+export declare function normalizeRecordAddress(value: unknown): string;
+/**
+ * The "Page address" field type, as the custom-field registry holds it: text
+ * storage, offered in the schema dialog, and checked on every write path
+ * after the address has been normalized (`fillRecordAddresses`), so what it
+ * refuses is an address with nothing addressable left in it, never one typed
+ * with a capital letter.
+ */
+export declare const RECORD_PAGE_ADDRESS_FIELD: CustomFieldType;
+/** Whether a value is already a page address, exactly as stored. */
+export declare function isRecordAddress(value: unknown): value is string;
+/** The page address a record holds in its address field, or `''`. */
+export declare function recordAddressOf(values: Record<string, unknown> | null | undefined, slugField: string): string;
+/**
+ * A base as stored: `/Services/Residential/` → `services/residential`. `null`
+ * when it is empty, has more than {@link RECORD_PAGE_BASE_MAX_SEGMENTS}
+ * segments, or a segment that is not URL-safe once lowercased — a base is
+ * typed by a person and refused rather than rewritten, because a rewritten
+ * base is a URL they did not choose.
+ */
+export declare function normalizeRecordPageBase(input: unknown): string | null;
+/** What a base must not collide with, on the site it is chosen for. */
+export interface RecordPageBaseContext {
+    /** The site's content collections' slugs, which own `/{slug}/…`. */
+    collectionSlugs?: readonly string[];
+    /**
+     * The first segments other plugins serve pages under on every site —
+     * `products` for a store — read off their declared sitemap sections.
+     */
+    pluginRouteSegments?: readonly string[];
+    /** The bases the site's OTHER record templates already use. */
+    otherBases?: readonly string[];
+}
+/**
+ * Why a base cannot be used on this site, as one sentence an author reads, or
+ * `null` when it can.
+ *
+ * Record pages are answered after every published page and before content
+ * collections, so a base whose first segment is a collection's would take
+ * that collection's entry addresses; the platform's reserved addresses and
+ * another plugin's routes are refused for the same reason. Two templates may
+ * nest — `services` and `services/residential` serve different depths — but
+ * never share a base.
+ */
+export declare function recordPageBaseRefusal(input: unknown, context?: RecordPageBaseContext): string | null;
+/** A record page's site path: `/services/kitchen-remodel`. */
+export declare function recordPagePath(base: string, address: string): string;
+/** The route a record template answers, as the page review names it. */
+export declare function recordPageRoute(base: string): string;
+/**
+ * The binding a request path is a record page of, with the address it asks
+ * for — or `null`. A path matches a binding when it is the base plus exactly
+ * one more segment, so nested bases never compete: `/services/residential`
+ * asks `services` for `residential`, and `/services/residential/roofing` asks
+ * `services/residential` for `roofing`.
+ *
+ * The address segment is normalized the way a stored one is, so a request
+ * spelled `/services/Kitchen-Remodel` finds the record and the head names the
+ * one address that is canonical.
+ */
+export declare function matchRecordPagePath<B extends Pick<DatasetRecordPageBinding, 'base'>>(bindings: readonly B[], path: string): {
+    binding: B;
+    address: string;
+} | null;
+/** Is this field a page address? */
+export declare function isRecordAddressField(field: DatasetFieldDefinition | null | undefined): boolean;
+/** The model's page-address fields, in display order. */
+export declare function recordAddressFieldIds(model: DatasetModel): string[];
+/**
+ * Fills each EMPTY page-address field from the field it names as its source
+ * (`slugFrom`), and normalizes every address the values already hold.
+ *
+ * Run on a record's WHOLE values before every write — a create, an import, a
+ * form or automation append, and the merged values of an update — which is
+ * what makes "the address fills in once and never moves" true: an update that
+ * renames the record arrives with the address it already has, so there is
+ * nothing empty to fill. Returns the input itself when nothing changes.
+ */
+export declare function fillRecordAddresses<V extends Record<string, unknown>>(model: DatasetModel, values: V): V;
+/**
+ * Unique addresses for a set of records being given one for the first time —
+ * `kitchen-remodel`, `kitchen-remodel-2` — in the order given, skipping the
+ * addresses already `taken`. A record whose source has nothing addressable in
+ * it gets none.
+ */
+export declare function uniqueRecordAddresses(sources: ReadonlyArray<{
+    id: string;
+    source: unknown;
+}>, taken?: Iterable<string>): Map<string, string>;
+/**
+ * The field that names a record page: the binding's `titleField`, else the
+ * model's first text field that is not a page address.
+ */
+export declare function recordPageNameField(binding: Pick<DatasetRecordPageBinding, 'titleField' | 'slugField'>, model: DatasetModel): string | undefined;
+/** What a record page says about itself in the head. */
+export interface RecordPageHead {
+    /** The page's name: the site title is joined after it. */
+    name?: string;
+    /** An authored search title, used verbatim. */
+    title?: string;
+    description?: string;
+    /** A media reference or URL, resolved by the head like any page image. */
+    image?: string;
+}
+/**
+ * The head of one record's page, from the fields the binding picked. Each
+ * part is absent when its field is unset or empty, and the head then falls
+ * back to the template page's own value, then the site's, exactly as it does
+ * for every page.
+ */
+export declare function recordPageHead(binding: DatasetRecordPageBinding, model: DatasetModel, values: Record<string, unknown>): RecordPageHead;
+/**
+ * A binding document read back, or `null` when it does not describe one: the
+ * fields every reader needs, trimmed. Optional fields that are blank are
+ * dropped rather than kept as `''`.
+ */
+export declare function parseRecordPageBinding(screenId: string, data: Record<string, unknown> | null | undefined): DatasetRecordPageBinding | null;
+/**
+ * The records a row's reference fields point at, by the dataset each lives in:
+ * what a one-hop `{{item.author.name}}` on a record page has to read. A
+ * multiple reference contributes every id it holds.
+ */
+export declare function referencedRecordIds(model: RepeatRowsModel, record: Record<string, unknown>): Map<string, Set<string>>;
+/**
+ * The row key `{{item.url}}` reads: a record's page on this site.
+ * Persisted in nothing — it is computed on every read — but bound by authors,
+ * so never rename.
+ */
+export declare const RECORD_PAGE_URL_KEY = "url";
+/**
+ * A dataset's repeated rows, each carrying its page as `url` when this site
+ * has a record template for the dataset (AGL-3475) — so a listing card links
+ * to the record's page with `{{item.url}}`, and the canvas previews the same
+ * link the page renders.
+ *
+ * A model that declares a field of its own called `url` keeps it: the token
+ * always means the dataset's field first. A row with no address has no page,
+ * and so no `url`, and its token stays as written. Returns the rows
+ * themselves when there is nothing to add.
+ */
+export declare function withRecordPageUrls<R extends Record<string, unknown>>(rows: R[], binding: Pick<DatasetRecordPageBinding, 'base' | 'slugField'> | null | undefined, model: DatasetModel): R[];

package/src/lib/record-pages/record-pages.js

@@ -0,0 +1,351 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * Record pages (AGL-3475): one page per dataset record, rendered from one
+ * template page.
+ *
+ * A site marks a page as the RECORD TEMPLATE of a dataset and names a base
+ * path, and every record of that dataset with a page address is served at
+ * `/{base}/{address}` — a services dataset becomes `/services/kitchen-remodel`,
+ * `/services/roofing`, and so on, all drawn by the one design. Inside the
+ * template `{{item.field}}` means exactly what it means inside a repeat
+ * (`substituteRecordTokens`, one reference hop), so an author who has built a
+ * repeated card already knows how to build the page it links to.
+ *
+ * ## What lives where
+ *
+ * - The BINDING — which page, which dataset, which base, which fields — is a
+ *   document of this plugin's own, `hosts/{hostId}/recordPages/{screenId}`.
+ *   It is per site because the base and the page are; the dataset is the
+ *   organization's, so one dataset can have a record template on every site
+ *   it is shared with, each at its own base.
+ * - The ADDRESS is a field on the record: a text field of the "Page address"
+ *   custom type ({@link RECORD_PAGE_ADDRESS_FIELD_TYPE}). It is stored rather
+ *   than derived at read time for two reasons. A stored address is what a
+ *   query can find — `filterValues.<field>` is already indexed on every record
+ *   (AGL-3321) — and it is what keeps a live URL where it is when somebody
+ *   renames the record. An address field may name a SOURCE field
+ *   (`slugFrom`): an empty address fills in from it once, on whichever write
+ *   first finds it empty, and never moves afterwards.
+ * - The TEMPLATE is an ordinary screen stamped `kind: 'template'`, the stamp a
+ *   blog's entry template carries: it renders at no address of its own, it is
+ *   not one of the plan's pages, and its raw `{{item.*}}` never ships.
+ *
+ * Pure and SDK-free: the console's settings, the canvas preview and the
+ * tenant's resolver all read it.
+ */ import { AUTHOR_ROUTE_SEGMENT } from "@aglyn/aglyn/app-utils/content-authors";
+import { reservedScreenRouteSegment } from "@aglyn/aglyn/app-utils/screen-route";
+import { urlSlugSegment } from "@aglyn/aglyn/app-utils/url-slug";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+/** This plugin's host subcollection the bindings live in. Persisted — never rename. */ export const DATASET_RECORD_PAGES_COLLECTION = 'recordPages';
+/**
+ * The custom field type a record's page address rides (`text` storage).
+ * Persisted on field definitions — never rename.
+ */ export const RECORD_PAGE_ADDRESS_FIELD_TYPE = 'pageAddress';
+/**
+ * The longest page address, in characters. It is the length a plain text
+ * value's `filterValues` entry is clipped to (`DATASET_FILTER_VALUE_MAX`), so
+ * every address a record can hold is one the indexed lookup can find whole.
+ */ export const RECORD_PAGE_ADDRESS_MAX = 64;
+/** The most path segments a base may have: `services/residential/roofing`. */ export const RECORD_PAGE_BASE_MAX_SEGMENTS = 4;
+/** The longest single base segment. */ export const RECORD_PAGE_BASE_SEGMENT_MAX = 60;
+/** How many record templates one site may hold. */ export const RECORD_PAGES_MAX_PER_SITE = 50;
+/** One URL-safe segment: lowercase letters and digits joined by single hyphens. */ const SEGMENT = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/**
+ * A record's page address from any text: the platform's URL segment
+ * (`urlSlugSegment`, the rule category and author pages use) of the text with
+ * its accents folded first, so `Café` is `cafe` rather than `caf`, and at most
+ * {@link RECORD_PAGE_ADDRESS_MAX} characters. Idempotent, so an address that
+ * is already one comes back unchanged — `Kitchen Remodeling` →
+ * `kitchen-remodeling` → `kitchen-remodeling`. `''` for text with nothing
+ * addressable in it.
+ */ export function normalizeRecordAddress(value) {
+    if (typeof value !== 'string' && typeof value !== 'number') return '';
+    return urlSlugSegment(String(value).normalize('NFKD').replace(/[̀-ͯ]/g, '')).slice(0, RECORD_PAGE_ADDRESS_MAX).replace(/-+$/g, '');
+}
+/**
+ * The "Page address" field type, as the custom-field registry holds it: text
+ * storage, offered in the schema dialog, and checked on every write path
+ * after the address has been normalized (`fillRecordAddresses`), so what it
+ * refuses is an address with nothing addressable left in it, never one typed
+ * with a capital letter.
+ */ export const RECORD_PAGE_ADDRESS_FIELD = {
+    name: RECORD_PAGE_ADDRESS_FIELD_TYPE,
+    pluginId: BUNDLE_ID,
+    label: 'Page address',
+    baseType: 'text',
+    description: 'The record’s own page under a record template: lowercase words joined by hyphens',
+    validate: (value)=>isRecordAddress(value) ? null : `Use lowercase letters, numbers and hyphens, up to ${RECORD_PAGE_ADDRESS_MAX} characters`
+};
+/** Whether a value is already a page address, exactly as stored. */ export function isRecordAddress(value) {
+    return typeof value === 'string' && value.length <= RECORD_PAGE_ADDRESS_MAX && SEGMENT.test(value);
+}
+/** The page address a record holds in its address field, or `''`. */ export function recordAddressOf(values, slugField) {
+    return normalizeRecordAddress(values == null ? void 0 : values[slugField]);
+}
+/**
+ * A base as stored: `/Services/Residential/` → `services/residential`. `null`
+ * when it is empty, has more than {@link RECORD_PAGE_BASE_MAX_SEGMENTS}
+ * segments, or a segment that is not URL-safe once lowercased — a base is
+ * typed by a person and refused rather than rewritten, because a rewritten
+ * base is a URL they did not choose.
+ */ export function normalizeRecordPageBase(input) {
+    if (typeof input !== 'string') return null;
+    const segments = input.trim().toLowerCase().split('/').filter(Boolean);
+    if (!segments.length || segments.length > RECORD_PAGE_BASE_MAX_SEGMENTS) {
+        return null;
+    }
+    for (const segment of segments){
+        if (segment.length > RECORD_PAGE_BASE_SEGMENT_MAX || !SEGMENT.test(segment)) {
+            return null;
+        }
+    }
+    return segments.join('/');
+}
+/**
+ * Why a base cannot be used on this site, as one sentence an author reads, or
+ * `null` when it can.
+ *
+ * Record pages are answered after every published page and before content
+ * collections, so a base whose first segment is a collection's would take
+ * that collection's entry addresses; the platform's reserved addresses and
+ * another plugin's routes are refused for the same reason. Two templates may
+ * nest — `services` and `services/residential` serve different depths — but
+ * never share a base.
+ */ export function recordPageBaseRefusal(input, context = {}) {
+    var _context_pluginRouteSegments, _context_collectionSlugs, _context_otherBases;
+    const base = normalizeRecordPageBase(input);
+    if (!base) {
+        return `Use one to ${RECORD_PAGE_BASE_MAX_SEGMENTS} path segments of lowercase ` + 'letters, numbers and hyphens, like services or services/residential';
+    }
+    const [first] = base.split('/');
+    const reserved = reservedScreenRouteSegment(base);
+    if (reserved || first === AUTHOR_ROUTE_SEGMENT) {
+        return `/${reserved != null ? reserved : first} is a reserved address on every site — pick another base`;
+    }
+    if ((_context_pluginRouteSegments = context.pluginRouteSegments) == null ? void 0 : _context_pluginRouteSegments.includes(first)) {
+        return `/${first} already serves pages of its own on this site — pick another base`;
+    }
+    if ((_context_collectionSlugs = context.collectionSlugs) == null ? void 0 : _context_collectionSlugs.includes(first)) {
+        return `/${first} is a content collection on this site — pick another base`;
+    }
+    if ((_context_otherBases = context.otherBases) == null ? void 0 : _context_otherBases.includes(base)) {
+        return `Another record template already uses /${base}`;
+    }
+    return null;
+}
+/** A record page's site path: `/services/kitchen-remodel`. */ export function recordPagePath(base, address) {
+    return `/${base}/${address}`;
+}
+/** The route a record template answers, as the page review names it. */ export function recordPageRoute(base) {
+    return `/${base}/:slug`;
+}
+/**
+ * The binding a request path is a record page of, with the address it asks
+ * for — or `null`. A path matches a binding when it is the base plus exactly
+ * one more segment, so nested bases never compete: `/services/residential`
+ * asks `services` for `residential`, and `/services/residential/roofing` asks
+ * `services/residential` for `roofing`.
+ *
+ * The address segment is normalized the way a stored one is, so a request
+ * spelled `/services/Kitchen-Remodel` finds the record and the head names the
+ * one address that is canonical.
+ */ export function matchRecordPagePath(bindings, path) {
+    const segments = path.split('/').filter(Boolean);
+    if (segments.length < 2) return null;
+    const base = segments.slice(0, -1).join('/').toLowerCase();
+    const binding = bindings.find((one)=>one.base === base);
+    if (!binding) return null;
+    const address = normalizeRecordAddress(safeDecode(segments[segments.length - 1]));
+    return address ? {
+        binding,
+        address
+    } : null;
+}
+function safeDecode(segment) {
+    try {
+        return decodeURIComponent(segment);
+    } catch (unused) {
+        return segment;
+    }
+}
+/** Is this field a page address? */ export function isRecordAddressField(field) {
+    return (field == null ? void 0 : field.type) === 'text' && field.customType === RECORD_PAGE_ADDRESS_FIELD_TYPE;
+}
+/** The model's page-address fields, in display order. */ export function recordAddressFieldIds(model) {
+    var _model_order;
+    // Tolerant of a partial model, as the filter fields' readers are: a write
+    // path must not fail over a model stored without its `order`.
+    return ((_model_order = model.order) != null ? _model_order : []).filter((fieldId)=>{
+        var _model_fields;
+        return isRecordAddressField((_model_fields = model.fields) == null ? void 0 : _model_fields[fieldId]);
+    });
+}
+/**
+ * Fills each EMPTY page-address field from the field it names as its source
+ * (`slugFrom`), and normalizes every address the values already hold.
+ *
+ * Run on a record's WHOLE values before every write — a create, an import, a
+ * form or automation append, and the merged values of an update — which is
+ * what makes "the address fills in once and never moves" true: an update that
+ * renames the record arrives with the address it already has, so there is
+ * nothing empty to fill. Returns the input itself when nothing changes.
+ */ export function fillRecordAddresses(model, values) {
+    let next = null;
+    for (const fieldId of recordAddressFieldIds(model)){
+        var _model_fields;
+        const field = (_model_fields = model.fields) == null ? void 0 : _model_fields[fieldId];
+        const held = values[fieldId];
+        const normalized = held == null || held === '' ? (field == null ? void 0 : field.slugFrom) ? normalizeRecordAddress(values[field.slugFrom]) : '' : normalizeRecordAddress(held);
+        if ((held != null ? held : '') === normalized) continue;
+        next != null ? next : next = _extends({}, values);
+        if (normalized) next[fieldId] = normalized;
+        else delete next[fieldId];
+    }
+    return next != null ? next : values;
+}
+/**
+ * Unique addresses for a set of records being given one for the first time —
+ * `kitchen-remodel`, `kitchen-remodel-2` — in the order given, skipping the
+ * addresses already `taken`. A record whose source has nothing addressable in
+ * it gets none.
+ */ export function uniqueRecordAddresses(sources, taken = []) {
+    const used = new Set(taken);
+    const assigned = new Map();
+    for (const { id, source } of sources){
+        const base = normalizeRecordAddress(source);
+        if (!base) continue;
+        let candidate = base;
+        for(let suffix = 2; used.has(candidate); suffix += 1){
+            const tail = `-${suffix}`;
+            candidate = `${base.slice(0, RECORD_PAGE_ADDRESS_MAX - tail.length).replace(/-+$/g, '')}${tail}`;
+        }
+        used.add(candidate);
+        assigned.set(id, candidate);
+    }
+    return assigned;
+}
+const textOf = (value)=>{
+    if (typeof value === 'string') return value.trim();
+    if (typeof value === 'number' && Number.isFinite(value)) return String(value);
+    return '';
+};
+/**
+ * The field that names a record page: the binding's `titleField`, else the
+ * model's first text field that is not a page address.
+ */ export function recordPageNameField(binding, model) {
+    if (binding.titleField && model.fields[binding.titleField]) {
+        return binding.titleField;
+    }
+    return model.order.find((fieldId)=>{
+        const field = model.fields[fieldId];
+        return (field == null ? void 0 : field.type) === 'text' && fieldId !== binding.slugField && !isRecordAddressField(field);
+    });
+}
+/**
+ * The head of one record's page, from the fields the binding picked. Each
+ * part is absent when its field is unset or empty, and the head then falls
+ * back to the template page's own value, then the site's, exactly as it does
+ * for every page.
+ */ export function recordPageHead(binding, model, values) {
+    const pick = (fieldId)=>fieldId ? textOf(values[fieldId]) : '';
+    const name = pick(recordPageNameField(binding, model));
+    const title = pick(binding.seoTitleField);
+    const description = pick(binding.seoDescriptionField);
+    const image = pick(binding.seoImageField);
+    return _extends({}, name ? {
+        name
+    } : {}, title ? {
+        title
+    } : {}, description ? {
+        description
+    } : {}, image ? {
+        image
+    } : {});
+}
+/**
+ * A binding document read back, or `null` when it does not describe one: the
+ * fields every reader needs, trimmed. Optional fields that are blank are
+ * dropped rather than kept as `''`.
+ */ export function parseRecordPageBinding(screenId, data) {
+    const text = (value)=>typeof value === 'string' ? value.trim() : '';
+    const datasetId = text(data == null ? void 0 : data['datasetId']);
+    const base = normalizeRecordPageBase(data == null ? void 0 : data['base']);
+    const slugField = text(data == null ? void 0 : data['slugField']);
+    if (!screenId || !datasetId || !base || !slugField) return null;
+    const optional = (key)=>{
+        const value = text(data == null ? void 0 : data[key]);
+        return value ? {
+            [key]: value
+        } : {};
+    };
+    return _extends({
+        screenId,
+        datasetId,
+        base,
+        slugField
+    }, optional('titleField'), optional('seoTitleField'), optional('seoDescriptionField'), optional('seoImageField'));
+}
+/**
+ * The records a row's reference fields point at, by the dataset each lives in:
+ * what a one-hop `{{item.author.name}}` on a record page has to read. A
+ * multiple reference contributes every id it holds.
+ */ export function referencedRecordIds(model, record) {
+    var _model_references;
+    const wanted = new Map();
+    for (const [fieldId, datasetId] of Object.entries((_model_references = model.references) != null ? _model_references : {})){
+        if (!datasetId || datasetId.includes('/')) continue;
+        const value = record[fieldId];
+        for (const id of Array.isArray(value) ? value : [
+            value
+        ]){
+            var _wanted_get;
+            if (typeof id !== 'string' || !id || id.includes('/')) continue;
+            const ids = (_wanted_get = wanted.get(datasetId)) != null ? _wanted_get : new Set();
+            ids.add(id);
+            wanted.set(datasetId, ids);
+        }
+    }
+    return wanted;
+}
+/**
+ * The row key `{{item.url}}` reads: a record's page on this site.
+ * Persisted in nothing — it is computed on every read — but bound by authors,
+ * so never rename.
+ */ export const RECORD_PAGE_URL_KEY = 'url';
+/**
+ * A dataset's repeated rows, each carrying its page as `url` when this site
+ * has a record template for the dataset (AGL-3475) — so a listing card links
+ * to the record's page with `{{item.url}}`, and the canvas previews the same
+ * link the page renders.
+ *
+ * A model that declares a field of its own called `url` keeps it: the token
+ * always means the dataset's field first. A row with no address has no page,
+ * and so no `url`, and its token stays as written. Returns the rows
+ * themselves when there is nothing to add.
+ */ export function withRecordPageUrls(rows, binding, model) {
+    var _model_fields;
+    if (!binding || ((_model_fields = model.fields) == null ? void 0 : _model_fields[RECORD_PAGE_URL_KEY])) return rows;
+    return rows.map((row)=>{
+        const address = recordAddressOf(row, binding.slugField);
+        return address ? _extends({}, row, {
+            [RECORD_PAGE_URL_KEY]: recordPagePath(binding.base, address)
+        }) : row;
+    });
+}
+
+//# sourceMappingURL=record-pages.js.map

package/src/lib/record-pages/record-pages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/data/src/lib/record-pages/record-pages.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Record pages (AGL-3475): one page per dataset record, rendered from one\n * template page.\n *\n * A site marks a page as the RECORD TEMPLATE of a dataset and names a base\n * path, and every record of that dataset with a page address is served at\n * `/{base}/{address}` — a services dataset becomes `/services/kitchen-remodel`,\n * `/services/roofing`, and so on, all drawn by the one design. Inside the\n * template `{{item.field}}` means exactly what it means inside a repeat\n * (`substituteRecordTokens`, one reference hop), so an author who has built a\n * repeated card already knows how to build the page it links to.\n *\n * ## What lives where\n *\n * - The BINDING — which page, which dataset, which base, which fields — is a\n *   document of this plugin's own, `hosts/{hostId}/recordPages/{screenId}`.\n *   It is per site because the base and the page are; the dataset is the\n *   organization's, so one dataset can have a record template on every site\n *   it is shared with, each at its own base.\n * - The ADDRESS is a field on the record: a text field of the \"Page address\"\n *   custom type ({@link RECORD_PAGE_ADDRESS_FIELD_TYPE}). It is stored rather\n *   than derived at read time for two reasons. A stored address is what a\n *   query can find — `filterValues.<field>` is already indexed on every record\n *   (AGL-3321) — and it is what keeps a live URL where it is when somebody\n *   renames the record. An address field may name a SOURCE field\n *   (`slugFrom`): an empty address fills in from it once, on whichever write\n *   first finds it empty, and never moves afterwards.\n * - The TEMPLATE is an ordinary screen stamped `kind: 'template'`, the stamp a\n *   blog's entry template carries: it renders at no address of its own, it is\n *   not one of the plan's pages, and its raw `{{item.*}}` never ships.\n *\n * Pure and SDK-free: the console's settings, the canvas preview and the\n * tenant's resolver all read it.\n */\n\nimport { AUTHOR_ROUTE_SEGMENT } from '@aglyn/aglyn/app-utils/content-authors'\nimport { reservedScreenRouteSegment } from '@aglyn/aglyn/app-utils/screen-route'\nimport { urlSlugSegment } from '@aglyn/aglyn/app-utils/url-slug'\nimport type { RepeatRowsModel } from '@aglyn/aglyn/app-utils/expand-repeatables'\nimport type { CustomFieldType } from '@aglyn/aglyn/plugin-manager/custom-fields'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport type { DatasetFieldDefinition, DatasetModel } from '../model/dataset-models'\n\n/** This plugin's host subcollection the bindings live in. Persisted — never rename. */\nexport const DATASET_RECORD_PAGES_COLLECTION = 'recordPages'\n\n/**\n * The custom field type a record's page address rides (`text` storage).\n * Persisted on field definitions — never rename.\n */\nexport const RECORD_PAGE_ADDRESS_FIELD_TYPE = 'pageAddress'\n\n/**\n * The longest page address, in characters. It is the length a plain text\n * value's `filterValues` entry is clipped to (`DATASET_FILTER_VALUE_MAX`), so\n * every address a record can hold is one the indexed lookup can find whole.\n */\nexport const RECORD_PAGE_ADDRESS_MAX = 64\n\n/** The most path segments a base may have: `services/residential/roofing`. */\nexport const RECORD_PAGE_BASE_MAX_SEGMENTS = 4\n\n/** The longest single base segment. */\nexport const RECORD_PAGE_BASE_SEGMENT_MAX = 60\n\n/** How many record templates one site may hold. */\nexport const RECORD_PAGES_MAX_PER_SITE = 50\n\n/** One URL-safe segment: lowercase letters and digits joined by single hyphens. */\nconst SEGMENT = /^[a-z0-9]+(?:-[a-z0-9]+)*$/\n\n/**\n * A site's record template, as `hosts/{hostId}/recordPages/{screenId}` holds\n * it. The document id is the template screen's id, so a page is the template\n * of at most one dataset.\n */\nexport interface DatasetRecordPageBinding {\n  /** The template screen — also the document id. */\n  screenId: string\n  /** The organization dataset whose records the pages render. */\n  datasetId: string\n  /**\n   * The path the pages are served under, without slashes at either end: one\n   * or more segments (`services`, `services/residential`).\n   */\n  base: string\n  /** The record's page-address field. */\n  slugField: string\n  /**\n   * The field that NAMES a record page — the tab title's first half, the\n   * breadcrumb, the sitemap's view of it. Absent, the dataset's first text\n   * field does.\n   */\n  titleField?: string\n  /** A field whose value is the search title, used verbatim. */\n  seoTitleField?: string\n  /** A field whose value is the search description. */\n  seoDescriptionField?: string\n  /** A field holding the sharing image: a media reference or a URL. */\n  seoImageField?: string\n}\n\n/**\n * A record's page address from any text: the platform's URL segment\n * (`urlSlugSegment`, the rule category and author pages use) of the text with\n * its accents folded first, so `Café` is `cafe` rather than `caf`, and at most\n * {@link RECORD_PAGE_ADDRESS_MAX} characters. Idempotent, so an address that\n * is already one comes back unchanged — `Kitchen Remodeling` →\n * `kitchen-remodeling` → `kitchen-remodeling`. `''` for text with nothing\n * addressable in it.\n */\nexport function normalizeRecordAddress(value: unknown): string {\n  if (typeof value !== 'string' && typeof value !== 'number') return ''\n  return urlSlugSegment(\n    String(value).normalize('NFKD').replace(/[̀-ͯ]/g, ''),\n  )\n    .slice(0, RECORD_PAGE_ADDRESS_MAX)\n    .replace(/-+$/g, '')\n}\n\n/**\n * The \"Page address\" field type, as the custom-field registry holds it: text\n * storage, offered in the schema dialog, and checked on every write path\n * after the address has been normalized (`fillRecordAddresses`), so what it\n * refuses is an address with nothing addressable left in it, never one typed\n * with a capital letter.\n */\nexport const RECORD_PAGE_ADDRESS_FIELD: CustomFieldType = {\n  name: RECORD_PAGE_ADDRESS_FIELD_TYPE,\n  pluginId: BUNDLE_ID,\n  label: 'Page address',\n  baseType: 'text',\n  description:\n    'The record’s own page under a record template: lowercase words joined by hyphens',\n  validate: (value) =>\n    isRecordAddress(value)\n      ? null\n      : `Use lowercase letters, numbers and hyphens, up to ${RECORD_PAGE_ADDRESS_MAX} characters`,\n}\n\n/** Whether a value is already a page address, exactly as stored. */\nexport function isRecordAddress(value: unknown): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length <= RECORD_PAGE_ADDRESS_MAX &&\n    SEGMENT.test(value)\n  )\n}\n\n/** The page address a record holds in its address field, or `''`. */\nexport function recordAddressOf(\n  values: Record<string, unknown> | null | undefined,\n  slugField: string,\n): string {\n  return normalizeRecordAddress(values?.[slugField])\n}\n\n/**\n * A base as stored: `/Services/Residential/` → `services/residential`. `null`\n * when it is empty, has more than {@link RECORD_PAGE_BASE_MAX_SEGMENTS}\n * segments, or a segment that is not URL-safe once lowercased — a base is\n * typed by a person and refused rather than rewritten, because a rewritten\n * base is a URL they did not choose.\n */\nexport function normalizeRecordPageBase(input: unknown): string | null {\n  if (typeof input !== 'string') return null\n  const segments = input\n    .trim()\n    .toLowerCase()\n    .split('/')\n    .filter(Boolean)\n  if (!segments.length || segments.length > RECORD_PAGE_BASE_MAX_SEGMENTS) {\n    return null\n  }\n  for (const segment of segments) {\n    if (segment.length > RECORD_PAGE_BASE_SEGMENT_MAX || !SEGMENT.test(segment)) {\n      return null\n    }\n  }\n  return segments.join('/')\n}\n\n/** What a base must not collide with, on the site it is chosen for. */\nexport interface RecordPageBaseContext {\n  /** The site's content collections' slugs, which own `/{slug}/…`. */\n  collectionSlugs?: readonly string[]\n  /**\n   * The first segments other plugins serve pages under on every site —\n   * `products` for a store — read off their declared sitemap sections.\n   */\n  pluginRouteSegments?: readonly string[]\n  /** The bases the site's OTHER record templates already use. */\n  otherBases?: readonly string[]\n}\n\n/**\n * Why a base cannot be used on this site, as one sentence an author reads, or\n * `null` when it can.\n *\n * Record pages are answered after every published page and before content\n * collections, so a base whose first segment is a collection's would take\n * that collection's entry addresses; the platform's reserved addresses and\n * another plugin's routes are refused for the same reason. Two templates may\n * nest — `services` and `services/residential` serve different depths — but\n * never share a base.\n */\nexport function recordPageBaseRefusal(\n  input: unknown,\n  context: RecordPageBaseContext = {},\n): string | null {\n  const base = normalizeRecordPageBase(input)\n  if (!base) {\n    return (\n      `Use one to ${RECORD_PAGE_BASE_MAX_SEGMENTS} path segments of lowercase ` +\n      'letters, numbers and hyphens, like services or services/residential'\n    )\n  }\n  const [first] = base.split('/')\n  const reserved = reservedScreenRouteSegment(base)\n  if (reserved || first === AUTHOR_ROUTE_SEGMENT) {\n    return `/${reserved ?? first} is a reserved address on every site — pick another base`\n  }\n  if (context.pluginRouteSegments?.includes(first)) {\n    return `/${first} already serves pages of its own on this site — pick another base`\n  }\n  if (context.collectionSlugs?.includes(first)) {\n    return `/${first} is a content collection on this site — pick another base`\n  }\n  if (context.otherBases?.includes(base)) {\n    return `Another record template already uses /${base}`\n  }\n  return null\n}\n\n/** A record page's site path: `/services/kitchen-remodel`. */\nexport function recordPagePath(base: string, address: string): string {\n  return `/${base}/${address}`\n}\n\n/** The route a record template answers, as the page review names it. */\nexport function recordPageRoute(base: string): string {\n  return `/${base}/:slug`\n}\n\n/**\n * The binding a request path is a record page of, with the address it asks\n * for — or `null`. A path matches a binding when it is the base plus exactly\n * one more segment, so nested bases never compete: `/services/residential`\n * asks `services` for `residential`, and `/services/residential/roofing` asks\n * `services/residential` for `roofing`.\n *\n * The address segment is normalized the way a stored one is, so a request\n * spelled `/services/Kitchen-Remodel` finds the record and the head names the\n * one address that is canonical.\n */\nexport function matchRecordPagePath<B extends Pick<DatasetRecordPageBinding, 'base'>>(\n  bindings: readonly B[],\n  path: string,\n): { binding: B; address: string } | null {\n  const segments = path.split('/').filter(Boolean)\n  if (segments.length < 2) return null\n  const base = segments.slice(0, -1).join('/').toLowerCase()\n  const binding = bindings.find((one) => one.base === base)\n  if (!binding) return null\n  const address = normalizeRecordAddress(\n    safeDecode(segments[segments.length - 1]),\n  )\n  return address ? { binding, address } : null\n}\n\nfunction safeDecode(segment: string): string {\n  try {\n    return decodeURIComponent(segment)\n  } catch {\n    return segment\n  }\n}\n\n/** Is this field a page address? */\nexport function isRecordAddressField(\n  field: DatasetFieldDefinition | null | undefined,\n): boolean {\n  return field?.type === 'text' && field.customType === RECORD_PAGE_ADDRESS_FIELD_TYPE\n}\n\n/** The model's page-address fields, in display order. */\nexport function recordAddressFieldIds(model: DatasetModel): string[] {\n  // Tolerant of a partial model, as the filter fields' readers are: a write\n  // path must not fail over a model stored without its `order`.\n  return (model.order ?? []).filter((fieldId) =>\n    isRecordAddressField(model.fields?.[fieldId]),\n  )\n}\n\n/**\n * Fills each EMPTY page-address field from the field it names as its source\n * (`slugFrom`), and normalizes every address the values already hold.\n *\n * Run on a record's WHOLE values before every write — a create, an import, a\n * form or automation append, and the merged values of an update — which is\n * what makes \"the address fills in once and never moves\" true: an update that\n * renames the record arrives with the address it already has, so there is\n * nothing empty to fill. Returns the input itself when nothing changes.\n */\nexport function fillRecordAddresses<V extends Record<string, unknown>>(\n  model: DatasetModel,\n  values: V,\n): V {\n  let next: V | null = null\n  for (const fieldId of recordAddressFieldIds(model)) {\n    const field = model.fields?.[fieldId]\n    const held = values[fieldId]\n    const normalized =\n      held == null || held === ''\n        ? field?.slugFrom\n          ? normalizeRecordAddress(values[field.slugFrom])\n          : ''\n        : normalizeRecordAddress(held)\n    if ((held ?? '') === normalized) continue\n    next ??= { ...values }\n    if (normalized) (next as Record<string, unknown>)[fieldId] = normalized\n    else delete (next as Record<string, unknown>)[fieldId]\n  }\n  return next ?? values\n}\n\n/**\n * Unique addresses for a set of records being given one for the first time —\n * `kitchen-remodel`, `kitchen-remodel-2` — in the order given, skipping the\n * addresses already `taken`. A record whose source has nothing addressable in\n * it gets none.\n */\nexport function uniqueRecordAddresses(\n  sources: ReadonlyArray<{ id: string; source: unknown }>,\n  taken: Iterable<string> = [],\n): Map<string, string> {\n  const used = new Set(taken)\n  const assigned = new Map<string, string>()\n  for (const { id, source } of sources) {\n    const base = normalizeRecordAddress(source)\n    if (!base) continue\n    let candidate = base\n    for (let suffix = 2; used.has(candidate); suffix += 1) {\n      const tail = `-${suffix}`\n      candidate = `${base.slice(0, RECORD_PAGE_ADDRESS_MAX - tail.length).replace(/-+$/g, '')}${tail}`\n    }\n    used.add(candidate)\n    assigned.set(id, candidate)\n  }\n  return assigned\n}\n\nconst textOf = (value: unknown): string => {\n  if (typeof value === 'string') return value.trim()\n  if (typeof value === 'number' && Number.isFinite(value)) return String(value)\n  return ''\n}\n\n/**\n * The field that names a record page: the binding's `titleField`, else the\n * model's first text field that is not a page address.\n */\nexport function recordPageNameField(\n  binding: Pick<DatasetRecordPageBinding, 'titleField' | 'slugField'>,\n  model: DatasetModel,\n): string | undefined {\n  if (binding.titleField && model.fields[binding.titleField]) {\n    return binding.titleField\n  }\n  return model.order.find((fieldId) => {\n    const field = model.fields[fieldId]\n    return field?.type === 'text' && fieldId !== binding.slugField && !isRecordAddressField(field)\n  })\n}\n\n/** What a record page says about itself in the head. */\nexport interface RecordPageHead {\n  /** The page's name: the site title is joined after it. */\n  name?: string\n  /** An authored search title, used verbatim. */\n  title?: string\n  description?: string\n  /** A media reference or URL, resolved by the head like any page image. */\n  image?: string\n}\n\n/**\n * The head of one record's page, from the fields the binding picked. Each\n * part is absent when its field is unset or empty, and the head then falls\n * back to the template page's own value, then the site's, exactly as it does\n * for every page.\n */\nexport function recordPageHead(\n  binding: DatasetRecordPageBinding,\n  model: DatasetModel,\n  values: Record<string, unknown>,\n): RecordPageHead {\n  const pick = (fieldId: string | undefined) =>\n    fieldId ? textOf(values[fieldId]) : ''\n  const name = pick(recordPageNameField(binding, model))\n  const title = pick(binding.seoTitleField)\n  const description = pick(binding.seoDescriptionField)\n  const image = pick(binding.seoImageField)\n  return {\n    ...(name ? { name } : {}),\n    ...(title ? { title } : {}),\n    ...(description ? { description } : {}),\n    ...(image ? { image } : {}),\n  }\n}\n\n/**\n * A binding document read back, or `null` when it does not describe one: the\n * fields every reader needs, trimmed. Optional fields that are blank are\n * dropped rather than kept as `''`.\n */\nexport function parseRecordPageBinding(\n  screenId: string,\n  data: Record<string, unknown> | null | undefined,\n): DatasetRecordPageBinding | null {\n  const text = (value: unknown) => (typeof value === 'string' ? value.trim() : '')\n  const datasetId = text(data?.['datasetId'])\n  const base = normalizeRecordPageBase(data?.['base'])\n  const slugField = text(data?.['slugField'])\n  if (!screenId || !datasetId || !base || !slugField) return null\n  const optional = (key: keyof DatasetRecordPageBinding) => {\n    const value = text(data?.[key])\n    return value ? { [key]: value } : {}\n  }\n  return {\n    screenId,\n    datasetId,\n    base,\n    slugField,\n    ...optional('titleField'),\n    ...optional('seoTitleField'),\n    ...optional('seoDescriptionField'),\n    ...optional('seoImageField'),\n  }\n}\n\n/**\n * The records a row's reference fields point at, by the dataset each lives in:\n * what a one-hop `{{item.author.name}}` on a record page has to read. A\n * multiple reference contributes every id it holds.\n */\nexport function referencedRecordIds(\n  model: RepeatRowsModel,\n  record: Record<string, unknown>,\n): Map<string, Set<string>> {\n  const wanted = new Map<string, Set<string>>()\n  for (const [fieldId, datasetId] of Object.entries(model.references ?? {})) {\n    if (!datasetId || datasetId.includes('/')) continue\n    const value = record[fieldId]\n    for (const id of Array.isArray(value) ? value : [value]) {\n      if (typeof id !== 'string' || !id || id.includes('/')) continue\n      const ids = wanted.get(datasetId) ?? new Set<string>()\n      ids.add(id)\n      wanted.set(datasetId, ids)\n    }\n  }\n  return wanted\n}\n\n/**\n * The row key `{{item.url}}` reads: a record's page on this site.\n * Persisted in nothing — it is computed on every read — but bound by authors,\n * so never rename.\n */\nexport const RECORD_PAGE_URL_KEY = 'url'\n\n/**\n * A dataset's repeated rows, each carrying its page as `url` when this site\n * has a record template for the dataset (AGL-3475) — so a listing card links\n * to the record's page with `{{item.url}}`, and the canvas previews the same\n * link the page renders.\n *\n * A model that declares a field of its own called `url` keeps it: the token\n * always means the dataset's field first. A row with no address has no page,\n * and so no `url`, and its token stays as written. Returns the rows\n * themselves when there is nothing to add.\n */\nexport function withRecordPageUrls<R extends Record<string, unknown>>(\n  rows: R[],\n  binding: Pick<DatasetRecordPageBinding, 'base' | 'slugField'> | null | undefined,\n  model: DatasetModel,\n): R[] {\n  if (!binding || model.fields?.[RECORD_PAGE_URL_KEY]) return rows\n  return rows.map((row) => {\n    const address = recordAddressOf(row, binding.slugField)\n    return address\n      ? { ...row, [RECORD_PAGE_URL_KEY]: recordPagePath(binding.base, address) }\n      : row\n  })\n}\n"],"names":["AUTHOR_ROUTE_SEGMENT","reservedScreenRouteSegment","urlSlugSegment","BUNDLE_ID","DATASET_RECORD_PAGES_COLLECTION","RECORD_PAGE_ADDRESS_FIELD_TYPE","RECORD_PAGE_ADDRESS_MAX","RECORD_PAGE_BASE_MAX_SEGMENTS","RECORD_PAGE_BASE_SEGMENT_MAX","RECORD_PAGES_MAX_PER_SITE","SEGMENT","normalizeRecordAddress","value","String","normalize","replace","slice","RECORD_PAGE_ADDRESS_FIELD","name","pluginId","label","baseType","description","validate","isRecordAddress","length","test","recordAddressOf","values","slugField","normalizeRecordPageBase","input","segments","trim","toLowerCase","split","filter","Boolean","segment","join","recordPageBaseRefusal","context","base","first","reserved","pluginRouteSegments","includes","collectionSlugs","otherBases","recordPagePath","address","recordPageRoute","matchRecordPagePath","bindings","path","binding","find","one","safeDecode","decodeURIComponent","isRecordAddressField","field","type","customType","recordAddressFieldIds","model","order","fieldId","fields","fillRecordAddresses","next","held","normalized","slugFrom","uniqueRecordAddresses","sources","taken","used","Set","assigned","Map","id","source","candidate","suffix","has","tail","add","set","textOf","Number","isFinite","recordPageNameField","titleField","recordPageHead","pick","title","seoTitleField","seoDescriptionField","image","seoImageField","parseRecordPageBinding","screenId","data","text","datasetId","optional","key","referencedRecordIds","record","wanted","Object","entries","references","Array","isArray","ids","get","RECORD_PAGE_URL_KEY","withRecordPageUrls","rows","map","row"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCC,GAED,SAASA,oBAAoB,QAAQ,yCAAwC;AAC7E,SAASC,0BAA0B,QAAQ,sCAAqC;AAChF,SAASC,cAAc,QAAQ,kCAAiC;AAGhE,SAASC,SAAS,QAAQ,gCAA4B;AAGtD,qFAAqF,GACrF,OAAO,MAAMC,kCAAkC,cAAa;AAE5D;;;CAGC,GACD,OAAO,MAAMC,iCAAiC,cAAa;AAE3D;;;;CAIC,GACD,OAAO,MAAMC,0BAA0B,GAAE;AAEzC,4EAA4E,GAC5E,OAAO,MAAMC,gCAAgC,EAAC;AAE9C,qCAAqC,GACrC,OAAO,MAAMC,+BAA+B,GAAE;AAE9C,iDAAiD,GACjD,OAAO,MAAMC,4BAA4B,GAAE;AAE3C,iFAAiF,GACjF,MAAMC,UAAU;AAiChB;;;;;;;;CAQC,GACD,OAAO,SAASC,uBAAuBC,KAAc;IACnD,IAAI,OAAOA,UAAU,YAAY,OAAOA,UAAU,UAAU,OAAO;IACnE,OAAOV,eACLW,OAAOD,OAAOE,SAAS,CAAC,QAAQC,OAAO,CAAC,UAAU,KAEjDC,KAAK,CAAC,GAAGV,yBACTS,OAAO,CAAC,QAAQ;AACrB;AAEA;;;;;;CAMC,GACD,OAAO,MAAME,4BAA6C;IACxDC,MAAMb;IACNc,UAAUhB;IACViB,OAAO;IACPC,UAAU;IACVC,aACE;IACFC,UAAU,CAACX,QACTY,gBAAgBZ,SACZ,OACA,CAAC,kDAAkD,EAAEN,wBAAwB,WAAW,CAAC;AACjG,EAAC;AAED,kEAAkE,GAClE,OAAO,SAASkB,gBAAgBZ,KAAc;IAC5C,OACE,OAAOA,UAAU,YACjBA,MAAMa,MAAM,IAAInB,2BAChBI,QAAQgB,IAAI,CAACd;AAEjB;AAEA,mEAAmE,GACnE,OAAO,SAASe,gBACdC,MAAkD,EAClDC,SAAiB;IAEjB,OAAOlB,uBAAuBiB,0BAAAA,MAAQ,CAACC,UAAU;AACnD;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,wBAAwBC,KAAc;IACpD,IAAI,OAAOA,UAAU,UAAU,OAAO;IACtC,MAAMC,WAAWD,MACdE,IAAI,GACJC,WAAW,GACXC,KAAK,CAAC,KACNC,MAAM,CAACC;IACV,IAAI,CAACL,SAASP,MAAM,IAAIO,SAASP,MAAM,GAAGlB,+BAA+B;QACvE,OAAO;IACT;IACA,KAAK,MAAM+B,WAAWN,SAAU;QAC9B,IAAIM,QAAQb,MAAM,GAAGjB,gCAAgC,CAACE,QAAQgB,IAAI,CAACY,UAAU;YAC3E,OAAO;QACT;IACF;IACA,OAAON,SAASO,IAAI,CAAC;AACvB;AAeA;;;;;;;;;;CAUC,GACD,OAAO,SAASC,sBACdT,KAAc,EACdU,UAAiC,CAAC,CAAC;QAc/BA,8BAGAA,0BAGAA;IAlBJ,MAAMC,OAAOZ,wBAAwBC;IACrC,IAAI,CAACW,MAAM;QACT,OACE,CAAC,WAAW,EAAEnC,8BAA8B,4BAA4B,CAAC,GACzE;IAEJ;IACA,MAAM,CAACoC,MAAM,GAAGD,KAAKP,KAAK,CAAC;IAC3B,MAAMS,WAAW3C,2BAA2ByC;IAC5C,IAAIE,YAAYD,UAAU3C,sBAAsB;QAC9C,OAAO,CAAC,CAAC,EAAE4C,mBAAAA,WAAYD,MAAM,wDAAwD,CAAC;IACxF;IACA,KAAIF,+BAAAA,QAAQI,mBAAmB,qBAA3BJ,6BAA6BK,QAAQ,CAACH,QAAQ;QAChD,OAAO,CAAC,CAAC,EAAEA,MAAM,iEAAiE,CAAC;IACrF;IACA,KAAIF,2BAAAA,QAAQM,eAAe,qBAAvBN,yBAAyBK,QAAQ,CAACH,QAAQ;QAC5C,OAAO,CAAC,CAAC,EAAEA,MAAM,yDAAyD,CAAC;IAC7E;IACA,KAAIF,sBAAAA,QAAQO,UAAU,qBAAlBP,oBAAoBK,QAAQ,CAACJ,OAAO;QACtC,OAAO,CAAC,sCAAsC,EAAEA,MAAM;IACxD;IACA,OAAO;AACT;AAEA,4DAA4D,GAC5D,OAAO,SAASO,eAAeP,IAAY,EAAEQ,OAAe;IAC1D,OAAO,CAAC,CAAC,EAAER,KAAK,CAAC,EAAEQ,SAAS;AAC9B;AAEA,sEAAsE,GACtE,OAAO,SAASC,gBAAgBT,IAAY;IAC1C,OAAO,CAAC,CAAC,EAAEA,KAAK,MAAM,CAAC;AACzB;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASU,oBACdC,QAAsB,EACtBC,IAAY;IAEZ,MAAMtB,WAAWsB,KAAKnB,KAAK,CAAC,KAAKC,MAAM,CAACC;IACxC,IAAIL,SAASP,MAAM,GAAG,GAAG,OAAO;IAChC,MAAMiB,OAAOV,SAAShB,KAAK,CAAC,GAAG,CAAC,GAAGuB,IAAI,CAAC,KAAKL,WAAW;IACxD,MAAMqB,UAAUF,SAASG,IAAI,CAAC,CAACC,MAAQA,IAAIf,IAAI,KAAKA;IACpD,IAAI,CAACa,SAAS,OAAO;IACrB,MAAML,UAAUvC,uBACd+C,WAAW1B,QAAQ,CAACA,SAASP,MAAM,GAAG,EAAE;IAE1C,OAAOyB,UAAU;QAAEK;QAASL;IAAQ,IAAI;AAC1C;AAEA,SAASQ,WAAWpB,OAAe;IACjC,IAAI;QACF,OAAOqB,mBAAmBrB;IAC5B,EAAE,eAAM;QACN,OAAOA;IACT;AACF;AAEA,kCAAkC,GAClC,OAAO,SAASsB,qBACdC,KAAgD;IAEhD,OAAOA,CAAAA,yBAAAA,MAAOC,IAAI,MAAK,UAAUD,MAAME,UAAU,KAAK1D;AACxD;AAEA,uDAAuD,GACvD,OAAO,SAAS2D,sBAAsBC,KAAmB;QAG/CA;IAFR,0EAA0E;IAC1E,8DAA8D;IAC9D,OAAO,EAACA,eAAAA,MAAMC,KAAK,YAAXD,eAAe,EAAE,EAAE7B,MAAM,CAAC,CAAC+B;YACZF;eAArBL,sBAAqBK,gBAAAA,MAAMG,MAAM,qBAAZH,aAAc,CAACE,QAAQ;;AAEhD;AAEA;;;;;;;;;CASC,GACD,OAAO,SAASE,oBACdJ,KAAmB,EACnBrC,MAAS;IAET,IAAI0C,OAAiB;IACrB,KAAK,MAAMH,WAAWH,sBAAsBC,OAAQ;YACpCA;QAAd,MAAMJ,SAAQI,gBAAAA,MAAMG,MAAM,qBAAZH,aAAc,CAACE,QAAQ;QACrC,MAAMI,OAAO3C,MAAM,CAACuC,QAAQ;QAC5B,MAAMK,aACJD,QAAQ,QAAQA,SAAS,KACrBV,CAAAA,yBAAAA,MAAOY,QAAQ,IACb9D,uBAAuBiB,MAAM,CAACiC,MAAMY,QAAQ,CAAC,IAC7C,KACF9D,uBAAuB4D;QAC7B,IAAI,CAACA,eAAAA,OAAQ,QAAQC,YAAY;QACjCF,eAAAA,OAAAA,OAAS,aAAK1C;QACd,IAAI4C,YAAY,AAACF,IAAgC,CAACH,QAAQ,GAAGK;aACxD,OAAO,AAACF,IAAgC,CAACH,QAAQ;IACxD;IACA,OAAOG,eAAAA,OAAQ1C;AACjB;AAEA;;;;;CAKC,GACD,OAAO,SAAS8C,sBACdC,OAAuD,EACvDC,QAA0B,EAAE;IAE5B,MAAMC,OAAO,IAAIC,IAAIF;IACrB,MAAMG,WAAW,IAAIC;IACrB,KAAK,MAAM,EAAEC,EAAE,EAAEC,MAAM,EAAE,IAAIP,QAAS;QACpC,MAAMjC,OAAO/B,uBAAuBuE;QACpC,IAAI,CAACxC,MAAM;QACX,IAAIyC,YAAYzC;QAChB,IAAK,IAAI0C,SAAS,GAAGP,KAAKQ,GAAG,CAACF,YAAYC,UAAU,EAAG;YACrD,MAAME,OAAO,CAAC,CAAC,EAAEF,QAAQ;YACzBD,YAAY,GAAGzC,KAAK1B,KAAK,CAAC,GAAGV,0BAA0BgF,KAAK7D,MAAM,EAAEV,OAAO,CAAC,QAAQ,MAAMuE,MAAM;QAClG;QACAT,KAAKU,GAAG,CAACJ;QACTJ,SAASS,GAAG,CAACP,IAAIE;IACnB;IACA,OAAOJ;AACT;AAEA,MAAMU,SAAS,CAAC7E;IACd,IAAI,OAAOA,UAAU,UAAU,OAAOA,MAAMqB,IAAI;IAChD,IAAI,OAAOrB,UAAU,YAAY8E,OAAOC,QAAQ,CAAC/E,QAAQ,OAAOC,OAAOD;IACvE,OAAO;AACT;AAEA;;;CAGC,GACD,OAAO,SAASgF,oBACdrC,OAAmE,EACnEU,KAAmB;IAEnB,IAAIV,QAAQsC,UAAU,IAAI5B,MAAMG,MAAM,CAACb,QAAQsC,UAAU,CAAC,EAAE;QAC1D,OAAOtC,QAAQsC,UAAU;IAC3B;IACA,OAAO5B,MAAMC,KAAK,CAACV,IAAI,CAAC,CAACW;QACvB,MAAMN,QAAQI,MAAMG,MAAM,CAACD,QAAQ;QACnC,OAAON,CAAAA,yBAAAA,MAAOC,IAAI,MAAK,UAAUK,YAAYZ,QAAQ1B,SAAS,IAAI,CAAC+B,qBAAqBC;IAC1F;AACF;AAaA;;;;;CAKC,GACD,OAAO,SAASiC,eACdvC,OAAiC,EACjCU,KAAmB,EACnBrC,MAA+B;IAE/B,MAAMmE,OAAO,CAAC5B,UACZA,UAAUsB,OAAO7D,MAAM,CAACuC,QAAQ,IAAI;IACtC,MAAMjD,OAAO6E,KAAKH,oBAAoBrC,SAASU;IAC/C,MAAM+B,QAAQD,KAAKxC,QAAQ0C,aAAa;IACxC,MAAM3E,cAAcyE,KAAKxC,QAAQ2C,mBAAmB;IACpD,MAAMC,QAAQJ,KAAKxC,QAAQ6C,aAAa;IACxC,OAAO,aACDlF,OAAO;QAAEA;IAAK,IAAI,CAAC,GACnB8E,QAAQ;QAAEA;IAAM,IAAI,CAAC,GACrB1E,cAAc;QAAEA;IAAY,IAAI,CAAC,GACjC6E,QAAQ;QAAEA;IAAM,IAAI,CAAC;AAE7B;AAEA;;;;CAIC,GACD,OAAO,SAASE,uBACdC,QAAgB,EAChBC,IAAgD;IAEhD,MAAMC,OAAO,CAAC5F,QAAoB,OAAOA,UAAU,WAAWA,MAAMqB,IAAI,KAAK;IAC7E,MAAMwE,YAAYD,KAAKD,wBAAAA,IAAM,CAAC,YAAY;IAC1C,MAAM7D,OAAOZ,wBAAwByE,wBAAAA,IAAM,CAAC,OAAO;IACnD,MAAM1E,YAAY2E,KAAKD,wBAAAA,IAAM,CAAC,YAAY;IAC1C,IAAI,CAACD,YAAY,CAACG,aAAa,CAAC/D,QAAQ,CAACb,WAAW,OAAO;IAC3D,MAAM6E,WAAW,CAACC;QAChB,MAAM/F,QAAQ4F,KAAKD,wBAAAA,IAAM,CAACI,IAAI;QAC9B,OAAO/F,QAAQ;YAAE,CAAC+F,IAAI,EAAE/F;QAAM,IAAI,CAAC;IACrC;IACA,OAAO;QACL0F;QACAG;QACA/D;QACAb;OACG6E,SAAS,eACTA,SAAS,kBACTA,SAAS,wBACTA,SAAS;AAEhB;AAEA;;;;CAIC,GACD,OAAO,SAASE,oBACd3C,KAAsB,EACtB4C,MAA+B;QAGmB5C;IADlD,MAAM6C,SAAS,IAAI9B;IACnB,KAAK,MAAM,CAACb,SAASsC,UAAU,IAAIM,OAAOC,OAAO,EAAC/C,oBAAAA,MAAMgD,UAAU,YAAhBhD,oBAAoB,CAAC,GAAI;QACzE,IAAI,CAACwC,aAAaA,UAAU3D,QAAQ,CAAC,MAAM;QAC3C,MAAMlC,QAAQiG,MAAM,CAAC1C,QAAQ;QAC7B,KAAK,MAAMc,MAAMiC,MAAMC,OAAO,CAACvG,SAASA,QAAQ;YAACA;SAAM,CAAE;gBAE3CkG;YADZ,IAAI,OAAO7B,OAAO,YAAY,CAACA,MAAMA,GAAGnC,QAAQ,CAAC,MAAM;YACvD,MAAMsE,OAAMN,cAAAA,OAAOO,GAAG,CAACZ,sBAAXK,cAAyB,IAAIhC;YACzCsC,IAAI7B,GAAG,CAACN;YACR6B,OAAOtB,GAAG,CAACiB,WAAWW;QACxB;IACF;IACA,OAAON;AACT;AAEA;;;;CAIC,GACD,OAAO,MAAMQ,sBAAsB,MAAK;AAExC;;;;;;;;;;CAUC,GACD,OAAO,SAASC,mBACdC,IAAS,EACTjE,OAAgF,EAChFU,KAAmB;QAEHA;IAAhB,IAAI,CAACV,aAAWU,gBAAAA,MAAMG,MAAM,qBAAZH,aAAc,CAACqD,oBAAoB,GAAE,OAAOE;IAC5D,OAAOA,KAAKC,GAAG,CAAC,CAACC;QACf,MAAMxE,UAAUvB,gBAAgB+F,KAAKnE,QAAQ1B,SAAS;QACtD,OAAOqB,UACH,aAAKwE;YAAK,CAACJ,oBAAoB,EAAErE,eAAeM,QAAQb,IAAI,EAAEQ;aAC9DwE;IACN;AACF"}