@shoalrun/cli 0.1.0-alpha.13 → 0.1.0-alpha.15

package/dist/content-export.js

@@ -1,3 +1,4 @@
+import { pruneFeatureTree, profileSelection } from './deployment-profile.js';
 import { readFile, realpath } from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -53,7 +54,7 @@ const visitTree = (node, visit) => {
 };
 /** Export selected source content; never invoke the website shell/compiler. */
 export async function exportContent(configFile, destination, options = {}) {
-    const loaded = await loadConfig(configFile);
+    const loaded = await loadConfig(configFile, { profile: options.profile });
     const resolved = resolvedCompilerConfig(loaded.value);
     // Export has no masthead, so a website title is optional in a content-only project.
     if (resolved.site !== undefined && !isConfigMapping(resolved.site))
@@ -150,7 +151,7 @@ export async function exportContent(configFile, destination, options = {}) {
                 throw new Error(`Unknown export snippet ${selection.snippetId}`);
             // This is an explicit isolated context. It has no containing page, operations,
             // relationships, page variables, or inherited publication/access metadata.
-            const snippetDocument = { file: definition.file, body: '', tree: root([]), variant: publication,
+            const snippetDocument = { featureContext: loaded.deployment?.context, file: definition.file, body: '', tree: root([]), variant: publication,
                 route: `/__content_snippets/${encodeURIComponent(selection.id)}`, markdownRoute: '',
                 frontmatter: { id: selection.id, title: selection.title, summary: selection.summary, type: 'snippet', slug: '/', access: { policy: 'public' } } };
             const checkSnippet = (id, seen = new Set()) => {
@@ -160,7 +161,7 @@ export async function exportContent(configFile, destination, options = {}) {
                 const source = snippets.get(id);
                 if (!source)
                     throw new Error(`Unknown snippet ${id}`);
-                visitTree(source.tree, node => {
+                visitTree(pruneFeatureTree(source.tree, loaded.deployment?.context, source.file), node => {
                     if (['RelatedReading', 'DocCard', 'DocCards', 'DocCollection', 'CookbookChooser', 'ApiExample', 'ApiSchema', 'FrontmatterReference', 'Anchor'].includes(node.name))
                         throw new Error(`Snippet instance ${selection.id}: <${node.name}> needs page context`);
                     if (node.name === 'Snippet') {
@@ -455,6 +456,6 @@ export async function exportContent(configFile, destination, options = {}) {
     }
     await commitArtifacts(path.resolve(destination), artifacts, undefined, 'export');
     return { status: unreviewed.length ? 'needs-review' : 'ok', output: path.resolve(destination), publication, formats: target.formats,
-        resources: records.length, documents: records.filter(item => item.ref.kind === 'page').length, documentIds: records.flatMap(item => item.ref.kind === 'page' ? [item.ref.documentId] : []), comparison, assets: assets.records.size, digest: bundleDigest,
+        profileSelection: profileSelection(loaded.deployment), resources: records.length, documents: records.filter(item => item.ref.kind === 'page').length, documentIds: records.flatMap(item => item.ref.kind === 'page' ? [item.ref.documentId] : []), comparison, assets: assets.records.size, digest: bundleDigest,
         apiReview: reviews.map(row => ({ apiId: row.apiId, digest: row.digest })), diagnostics };
 }

package/dist/content-source.d.ts

@@ -50,6 +50,7 @@ export type Frontmatter = {
     [key: string]: unknown;
 };
 export type Document = {
+    featureContext?: import('./deployment-profile.js').FeatureContext;
     change?: ResolvedChange;
     subjectDeprecation?: ResolvedSubjectDeprecation;
     file: string;

package/dist/content-workspace.d.ts

@@ -33,6 +33,7 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
     snippets: Map<string, SnippetDefinition>;
     apiPlan: {
         api: import("./api.js").ApiReader;
+        operationRequirements: Map<string, unknown>;
         queryRules: Map<string, import("./api.js").QuerySyntaxRule[]>;
         lifecycleMappings: Map<string, {
             from: string;
@@ -66,6 +67,8 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
                 id: string;
                 reference: string;
                 sourceOperationId?: string;
+                shared?: unknown;
+                requires?: unknown;
             }>;
             generateReferences?: boolean | {
                 pathPrefix?: string;
@@ -107,6 +110,8 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
                     id: string;
                     reference: string;
                     sourceOperationId?: string;
+                    shared?: unknown;
+                    requires?: unknown;
                 }>;
                 generateReferences?: boolean | {
                     pathPrefix?: string;
@@ -149,6 +154,8 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
                 id: string;
                 reference: string;
                 sourceOperationId?: string;
+                shared?: unknown;
+                requires?: unknown;
             }>;
             generateReferences?: boolean | {
                 pathPrefix?: string;
@@ -186,6 +193,8 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
             id: string;
             reference: string;
             sourceOperationId?: string;
+            shared?: unknown;
+            requires?: unknown;
         }>;
         generateReferences?: boolean | {
             pathPrefix?: string;
@@ -227,6 +236,8 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
                 id: string;
                 reference: string;
                 sourceOperationId?: string;
+                shared?: unknown;
+                requires?: unknown;
             }>;
             generateReferences?: boolean | {
                 pathPrefix?: string;
@@ -279,6 +290,8 @@ export declare function prepareContentWorkspace({ base, basePath, config, loaded
                 id: string;
                 reference: string;
                 sourceOperationId?: string;
+                shared?: unknown;
+                requires?: unknown;
             }>;
             generateReferences?: boolean | {
                 pathPrefix?: string;

package/dist/content-workspace.js

@@ -1,3 +1,4 @@
+import { matchesFeatures } from './deployment-profile.js';
 import path from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { parse } from './content.js';
@@ -9,7 +10,7 @@ const keyFor = (id, variant) => `${id}|${variant.channel}|${variant.version}|${v
 /** Shared source resolution. No website navigation, styles, hosting or provider setup. */
 export async function prepareContentWorkspace({ base, basePath, config, loaded, variants, language, readerFilters, contentFilter, metadataProvider, metadataDependencies, sourceOverrides, authoringFiles, allowRouteCollisions }) {
     const { docs, knownDocumentIds, knownDocumentTypes, authoredOperationIds, routeOwners, contentDir } = await planAuthoredDocuments({
-        base, basePath, config, variants, language, readerFilters, contentFilter, metadataProvider, metadataDependencies, sourceOverrides, authoringFiles, allowRouteCollisions
+        base, basePath, config, variants, language, readerFilters, contentFilter, featureContext: loaded.deployment?.context, metadataProvider, metadataDependencies, sourceOverrides, authoringFiles, allowRouteCollisions
     });
     if (config.snippets !== undefined && (!config.snippets || typeof config.snippets !== 'object' || Array.isArray(config.snippets)))
         throw new Error('snippets must be a mapping');
@@ -29,6 +30,20 @@ export async function prepareContentWorkspace({ base, basePath, config, loaded,
         config, loaded, variants, docs, knownDocumentIds, knownDocumentTypes, authoredOperationIds, routeOwners, basePath, readerFilters, contentFilter, allowRouteCollisions
     });
     const { api, sourceForVariant, knownOperations } = apiPlan;
+    for (const [key, doc] of docs) {
+        doc.featureContext = loaded.deployment?.context;
+        for (const operationId of doc.frontmatter.operations ?? []) {
+            const known = knownOperations.get(operationId);
+            const definition = known && apiPlan.apiDefinitions[known.apiId];
+            const operation = definition?.operations?.find(entry => entry.id === operationId);
+            if (!matchesFeatures(definition?.requires, loaded.deployment?.context, `API ${known?.apiId}`) || !matchesFeatures(operation?.requires, loaded.deployment?.context, `Operation ${operationId}`) || !matchesFeatures(apiPlan.operationRequirements.get(keyFor(operationId, doc.variant)), loaded.deployment?.context, `Operation ${operationId} (${doc.variant.version})`)) {
+                docs.delete(key);
+                const decision = loaded.deployment?.context.decisions.find(decision => decision.id === `${doc.file}: ${doc.frontmatter.id}`);
+                if (decision)
+                    decision.included = false;
+            }
+        }
+    }
     const relatedApiTargets = new Map();
     const guidesByApi = new Map();
     for (const doc of docs.values()) {
@@ -57,6 +72,8 @@ export async function prepareContentWorkspace({ base, basePath, config, loaded,
         const operation = definition?.operations?.find(entry => entry.id === operationId);
         if (!definition || !operation)
             throw new Error(`unknown stable operation ${operationId}`);
+        if (!matchesFeatures(definition.requires, loaded.deployment?.context, `API ${known.apiId}`) || !matchesFeatures(operation.requires, loaded.deployment?.context, `Operation ${operationId}`) || !matchesFeatures(apiPlan.operationRequirements.get(keyFor(operationId, variant)), loaded.deployment?.context, `Operation ${operationId} (${variant.version})`) || (loaded.deployment?.context.grants && knownDocumentIds.has(known.reference) && !docs.has(keyFor(known.reference, variant))))
+            throw new Error(`Operation ${operationId} is excluded from this profile/publication`);
         if (!operation.sourceOperationId)
             throw new Error(`API ${known.apiId} operation needs sourceOperationId`);
         const binding = sourceForVariant(known.apiId, definition, variant);

package/dist/deployment-profile.d.ts

@@ -0,0 +1,52 @@
+export type FeatureRequirements = {
+    allOf?: string[];
+    anyOf?: string[];
+};
+export type FeatureContext = {
+    requireClassification?: boolean;
+    classificationPublications?: Array<{
+        channel: string;
+        version: string;
+        language: string;
+    }>;
+    features: Set<string>;
+    grants?: Set<string>;
+    digest: string;
+    pruneNavigation: boolean;
+    decisions: Array<{
+        kind: 'page' | 'section';
+        id: string;
+        included: boolean;
+        requires?: FeatureRequirements;
+    }>;
+    provenance: Record<string, string[]>;
+};
+export type ProfileResolution = {
+    context: FeatureContext;
+    overlay: Record<string, unknown>;
+    file?: string;
+    dependencies: string[];
+    assetFiles: string[];
+    digest: string;
+};
+/** Classification is an authored decision, never inferred from merged defaults. */
+export declare function validateFeatureClassification(source: Record<string, unknown>, context: FeatureContext | undefined, label: string): void;
+export declare function featureRequirements(value: unknown, context: FeatureContext | undefined, label: string): FeatureRequirements | undefined;
+export declare function matchesFeatures(value: unknown, context: FeatureContext | undefined, label: string, kind?: 'page' | 'section'): boolean;
+/** Validate every condition, but never resolve a dependency in an excluded branch. */
+export declare function pruneFeatureTree(tree: any, context: FeatureContext | undefined, file: string): any;
+/** Returned to the caller or written under .shoalrun, never a served artifact. */
+export declare function profileSelection(resolution: ProfileResolution | undefined): {
+    schemaVersion: number;
+    profileDigest: string;
+    features: string[];
+    provenance: Record<string, string[]>;
+    decisions: {
+        kind: "page" | "section";
+        id: string;
+        included: boolean;
+        requires?: FeatureRequirements;
+    }[];
+} | undefined;
+/** A profile is data, never executable configuration or a directory to discover. */
+export declare function resolveDeploymentProfile(settings: unknown, config: Record<string, any>, declaringFile: string, profileFile?: string): Promise<ProfileResolution | undefined>;

package/dist/deployment-profile.js

@@ -0,0 +1,277 @@
+import { readFile, lstat, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { parseYaml } from './yaml-value.js';
+import { defaultLanguage } from './frontmatter.js';
+import { paletteCatalog, presetCatalog } from './palettes.js';
+import { validateHeader, validateFooter } from './site-identity.js';
+import { normalizeBasePath } from './site-path.js';
+const object = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+const hash = (value) => createHash('sha256').update(value).digest('hex');
+const id = (value) => typeof value === 'string' && /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value);
+function keys(value, allowed, label) {
+    if (!object(value))
+        throw new Error(`${label} must be a mapping`);
+    for (const key of Object.keys(value))
+        if (!allowed.includes(key))
+            throw new Error(`${label}: unsupported setting ${key}`);
+}
+function names(value, label, nonempty = false) {
+    if (!Array.isArray(value) || (nonempty && !value.length) || value.some(item => !id(item)))
+        throw new Error(`${label} must be ${nonempty ? 'a nonempty' : 'a'} list of feature IDs`);
+    return [...new Set(value)];
+}
+function profileData(value) {
+    if (!value || typeof value !== 'object')
+        return;
+    for (const [key, child] of Object.entries(value)) {
+        if (['__proto__', 'constructor', 'prototype'].includes(key))
+            throw new Error(`Deployment profile: unsupported data key ${key}`);
+        profileData(child);
+    }
+}
+/** Classification is an authored decision, never inferred from merged defaults. */
+export function validateFeatureClassification(source, context, label) {
+    if (source.shared !== undefined && source.shared !== true)
+        throw new Error(`${label}: shared must be true; use requires for restricted content`);
+    if (source.shared === true && source.requires !== undefined)
+        throw new Error(`${label}: declare shared: true or requires, not both`);
+    if (context?.requireClassification && source.shared !== true && source.requires === undefined)
+        throw new Error(`${label}: unclassified content; declare shared: true or requires explicitly in this source (inherited defaults do not count)`);
+    if (source.requires !== undefined)
+        featureRequirements(source.requires, context, label);
+}
+export function featureRequirements(value, context, label) {
+    if (value === undefined)
+        return;
+    keys(value, ['allOf', 'anyOf'], `${label}: requires`);
+    if (!Object.keys(value).length)
+        throw new Error(`${label}: requires needs allOf or anyOf`);
+    if (!context)
+        throw new Error(`${label}: feature requirements need profiles.manifest and an explicit --profile`);
+    const result = {};
+    for (const clause of ['allOf', 'anyOf'])
+        if (value[clause] !== undefined) {
+            result[clause] = names(value[clause], `${label}: requires.${clause}`, true);
+            for (const name of result[clause])
+                if (!context.features.has(name))
+                    throw new Error(`${label}: unknown feature ${name}`);
+        }
+    if (!context.grants)
+        throw new Error(`${label}: feature requirements need an explicit --profile (an empty feature list is valid)`);
+    return result;
+}
+export function matchesFeatures(value, context, label, kind = 'page') {
+    const requirement = featureRequirements(value, context, label);
+    const included = !requirement || ((!requirement.allOf || requirement.allOf.every(name => context.grants.has(name))) && (!requirement.anyOf || requirement.anyOf.some(name => context.grants.has(name))));
+    context?.decisions.push({ kind, id: label, included, ...(requirement ? { requires: requirement } : {}) });
+    return included;
+}
+/** Validate every condition, but never resolve a dependency in an excluded branch. */
+export function pruneFeatureTree(tree, context, file) {
+    const walk = (node, parentIncluded = true) => {
+        if (!node || typeof node !== 'object')
+            return [node];
+        if (node.name === 'ForFeature') {
+            const label = `${file}:${node.position?.start?.line ?? 1}: <ForFeature>`;
+            const attributes = node.attributes ?? [];
+            if (node.type !== 'mdxJsxFlowElement' || !node.children?.length || !attributes.length || attributes.some((item) => item.type !== 'mdxJsxAttribute' || !['allOf', 'anyOf'].includes(item.name) || typeof item.value !== 'string') || new Set(attributes.map((item) => item.name)).size !== attributes.length)
+                throw new Error(`${label} needs block content and distinct literal allOf/anyOf attributes`);
+            const requirements = Object.fromEntries(attributes.map((item) => [item.name, item.value.trim().split(/\s+/).filter(Boolean)]));
+            const included = matchesFeatures(requirements, context, label, 'section');
+            if (!parentIncluded && context?.decisions.length)
+                context.decisions[context.decisions.length - 1].included = false;
+            const children = node.children.flatMap((child) => walk(child, parentIncluded && included));
+            return included && parentIncluded ? children : [];
+        }
+        return [{ ...node, ...(node.children ? { children: node.children.flatMap((child) => walk(child, parentIncluded)) } : {}) }];
+    };
+    return walk(tree)[0];
+}
+/** Returned to the caller or written under .shoalrun, never a served artifact. */
+export function profileSelection(resolution) {
+    if (!resolution?.context.grants)
+        return;
+    return { schemaVersion: 1, profileDigest: resolution.digest, features: [...resolution.context.grants].sort(), provenance: resolution.context.provenance, decisions: resolution.context.decisions };
+}
+/** A profile is data, never executable configuration or a directory to discover. */
+export async function resolveDeploymentProfile(settings, config, declaringFile, profileFile) {
+    if (settings === undefined) {
+        if (profileFile)
+            throw new Error('--profile requires profiles.manifest in the shared configuration');
+        return;
+    }
+    keys(settings, ['manifest', 'required', 'pruneNavigation', 'requireClassification'], 'profiles');
+    if (typeof settings.manifest !== 'string' || !settings.manifest.trim())
+        throw new Error('profiles.manifest must be a local path');
+    for (const setting of ['required', 'pruneNavigation', 'requireClassification'])
+        if (settings[setting] !== undefined && typeof settings[setting] !== 'boolean')
+            throw new Error(`profiles.${setting} must be boolean`);
+    const manifestFile = path.resolve(path.dirname(declaringFile), settings.manifest);
+    const manifestBytes = await readFile(manifestFile);
+    const manifest = parseYaml(manifestBytes.toString('utf8'), manifestFile);
+    keys(manifest, ['schemaVersion', 'features', 'skus'], 'SKU manifest');
+    if (manifest.schemaVersion !== 1 || !object(manifest.features) || !object(manifest.skus))
+        throw new Error('SKU manifest needs schemaVersion: 1, features, and skus mappings');
+    const features = new Set(Object.keys(manifest.features));
+    for (const [name, definition] of Object.entries(manifest.features)) {
+        if (!id(name))
+            throw new Error(`SKU manifest: invalid feature ID ${name}`);
+        keys(definition, ['description', 'lifecycle'], `Feature ${name}`);
+        if (definition.description !== undefined && typeof definition.description !== 'string')
+            throw new Error(`Feature ${name}: description must be text`);
+        if (definition.lifecycle !== undefined && !['active', 'deprecated', 'retired'].includes(definition.lifecycle))
+            throw new Error(`Feature ${name}: invalid lifecycle`);
+    }
+    for (const [sku, definition] of Object.entries(manifest.skus)) {
+        if (!id(sku))
+            throw new Error(`SKU manifest: invalid SKU ID ${sku}`);
+        keys(definition, ['revisions'], `SKU ${sku}`);
+        if (!object(definition.revisions) || !Object.keys(definition.revisions).length)
+            throw new Error(`SKU ${sku}: revisions must be a nonempty mapping`);
+        for (const [revision, grant] of Object.entries(definition.revisions)) {
+            if (!id(revision))
+                throw new Error(`SKU ${sku}: invalid revision ${revision}`);
+            keys(grant, ['features'], `SKU ${sku}@${revision}`);
+            for (const feature of names(grant.features, `SKU ${sku}@${revision}.features`))
+                if (!features.has(feature))
+                    throw new Error(`SKU ${sku}@${revision}: unknown feature ${feature}`);
+        }
+    }
+    const digest = hash(manifestBytes);
+    const context = { features, digest, pruneNavigation: settings.pruneNavigation ?? false, decisions: [], provenance: Object.create(null) };
+    context.requireClassification = settings.requireClassification ?? false;
+    if (context.requireClassification)
+        context.classificationPublications = (config.publications?.enabled ?? []).map((entry) => ({ channel: entry.channel, version: entry.version, language: entry.language ?? defaultLanguage(config) }));
+    if (!profileFile) {
+        if (settings.required !== false)
+            throw new Error('This project requires an explicit --profile FILE');
+        return { context, overlay: {}, dependencies: [manifestFile], assetFiles: [], digest };
+    }
+    const file = await realpath(path.resolve(profileFile));
+    const bytes = await readFile(file);
+    const profile = parseYaml(bytes.toString('utf8'), file);
+    profileData(profile);
+    keys(profile, ['schemaVersion', 'skus', 'features', 'site', 'theme', 'variables', 'publications'], 'Deployment profile');
+    if (profile.schemaVersion !== 1)
+        throw new Error('Deployment profile needs schemaVersion: 1');
+    if (!Object.hasOwn(profile, 'skus') && !Object.hasOwn(profile, 'features'))
+        throw new Error('Deployment profile must declare skus or features explicitly (empty lists are valid)');
+    const grants = new Set();
+    const add = (feature, reason) => {
+        if (!features.has(feature))
+            throw new Error(`Deployment profile: unknown feature ${feature}`);
+        grants.add(feature);
+        (context.provenance[feature] ??= []).push(reason);
+    };
+    if (profile.skus !== undefined) {
+        if (!Array.isArray(profile.skus))
+            throw new Error('Deployment profile skus must be a list');
+        for (const purchase of profile.skus) {
+            keys(purchase, ['id', 'revision'], 'Profile SKU');
+            if (!id(purchase.id) || !id(purchase.revision))
+                throw new Error('Profile SKU needs explicit id and revision strings');
+            const definition = manifest.skus[purchase.id];
+            if (!Object.hasOwn(manifest.skus, purchase.id) || !Object.hasOwn(definition.revisions, purchase.revision))
+                throw new Error(`Deployment profile: unknown SKU revision ${purchase.id}@${purchase.revision}`);
+            for (const feature of definition.revisions[purchase.revision].features)
+                add(feature, `sku:${purchase.id}@${purchase.revision}`);
+        }
+    }
+    for (const feature of names(profile.features === undefined ? [] : profile.features, 'Deployment profile features'))
+        add(feature, 'direct');
+    context.grants = grants;
+    context.digest = hash(JSON.stringify([digest, hash(bytes)]));
+    const overlay = {};
+    const assetFiles = [];
+    if (profile.site !== undefined) {
+        keys(profile.site, ['title', 'origin', 'basePath', 'favicon', 'logo', 'header', 'footer', 'indexing'], 'Profile site');
+        if (profile.site.title !== undefined && (typeof profile.site.title !== 'string' || !profile.site.title.trim()))
+            throw new Error('Profile site.title must be nonempty text');
+        if (profile.site.indexing !== undefined && typeof profile.site.indexing !== 'boolean')
+            throw new Error('Profile site.indexing must be boolean');
+        if (profile.site.basePath !== undefined)
+            normalizeBasePath(profile.site.basePath);
+        if (profile.site.origin !== undefined) {
+            let valid = false;
+            try {
+                const origin = new URL(profile.site.origin);
+                valid = origin.protocol === 'https:' && origin.origin === profile.site.origin;
+            }
+            catch { /* Report the input contract below. */ }
+            if (!valid)
+                throw new Error('Profile site.origin must be an HTTPS origin without a path');
+        }
+        if (profile.site.header !== undefined) {
+            keys(profile.site.header, ['links'], 'Profile site.header');
+            validateHeader({ ...(object(config.site?.header) ? config.site.header : {}), ...profile.site.header });
+        }
+        if (profile.site.footer !== undefined) {
+            keys(profile.site.footer, ['columns', 'links', 'text'], 'Profile site.footer');
+            validateFooter({ ...(object(config.site?.footer) ? config.site.footer : {}), ...profile.site.footer });
+        }
+        overlay.site = profile.site;
+        for (const setting of ['favicon', 'logo'])
+            if (profile.site[setting] !== undefined) {
+                const asset = profile.site[setting];
+                if (typeof asset !== 'string' || path.isAbsolute(asset) || !/\.(svg|png)$/i.test(asset))
+                    throw new Error(`Profile site.${setting} must be a relative .svg or .png path`);
+                const target = path.resolve(path.dirname(file), asset);
+                if (!target.startsWith(path.dirname(file) + path.sep))
+                    throw new Error('Profile asset must stay within the profile directory');
+                // Explicit assets only. Symlinks must not introduce an undeclared capture root.
+                let current = target;
+                while (current !== path.dirname(file)) {
+                    if ((await lstat(current)).isSymbolicLink())
+                        throw new Error('Profile assets must not use symlinks');
+                    current = path.dirname(current);
+                }
+                if (!(await lstat(target)).isFile())
+                    throw new Error(`Profile ${setting} must be a regular file`);
+                assetFiles.push(target);
+            }
+    }
+    if (profile.theme !== undefined) {
+        keys(profile.theme, ['preset', 'palette', 'mode', 'toggle'], 'Profile theme');
+        // File-backed palettes/fonts and CSS require a separate dependency contract.
+        if (profile.theme.palette !== undefined && !paletteCatalog.some(entry => entry.name === profile.theme.palette))
+            throw new Error('Profile theme.palette must name a built-in palette');
+        if (profile.theme.preset !== undefined && !presetCatalog.some(entry => entry.name === profile.theme.preset))
+            throw new Error('Profile theme.preset must name a built-in preset');
+        if (profile.theme.mode !== undefined && !['light', 'dark', 'system'].includes(profile.theme.mode))
+            throw new Error('Profile theme.mode must be light, dark, or system');
+        if (profile.theme.toggle !== undefined && typeof profile.theme.toggle !== 'boolean')
+            throw new Error('Profile theme.toggle must be boolean');
+        const mode = profile.theme.mode ?? config.theme?.mode ?? 'light';
+        const toggle = profile.theme.toggle ?? config.theme?.toggle ?? (mode === 'system');
+        if (toggle && mode !== 'system')
+            throw new Error('Profile theme.toggle needs effective theme.mode: system');
+        overlay.theme = profile.theme;
+    }
+    if (profile.variables !== undefined) {
+        if (!object(profile.variables) || Object.entries(profile.variables).some(([key, value]) => !id(key) || (!['string', 'number', 'boolean'].includes(typeof value) || typeof value === 'number' && !Number.isFinite(value))))
+            throw new Error('Profile variables must map IDs to string, number, or boolean values');
+        overlay.variables = profile.variables;
+    }
+    if (profile.publications !== undefined) {
+        keys(profile.publications, ['enabled'], 'Profile publications');
+        const enabled = profile.publications.enabled;
+        const language = defaultLanguage(config);
+        const coordinate = (value) => JSON.stringify([value.channel, value.version, value.language ?? language]);
+        if (!Array.isArray(enabled) || !enabled.length)
+            throw new Error('Profile publications.enabled must be a nonempty subset of shared publications.enabled');
+        const selected = new Set();
+        for (const variant of enabled) {
+            keys(variant, ['channel', 'version', 'language'], 'Profile publication');
+            if (typeof variant.channel !== 'string' || typeof variant.version !== 'string' || (variant.language !== undefined && typeof variant.language !== 'string') || !config.publications?.enabled?.some((entry) => coordinate(entry) === coordinate(variant)))
+                throw new Error('Profile publication is not enabled by the shared configuration');
+            const key = coordinate(variant);
+            if (selected.has(key))
+                throw new Error('Profile publications.enabled must not repeat publication coordinates');
+            selected.add(key);
+        }
+        overlay.publications = profile.publications;
+    }
+    context.digest = hash(JSON.stringify([digest, hash(bytes), await Promise.all(assetFiles.map(async (asset) => hash(await readFile(asset))))]));
+    return { context, overlay, file, dependencies: [manifestFile, file, ...assetFiles], assetFiles, digest: context.digest };
+}

package/dist/frontmatter.js

@@ -4,7 +4,7 @@ import { validateCardMetadata } from './cards.js';
 import { resolveTaxonomy, validateTaxonomy, taxonomySchema } from './taxonomy.js';
 import { validateStandaloneSectionDeclarations } from './section-identity.js';
 export const nativePublicFields = new Set(['id', 'title', 'type', 'summary', 'description', 'language', 'locale', 'date', 'updated', 'verified', 'releaseVersion', 'product', 'area', 'subarea', 'operations', 'relatedApiReferences', 'audiences', 'readerFilters', 'tags', 'subjectLifecycle', 'subjectDeprecation', 'change', 'lifecycle']);
-export const protectedMetadataRoots = new Set(['standaloneSections', 'access', 'seo', 'markdownMetadata', 'variables', 'tocDepth', 'layout', 'showNavigationTabs', 'showVerified', 'image', 'private', 'internal', 'card', 'displayText', 'publications']);
+export const protectedMetadataRoots = new Set(['shared', 'requires', 'standaloneSections', 'access', 'seo', 'markdownMetadata', 'variables', 'tocDepth', 'layout', 'showNavigationTabs', 'showVerified', 'image', 'private', 'internal', 'card', 'displayText', 'publications']);
 const fieldTypes = new Set(['string', 'number', 'integer', 'boolean', 'object', 'array']);
 const safePath = (value) => /^[A-Za-z_][A-Za-z0-9_-]*(?:\.[A-Za-z_][A-Za-z0-9_-]*)*$/.test(value);
 const object = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
@@ -33,7 +33,7 @@ export function frontmatterLayers(config = {}) {
         const layer = config[name] === undefined ? {} : config[name];
         if (!object(layer))
             throw new Error(`frontmatter.${name} must be a mapping`);
-        for (const field of ['id', 'slug', 'publications', 'standaloneSections', 'subjectDeprecation', 'change'])
+        for (const field of ['id', 'slug', 'shared', 'publications', 'standaloneSections', 'subjectDeprecation', 'change'])
             if (Object.hasOwn(layer, field))
                 throw new Error(`frontmatter.${name}.${field} must stay page-specific`);
         layers[name] = mergeMetadata({}, layer);
@@ -114,6 +114,10 @@ function matchesType(value, type) {
 export function validateFrontmatter(frontmatter, config, file, source) {
     const taxonomy = resolveTaxonomy(config?.taxonomy);
     validateTaxonomy(frontmatter, taxonomy, file, source);
+    if (frontmatter.shared !== undefined && frontmatter.shared !== true)
+        throw new Error(`${file}: shared must be true; use requires for restricted content`);
+    if (frontmatter.shared === true && frontmatter.requires !== undefined)
+        throw new Error(`${file}: declare shared: true or requires, not both`);
     validateCardMetadata(frontmatter.card, file);
     validateSubjectDeprecation(frontmatter.subjectDeprecation, file);
     validateAuthoredChange(frontmatter, file);
@@ -239,6 +243,8 @@ export function frontmatterSchema(config) {
         operations: { type: 'array', items: { type: 'string' }, description: 'Stable API operation IDs that connect this page to endpoint references and related documents.' },
         relatedApiReferences: { type: 'array', items: { type: 'string' }, description: 'API reference page IDs linked automatically from this guide and back from each reference, within the same publication.' },
         audiences: { type: 'array', items: { type: 'string' }, description: 'Readers this page is intended for; does not control who can access it.' },
+        shared: { type: 'boolean', const: true, description: 'Explicitly classify this page as shared across customer editions. Page-specific; cannot combine with requires. Sections may still use ForFeature.' },
+        requires: { type: 'object', minProperties: 1, additionalProperties: false, properties: Object.fromEntries(['allOf', 'anyOf'].map(name => [name, { type: 'array', minItems: 1, items: { type: 'string', minLength: 1 } }])), description: 'Build-time feature requirements from the shared SKU manifest. Both clauses must pass when present; omitted means shared within existing publication/access eligibility. Requires an explicit deployment profile.' },
         readerFilters: { type: 'object', additionalProperties: { type: 'array', items: { type: 'string' } }, description: 'Configured reader filter choices for this page. Missing facets are shared.' },
         tags: { type: 'array', items: { type: 'string' }, description: 'Editorial labels used to select pages in document collections.' },
         change: { type: 'object', additionalProperties: false, required: ['kind', 'affects'], description: 'Page-specific authored change meaning on a changelog-entry: kind, affected document IDs, and optional migration guide ID in the same publication. Omission means unclassified, not nonbreaking.', properties: { kind: { type: 'string', enum: [...changeKinds] }, affects: { type: 'array', minItems: 1, uniqueItems: true, items: { type: 'string', minLength: 1 } }, migration: { type: 'string', minLength: 1 } } },
@@ -310,18 +316,19 @@ export function frontmatterReference(config, sectionsOnly = false) {
         'This generated file is a project-wide field guide for authors and agents working with the repository. The build writes it to `.shoalrun/frontmatter-reference.md` beside the project config. Link to that local file from repository instructions when agents need it.', '',
         'Frontmatter is the YAML header between the first pair of `---` lines in a `.md` or `.mdx` source page. It tells the compiler what the page is, where to publish it, and how to connect it to other content. The prose below the second `---` is the page body. This example header illustrates the fields; it is not necessarily the header of the page linking here.', '',
         '```yaml', '---', 'id: guide.create-payment', 'title: Create a payment', 'summary: Submit a payment with the example API.', 'type: how-to', 'slug: /guides/create-payment', 'channel: production', 'version: v1', 'access: { policy: public }', '---', '```', '',
-        'This header describes one page. Its `id` stays stable when `slug` changes; `channel` and `version` select the publication in which that page appears. A **publication** is an enabled combination of channel, version, and language in project config. A public page also needs `access.policy: public`. The “Needed” column below refers to the *resolved* header after project defaults and enforced values are merged. Only `id` and `slug` must be written on each source page.', '',
+        'This header describes one page. Its `id` stays stable when `slug` changes; `channel` and `version` select the publication in which that page appears. A **publication** is an enabled combination of channel, version, and language in project config. A public page also needs `access.policy: public`. The “Needed” column below refers to the *resolved* header after project defaults and enforced values are merged. IDs and slugs must be written on each source page; optional explicit-classification and taxonomy policies can require additional source fields.', '',
         '## Identify and route a page', '',
         'Use the page ID for links and cards that should survive a URL change. The slug supplies the page part of the URL; publication prefixes may be added around it. Summary is short preview text; description is a separate, optional fuller account. Project output rules choose which field supplies each surface.', '',
         ...table, ...nativeRows(['id', 'title', 'summary', 'description', 'type', 'slug']), '',
         '## Choose a publication and visibility', '',
         'The project enables specific channel/version/language combinations. A page is built only for combinations matching its resolved values. `audiences` and `readerFilters` select reader views when the site config enables them; `access.policy` determines whether the page enters this public build. A draft page is excluded.', '',
-        ...table, ...nativeRows(['channel', 'version', 'language', 'locale', 'access', 'audiences', 'readerFilters']), '',
+        ...table, ...nativeRows(['channel', 'version', 'language', 'locale', 'access', 'shared', 'requires', 'audiences', 'readerFilters']), '',
         'Language is the content language and selects a publication. Locale describes formatting conventions in the content and does not select a publication. `frontmatter.locales` can set a project locale for each language; pages may override it.', '',
         '## Categorize, connect, and present the page', '',
         'By default, `product`, `area`, and `subarea` are optional, nonempty string categories. They can come from project defaults and appear in the document manifest and search index. A matching configured reader facet makes each category a page filter; without that facet it remains taxonomy only. `operations` links a guide or reference to stable API operation IDs. On a guide or how-to page, `relatedApiReferences` names API reference page IDs to add cross links in both directions within the same publication. Tags help document collections find the page. Card settings change its preview when another page links to it; they do not change the destination. `subjectLifecycle` displays the status of the documented API or feature; `lifecycle` is available for the document\'s editorial state. `tocDepth` limits the HTML page table of contents; use 0 to hide it. `layout` picks the HTML page layout: `docs`, `wide`, `landing`, or `splash`. `showNavigationTabs` overrides the navigation tab bar for this page; landing and splash pages hide it by default. `image` replaces the generated link-preview image. `date` and `releaseVersion` can identify a changelog entry under the project\'s `frontmatter.changelogIdentifier` rule.', '',
         ...table, ...nativeRows(['product', 'area', 'subarea', 'operations', 'relatedApiReferences', 'tags', 'date', 'releaseVersion', 'subjectLifecycle', 'subjectDeprecation', 'change', 'lifecycle', 'card', 'standaloneSections', 'tocDepth', 'layout', 'showNavigationTabs', 'showVerified', 'image']), '',
         'Projects can opt into built-in category enforcement with `frontmatter.taxonomy`. It declares areas and their allowed subareas, optional required fields, and optional explicit-field requirements for authored pages. Its `multiple` list permits arrays for selected category fields; otherwise each field allows one value. Defaults and enforced values still apply; generated API references use resolved categories. Definitions appear in the document manifest and constrain the generated frontmatter schema. Omit taxonomy or set it to false to preserve optional category behavior.', '',
+        'With `profiles.requireClassification: true`, every public source page in the shared enabled publications needs an explicit `shared: true` or `requires` declaration before customer selection. Defaults do not count. Shared pages may contain feature-specific sections wrapped in `<ForFeature>`; unwrapped text remains shared.', '',
         '## Control output details', '',
         '`seo` changes the browser title or HTML meta description. `displayText` overrides the text chosen for one output surface on this page. `variables` supplies values to registered snippets before they expand into the page body. `markdownMetadata` selects or overrides the YAML preamble of the generated Markdown twin—the machine-readable copy of this page. That generated preamble is separate from the source frontmatter shown above.', '',
         ...table, ...nativeRows(['seo', 'displayText', 'variables', 'markdownMetadata']), '',

package/dist/page-materialization.js

@@ -29,6 +29,8 @@ export async function materializePages({ variables, frontmatterConfig, publicati
                 local.set(other.frontmatter.id, other);
         const parsed = parse.parse(doc.body);
         const tree = await resolveApiEmbedTree(transformMdx(parsed, doc, local, snippets, variables, snippetUses, calloutTypes, base, readerFilters, frontmatterConfig, publications, badgeVariants, componentPlugins), api, operationId => sourceForOperation(operationId, doc.variant), apiId => {
+            if (doc.featureContext?.grants)
+                throw new Error('Standalone API schema embeds require an explicitly scoped source and are not supported in profiled builds; select an operation instead');
             const definition = apiPlan.apiDefinitions[apiId];
             if (!definition)
                 throw new Error(`unknown API ${apiId}`);

package/dist/page-renderer.d.ts

@@ -42,6 +42,7 @@ export type PageShell = {
         generated: boolean;
     };
     favicon?: string;
+    logo?: string;
     touchIcon?: boolean;
     origin?: string;
     indexing?: boolean;

package/dist/page-renderer.js

@@ -62,6 +62,8 @@ export function buildHtmlPage(doc, tree, markdownUrl, siteTitle, navigation, exa
     const audienceLabels = doc.frontmatter.audiences?.filter(label => label.trim()) ?? [];
     const audienceBadges = audienceLabels.length ? `<div class="audience-labels" role="group" aria-label="Intended audience"><span class="audience-label-heading">For</span>${audienceLabels.map(label => `<span class="audience-badge">${esc(readerConfig?.facets.audience?.options[label] ?? label)}</span>`).join('')}</div>` : '';
     const title = doc.frontmatter.seo?.title ?? doc.frontmatter.title;
+    const brand = `${shell.logo ? `<img class="brand-logo" src="${esc(shell.logo)}" alt="">` : ''}${esc(siteTitle)}`;
+    const brandClass = shell.logo ? 'brand brand-custom' : 'brand';
     const pageTitle = String(title).trim();
     const brandedTitle = `${pageTitle} | ${siteTitle.trim()}`;
     const socialTitle = !doc.frontmatter.seo?.title && pageTitle.length < 30 && brandedTitle.length <= 70 ? brandedTitle : pageTitle;
@@ -174,6 +176,6 @@ export function buildHtmlPage(doc, tree, markdownUrl, siteTitle, navigation, exa
     const menu = side || sectionNavigation ? `<a class="mobile-menu" href="#${side ? 'docs-navigation' : 'docs-sections'}">Menu</a>` : '';
     const rail = toc || panel ? `<aside class="page-rail">${doc.endpoint ? `${panel}${toc}` : `${toc}${panel}`}</aside>` : '';
     const breadcrumbs = (shell.breadcrumbs?.length ?? 0) > 1 && !hero ? `<nav class="doc-breadcrumbs" aria-label="Breadcrumb"><ol>${shell.breadcrumbs.map((item, index) => `<li>${index === shell.breadcrumbs.length - 1 ? `<span aria-current="page">${esc(item.label)}</span>` : item.url ? `<a href="${esc(item.url)}">${esc(item.label)}</a>` : `<span>${esc(item.label)}</span>`}</li>`).join('')}</ol></nav>` : '';
-    const markup = `<!doctype html><html lang="${esc(doc.variant.language)}"${shell.themeCss || shell.paletteCss ? ` data-theme="${esc(shell.preset ?? 'shoal')}" data-palette="${esc(shell.palette ?? '')}"` : ''}${shell.masthead ? ` data-masthead="${esc(shell.masthead)}"` : ''}${layout === 'docs' ? '' : ` data-layout="${layout}"`}><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="color-scheme" content="${shell.mode === 'system' ? 'light dark' : shell.mode ?? 'light'}">${shell.indexing === false || doc.frontmatter.seo?.noindex === true ? '<meta name="robots" content="noindex">' : ''}${shell.origin ? `<link rel="canonical" href="${esc(absolute(doc.route))}">` : ''}${shell.toggle ? '<script src="/assets/mode.js"></script>' : ''}<title>${esc(String(title))}</title>${description ? `<meta name="description" content="${esc(String(description))}">` : ''}${socialDescription ? `<meta property="og:description" content="${esc(socialDescription)}">` : ''}${social}<link rel="alternate" type="text/markdown" href="${esc(markdownUrl)}"><link rel="describedby" href="/llms.min.txt" title="Documentation index">${icons}${shell.preloadFont ? `<link rel="preload" href="/assets/fonts/${esc(shell.preloadFont)}" as="font" type="font/woff2" crossorigin>` : ''}<link rel="stylesheet" href="/assets/site.css">${article.includes('data-theme-preview') ? '<link rel="stylesheet" href="/assets/theme-preview.css">' : ''}${shell.themeCss ? '<link rel="stylesheet" href="/assets/theme.css" data-theme-link="theme">' : ''}${shell.paletteCss ? '<link rel="stylesheet" href="/assets/palette.css" data-theme-link="palette">' : ''}${shell.badgesCss ? '<link rel="stylesheet" href="/assets/badges.css">' : ''}${shell.themeSwitcher ? `<script src="/assets/theme-switcher.js" data-themes="${esc(shell.themeSwitcher)}"></script>` : ''}${shell.fontsCss ? '<link rel="stylesheet" href="/assets/fonts.css">' : ''}${customCss ? '<link rel="stylesheet" href="/assets/project.css">' : ''}</head><body><a class="skip" href="#main">Skip to content</a>${agent.mode === 'disclosure' ? '' : agentBlock}<header class="mast"><div class="mast-inner">${shell.home ? `<a class="brand" href="/">${esc(siteTitle)}</a>` : `<span class="brand">${esc(siteTitle)}</span>`}${editionLabel && (shell.publicationAlternates?.length ?? 0) < 2 ? `<span class="edition">${esc(editionLabel)}</span>` : ''}${menu}${headerTools(shell, doc.variant, esc, readerConfig)}${agent.mode === 'disclosure' ? agentBlock : ''}</div></header>${sectionNavigation}${shortcuts}<div class="layout${layout === 'docs' ? '' : ` layout-${layout}`}${rail ? ' has-rail' : ''}${panel ? ' has-examples' : ''}${doc.endpoint ? ' api-reference' : ''}"><main id="main" class="content" tabindex="-1" data-document-type="${esc(doc.frontmatter.type)}"${readerConfig ? ` data-reader-page="${esc(readerFilterAttribute(doc.readerFilters ?? {}))}"` : ''}>${breadcrumbs}${hero ? '' : `<header class="page-head"><span class="eyebrow">${esc(typeLabel(doc.frontmatter.type))}</span>${doc.endpoint ? '' : badge(doc.frontmatter.subjectLifecycle)}<h1>${esc(doc.frontmatter.title)}${doc.endpoint ? badge(doc.frontmatter.subjectLifecycle) : ''}</h1>${pageHeader && !routeSummary ? `<p class="summary">${esc(pageHeader)}</p>` : ''}${pageDates}${endpoint}${audienceBadges}</header>`}${hero ? '' : `<div class="page-formats"><a class="formats" href="${esc(markdownUrl)}">Read as Markdown</a><button type="button" class="formats" data-copy-markdown hidden>Copy as Markdown</button><span role="status" data-copy-markdown-status></span></div>`}${toc ? '<div class="mobile-outline-slot"></div>' : ''}${jumps}${readerBanner}<article>${article}</article></main>${rail}${side}</div>${footer}${analyticsBootstrap}${readerBootstrap}<script type="module" src="/assets/copy-markdown.js"></script><script type="module" src="/assets/navigation.js"></script><script type="module" src="/assets/reader.js"></script><script type="module" src="/assets/tabs.js"></script>${shell.search ? '<script type="module" src="/assets/search.js"></script>' : ''}${article.includes('data-tooltip') ? '<script type="module" src="/assets/tooltips.js"></script>' : ''}${article.includes('data-component-module') ? '<script type="module" src="/assets/components.js"></script>' : ''}${article.includes('data-file-tree') ? '<script type="module" src="/assets/file-tree.js"></script>' : ''}${article.includes('data-image-expand') ? '<script type="module" src="/assets/image-viewer.js"></script>' : ''}${article.includes('data-table-filter') || article.includes('data-definition-filter') ? '<script type="module" src="/assets/table-filter.js"></script>' : ''}${article.includes('data-walkthrough') ? '<script type="module" src="/assets/walkthrough.js"></script>' : ''}${article.includes('data-cookbook-chooser') ? '<script type="module" src="/assets/cookbook-chooser.js"></script>' : ''}${article.includes('data-theme-preview') ? '<script type="module" src="/assets/theme-preview.js"></script>' : ''}${panel ? '<script type="module" src="/assets/example-panel.js"></script>' : ''}${panel.includes('data-code-samples') ? '<script type="module" src="/assets/code-samples.js"></script>' : ''}</body></html>`;
+    const markup = `<!doctype html><html lang="${esc(doc.variant.language)}"${shell.themeCss || shell.paletteCss ? ` data-theme="${esc(shell.preset ?? 'shoal')}" data-palette="${esc(shell.palette ?? '')}"` : ''}${shell.masthead ? ` data-masthead="${esc(shell.masthead)}"` : ''}${layout === 'docs' ? '' : ` data-layout="${layout}"`}><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><meta name="color-scheme" content="${shell.mode === 'system' ? 'light dark' : shell.mode ?? 'light'}">${shell.indexing === false || doc.frontmatter.seo?.noindex === true ? '<meta name="robots" content="noindex">' : ''}${shell.origin ? `<link rel="canonical" href="${esc(absolute(doc.route))}">` : ''}${shell.toggle ? '<script src="/assets/mode.js"></script>' : ''}<title>${esc(String(title))}</title>${description ? `<meta name="description" content="${esc(String(description))}">` : ''}${socialDescription ? `<meta property="og:description" content="${esc(socialDescription)}">` : ''}${social}<link rel="alternate" type="text/markdown" href="${esc(markdownUrl)}"><link rel="describedby" href="/llms.min.txt" title="Documentation index">${icons}${shell.preloadFont ? `<link rel="preload" href="/assets/fonts/${esc(shell.preloadFont)}" as="font" type="font/woff2" crossorigin>` : ''}<link rel="stylesheet" href="/assets/site.css">${article.includes('data-theme-preview') ? '<link rel="stylesheet" href="/assets/theme-preview.css">' : ''}${shell.themeCss ? '<link rel="stylesheet" href="/assets/theme.css" data-theme-link="theme">' : ''}${shell.paletteCss ? '<link rel="stylesheet" href="/assets/palette.css" data-theme-link="palette">' : ''}${shell.badgesCss ? '<link rel="stylesheet" href="/assets/badges.css">' : ''}${shell.themeSwitcher ? `<script src="/assets/theme-switcher.js" data-themes="${esc(shell.themeSwitcher)}"></script>` : ''}${shell.fontsCss ? '<link rel="stylesheet" href="/assets/fonts.css">' : ''}${customCss ? '<link rel="stylesheet" href="/assets/project.css">' : ''}</head><body><a class="skip" href="#main">Skip to content</a>${agent.mode === 'disclosure' ? '' : agentBlock}<header class="mast"><div class="mast-inner">${shell.home ? `<a class="${brandClass}" href="/">${brand}</a>` : `<span class="${brandClass}">${brand}</span>`}${editionLabel && (shell.publicationAlternates?.length ?? 0) < 2 ? `<span class="edition">${esc(editionLabel)}</span>` : ''}${menu}${headerTools(shell, doc.variant, esc, readerConfig)}${agent.mode === 'disclosure' ? agentBlock : ''}</div></header>${sectionNavigation}${shortcuts}<div class="layout${layout === 'docs' ? '' : ` layout-${layout}`}${rail ? ' has-rail' : ''}${panel ? ' has-examples' : ''}${doc.endpoint ? ' api-reference' : ''}"><main id="main" class="content" tabindex="-1" data-document-type="${esc(doc.frontmatter.type)}"${readerConfig ? ` data-reader-page="${esc(readerFilterAttribute(doc.readerFilters ?? {}))}"` : ''}>${breadcrumbs}${hero ? '' : `<header class="page-head"><span class="eyebrow">${esc(typeLabel(doc.frontmatter.type))}</span>${doc.endpoint ? '' : badge(doc.frontmatter.subjectLifecycle)}<h1>${esc(doc.frontmatter.title)}${doc.endpoint ? badge(doc.frontmatter.subjectLifecycle) : ''}</h1>${pageHeader && !routeSummary ? `<p class="summary">${esc(pageHeader)}</p>` : ''}${pageDates}${endpoint}${audienceBadges}</header>`}${hero ? '' : `<div class="page-formats"><a class="formats" href="${esc(markdownUrl)}">Read as Markdown</a><button type="button" class="formats" data-copy-markdown hidden>Copy as Markdown</button><span role="status" data-copy-markdown-status></span></div>`}${toc ? '<div class="mobile-outline-slot"></div>' : ''}${jumps}${readerBanner}<article>${article}</article></main>${rail}${side}</div>${footer}${analyticsBootstrap}${readerBootstrap}<script type="module" src="/assets/copy-markdown.js"></script><script type="module" src="/assets/navigation.js"></script><script type="module" src="/assets/reader.js"></script><script type="module" src="/assets/tabs.js"></script>${shell.search ? '<script type="module" src="/assets/search.js"></script>' : ''}${article.includes('data-tooltip') ? '<script type="module" src="/assets/tooltips.js"></script>' : ''}${article.includes('data-component-module') ? '<script type="module" src="/assets/components.js"></script>' : ''}${article.includes('data-file-tree') ? '<script type="module" src="/assets/file-tree.js"></script>' : ''}${article.includes('data-image-expand') ? '<script type="module" src="/assets/image-viewer.js"></script>' : ''}${article.includes('data-table-filter') || article.includes('data-definition-filter') ? '<script type="module" src="/assets/table-filter.js"></script>' : ''}${article.includes('data-walkthrough') ? '<script type="module" src="/assets/walkthrough.js"></script>' : ''}${article.includes('data-cookbook-chooser') ? '<script type="module" src="/assets/cookbook-chooser.js"></script>' : ''}${article.includes('data-theme-preview') ? '<script type="module" src="/assets/theme-preview.js"></script>' : ''}${panel ? '<script type="module" src="/assets/example-panel.js"></script>' : ''}${panel.includes('data-code-samples') ? '<script type="module" src="/assets/code-samples.js"></script>' : ''}</body></html>`;
     return basePath ? markup.replace(/((?:href|src)=")\/(assets\/|llms(?:\.min)?\.txt|apple-touch-icon\.png)/g, `$1${basePath}/$2`).replace('href="/"', `href="${basePath}/"`) : markup;
 }