@se-studio/contentful-cms 0.0.0-next16-20260822103555

package/dist/contentful/scalar-value.js

@@ -0,0 +1,95 @@
+/** Parse CLI token literals only (no numeric guessing). */
+export function parseScalarToken(raw) {
+    if (raw === 'true')
+        return true;
+    if (raw === 'false')
+        return false;
+    if (raw === 'null')
+        return null;
+    return raw;
+}
+/** Extract enum values from Symbol/Text field validations (same rules as schema command). */
+export function getFieldEnumValues(fieldDef) {
+    if (!fieldDef)
+        return undefined;
+    const validations = fieldDef.validations ?? [];
+    for (const v of validations) {
+        const inVals = v.in;
+        if (Array.isArray(inVals) && inVals.length > 0) {
+            return inVals;
+        }
+    }
+    return undefined;
+}
+/**
+ * Returns an error message if value is not in the field enum; null if valid or no enum.
+ */
+export function validateScalarEnum(value, fieldDef, fieldId) {
+    const allowed = getFieldEnumValues(fieldDef);
+    if (!allowed || allowed.length === 0)
+        return null;
+    const str = typeof value === 'string' ? value : String(value);
+    if (!allowed.includes(str)) {
+        return `Invalid value for '${fieldId}'. Allowed: ${allowed.join(', ')}`;
+    }
+    return null;
+}
+/**
+ * Coerce a CLI scalar token to the CMA value type for the field.
+ * Symbol/Text always stay strings (no numeric guessing).
+ */
+export function coerceScalarForField(raw, fieldDef) {
+    const token = parseScalarToken(raw);
+    const type = fieldDef?.type;
+    if (type === 'Integer' || type === 'Number') {
+        if (token === null)
+            return null;
+        if (typeof token === 'boolean')
+            return token ? 1 : 0;
+        const num = Number(raw.trim());
+        if (Number.isNaN(num)) {
+            throw new Error(`Expected a number for field type ${type}, got "${raw}".`);
+        }
+        return num;
+    }
+    if (type === 'Boolean') {
+        if (typeof token === 'boolean')
+            return token;
+        if (token === null)
+            return false;
+        const lower = raw.trim().toLowerCase();
+        if (lower === 'true' || lower === '1')
+            return true;
+        if (lower === 'false' || lower === '0')
+            return false;
+        throw new Error(`Expected true/false for Boolean field, got "${raw}".`);
+    }
+    if (type === 'Symbol' || type === 'Text') {
+        if (token === null)
+            return '';
+        if (typeof token === 'boolean')
+            return token ? 'true' : 'false';
+        return raw;
+    }
+    if (token === null)
+        return null;
+    if (typeof token === 'boolean')
+        return token;
+    const num = Number(raw.trim());
+    if (!Number.isNaN(num) && raw.trim() !== '' && /^-?\d+(\.\d+)?$/.test(raw.trim())) {
+        return num;
+    }
+    return raw;
+}
+/**
+ * Coerce token and validate enum; throws with actionable message on failure.
+ */
+export function resolveScalarValueForField(raw, fieldDef, fieldId) {
+    const value = coerceScalarForField(raw, fieldDef);
+    const enumErr = validateScalarEnum(value, fieldDef, fieldId);
+    if (enumErr) {
+        throw new Error(enumErr);
+    }
+    return value;
+}
+//# sourceMappingURL=scalar-value.js.map

package/dist/contentful/scalar-value.js.map

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

package/dist/contentful/set-field-schema.d.ts

@@ -0,0 +1,32 @@
+import type { ContentFields, ContentTypeProps } from 'contentful-management';
+import type { SessionState } from '../session/state.js';
+import type { SafeEnvironment } from './client.js';
+/** Clears in-process content-type cache (for tests). */
+export declare function clearContentTypeCacheForTests(): void;
+export declare function getContentTypeCached(env: SafeEnvironment, session: SessionState, ctId: string): Promise<ContentTypeProps>;
+export declare function getActiveFieldDef(ct: ContentTypeProps, fieldId: string): ContentFields | undefined;
+export type SetSchemaConflict = {
+    kind: 'entryLink';
+} | {
+    kind: 'assetLink';
+} | {
+    kind: 'entryLinkArray';
+} | {
+    kind: 'assetLinkArray';
+};
+/**
+ * Validates that a field is suitable for --links (array of entry links).
+ * Returns an error string if the field is incompatible, null if valid or unknown.
+ */
+export declare function validateLinksSetAgainstFieldSchema(fieldDef: ContentFields | undefined, fieldId: string): string | null;
+/**
+ * Validates that a field is suitable for --link (single entry link).
+ * Returns an error string if incompatible, null if valid or unknown.
+ */
+export declare function validateLinkSetAgainstFieldSchema(fieldDef: ContentFields | undefined, fieldId: string, ref: string): string | null;
+/**
+ * When the user uses scalar `set` (no --link / --asset / --links / --json),
+ * ensure the target field is not a RichText or Link type that requires those flags.
+ */
+export declare function validateScalarSetAgainstFieldSchema(fieldDef: ContentFields | undefined): SetSchemaConflict | null;
+//# sourceMappingURL=set-field-schema.d.ts.map

package/dist/contentful/set-field-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-field-schema.d.ts","sourceRoot":"","sources":["../../src/contentful/set-field-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA+BnD,wDAAwD;AACxD,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD;AAED,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,gBAAgB,EACpB,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,SAAS,CAE3B;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAuBf;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,aAAa,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CA4Bf;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,aAAa,GAAG,SAAS,GAClC,iBAAiB,GAAG,IAAI,CA2B1B"}

package/dist/contentful/set-field-schema.js

@@ -0,0 +1,123 @@
+import { readContentTypeFromDisk, writeContentTypeToDisk } from './content-type-disk-cache.js';
+const contentTypeCache = new Map();
+function contentTypeCacheKey(session, ctId) {
+    return `${session.spaceId}\0${session.environment}\0${ctId}`;
+}
+function storeContentTypeInSession(session, ctId, ct) {
+    if (!session.contentTypes) {
+        session.contentTypes = {};
+    }
+    session.contentTypes[ctId] = ct;
+}
+function persistContentTypeEverywhere(session, ctId, ct) {
+    const key = contentTypeCacheKey(session, ctId);
+    contentTypeCache.set(key, ct);
+    storeContentTypeInSession(session, ctId, ct);
+    writeContentTypeToDisk(session.spaceId, session.environment, ctId, ct);
+}
+/** Clears in-process content-type cache (for tests). */
+export function clearContentTypeCacheForTests() {
+    contentTypeCache.clear();
+}
+export async function getContentTypeCached(env, session, ctId) {
+    const key = contentTypeCacheKey(session, ctId);
+    let ct = contentTypeCache.get(key);
+    if (ct)
+        return ct;
+    ct = session.contentTypes?.[ctId];
+    if (ct) {
+        contentTypeCache.set(key, ct);
+        return ct;
+    }
+    ct = readContentTypeFromDisk(session.spaceId, session.environment, ctId) ?? undefined;
+    if (ct) {
+        persistContentTypeEverywhere(session, ctId, ct);
+        return ct;
+    }
+    ct = await env.getContentType(ctId);
+    persistContentTypeEverywhere(session, ctId, ct);
+    return ct;
+}
+export function getActiveFieldDef(ct, fieldId) {
+    return ct.fields.find((f) => f.id === fieldId && !f.disabled && !f.omitted);
+}
+/**
+ * Validates that a field is suitable for --links (array of entry links).
+ * Returns an error string if the field is incompatible, null if valid or unknown.
+ */
+export function validateLinksSetAgainstFieldSchema(fieldDef, fieldId) {
+    if (!fieldDef)
+        return null;
+    if (fieldDef.type === 'Array' &&
+        fieldDef.items?.type === 'Link' &&
+        fieldDef.items.linkType === 'Entry') {
+        return null;
+    }
+    if (fieldDef.type === 'Array' &&
+        fieldDef.items?.type === 'Link' &&
+        fieldDef.items.linkType === 'Asset') {
+        return `'${fieldId}' holds asset links — use --json/--json-base64 with a valid link array, or manage assets with cms-edit asset.`;
+    }
+    if (fieldDef.type === 'Link' && fieldDef.linkType === 'Entry') {
+        return (`'${fieldId}' is a single Entry link field — use --link (not --links).\n` +
+            `  Example: cms-edit set <ref> ${fieldId} <entry-id> --link`);
+    }
+    return `'${fieldId}' (type: ${fieldDef.type}) is not an array of entry links.`;
+}
+/**
+ * Validates that a field is suitable for --link (single entry link).
+ * Returns an error string if incompatible, null if valid or unknown.
+ */
+export function validateLinkSetAgainstFieldSchema(fieldDef, fieldId, ref) {
+    if (!fieldDef)
+        return null;
+    if (fieldDef.type === 'Link' && fieldDef.linkType === 'Entry') {
+        return null;
+    }
+    if (fieldDef.type === 'Array' &&
+        fieldDef.items?.type === 'Link' &&
+        fieldDef.items.linkType === 'Entry') {
+        return (`'${fieldId}' is an array of entry links — use --links (or --links --append), not --link.\n` +
+            `  Replace the whole array: cms-edit set ${ref} ${fieldId} <id1>,<id2> --links\n` +
+            `  Append: cms-edit set ${ref} ${fieldId} <id> --links --append\n` +
+            `  To change one item: read the array, edit the list, write all ids back with --links.`);
+    }
+    if (fieldDef.type === 'Link' && fieldDef.linkType === 'Asset') {
+        return `'${fieldId}' is an Asset link field — use: cms-edit set ${ref} ${fieldId} <asset-id> --asset`;
+    }
+    if (fieldDef.type === 'Array' &&
+        fieldDef.items?.type === 'Link' &&
+        fieldDef.items.linkType === 'Asset') {
+        return `'${fieldId}' holds asset links — use --json/--json-base64 with a valid link array, or manage assets with cms-edit asset.`;
+    }
+    return `'${fieldId}' (type: ${fieldDef.type}) is not a single Entry link field — do not use --link.`;
+}
+/**
+ * When the user uses scalar `set` (no --link / --asset / --links / --json),
+ * ensure the target field is not a RichText or Link type that requires those flags.
+ */
+export function validateScalarSetAgainstFieldSchema(fieldDef) {
+    if (!fieldDef)
+        return null;
+    if (fieldDef.type === 'RichText') {
+        return null;
+    }
+    if (fieldDef.type === 'Link' && fieldDef.linkType === 'Entry') {
+        return { kind: 'entryLink' };
+    }
+    if (fieldDef.type === 'Link' && fieldDef.linkType === 'Asset') {
+        return { kind: 'assetLink' };
+    }
+    if (fieldDef.type === 'Array' &&
+        fieldDef.items?.type === 'Link' &&
+        fieldDef.items.linkType === 'Entry') {
+        return { kind: 'entryLinkArray' };
+    }
+    if (fieldDef.type === 'Array' &&
+        fieldDef.items?.type === 'Link' &&
+        fieldDef.items.linkType === 'Asset') {
+        return { kind: 'assetLinkArray' };
+    }
+    return null;
+}
+//# sourceMappingURL=set-field-schema.js.map

package/dist/contentful/set-field-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-field-schema.js","sourceRoot":"","sources":["../../src/contentful/set-field-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE/F,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAC;AAE7D,SAAS,mBAAmB,CAAC,OAAqB,EAAE,IAAY;IAC9D,OAAO,GAAG,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAqB,EACrB,IAAY,EACZ,EAAoB;IAEpB,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,CAAC,YAAY,GAAG,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,4BAA4B,CACnC,OAAqB,EACrB,IAAY,EACZ,EAAoB;IAEpB,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9B,yBAAyB,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7C,sBAAsB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,6BAA6B;IAC3C,gBAAgB,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAoB,EACpB,OAAqB,EACrB,IAAY;IAEZ,MAAM,GAAG,GAAG,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,IAAI,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,EAAE,EAAE,CAAC;QACP,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,EAAE,GAAG,uBAAuB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,SAAS,CAAC;IACtF,IAAI,EAAE,EAAE,CAAC;QACP,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,EAAE,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,4BAA4B,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAChD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,EAAoB,EACpB,OAAe;IAEf,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAC9E,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,QAAmC,EACnC,OAAe;IAEf,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM;QAC/B,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM;QAC/B,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EACnC,CAAC;QACD,OAAO,IAAI,OAAO,+GAA+G,CAAC;IACpI,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,CACL,IAAI,OAAO,8DAA8D;YACzE,iCAAiC,OAAO,oBAAoB,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,OAAO,YAAY,QAAQ,CAAC,IAAI,mCAAmC,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC,CAC/C,QAAmC,EACnC,OAAe,EACf,GAAW;IAEX,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM;QAC/B,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EACnC,CAAC;QACD,OAAO,CACL,IAAI,OAAO,iFAAiF;YAC5F,2CAA2C,GAAG,IAAI,OAAO,wBAAwB;YACjF,0BAA0B,GAAG,IAAI,OAAO,0BAA0B;YAClE,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,IAAI,OAAO,gDAAgD,GAAG,IAAI,OAAO,qBAAqB,CAAC;IACxG,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM;QAC/B,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EACnC,CAAC;QACD,OAAO,IAAI,OAAO,+GAA+G,CAAC;IACpI,CAAC;IACD,OAAO,IAAI,OAAO,YAAY,QAAQ,CAAC,IAAI,yDAAyD,CAAC;AACvG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CACjD,QAAmC;IAEnC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM;QAC/B,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EACnC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,OAAO;QACzB,QAAQ,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM;QAC/B,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,EACnC,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/contentful/slug-validation.d.ts

@@ -0,0 +1,7 @@
+/** RE2-compatible slug pattern (matches Contentful field validation). */
+export declare const SLUG_REGEXP_PATTERN = "^[^/]+(?:\\/[^/]+)*$";
+export declare const SLUG_VALIDATION_MESSAGE = "Slug must not start or end with /. Use one or more segments separated by / (e.g. part1, part1/part2, or part1/part2/part3). Home page slug is \"index\".";
+export declare function isSlugFieldId(fieldId: string): boolean;
+/** Returns an error message when invalid, or null when the value matches the slug format. */
+export declare function validateSlugFieldValue(value: string): string | null;
+//# sourceMappingURL=slug-validation.d.ts.map

package/dist/contentful/slug-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-validation.d.ts","sourceRoot":"","sources":["../../src/contentful/slug-validation.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAE1D,eAAO,MAAM,uBAAuB,6JACsH,CAAC;AAI3J,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKnE"}

package/dist/contentful/slug-validation.js

@@ -0,0 +1,15 @@
+/** RE2-compatible slug pattern (matches Contentful field validation). */
+export const SLUG_REGEXP_PATTERN = '^[^/]+(?:\\/[^/]+)*$';
+export const SLUG_VALIDATION_MESSAGE = 'Slug must not start or end with /. Use one or more segments separated by / (e.g. part1, part1/part2, or part1/part2/part3). Home page slug is "index".';
+const SLUG_REGEXP = new RegExp(SLUG_REGEXP_PATTERN);
+export function isSlugFieldId(fieldId) {
+    return fieldId === 'slug' || fieldId === 'indexPageSlug';
+}
+/** Returns an error message when invalid, or null when the value matches the slug format. */
+export function validateSlugFieldValue(value) {
+    if (SLUG_REGEXP.test(value)) {
+        return null;
+    }
+    return SLUG_VALIDATION_MESSAGE;
+}
+//# sourceMappingURL=slug-validation.js.map

package/dist/contentful/slug-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug-validation.js","sourceRoot":"","sources":["../../src/contentful/slug-validation.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,uBAAuB,GAClC,wJAAwJ,CAAC;AAE3J,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAEpD,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,eAAe,CAAC;AAC3D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC"}

package/dist/contentful/upload-fetch.d.ts

@@ -0,0 +1,11 @@
+export { MAX_UPLOAD_BYTES } from './upload-limits.js';
+export declare const UPLOAD_FETCH_TIMEOUT_MS = 30000;
+export interface FetchedUploadSource {
+    buffer: Buffer;
+    contentType: string | null;
+}
+/**
+ * Fetches a remote URL for asset upload with timeout and size limits.
+ */
+export declare function fetchUploadSource(url: string): Promise<FetchedUploadSource>;
+//# sourceMappingURL=upload-fetch.d.ts.map

package/dist/contentful/upload-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-fetch.d.ts","sourceRoot":"","sources":["../../src/contentful/upload-fetch.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqBjF"}

package/dist/contentful/upload-fetch.js

@@ -0,0 +1,26 @@
+import { assertUploadBufferSize, MAX_UPLOAD_BYTES, uploadSizeLimitMessage, } from './upload-limits.js';
+export { MAX_UPLOAD_BYTES } from './upload-limits.js';
+export const UPLOAD_FETCH_TIMEOUT_MS = 30_000;
+/**
+ * Fetches a remote URL for asset upload with timeout and size limits.
+ */
+export async function fetchUploadSource(url) {
+    const response = await fetch(url, { signal: AbortSignal.timeout(UPLOAD_FETCH_TIMEOUT_MS) });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch URL (${String(response.status)}): ${url}`);
+    }
+    const contentLength = response.headers.get('content-length');
+    if (contentLength) {
+        const declaredSize = Number.parseInt(contentLength, 10);
+        if (!Number.isNaN(declaredSize) && declaredSize > MAX_UPLOAD_BYTES) {
+            throw new Error(`Remote file ${uploadSizeLimitMessage(declaredSize)}`);
+        }
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    assertUploadBufferSize(buffer);
+    return {
+        buffer,
+        contentType: response.headers.get('content-type')?.split(';')[0]?.trim() ?? null,
+    };
+}
+//# sourceMappingURL=upload-fetch.js.map

package/dist/contentful/upload-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-fetch.js","sourceRoot":"","sources":["../../src/contentful/upload-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAO9C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,gBAAgB,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CAAC,eAAe,sBAAsB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE/B,OAAO;QACL,MAAM;QACN,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI;KACjF,CAAC;AACJ,CAAC"}

package/dist/contentful/upload-limits.d.ts

@@ -0,0 +1,7 @@
+/** Maximum upload size for asset sources (local file, URL, base64). */
+export declare const MAX_UPLOAD_BYTES: number;
+export declare const MAX_UPLOAD_MB: number;
+export declare function uploadSizeLimitMessage(byteLength: number): string;
+/** Throws when buffer exceeds {@link MAX_UPLOAD_BYTES}. */
+export declare function assertUploadBufferSize(buffer: Buffer): void;
+//# sourceMappingURL=upload-limits.d.ts.map

package/dist/contentful/upload-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-limits.d.ts","sourceRoot":"","sources":["../../src/contentful/upload-limits.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAEjD,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI3D"}

package/dist/contentful/upload-limits.js

@@ -0,0 +1,13 @@
+/** Maximum upload size for asset sources (local file, URL, base64). */
+export const MAX_UPLOAD_BYTES = 10 * 1024 * 1024;
+export const MAX_UPLOAD_MB = MAX_UPLOAD_BYTES / (1024 * 1024);
+export function uploadSizeLimitMessage(byteLength) {
+    return `File exceeds ${String(MAX_UPLOAD_MB)}MB limit (${String(byteLength)} bytes).`;
+}
+/** Throws when buffer exceeds {@link MAX_UPLOAD_BYTES}. */
+export function assertUploadBufferSize(buffer) {
+    if (buffer.length > MAX_UPLOAD_BYTES) {
+        throw new Error(uploadSizeLimitMessage(buffer.length));
+    }
+}
+//# sourceMappingURL=upload-limits.js.map

package/dist/contentful/upload-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-limits.js","sourceRoot":"","sources":["../../src/contentful/upload-limits.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AAE9D,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,OAAO,gBAAgB,MAAM,CAAC,aAAa,CAAC,aAAa,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;AACxF,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,IAAI,MAAM,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC"}

package/dist/contentful/write.d.ts

@@ -0,0 +1,16 @@
+import type { SessionState } from '../session/state.js';
+import type { SafeEnvironment } from './client.js';
+/**
+ * Applies all local modifications to Contentful as drafts.
+ * Never publishes. Handles optimistic locking by fetching fresh versions.
+ *
+ * Returns a list of entry IDs that were successfully saved.
+ */
+export declare function applySessionPatches(env: SafeEnvironment, session: SessionState): Promise<{
+    saved: string[];
+    failed: Array<{
+        entryId: string;
+        error: string;
+    }>;
+}>;
+//# sourceMappingURL=write.d.ts.map

package/dist/contentful/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/contentful/write.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAoDjF"}

package/dist/contentful/write.js

@@ -0,0 +1,97 @@
+import { serializeEntry } from './fetch.js';
+/**
+ * Applies all local modifications to Contentful as drafts.
+ * Never publishes. Handles optimistic locking by fetching fresh versions.
+ *
+ * Returns a list of entry IDs that were successfully saved.
+ */
+export async function applySessionPatches(env, session) {
+    const saved = [];
+    const failed = [];
+    for (const entryId of session.modifiedEntryIds) {
+        const localEntry = session.entries[entryId];
+        if (!localEntry)
+            continue;
+        try {
+            // Fetch the latest version from CMA for optimistic locking
+            const fresh = await env.getEntry(entryId);
+            // Apply our local field changes on top of the freshly fetched entry
+            mergeFields(fresh, localEntry, session.defaultLocale);
+            const updated = await env.saveDraft(fresh);
+            session.entries[entryId] = serializeEntry(updated);
+            saved.push(entryId);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            failed.push({
+                entryId,
+                error: message.includes('Version mismatch')
+                    ? `Version conflict on ${entryId} — the entry was modified by someone else. Re-open with "cms-edit open" to get the latest.`
+                    : formatContentfulError(message),
+            });
+        }
+    }
+    // Process pending deletions (only delete draft entries that aren't referenced elsewhere)
+    for (const entryId of session.pendingDeletions) {
+        try {
+            const fresh = await env.getEntry(entryId);
+            // Only delete if the entry has never been published
+            if (fresh.sys.publishedVersion) {
+                failed.push({
+                    entryId,
+                    error: `Entry ${entryId} is published and cannot be deleted via cms-edit. Unlink only — remove it manually in Contentful if needed.`,
+                });
+                continue;
+            }
+            await env.deleteEntry(entryId);
+            saved.push(entryId);
+        }
+        catch (err) {
+            failed.push({
+                entryId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return { saved, failed };
+}
+/**
+ * Attempts to parse a Contentful API error message into a human-readable summary.
+ * Contentful validation errors are JSON strings with a details.errors array.
+ * Falls back to the raw message if parsing fails.
+ */
+function formatContentfulError(message) {
+    try {
+        const parsed = JSON.parse(message);
+        const errors = parsed?.details?.errors;
+        if (Array.isArray(errors) && errors.length > 0) {
+            const lines = errors.map((e) => {
+                const path = Array.isArray(e.path) ? e.path.join('.') : (e.name ?? 'unknown');
+                const detail = e.details ?? e.name ?? 'invalid value';
+                return `  Field '${path}': ${detail}`;
+            });
+            return `Contentful validation failed:\n${lines.join('\n')}`;
+        }
+    }
+    catch {
+        // not JSON — fall through
+    }
+    return message;
+}
+/**
+ * Merges fields from a local serialized entry onto a fresh CMA entry.
+ * Only overwrites fields that differ from the original.
+ */
+function mergeFields(fresh, local, locale) {
+    for (const [fieldId, localeMap] of Object.entries(local.fields)) {
+        if (!fresh.fields[fieldId]) {
+            fresh.fields[fieldId] = {};
+        }
+        // Set the locale-specific value
+        const value = localeMap[locale] ?? localeMap['en-US'];
+        if (value !== undefined) {
+            fresh.fields[fieldId][locale] = value;
+        }
+    }
+}
+//# sourceMappingURL=write.js.map

package/dist/contentful/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/contentful/write.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAoB,EACpB,OAAqB;IAErB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAA8C,EAAE,CAAC;IAE7D,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,IAAI,CAAC;YACH,2DAA2D;YAC3D,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAE1C,oEAAoE;YACpE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;YAEtD,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;oBACzC,CAAC,CAAC,uBAAuB,OAAO,4FAA4F;oBAC5H,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC;aACnC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,yFAAyF;IACzF,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1C,oDAAoD;YACpD,IAAI,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;gBAC/B,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO;oBACP,KAAK,EAAE,SAAS,OAAO,6GAA6G;iBACrI,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,OAAO;gBACP,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAUhC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC;gBAC9E,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,eAAe,CAAC;gBACtD,OAAO,YAAY,IAAI,MAAM,MAAM,EAAE,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,OAAO,kCAAkC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,KAAiB,EAAE,KAAsB,EAAE,MAAc;IAC5E,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAChE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC7B,CAAC;QACD,gCAAgC;QAChC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,OAAO,CAA6B,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QACrE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/editor-pack/capabilities.d.ts

@@ -0,0 +1,105 @@
+import type { CmsEditProject } from '../project/types.js';
+import type { RoutingConstants } from './parse-constants.js';
+import type { RegistrationEntry } from './parse-registrations.js';
+export interface SiteCapabilities {
+    projectKey: string;
+    generatedAt: string;
+    content: {
+        pages: boolean;
+        articles: boolean;
+        persons: boolean;
+        tags: boolean;
+        navigation: boolean;
+    };
+    routing: {
+        homepageSlug: string;
+        articlesBase?: string;
+        tagsBase?: string;
+        peopleBase?: string;
+        enablePrimaryTagPartOfSlug?: boolean;
+    };
+    registrations: {
+        components: number;
+        collections: number;
+        externals: number;
+    };
+    mechanisms: {
+        scalarEdit: boolean;
+        richTextEdit: boolean;
+        batchScalar: boolean;
+        bulkRtfFindReplace: boolean;
+        createFromJson: boolean;
+        assetSearch: boolean;
+        assetUpload: boolean;
+        taxonomyImport: boolean;
+        articleTagLinks: boolean;
+        personEntries: boolean;
+        navigationEdit: boolean;
+    };
+    devTools: {
+        cmsSeoAudit: boolean;
+    };
+    website: {
+        productionSiteUrl?: string;
+        devBaseUrl?: string;
+        markdownAccess?: CmsEditProject['website']['markdownAccess'];
+    };
+    hasSiteFacts: boolean;
+    hasBrand: boolean;
+    hasPagesPlaybook: boolean;
+    hasPeoplePlaybook: boolean;
+}
+export interface EditorTaskDefinition {
+    id: string;
+    title: string;
+    resourceName: string;
+    sourceFile: string;
+    intentPhrases: string[];
+    mcpPrompt?: string;
+    isEnabled: (caps: SiteCapabilities) => boolean;
+}
+export declare const EDITOR_TASKS_DIR: string;
+export declare const EDITOR_TASK_REGISTRY: EditorTaskDefinition[];
+export declare function buildSiteCapabilities(options: {
+    project: CmsEditProject;
+    constants: RoutingConstants;
+    registrations: RegistrationEntry[];
+    repoRoot: string;
+    appDir: string;
+    hasArticlesPlaybook: boolean;
+    hasPagesPlaybook: boolean;
+    hasPeoplePlaybook: boolean;
+    hasSiteFacts: boolean;
+    hasBrand: boolean;
+    homepageSlug: string;
+}): SiteCapabilities;
+/** Whether docs/cms-editor/<projectKey>/<filename> exists. */
+export declare function hasSiteHandbook(repoRoot: string, projectKey: string, filename: string): boolean;
+/** Reads production URL from app .env.example when not set in project.json. */
+export declare function detectProductionSiteUrl(appDir: string): string | undefined;
+export declare function getEnabledTasks(caps: SiteCapabilities): EditorTaskDefinition[];
+export interface ParsedSiteTaskPlaybook {
+    title: string;
+    intentPhrases: string[];
+}
+/** Parse site-specific task playbooks in docs/cms-editor/<projectKey>/tasks/*.md */
+export declare function parseSiteTaskPlaybook(content: string): ParsedSiteTaskPlaybook;
+export declare function buildTasksIndexMarkdown(caps: SiteCapabilities, enabledTasks: EditorTaskDefinition[], siteTasks?: {
+    resourceName: string;
+    content: string;
+}[]): string;
+export declare function buildChecklistMarkdown(caps: SiteCapabilities): string;
+export declare function copyEditorTaskPlaybooks(outDir: string, enabledTasks: EditorTaskDefinition[]): void;
+export declare function findSiteContext(repoRoot: string, projectKey: string): Record<string, unknown> | null;
+export declare function findSiteFacts(repoRoot: string, projectKey: string): Record<string, unknown> | null;
+/** Site-specific task overrides from docs/cms-editor/<projectKey>/tasks/*.md */
+export declare function findSiteTaskOverrides(repoRoot: string, projectKey: string): {
+    resourceName: string;
+    content: string;
+}[];
+export declare const CUSTOMER_REQUIRED_READING: readonly ["tasks-index", "capabilities", "checklist", "overview", "routing", "production-site", "components-index"];
+export declare function buildRequiredReadingUris(resources: {
+    name: string;
+    uri: string;
+}[]): string[];
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/editor-pack/capabilities.d.ts.map

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