fail(`Empty oc:// path: ${printable(input)}`, input, "OC_PATH_EMPTY");

}

const segments = splitRespectingBrackets(pathPart, "/", input);

for (const seg of segments) {

const rawSegments = splitRespectingBrackets(pathPart, "/", input);

for (const seg of rawSegments) {

if (seg.length === 0) {

fail(`Empty segment in oc:// path: ${printable(input)}`, input, "OC_PATH_EMPTY_SEGMENT");

}

}

const fileSeg = rawSegments[0];

const file = isQuotedSeg(fileSeg) ? unquoteSeg(fileSeg) : fileSeg;

validateFileSlot(file, input);

const segments = normalizeDeepJsonPathSegments(rawSegments, file, input);

if (segments.length > 4) {

fail(`Too many segments in oc:// path (max 4): ${printable(input)}`, input, "OC_PATH_TOO_DEEP");

}

}

}

// Unquote the file slot — splitRespectingBrackets keeps a quoted file

// segment intact so its `/` isn't a slot separator; strip the quotes

// so consumers see the literal filename.

const fileSeg = segments[0];

const file = isQuotedSeg(fileSeg) ? unquoteSeg(fileSeg) : fileSeg;

validateFileSlot(file, input);

const session = extractSession(queryPart, input);

return {

file,

};

}

function isJsonPathFile(file: string): boolean {

const lower = file.toLowerCase();

return lower.endsWith(".json") || lower.endsWith(".jsonc");

}

function normalizeDeepJsonPathSegments(

segments: readonly string[],

file: string,

input: string,

): readonly string[] {

if (segments.length <= 4 || !isJsonPathFile(file)) {

return segments;

}

const pathSegments = segments.slice(1);

if (pathSegments.length > MAX_TRAVERSAL_DEPTH) {

fail(

`JSON oc:// path exceeds ${MAX_TRAVERSAL_DEPTH} nested segments: ${printable(input)}`,

input,

"OC_PATH_TOO_DEEP",

);

}

const section = pathSegments.slice(0, -2).join(".");

const item = pathSegments[pathSegments.length - 2];

const field = pathSegments[pathSegments.length - 1];

return [segments[0], section, item, field];

}

/** Format an `OcPath` struct into its canonical string form. */

export function formatOcPath(path: OcPath): string {

if (!path.file || path.file.length === 0) {