@aglyn/aglyn 1.0.0-beta.231 → 1.0.0-beta.232

package/src/lib/app-utils/business-profile.d.ts

@@ -0,0 +1,171 @@
+/**
+ * @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 HostSeoEntity } from './content-authors';
+/**
+ * A site's BUSINESS PROFILE (AGL-3661): what the business is, as everything
+ * that writes about it needs to know — the site's own pages, the structured
+ * data, and any generator a plugin brings.
+ *
+ * ── Most of it is already stored, so this stores only the rest ─────────────
+ *
+ * The site's name, its one-line description, its contact details, its hours,
+ * the areas it serves and its social profiles all have a home on the host
+ * document already: `seo.entity` (the publisher entity the JSON-LD is built
+ * from, edited in Setup → SEO) and `business` (the contact card the `host.*`
+ * tokens and the footer read, edited in Setup → Basic details). Copying them
+ * here would make two places to keep in step, and the copy would drift.
+ *
+ * So the profile document holds only what has no home yet — the services, the
+ * audience, the tone of voice — plus a line about the business and the area it
+ * serves for a site whose SEO entity does not say. {@link resolveBusinessProfile}
+ * reads the two together into one picture, field by field, and says where
+ * each value came from.
+ *
+ * ── Where it is stored ────────────────────────────────────────────────────
+ *
+ * `hosts/{hostId}/businessProfile/profile` for a site and
+ * `orgs/{orgId}/businessProfile/defaults` for the workspace, whose values a
+ * site inherits where it has none of its own. A subcollection document rather
+ * than a key on the host: the host document's `business` map is replaced
+ * whole by the contact card's save, and a key beside it would be one more
+ * thing a partial write could blank.
+ *
+ * ── Whose words win ───────────────────────────────────────────────────────
+ *
+ * Every stored value carries its source. What the owner typed is never
+ * replaced by anything else; what the guided start was told replaces only
+ * what a generator guessed; and a generator's guess fills only what is empty.
+ * {@link mergeBusinessProfilePrefill} is the one place that rule is applied.
+ */
+/** The collection a profile document lives in, under a host or an org. */
+export declare const BUSINESS_PROFILE_SUBCOLLECTION = "businessProfile";
+/** The site's profile document id. */
+export declare const BUSINESS_PROFILE_SITE_DOC = "profile";
+/** The workspace defaults document id. */
+export declare const BUSINESS_PROFILE_WORKSPACE_DOC = "defaults";
+/** Who wrote a stored value: the owner, the guided start's answers, or a generator. */
+export type BusinessProfileSource = 'owner' | 'start' | 'ai';
+/**
+ * Where a RESOLVED value came from: a stored source, the site's own settings
+ * (`seo.entity`, `business`, the display name), or the workspace defaults.
+ */
+export type BusinessProfileOrigin = BusinessProfileSource | 'site' | 'workspace';
+export declare const BUSINESS_TONES: readonly ["friendly", "professional", "playful", "premium", "plain"];
+export type BusinessTone = (typeof BUSINESS_TONES)[number];
+/** Each tone as the owner picks it and as a writer is told it. */
+export declare const BUSINESS_TONE_LABELS: Readonly<Record<BusinessTone, string>>;
+/** The fields the profile document stores itself. */
+export declare const BUSINESS_PROFILE_FIELDS: readonly ["whatYouDo", "services", "serviceArea", "audience", "tone", "toneNotes"];
+export type BusinessProfileField = (typeof BUSINESS_PROFILE_FIELDS)[number];
+/** Each field's ceiling, in characters; `services` is per item. */
+export declare const BUSINESS_PROFILE_MAX_CHARS: Readonly<Record<Exclude<BusinessProfileField, 'tone'>, number>>;
+/** At most this many services are kept. */
+export declare const BUSINESS_PROFILE_MAX_SERVICES = 12;
+/** The stored document, at either level. */
+export interface BusinessProfileDoc {
+    whatYouDo?: string;
+    services?: string[];
+    serviceArea?: string;
+    audience?: string;
+    tone?: BusinessTone | null;
+    toneNotes?: string;
+    /** Who wrote each stored value; a value without one is the owner's. */
+    sources?: Partial<Record<BusinessProfileField, BusinessProfileSource>>;
+    updatedAt?: unknown;
+    updatedBy?: string | null;
+}
+/** The values a write carries, before they are sanitized. */
+export type BusinessProfileValues = Partial<Pick<BusinessProfileDoc, 'whatYouDo' | 'services' | 'serviceArea' | 'audience' | 'tone' | 'toneNotes'>>;
+/** The host fields the profile reads. A closed surface, as the host tokens' is. */
+export interface BusinessProfileHost {
+    displayName?: string;
+    logoUrl?: string;
+    seo?: {
+        description?: string;
+        entity?: HostSeoEntity | null;
+    } | null;
+    business?: {
+        supportEmail?: string;
+        address?: string;
+        socialLinks?: Array<{
+            label?: string;
+            url?: string;
+        } | null> | null;
+    } | null;
+}
+export interface ResolvedBusinessField<T> {
+    value: T;
+    origin: BusinessProfileOrigin;
+}
+/** The picture every reader works from: each field's value and where it came from. */
+export interface ResolvedBusinessProfile {
+    name: ResolvedBusinessField<string> | null;
+    whatYouDo: ResolvedBusinessField<string> | null;
+    services: ResolvedBusinessField<string[]> | null;
+    serviceArea: ResolvedBusinessField<string> | null;
+    audience: ResolvedBusinessField<string> | null;
+    tone: ResolvedBusinessField<BusinessTone> | null;
+    toneNotes: ResolvedBusinessField<string> | null;
+    /** The schema.org business type the SEO entity names, e.g. `Plumber`. */
+    businessType: string | null;
+    /** Real contact details, each only where the owner entered it in the site's settings. */
+    contact: {
+        email: string | null;
+        phone: string | null;
+        address: string | null;
+        hours: string | null;
+    };
+    /** The site's social and other profiles, https only. */
+    profiles: string[];
+    logo: string | null;
+}
+/** The source a stored, non-empty value carries; the owner's when none is recorded. */
+export declare function businessProfileSourceOf(doc: BusinessProfileDoc | null | undefined, field: BusinessProfileField): BusinessProfileSource | null;
+/** Every value a write may carry, sanitized; an absent field stays absent. */
+export declare function sanitizeBusinessProfileValues(values: BusinessProfileValues): BusinessProfileValues;
+/**
+ * The document a generator's or the guided start's values make of the stored
+ * one: each value fills a field that is empty or was written by a source that
+ * weighs less, and nothing else. `null` when nothing would change, so a caller
+ * writes only when there is something to write.
+ */
+export declare function mergeBusinessProfilePrefill(current: BusinessProfileDoc | null | undefined, values: BusinessProfileValues, source: Exclude<BusinessProfileSource, 'owner'>): BusinessProfileDoc | null;
+/**
+ * The document the owner's save makes: every field they changed becomes
+ * theirs, and a field they left as it was keeps the source it had — so saving
+ * the form after correcting one line does not claim every suggestion on it.
+ */
+export declare function businessProfileOwnerWrite(current: BusinessProfileDoc | null | undefined, edited: BusinessProfileValues): Pick<BusinessProfileDoc, BusinessProfileField | 'sources'>;
+/**
+ * The profile as every reader sees it, field by field (AGL-3661):
+ *
+ * 1. what the OWNER typed into the site's profile;
+ * 2. what the site's own settings say (the SEO entity, the contact card, the
+ *    display name), which the owner typed too, elsewhere;
+ * 3. what the guided start or a generator stored on the site's profile;
+ * 4. the workspace defaults.
+ *
+ * Contact details, the logo and the profiles come from the site's settings
+ * only: nothing but the owner's own entry may say how to reach the business.
+ */
+export declare function resolveBusinessProfile(input: {
+    host: BusinessProfileHost | null | undefined;
+    site?: BusinessProfileDoc | null;
+    workspace?: BusinessProfileDoc | null;
+}): ResolvedBusinessProfile;
+/** Each origin as the profile screen labels it. */
+export declare const BUSINESS_PROFILE_ORIGIN_LABELS: Readonly<Record<BusinessProfileOrigin, string>>;

package/src/lib/app-utils/business-profile.js

@@ -0,0 +1,277 @@
+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.
+ */ import { siteProfileUrls } from "./content-authors.js";
+import { normalizeAreaServed } from "./local-business.js";
+import { PLATFORM_BRAND_NAME } from "./platform-brand.js";
+/**
+ * A site's BUSINESS PROFILE (AGL-3661): what the business is, as everything
+ * that writes about it needs to know — the site's own pages, the structured
+ * data, and any generator a plugin brings.
+ *
+ * ── Most of it is already stored, so this stores only the rest ─────────────
+ *
+ * The site's name, its one-line description, its contact details, its hours,
+ * the areas it serves and its social profiles all have a home on the host
+ * document already: `seo.entity` (the publisher entity the JSON-LD is built
+ * from, edited in Setup → SEO) and `business` (the contact card the `host.*`
+ * tokens and the footer read, edited in Setup → Basic details). Copying them
+ * here would make two places to keep in step, and the copy would drift.
+ *
+ * So the profile document holds only what has no home yet — the services, the
+ * audience, the tone of voice — plus a line about the business and the area it
+ * serves for a site whose SEO entity does not say. {@link resolveBusinessProfile}
+ * reads the two together into one picture, field by field, and says where
+ * each value came from.
+ *
+ * ── Where it is stored ────────────────────────────────────────────────────
+ *
+ * `hosts/{hostId}/businessProfile/profile` for a site and
+ * `orgs/{orgId}/businessProfile/defaults` for the workspace, whose values a
+ * site inherits where it has none of its own. A subcollection document rather
+ * than a key on the host: the host document's `business` map is replaced
+ * whole by the contact card's save, and a key beside it would be one more
+ * thing a partial write could blank.
+ *
+ * ── Whose words win ───────────────────────────────────────────────────────
+ *
+ * Every stored value carries its source. What the owner typed is never
+ * replaced by anything else; what the guided start was told replaces only
+ * what a generator guessed; and a generator's guess fills only what is empty.
+ * {@link mergeBusinessProfilePrefill} is the one place that rule is applied.
+ */ /** The collection a profile document lives in, under a host or an org. */ export const BUSINESS_PROFILE_SUBCOLLECTION = 'businessProfile';
+/** The site's profile document id. */ export const BUSINESS_PROFILE_SITE_DOC = 'profile';
+/** The workspace defaults document id. */ export const BUSINESS_PROFILE_WORKSPACE_DOC = 'defaults';
+/** How much a source's words weigh: a higher rank is never replaced by a lower one. */ const SOURCE_RANK = {
+    ai: 1,
+    start: 2,
+    owner: 3
+};
+export const BUSINESS_TONES = [
+    'friendly',
+    'professional',
+    'playful',
+    'premium',
+    'plain'
+];
+/** Each tone as the owner picks it and as a writer is told it. */ export const BUSINESS_TONE_LABELS = {
+    friendly: 'Friendly and warm',
+    professional: 'Professional and clear',
+    playful: 'Playful and upbeat',
+    premium: 'Premium and refined',
+    plain: 'Plain and direct'
+};
+/** The fields the profile document stores itself. */ export const BUSINESS_PROFILE_FIELDS = [
+    'whatYouDo',
+    'services',
+    'serviceArea',
+    'audience',
+    'tone',
+    'toneNotes'
+];
+/** Each field's ceiling, in characters; `services` is per item. */ export const BUSINESS_PROFILE_MAX_CHARS = {
+    whatYouDo: 200,
+    services: 60,
+    serviceArea: 120,
+    audience: 160,
+    toneNotes: 200
+};
+/** At most this many services are kept. */ export const BUSINESS_PROFILE_MAX_SERVICES = 12;
+const text = (value, max)=>typeof value === 'string' ? value.replace(/\s+/g, ' ').trim().slice(0, max) : '';
+const tone = (value)=>BUSINESS_TONES.includes(value) ? value : null;
+const services = (value)=>{
+    const items = Array.isArray(value) ? value : typeof value === 'string' ? value.split(/[,\n]/) : [];
+    const seen = new Set();
+    const kept = [];
+    for (const item of items){
+        const name = text(item, BUSINESS_PROFILE_MAX_CHARS.services);
+        const key = name.toLowerCase();
+        if (!name || seen.has(key)) continue;
+        seen.add(key);
+        kept.push(name);
+        if (kept.length >= BUSINESS_PROFILE_MAX_SERVICES) break;
+    }
+    return kept;
+};
+/** One field's stored value, sanitized; empty is `''`, `[]` or `null`. */ function fieldValue(doc, field) {
+    switch(field){
+        case 'services':
+            return services(doc == null ? void 0 : doc.services);
+        case 'tone':
+            return tone(doc == null ? void 0 : doc.tone);
+        default:
+            return text(doc == null ? void 0 : doc[field], BUSINESS_PROFILE_MAX_CHARS[field]);
+    }
+}
+const isEmpty = (value)=>value === null || value === '' || Array.isArray(value) && value.length === 0;
+/** The source a stored, non-empty value carries; the owner's when none is recorded. */ export function businessProfileSourceOf(doc, field) {
+    var _doc_sources;
+    if (isEmpty(fieldValue(doc, field))) return null;
+    const source = doc == null ? void 0 : (_doc_sources = doc.sources) == null ? void 0 : _doc_sources[field];
+    return source && source in SOURCE_RANK ? source : 'owner';
+}
+/** Every value a write may carry, sanitized; an absent field stays absent. */ export function sanitizeBusinessProfileValues(values) {
+    const clean = {};
+    for (const field of BUSINESS_PROFILE_FIELDS){
+        if (!(field in values)) continue;
+        clean[field] = fieldValue(values, field);
+    }
+    return clean;
+}
+/**
+ * The document a generator's or the guided start's values make of the stored
+ * one: each value fills a field that is empty or was written by a source that
+ * weighs less, and nothing else. `null` when nothing would change, so a caller
+ * writes only when there is something to write.
+ */ export function mergeBusinessProfilePrefill(current, values, source) {
+    var _ref;
+    const clean = sanitizeBusinessProfileValues(values);
+    const next = _extends({}, current != null ? current : {}, {
+        sources: _extends({}, (_ref = current == null ? void 0 : current.sources) != null ? _ref : {})
+    });
+    let changed = false;
+    for (const field of BUSINESS_PROFILE_FIELDS){
+        var _current_sources;
+        if (!(field in clean)) continue;
+        const value = clean[field];
+        if (isEmpty(value)) continue;
+        // An explicit source counts even on an empty value: a field the owner
+        // cleared stays cleared rather than being refilled behind them.
+        const recorded = current == null ? void 0 : (_current_sources = current.sources) == null ? void 0 : _current_sources[field];
+        const held = recorded && recorded in SOURCE_RANK ? recorded : businessProfileSourceOf(current, field);
+        if (held && SOURCE_RANK[held] >= SOURCE_RANK[source]) continue;
+        if (JSON.stringify(fieldValue(current, field)) === JSON.stringify(value)) continue;
+        next[field] = value;
+        next.sources[field] = source;
+        changed = true;
+    }
+    return changed ? next : null;
+}
+/**
+ * The document the owner's save makes: every field they changed becomes
+ * theirs, and a field they left as it was keeps the source it had — so saving
+ * the form after correcting one line does not claim every suggestion on it.
+ */ export function businessProfileOwnerWrite(current, edited) {
+    const clean = sanitizeBusinessProfileValues(edited);
+    const next = {};
+    const sources = {};
+    for (const field of BUSINESS_PROFILE_FIELDS){
+        var _businessProfileSourceOf;
+        const before = fieldValue(current, field);
+        const after = field in clean ? clean[field] : before;
+        next[field] = after;
+        const same = JSON.stringify(before) === JSON.stringify(after);
+        if (isEmpty(after)) {
+            var _current_sources;
+            // A suggestion the owner deleted is their decision, and recorded as
+            // one, so the next prefill does not put it back.
+            if (!same) sources[field] = 'owner';
+            else if ((current == null ? void 0 : (_current_sources = current.sources) == null ? void 0 : _current_sources[field]) === 'owner') sources[field] = 'owner';
+            continue;
+        }
+        sources[field] = same ? (_businessProfileSourceOf = businessProfileSourceOf(current, field)) != null ? _businessProfileSourceOf : 'owner' : 'owner';
+    }
+    return _extends({}, next, {
+        sources
+    });
+}
+/** The postal address as one line: the SEO entity's parts, else the contact card's block. */ function addressLine(host) {
+    var _host_seo_entity, _host_seo, _host_business;
+    const parts = host == null ? void 0 : (_host_seo = host.seo) == null ? void 0 : (_host_seo_entity = _host_seo.entity) == null ? void 0 : _host_seo_entity.address;
+    const line = [
+        parts == null ? void 0 : parts.streetAddress,
+        parts == null ? void 0 : parts.addressLocality,
+        parts == null ? void 0 : parts.addressRegion,
+        parts == null ? void 0 : parts.postalCode,
+        parts == null ? void 0 : parts.addressCountry
+    ].map((part)=>text(part, 200)).filter(Boolean).join(', ');
+    return line || text(host == null ? void 0 : (_host_business = host.business) == null ? void 0 : _host_business.address, 400);
+}
+/**
+ * The profile as every reader sees it, field by field (AGL-3661):
+ *
+ * 1. what the OWNER typed into the site's profile;
+ * 2. what the site's own settings say (the SEO entity, the contact card, the
+ *    display name), which the owner typed too, elsewhere;
+ * 3. what the guided start or a generator stored on the site's profile;
+ * 4. the workspace defaults.
+ *
+ * Contact details, the logo and the profiles come from the site's settings
+ * only: nothing but the owner's own entry may say how to reach the business.
+ */ export function resolveBusinessProfile(input) {
+    var _ref;
+    var _host_seo, _host_business;
+    const { host, site, workspace } = input;
+    const entity = (_ref = host == null ? void 0 : (_host_seo = host.seo) == null ? void 0 : _host_seo.entity) != null ? _ref : null;
+    const fromSite = {
+        whatYouDo: text(entity == null ? void 0 : entity.description, BUSINESS_PROFILE_MAX_CHARS.whatYouDo),
+        serviceArea: normalizeAreaServed(entity == null ? void 0 : entity.areaServed).join(', ').slice(0, BUSINESS_PROFILE_MAX_CHARS.serviceArea)
+    };
+    const resolve = (field)=>{
+        const stored = businessProfileSourceOf(site, field);
+        if (stored === 'owner') return {
+            value: fieldValue(site, field),
+            origin: 'owner'
+        };
+        const own = fromSite[field];
+        if (own !== undefined && !isEmpty(own)) return {
+            value: own,
+            origin: 'site'
+        };
+        if (stored) return {
+            value: fieldValue(site, field),
+            origin: stored
+        };
+        if (businessProfileSourceOf(workspace, field)) {
+            return {
+                value: fieldValue(workspace, field),
+                origin: 'workspace'
+            };
+        }
+        return null;
+    };
+    const name = text(entity == null ? void 0 : entity.name, 200) || text(host == null ? void 0 : host.displayName, 200);
+    return {
+        name: name ? {
+            value: name,
+            origin: 'site'
+        } : null,
+        whatYouDo: resolve('whatYouDo'),
+        services: resolve('services'),
+        serviceArea: resolve('serviceArea'),
+        audience: resolve('audience'),
+        tone: resolve('tone'),
+        toneNotes: resolve('toneNotes'),
+        businessType: text(entity == null ? void 0 : entity.businessType, 80) || null,
+        contact: {
+            email: text(entity == null ? void 0 : entity.email, 320) || text(host == null ? void 0 : (_host_business = host.business) == null ? void 0 : _host_business.supportEmail, 320) || null,
+            phone: text(entity == null ? void 0 : entity.telephone, 64) || null,
+            address: addressLine(host) || null,
+            hours: text(entity == null ? void 0 : entity.openingHours, 400) || null
+        },
+        profiles: siteProfileUrls(host),
+        logo: text(host == null ? void 0 : host.logoUrl, 800) || text(entity == null ? void 0 : entity.logo, 800) || null
+    };
+}
+/** Each origin as the profile screen labels it. */ export const BUSINESS_PROFILE_ORIGIN_LABELS = {
+    owner: 'You',
+    site: 'Site settings',
+    start: 'Your answers when the site was started',
+    ai: `Suggested by ${PLATFORM_BRAND_NAME} AI`,
+    workspace: 'Workspace default'
+};
+
+//# sourceMappingURL=business-profile.js.map

package/src/lib/app-utils/business-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/business-profile.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\nimport { siteProfileUrls, type HostSeoEntity } from './content-authors'\nimport { normalizeAreaServed } from './local-business'\nimport { PLATFORM_BRAND_NAME } from './platform-brand'\n\n/**\n * A site's BUSINESS PROFILE (AGL-3661): what the business is, as everything\n * that writes about it needs to know — the site's own pages, the structured\n * data, and any generator a plugin brings.\n *\n * ── Most of it is already stored, so this stores only the rest ─────────────\n *\n * The site's name, its one-line description, its contact details, its hours,\n * the areas it serves and its social profiles all have a home on the host\n * document already: `seo.entity` (the publisher entity the JSON-LD is built\n * from, edited in Setup → SEO) and `business` (the contact card the `host.*`\n * tokens and the footer read, edited in Setup → Basic details). Copying them\n * here would make two places to keep in step, and the copy would drift.\n *\n * So the profile document holds only what has no home yet — the services, the\n * audience, the tone of voice — plus a line about the business and the area it\n * serves for a site whose SEO entity does not say. {@link resolveBusinessProfile}\n * reads the two together into one picture, field by field, and says where\n * each value came from.\n *\n * ── Where it is stored ────────────────────────────────────────────────────\n *\n * `hosts/{hostId}/businessProfile/profile` for a site and\n * `orgs/{orgId}/businessProfile/defaults` for the workspace, whose values a\n * site inherits where it has none of its own. A subcollection document rather\n * than a key on the host: the host document's `business` map is replaced\n * whole by the contact card's save, and a key beside it would be one more\n * thing a partial write could blank.\n *\n * ── Whose words win ───────────────────────────────────────────────────────\n *\n * Every stored value carries its source. What the owner typed is never\n * replaced by anything else; what the guided start was told replaces only\n * what a generator guessed; and a generator's guess fills only what is empty.\n * {@link mergeBusinessProfilePrefill} is the one place that rule is applied.\n */\n\n/** The collection a profile document lives in, under a host or an org. */\nexport const BUSINESS_PROFILE_SUBCOLLECTION = 'businessProfile'\n/** The site's profile document id. */\nexport const BUSINESS_PROFILE_SITE_DOC = 'profile'\n/** The workspace defaults document id. */\nexport const BUSINESS_PROFILE_WORKSPACE_DOC = 'defaults'\n\n/** Who wrote a stored value: the owner, the guided start's answers, or a generator. */\nexport type BusinessProfileSource = 'owner' | 'start' | 'ai'\n\n/**\n * Where a RESOLVED value came from: a stored source, the site's own settings\n * (`seo.entity`, `business`, the display name), or the workspace defaults.\n */\nexport type BusinessProfileOrigin = BusinessProfileSource | 'site' | 'workspace'\n\n/** How much a source's words weigh: a higher rank is never replaced by a lower one. */\nconst SOURCE_RANK: Readonly<Record<BusinessProfileSource, number>> = {\n  ai: 1,\n  start: 2,\n  owner: 3,\n}\n\nexport const BUSINESS_TONES = ['friendly', 'professional', 'playful', 'premium', 'plain'] as const\nexport type BusinessTone = (typeof BUSINESS_TONES)[number]\n\n/** Each tone as the owner picks it and as a writer is told it. */\nexport const BUSINESS_TONE_LABELS: Readonly<Record<BusinessTone, string>> = {\n  friendly: 'Friendly and warm',\n  professional: 'Professional and clear',\n  playful: 'Playful and upbeat',\n  premium: 'Premium and refined',\n  plain: 'Plain and direct',\n}\n\n/** The fields the profile document stores itself. */\nexport const BUSINESS_PROFILE_FIELDS = [\n  'whatYouDo',\n  'services',\n  'serviceArea',\n  'audience',\n  'tone',\n  'toneNotes',\n] as const\nexport type BusinessProfileField = (typeof BUSINESS_PROFILE_FIELDS)[number]\n\n/** Each field's ceiling, in characters; `services` is per item. */\nexport const BUSINESS_PROFILE_MAX_CHARS: Readonly<Record<Exclude<BusinessProfileField, 'tone'>, number>> = {\n  whatYouDo: 200,\n  services: 60,\n  serviceArea: 120,\n  audience: 160,\n  toneNotes: 200,\n}\n\n/** At most this many services are kept. */\nexport const BUSINESS_PROFILE_MAX_SERVICES = 12\n\n/** The stored document, at either level. */\nexport interface BusinessProfileDoc {\n  whatYouDo?: string\n  services?: string[]\n  serviceArea?: string\n  audience?: string\n  tone?: BusinessTone | null\n  toneNotes?: string\n  /** Who wrote each stored value; a value without one is the owner's. */\n  sources?: Partial<Record<BusinessProfileField, BusinessProfileSource>>\n  updatedAt?: unknown\n  updatedBy?: string | null\n}\n\n/** The values a write carries, before they are sanitized. */\nexport type BusinessProfileValues = Partial<\n  Pick<BusinessProfileDoc, 'whatYouDo' | 'services' | 'serviceArea' | 'audience' | 'tone' | 'toneNotes'>\n>\n\n/** The host fields the profile reads. A closed surface, as the host tokens' is. */\nexport interface BusinessProfileHost {\n  displayName?: string\n  logoUrl?: string\n  seo?: { description?: string; entity?: HostSeoEntity | null } | null\n  business?: {\n    supportEmail?: string\n    address?: string\n    socialLinks?: Array<{ label?: string; url?: string } | null> | null\n  } | null\n}\n\nexport interface ResolvedBusinessField<T> {\n  value: T\n  origin: BusinessProfileOrigin\n}\n\n/** The picture every reader works from: each field's value and where it came from. */\nexport interface ResolvedBusinessProfile {\n  name: ResolvedBusinessField<string> | null\n  whatYouDo: ResolvedBusinessField<string> | null\n  services: ResolvedBusinessField<string[]> | null\n  serviceArea: ResolvedBusinessField<string> | null\n  audience: ResolvedBusinessField<string> | null\n  tone: ResolvedBusinessField<BusinessTone> | null\n  toneNotes: ResolvedBusinessField<string> | null\n  /** The schema.org business type the SEO entity names, e.g. `Plumber`. */\n  businessType: string | null\n  /** Real contact details, each only where the owner entered it in the site's settings. */\n  contact: {\n    email: string | null\n    phone: string | null\n    address: string | null\n    hours: string | null\n  }\n  /** The site's social and other profiles, https only. */\n  profiles: string[]\n  logo: string | null\n}\n\nconst text = (value: unknown, max: number): string =>\n  typeof value === 'string' ? value.replace(/\\s+/g, ' ').trim().slice(0, max) : ''\n\nconst tone = (value: unknown): BusinessTone | null =>\n  (BUSINESS_TONES as readonly unknown[]).includes(value) ? (value as BusinessTone) : null\n\nconst services = (value: unknown): string[] => {\n  const items = Array.isArray(value) ? value : typeof value === 'string' ? value.split(/[,\\n]/) : []\n  const seen = new Set<string>()\n  const kept: string[] = []\n  for (const item of items) {\n    const name = text(item, BUSINESS_PROFILE_MAX_CHARS.services)\n    const key = name.toLowerCase()\n    if (!name || seen.has(key)) continue\n    seen.add(key)\n    kept.push(name)\n    if (kept.length >= BUSINESS_PROFILE_MAX_SERVICES) break\n  }\n  return kept\n}\n\n/** One field's stored value, sanitized; empty is `''`, `[]` or `null`. */\nfunction fieldValue(doc: BusinessProfileValues | null | undefined, field: BusinessProfileField): unknown {\n  switch (field) {\n    case 'services':\n      return services(doc?.services)\n    case 'tone':\n      return tone(doc?.tone)\n    default:\n      return text(doc?.[field], BUSINESS_PROFILE_MAX_CHARS[field])\n  }\n}\n\nconst isEmpty = (value: unknown): boolean =>\n  value === null || value === '' || (Array.isArray(value) && value.length === 0)\n\n/** The source a stored, non-empty value carries; the owner's when none is recorded. */\nexport function businessProfileSourceOf(\n  doc: BusinessProfileDoc | null | undefined,\n  field: BusinessProfileField,\n): BusinessProfileSource | null {\n  if (isEmpty(fieldValue(doc, field))) return null\n  const source = doc?.sources?.[field]\n  return source && source in SOURCE_RANK ? source : 'owner'\n}\n\n/** Every value a write may carry, sanitized; an absent field stays absent. */\nexport function sanitizeBusinessProfileValues(values: BusinessProfileValues): BusinessProfileValues {\n  const clean: BusinessProfileValues = {}\n  for (const field of BUSINESS_PROFILE_FIELDS) {\n    if (!(field in values)) continue\n    ;(clean as Record<string, unknown>)[field] = fieldValue(values, field)\n  }\n  return clean\n}\n\n/**\n * The document a generator's or the guided start's values make of the stored\n * one: each value fills a field that is empty or was written by a source that\n * weighs less, and nothing else. `null` when nothing would change, so a caller\n * writes only when there is something to write.\n */\nexport function mergeBusinessProfilePrefill(\n  current: BusinessProfileDoc | null | undefined,\n  values: BusinessProfileValues,\n  source: Exclude<BusinessProfileSource, 'owner'>,\n): BusinessProfileDoc | null {\n  const clean = sanitizeBusinessProfileValues(values)\n  const next: BusinessProfileDoc = { ...(current ?? {}), sources: { ...(current?.sources ?? {}) } }\n  let changed = false\n  for (const field of BUSINESS_PROFILE_FIELDS) {\n    if (!(field in clean)) continue\n    const value = (clean as Record<string, unknown>)[field]\n    if (isEmpty(value)) continue\n    // An explicit source counts even on an empty value: a field the owner\n    // cleared stays cleared rather than being refilled behind them.\n    const recorded = current?.sources?.[field]\n    const held = recorded && recorded in SOURCE_RANK ? recorded : businessProfileSourceOf(current, field)\n    if (held && SOURCE_RANK[held] >= SOURCE_RANK[source]) continue\n    if (JSON.stringify(fieldValue(current, field)) === JSON.stringify(value)) continue\n    ;(next as Record<string, unknown>)[field] = value\n    next.sources![field] = source\n    changed = true\n  }\n  return changed ? next : null\n}\n\n/**\n * The document the owner's save makes: every field they changed becomes\n * theirs, and a field they left as it was keeps the source it had — so saving\n * the form after correcting one line does not claim every suggestion on it.\n */\nexport function businessProfileOwnerWrite(\n  current: BusinessProfileDoc | null | undefined,\n  edited: BusinessProfileValues,\n): Pick<BusinessProfileDoc, BusinessProfileField | 'sources'> {\n  const clean = sanitizeBusinessProfileValues(edited)\n  const next: Record<string, unknown> = {}\n  const sources: Partial<Record<BusinessProfileField, BusinessProfileSource>> = {}\n  for (const field of BUSINESS_PROFILE_FIELDS) {\n    const before = fieldValue(current, field)\n    const after = field in clean ? (clean as Record<string, unknown>)[field] : before\n    next[field] = after\n    const same = JSON.stringify(before) === JSON.stringify(after)\n    if (isEmpty(after)) {\n      // A suggestion the owner deleted is their decision, and recorded as\n      // one, so the next prefill does not put it back.\n      if (!same) sources[field] = 'owner'\n      else if (current?.sources?.[field] === 'owner') sources[field] = 'owner'\n      continue\n    }\n    sources[field] = same ? (businessProfileSourceOf(current, field) ?? 'owner') : 'owner'\n  }\n  return { ...(next as Pick<BusinessProfileDoc, BusinessProfileField>), sources }\n}\n\n/** The postal address as one line: the SEO entity's parts, else the contact card's block. */\nfunction addressLine(host: BusinessProfileHost | null | undefined): string {\n  const parts = host?.seo?.entity?.address\n  const line = [\n    parts?.streetAddress,\n    parts?.addressLocality,\n    parts?.addressRegion,\n    parts?.postalCode,\n    parts?.addressCountry,\n  ]\n    .map((part) => text(part, 200))\n    .filter(Boolean)\n    .join(', ')\n  return line || text(host?.business?.address, 400)\n}\n\n/**\n * The profile as every reader sees it, field by field (AGL-3661):\n *\n * 1. what the OWNER typed into the site's profile;\n * 2. what the site's own settings say (the SEO entity, the contact card, the\n *    display name), which the owner typed too, elsewhere;\n * 3. what the guided start or a generator stored on the site's profile;\n * 4. the workspace defaults.\n *\n * Contact details, the logo and the profiles come from the site's settings\n * only: nothing but the owner's own entry may say how to reach the business.\n */\nexport function resolveBusinessProfile(input: {\n  host: BusinessProfileHost | null | undefined\n  site?: BusinessProfileDoc | null\n  workspace?: BusinessProfileDoc | null\n}): ResolvedBusinessProfile {\n  const { host, site, workspace } = input\n  const entity = host?.seo?.entity ?? null\n  const fromSite: Partial<Record<BusinessProfileField, unknown>> = {\n    whatYouDo: text(entity?.description, BUSINESS_PROFILE_MAX_CHARS.whatYouDo),\n    serviceArea: normalizeAreaServed(entity?.areaServed).join(', ').slice(0, BUSINESS_PROFILE_MAX_CHARS.serviceArea),\n  }\n\n  const resolve = <T>(field: BusinessProfileField): ResolvedBusinessField<T> | null => {\n    const stored = businessProfileSourceOf(site, field)\n    if (stored === 'owner') return { value: fieldValue(site, field) as T, origin: 'owner' }\n    const own = fromSite[field]\n    if (own !== undefined && !isEmpty(own)) return { value: own as T, origin: 'site' }\n    if (stored) return { value: fieldValue(site, field) as T, origin: stored }\n    if (businessProfileSourceOf(workspace, field)) {\n      return { value: fieldValue(workspace, field) as T, origin: 'workspace' }\n    }\n    return null\n  }\n\n  const name = text(entity?.name, 200) || text(host?.displayName, 200)\n  return {\n    name: name ? { value: name, origin: 'site' } : null,\n    whatYouDo: resolve<string>('whatYouDo'),\n    services: resolve<string[]>('services'),\n    serviceArea: resolve<string>('serviceArea'),\n    audience: resolve<string>('audience'),\n    tone: resolve<BusinessTone>('tone'),\n    toneNotes: resolve<string>('toneNotes'),\n    businessType: text(entity?.businessType, 80) || null,\n    contact: {\n      email: text(entity?.email, 320) || text(host?.business?.supportEmail, 320) || null,\n      phone: text(entity?.telephone, 64) || null,\n      address: addressLine(host) || null,\n      hours: text(entity?.openingHours, 400) || null,\n    },\n    profiles: siteProfileUrls(host as Parameters<typeof siteProfileUrls>[0]),\n    logo: text(host?.logoUrl, 800) || text(entity?.logo, 800) || null,\n  }\n}\n\n/** Each origin as the profile screen labels it. */\nexport const BUSINESS_PROFILE_ORIGIN_LABELS: Readonly<Record<BusinessProfileOrigin, string>> = {\n  owner: 'You',\n  site: 'Site settings',\n  start: 'Your answers when the site was started',\n  ai: `Suggested by ${PLATFORM_BRAND_NAME} AI`,\n  workspace: 'Workspace default',\n}\n"],"names":["siteProfileUrls","normalizeAreaServed","PLATFORM_BRAND_NAME","BUSINESS_PROFILE_SUBCOLLECTION","BUSINESS_PROFILE_SITE_DOC","BUSINESS_PROFILE_WORKSPACE_DOC","SOURCE_RANK","ai","start","owner","BUSINESS_TONES","BUSINESS_TONE_LABELS","friendly","professional","playful","premium","plain","BUSINESS_PROFILE_FIELDS","BUSINESS_PROFILE_MAX_CHARS","whatYouDo","services","serviceArea","audience","toneNotes","BUSINESS_PROFILE_MAX_SERVICES","text","value","max","replace","trim","slice","tone","includes","items","Array","isArray","split","seen","Set","kept","item","name","key","toLowerCase","has","add","push","length","fieldValue","doc","field","isEmpty","businessProfileSourceOf","source","sources","sanitizeBusinessProfileValues","values","clean","mergeBusinessProfilePrefill","current","next","changed","recorded","held","JSON","stringify","businessProfileOwnerWrite","edited","before","after","same","addressLine","host","parts","seo","entity","address","line","streetAddress","addressLocality","addressRegion","postalCode","addressCountry","map","part","filter","Boolean","join","business","resolveBusinessProfile","input","site","workspace","fromSite","description","areaServed","resolve","stored","origin","own","undefined","displayName","businessType","contact","email","supportEmail","phone","telephone","hours","openingHours","profiles","logo","logoUrl","BUSINESS_PROFILE_ORIGIN_LABELS"],"mappings":"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"}

package/src/lib/app-utils/child-contract.d.ts

@@ -79,7 +79,10 @@ export declare function isFlagDisabled(flag?: FEATURE_FLAG): boolean;
  *
  * - `flags.selfClosing` — an image, an icon, a divider.
  * - `flags.textEditable` — the component renders `children` as editable text,
- *   so an element dropped in would be destroyed by the next text edit.
+ *   so an element dropped in would be destroyed by the next text edit —
+ *   unless the schema also says `flags.dropping: ENABLED`. That is a promise
+ *   the component keeps its text in its own `<aglyn-text>` beside the child
+ *   elements, which is the only part the in-place editor rewrites (AGL-3672).
  * - `flags.dropping: DISABLED` — neither of the above, but still no slot
  *   (AGL-1388): Markdown renders its parsed `content` prop and nothing else;
  *   a Reusable Component instance has its child list REPLACED by the grafted

package/src/lib/app-utils/child-contract.js

@@ -80,7 +80,10 @@
  *
  * - `flags.selfClosing` — an image, an icon, a divider.
  * - `flags.textEditable` — the component renders `children` as editable text,
- *   so an element dropped in would be destroyed by the next text edit.
+ *   so an element dropped in would be destroyed by the next text edit —
+ *   unless the schema also says `flags.dropping: ENABLED`. That is a promise
+ *   the component keeps its text in its own `<aglyn-text>` beside the child
+ *   elements, which is the only part the in-place editor rewrites (AGL-3672).
  * - `flags.dropping: DISABLED` — neither of the above, but still no slot
  *   (AGL-1388): Markdown renders its parsed `content` prop and nothing else;
  *   a Reusable Component instance has its child list REPLACED by the grafted
@@ -98,7 +101,7 @@
     const flags = schema.flags;
     if (isFlagDisabled(flags == null ? void 0 : flags.dropping)) return false;
     if (isLeafFlagEnabled(flags == null ? void 0 : flags.selfClosing)) return false;
-    if (isLeafFlagEnabled(flags == null ? void 0 : flags.textEditable)) return false;
+    if (isLeafFlagEnabled(flags == null ? void 0 : flags.textEditable) && !isLeafFlagEnabled(flags == null ? void 0 : flags.dropping)) return false;
     return !restrictsChildrenToNothing(schema.restrictChildren);
 }
 /**

package/src/lib/app-utils/child-contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/child-contract.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 * The drop/render agreement (AGL-1389).\n *\n * A component that accepts a drop in the hierarchy and discards the node at\n * render is silent data loss: the author sees the node in the tree, the\n * published page does not have it, and nothing warns — so the work reads as\n * *never done* rather than broken. Three /press screenshots shipped in a page\n * payload for weeks that way (AGL-1388).\n *\n * That was found by reading all 82 registered schemas by hand, one at a time.\n * This module is the repeatable half: the predicate the editor actually gates\n * drops on, plus an audit that turns \"someone added a component and never\n * thought about children\" into a red test.\n *\n * Deliberately NOT a render sweep. Rendering every schema with a sentinel\n * child fails for components that legitimately hide children behind state\n * (a collapsed Accordion, a closed Drawer, a `lazyPanels` TabPanel) and for\n * every one needing a provider or the canvas singleton — so it would need an\n * exemption list, and an exemption list that grows silently is worth less\n * than no test. See {@link auditChildContract} for what is enforced instead.\n */\n\nimport { FEATURE_FLAG } from '../foundation/constants/shared'\n\n/**\n * The slice of a component schema this contract reads. Structural on purpose:\n * `ComponentSchema` (types/nodes) and `AglynComponentSchema` (foundation) are\n * two spellings of the same thing and bundles are typed with both.\n */\nexport interface ChildContractSchema {\n  $id?: string\n  displayName?: string\n  restrictChildren?: unknown\n  flags?: {\n    dropping?: FEATURE_FLAG\n    selfClosing?: FEATURE_FLAG\n    textEditable?: FEATURE_FLAG\n  }\n}\n\n/** One registry entry — matches `MUI_BUNDLE` / `FeatureBundleEntry`. */\nexport interface ChildContractEntry {\n  schema: ChildContractSchema\n}\n\n/**\n * True only when a feature flag is explicitly present and carries the ENABLED\n * bit. An absent (undefined) flag reads as false: components that declare no\n * flags at all (Stack, Section, the document root) must not be mistaken for\n * self-closing leaves.\n */\nexport function isLeafFlagEnabled(flag?: FEATURE_FLAG): boolean {\n  return typeof flag === 'number' && (flag & FEATURE_FLAG.ENABLED) !== 0\n}\n\n/**\n * The mirror, for the flags whose interesting value is the switched-OFF one.\n * An absent flag reads as false, so a component that declares no flags keeps\n * the permissive default.\n */\nexport function isFlagDisabled(flag?: FEATURE_FLAG): boolean {\n  return typeof flag === 'number' && (flag & FEATURE_FLAG.DISABLED) !== 0\n}\n\n/**\n * A `restrictChildren` that allows NOTHING — `[LIMIT_TO, { components: [] }]`,\n * the Layout Slot's spelling of \"my children come from somewhere else\".\n *\n * Read here as a fourth way to say \"no canvas child slot\", alongside the three\n * flags: the dnd manager's `confirmValidLinealRelationship` already refuses\n * every candidate against an empty allowlist, so a schema that says this and\n * nothing else was already unreachable by drop — the hierarchy just hadn't\n * been told. Deliberately narrow: an empty DISALLOW list forbids nothing, and\n * an allowlist naming plugins (rather than components) still admits those.\n */\nfunction restrictsChildrenToNothing(restrict: unknown): boolean {\n  if (!Array.isArray(restrict) || restrict.length < 2) return false\n  const [directive, definition] = restrict as [unknown, unknown]\n  if (directive !== 'limitedTo') return false\n  if (Array.isArray(definition)) return definition.length === 0\n  if (!definition || typeof definition !== 'object') return false\n  const { components, plugins } = definition as {\n    components?: unknown\n    plugins?: unknown\n  }\n  if (Array.isArray(plugins) && plugins.length > 0) return false\n  return Array.isArray(components) && components.length === 0\n}\n\n/**\n * Whether the editor will let a node be dropped into a node of this component\n * — the ONE rule every author-facing entry point shares (the Insert menu and\n * paste via `resolveInsertTarget`, canvas drag-and-drop via the dnd manager's\n * `computedDrop`, and the drop indicator), read through\n * `CanvasManager.nodeAcceptsChildren`.\n *\n * Four ways a schema declares it has nowhere to put a dropped node:\n *\n * - `flags.selfClosing` — an image, an icon, a divider.\n * - `flags.textEditable` — the component renders `children` as editable text,\n *   so an element dropped in would be destroyed by the next text edit.\n * - `flags.dropping: DISABLED` — neither of the above, but still no slot\n *   (AGL-1388): Markdown renders its parsed `content` prop and nothing else;\n *   a Reusable Component instance has its child list REPLACED by the grafted\n *   definition at compose time; List Item Text hands `children` to MUI, which\n *   reads it only as a fallback for a missing `primary`.\n * - an empty `restrictChildren` allowlist — see above.\n *\n * Anything else accepts children, which is why the audit below exists: the\n * permissive answer is the DEFAULT, so a component nobody thought about is\n * indistinguishable from a container until something asks.\n *\n * An unregistered / missing schema accepts children, matching the canvas.\n */\nexport function schemaAcceptsChildren(\n  schema: ChildContractSchema | null | undefined,\n): boolean {\n  if (!schema) return true\n  const flags = schema.flags\n  if (isFlagDisabled(flags?.dropping)) return false\n  if (isLeafFlagEnabled(flags?.selfClosing)) return false\n  if (isLeafFlagEnabled(flags?.textEditable)) return false\n  return !restrictsChildrenToNothing(schema.restrictChildren)\n}\n\n/**\n * A bundle's declared containers: the component ids whose author has\n * confirmed the component renders the nodes dropped into it.\n *\n * Not an exemption list — the inverse. Exemptions are the entries a guard\n * agrees to skip, so they accumulate quietly and the guard shrinks. This list\n * is the set the guard is ABOUT: a new component defaults to accepting\n * children, so it lands here or the test is red, and the only way to make it\n * green is to answer the question (\"does it render `children`?\") one way or\n * the other. Nothing can be added by accident.\n */\nexport type DeclaredContainers = readonly string[]\n\n/**\n * Every disagreement between a bundle's schemas and its declared container\n * list, as reviewer-facing lines (empty = the contract holds).\n *\n * Both directions matter:\n *\n * - An undeclared container is the AGL-1388 shape arriving again — a\n *   component the editor will accept a drop into that nobody has confirmed\n *   renders one.\n * - A declared id that no longer accepts a drop, or is no longer registered,\n *   is a stale entry. Left alone the list would slowly become a wish, and a\n *   guard checked against a wish passes over anything.\n *\n * Returns strings rather than throwing so the caller is a one-line\n * `expect(...).toEqual([])` whose failure output names every offender at once\n * — the whole point being that the next person does not repeat the 82-schema\n * hand audit.\n */\nexport function auditChildContract(\n  entries: readonly ChildContractEntry[],\n  declared: DeclaredContainers,\n): string[] {\n  const problems: string[] = []\n  const declaredSet = new Set(declared)\n  const registered = new Set<string>()\n\n  for (const entry of entries) {\n    const schema = entry?.schema\n    const id = schema?.$id\n    if (!id) {\n      problems.push(\n        `a schema in this bundle has no $id (${\n          schema?.displayName ?? 'unnamed'\n        }) — it cannot be held to the drop/render agreement`,\n      )\n      continue\n    }\n    registered.add(id)\n    const accepts = schemaAcceptsChildren(schema)\n    if (accepts && !declaredSet.has(id)) {\n      problems.push(\n        `${id} accepts a drop but is not a declared container — either it ` +\n          'renders its children (add it to the list) or it does not, and ' +\n          'then it must SAY so: flags.selfClosing, flags.textEditable, ' +\n          'flags.dropping: FEATURE_FLAG.DISABLED, or an empty ' +\n          'restrictChildren allowlist (AGL-1389)',\n      )\n    }\n    if (!accepts && declaredSet.has(id)) {\n      problems.push(\n        `${id} is a declared container but the editor now refuses drops ` +\n          'into it — drop it from the list, or remove whatever flag closed ' +\n          'it (AGL-1389)',\n      )\n    }\n  }\n\n  for (const id of declaredSet) {\n    if (!registered.has(id)) {\n      problems.push(\n        `${id} is a declared container but is not registered in this ` +\n          'bundle — remove the stale entry (AGL-1389)',\n      )\n    }\n  }\n\n  return problems.sort()\n}\n\n/** The ids in a bundle the editor will accept a drop into, sorted. */\nexport function listAcceptingComponentIds(\n  entries: readonly ChildContractEntry[],\n): string[] {\n  return entries\n    .filter((entry) => schemaAcceptsChildren(entry?.schema))\n    .map((entry) => entry.schema.$id as string)\n    .filter(Boolean)\n    .sort()\n}\n"],"names":["FEATURE_FLAG","isLeafFlagEnabled","flag","ENABLED","isFlagDisabled","DISABLED","restrictsChildrenToNothing","restrict","Array","isArray","length","directive","definition","components","plugins","schemaAcceptsChildren","schema","flags","dropping","selfClosing","textEditable","restrictChildren","auditChildContract","entries","declared","problems","declaredSet","Set","registered","entry","id","$id","push","displayName","add","accepts","has","sort","listAcceptingComponentIds","filter","map","Boolean"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/child-contract.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 * The drop/render agreement (AGL-1389).\n *\n * A component that accepts a drop in the hierarchy and discards the node at\n * render is silent data loss: the author sees the node in the tree, the\n * published page does not have it, and nothing warns — so the work reads as\n * *never done* rather than broken. Three /press screenshots shipped in a page\n * payload for weeks that way (AGL-1388).\n *\n * That was found by reading all 82 registered schemas by hand, one at a time.\n * This module is the repeatable half: the predicate the editor actually gates\n * drops on, plus an audit that turns \"someone added a component and never\n * thought about children\" into a red test.\n *\n * Deliberately NOT a render sweep. Rendering every schema with a sentinel\n * child fails for components that legitimately hide children behind state\n * (a collapsed Accordion, a closed Drawer, a `lazyPanels` TabPanel) and for\n * every one needing a provider or the canvas singleton — so it would need an\n * exemption list, and an exemption list that grows silently is worth less\n * than no test. See {@link auditChildContract} for what is enforced instead.\n */\n\nimport { FEATURE_FLAG } from '../foundation/constants/shared'\n\n/**\n * The slice of a component schema this contract reads. Structural on purpose:\n * `ComponentSchema` (types/nodes) and `AglynComponentSchema` (foundation) are\n * two spellings of the same thing and bundles are typed with both.\n */\nexport interface ChildContractSchema {\n  $id?: string\n  displayName?: string\n  restrictChildren?: unknown\n  flags?: {\n    dropping?: FEATURE_FLAG\n    selfClosing?: FEATURE_FLAG\n    textEditable?: FEATURE_FLAG\n  }\n}\n\n/** One registry entry — matches `MUI_BUNDLE` / `FeatureBundleEntry`. */\nexport interface ChildContractEntry {\n  schema: ChildContractSchema\n}\n\n/**\n * True only when a feature flag is explicitly present and carries the ENABLED\n * bit. An absent (undefined) flag reads as false: components that declare no\n * flags at all (Stack, Section, the document root) must not be mistaken for\n * self-closing leaves.\n */\nexport function isLeafFlagEnabled(flag?: FEATURE_FLAG): boolean {\n  return typeof flag === 'number' && (flag & FEATURE_FLAG.ENABLED) !== 0\n}\n\n/**\n * The mirror, for the flags whose interesting value is the switched-OFF one.\n * An absent flag reads as false, so a component that declares no flags keeps\n * the permissive default.\n */\nexport function isFlagDisabled(flag?: FEATURE_FLAG): boolean {\n  return typeof flag === 'number' && (flag & FEATURE_FLAG.DISABLED) !== 0\n}\n\n/**\n * A `restrictChildren` that allows NOTHING — `[LIMIT_TO, { components: [] }]`,\n * the Layout Slot's spelling of \"my children come from somewhere else\".\n *\n * Read here as a fourth way to say \"no canvas child slot\", alongside the three\n * flags: the dnd manager's `confirmValidLinealRelationship` already refuses\n * every candidate against an empty allowlist, so a schema that says this and\n * nothing else was already unreachable by drop — the hierarchy just hadn't\n * been told. Deliberately narrow: an empty DISALLOW list forbids nothing, and\n * an allowlist naming plugins (rather than components) still admits those.\n */\nfunction restrictsChildrenToNothing(restrict: unknown): boolean {\n  if (!Array.isArray(restrict) || restrict.length < 2) return false\n  const [directive, definition] = restrict as [unknown, unknown]\n  if (directive !== 'limitedTo') return false\n  if (Array.isArray(definition)) return definition.length === 0\n  if (!definition || typeof definition !== 'object') return false\n  const { components, plugins } = definition as {\n    components?: unknown\n    plugins?: unknown\n  }\n  if (Array.isArray(plugins) && plugins.length > 0) return false\n  return Array.isArray(components) && components.length === 0\n}\n\n/**\n * Whether the editor will let a node be dropped into a node of this component\n * — the ONE rule every author-facing entry point shares (the Insert menu and\n * paste via `resolveInsertTarget`, canvas drag-and-drop via the dnd manager's\n * `computedDrop`, and the drop indicator), read through\n * `CanvasManager.nodeAcceptsChildren`.\n *\n * Four ways a schema declares it has nowhere to put a dropped node:\n *\n * - `flags.selfClosing` — an image, an icon, a divider.\n * - `flags.textEditable` — the component renders `children` as editable text,\n *   so an element dropped in would be destroyed by the next text edit —\n *   unless the schema also says `flags.dropping: ENABLED`. That is a promise\n *   the component keeps its text in its own `<aglyn-text>` beside the child\n *   elements, which is the only part the in-place editor rewrites (AGL-3672).\n * - `flags.dropping: DISABLED` — neither of the above, but still no slot\n *   (AGL-1388): Markdown renders its parsed `content` prop and nothing else;\n *   a Reusable Component instance has its child list REPLACED by the grafted\n *   definition at compose time; List Item Text hands `children` to MUI, which\n *   reads it only as a fallback for a missing `primary`.\n * - an empty `restrictChildren` allowlist — see above.\n *\n * Anything else accepts children, which is why the audit below exists: the\n * permissive answer is the DEFAULT, so a component nobody thought about is\n * indistinguishable from a container until something asks.\n *\n * An unregistered / missing schema accepts children, matching the canvas.\n */\nexport function schemaAcceptsChildren(\n  schema: ChildContractSchema | null | undefined,\n): boolean {\n  if (!schema) return true\n  const flags = schema.flags\n  if (isFlagDisabled(flags?.dropping)) return false\n  if (isLeafFlagEnabled(flags?.selfClosing)) return false\n  if (\n    isLeafFlagEnabled(flags?.textEditable) &&\n    !isLeafFlagEnabled(flags?.dropping)\n  )\n    return false\n  return !restrictsChildrenToNothing(schema.restrictChildren)\n}\n\n/**\n * A bundle's declared containers: the component ids whose author has\n * confirmed the component renders the nodes dropped into it.\n *\n * Not an exemption list — the inverse. Exemptions are the entries a guard\n * agrees to skip, so they accumulate quietly and the guard shrinks. This list\n * is the set the guard is ABOUT: a new component defaults to accepting\n * children, so it lands here or the test is red, and the only way to make it\n * green is to answer the question (\"does it render `children`?\") one way or\n * the other. Nothing can be added by accident.\n */\nexport type DeclaredContainers = readonly string[]\n\n/**\n * Every disagreement between a bundle's schemas and its declared container\n * list, as reviewer-facing lines (empty = the contract holds).\n *\n * Both directions matter:\n *\n * - An undeclared container is the AGL-1388 shape arriving again — a\n *   component the editor will accept a drop into that nobody has confirmed\n *   renders one.\n * - A declared id that no longer accepts a drop, or is no longer registered,\n *   is a stale entry. Left alone the list would slowly become a wish, and a\n *   guard checked against a wish passes over anything.\n *\n * Returns strings rather than throwing so the caller is a one-line\n * `expect(...).toEqual([])` whose failure output names every offender at once\n * — the whole point being that the next person does not repeat the 82-schema\n * hand audit.\n */\nexport function auditChildContract(\n  entries: readonly ChildContractEntry[],\n  declared: DeclaredContainers,\n): string[] {\n  const problems: string[] = []\n  const declaredSet = new Set(declared)\n  const registered = new Set<string>()\n\n  for (const entry of entries) {\n    const schema = entry?.schema\n    const id = schema?.$id\n    if (!id) {\n      problems.push(\n        `a schema in this bundle has no $id (${\n          schema?.displayName ?? 'unnamed'\n        }) — it cannot be held to the drop/render agreement`,\n      )\n      continue\n    }\n    registered.add(id)\n    const accepts = schemaAcceptsChildren(schema)\n    if (accepts && !declaredSet.has(id)) {\n      problems.push(\n        `${id} accepts a drop but is not a declared container — either it ` +\n          'renders its children (add it to the list) or it does not, and ' +\n          'then it must SAY so: flags.selfClosing, flags.textEditable, ' +\n          'flags.dropping: FEATURE_FLAG.DISABLED, or an empty ' +\n          'restrictChildren allowlist (AGL-1389)',\n      )\n    }\n    if (!accepts && declaredSet.has(id)) {\n      problems.push(\n        `${id} is a declared container but the editor now refuses drops ` +\n          'into it — drop it from the list, or remove whatever flag closed ' +\n          'it (AGL-1389)',\n      )\n    }\n  }\n\n  for (const id of declaredSet) {\n    if (!registered.has(id)) {\n      problems.push(\n        `${id} is a declared container but is not registered in this ` +\n          'bundle — remove the stale entry (AGL-1389)',\n      )\n    }\n  }\n\n  return problems.sort()\n}\n\n/** The ids in a bundle the editor will accept a drop into, sorted. */\nexport function listAcceptingComponentIds(\n  entries: readonly ChildContractEntry[],\n): string[] {\n  return entries\n    .filter((entry) => schemaAcceptsChildren(entry?.schema))\n    .map((entry) => entry.schema.$id as string)\n    .filter(Boolean)\n    .sort()\n}\n"],"names":["FEATURE_FLAG","isLeafFlagEnabled","flag","ENABLED","isFlagDisabled","DISABLED","restrictsChildrenToNothing","restrict","Array","isArray","length","directive","definition","components","plugins","schemaAcceptsChildren","schema","flags","dropping","selfClosing","textEditable","restrictChildren","auditChildContract","entries","declared","problems","declaredSet","Set","registered","entry","id","$id","push","displayName","add","accepts","has","sort","listAcceptingComponentIds","filter","map","Boolean"],"mappings":"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"}

package/src/lib/app-utils/console-routes.d.ts

@@ -120,6 +120,7 @@ export declare enum Route {
     HOST_SETUP_SEO = "/[orgSlug]/hosts/[host]/setup/seo",
     HOST_SETUP_TRACKING = "/[orgSlug]/hosts/[host]/setup/tracking",
     HOST_SETUP_THEME = "/[orgSlug]/hosts/[host]/setup/theme",
+    HOST_SETUP_BUSINESS = "/[orgSlug]/hosts/[host]/setup/business",
     HOST_SETUP_EMAILS = "/[orgSlug]/hosts/[host]/setup/emails",
     HOST_ADMIN = "/[orgSlug]/hosts/[host]/admin",
     HOST_ADMIN_GENERAL = "/[orgSlug]/hosts/[host]/admin/general",
@@ -414,6 +415,10 @@ export interface RoutePayload {
         orgSlug: string;
         host: string;
     };
+    [Route.HOST_SETUP_BUSINESS]: {
+        orgSlug: string;
+        host: string;
+    };
     [Route.HOST_SETUP_EMAILS]: {
         orgSlug: string;
         host: string;

package/src/lib/app-utils/console-routes.js

@@ -380,6 +380,7 @@ export var Route = /*#__PURE__*/ function(Route) {
     Route["HOST_SETUP_SEO"] = "/[orgSlug]/hosts/[host]/setup/seo";
     Route["HOST_SETUP_TRACKING"] = "/[orgSlug]/hosts/[host]/setup/tracking";
     Route["HOST_SETUP_THEME"] = "/[orgSlug]/hosts/[host]/setup/theme";
+    Route["HOST_SETUP_BUSINESS"] = "/[orgSlug]/hosts/[host]/setup/business";
     Route["HOST_SETUP_EMAILS"] = "/[orgSlug]/hosts/[host]/setup/emails";
     // Host Admin area (AGL-1014): owner/admin-only controls — per-site plugin
     // enablement and the Danger zone — out of the Setup page collaborators