@harborclient/core 0.1.1

package/dist/scriptRefs.js

@@ -0,0 +1,387 @@
+import { DEFAULT_SCRIPT_STAGE, normalizeScriptStage, readScriptRefStage } from './scriptStage';
+/**
+ * Default display label for newly added inline scripts before the user names them.
+ */
+export const UNNAMED_SCRIPT_NAME = 'Unnamed script...';
+/**
+ * Maximum length for auto-generated script names derived from source code.
+ */
+export const SCRIPT_AUTO_NAME_MAX_LENGTH = 25;
+/**
+ * Creates a new inline script reference with a unique list id.
+ *
+ * @param code - Initial JavaScript source.
+ * @param name - Optional display label.
+ * @param stage - Stage within the phase script list.
+ * @returns A new inline {@link ScriptRef}.
+ */
+export function createInlineScriptRef(code = '', name, stage = DEFAULT_SCRIPT_STAGE) {
+    return {
+        id: crypto.randomUUID(),
+        enabled: true,
+        kind: 'inline',
+        code,
+        stage: normalizeScriptStage(stage),
+        ...(name?.trim() ? { name: name.trim() } : {})
+    };
+}
+/**
+ * Creates a new snippet reference with a unique list id.
+ *
+ * @param snippetUuid - Stable uuid of the referenced snippet.
+ * @param name - Optional display label override.
+ * @param stage - Stage within the phase script list.
+ * @returns A new snippet {@link ScriptRef}.
+ */
+export function createSnippetScriptRef(snippetUuid, name, stage = DEFAULT_SCRIPT_STAGE) {
+    return {
+        id: crypto.randomUUID(),
+        enabled: true,
+        kind: 'snippet',
+        snippetUuid: snippetUuid.trim(),
+        stage: normalizeScriptStage(stage),
+        ...(name?.trim() ? { name: name.trim() } : {})
+    };
+}
+/**
+ * Extracts a clipboard-safe payload from one script row.
+ *
+ * Snippet rows copy only the library uuid; inline rows copy code, name,
+ * enabled, and stage.
+ *
+ * @param script - Script row to copy.
+ * @returns Clipboard payload without list identity fields.
+ */
+export function copyScriptRefForClipboard(script) {
+    if (script.kind === 'snippet') {
+        return {
+            kind: 'snippet',
+            snippetUuid: script.snippetUuid?.trim() ?? ''
+        };
+    }
+    return {
+        kind: 'inline',
+        code: script.code ?? '',
+        enabled: script.enabled,
+        stage: normalizeScriptStage(readScriptRefStage(script)),
+        ...(script.name?.trim() ? { name: script.name.trim() } : {})
+    };
+}
+/**
+ * Builds a new script row from a clipboard payload.
+ *
+ * Snippet payloads resolve the live library entry by uuid. Inline payloads
+ * create a detached row with a fresh list id.
+ *
+ * @param copied - Clipboard payload from {@link copyScriptRefForClipboard}.
+ * @param snippets - Snippet library used to resolve snippet references.
+ * @returns A new script row, or null when a snippet uuid no longer exists.
+ */
+export function createScriptRefFromClipboard(copied, snippets) {
+    if (copied.kind === 'snippet') {
+        const trimmedUuid = copied.snippetUuid.trim();
+        if (!trimmedUuid) {
+            return null;
+        }
+        const snippet = snippets.find((entry) => entry.uuid === trimmedUuid);
+        if (!snippet) {
+            return null;
+        }
+        return {
+            ...createSnippetScriptRef(trimmedUuid, snippet.name, snippet.stage),
+            expanded: true
+        };
+    }
+    return {
+        ...createInlineScriptRef(copied.code, copied.name, copied.stage),
+        enabled: copied.enabled,
+        expanded: true
+    };
+}
+/**
+ * Converts an existing script row into a snippet reference without stale inline code.
+ *
+ * @param script - Script row to relink.
+ * @param snippetUuid - Saved snippet uuid to reference.
+ * @param name - Display label stored on the script row.
+ * @returns Snippet-linked {@link ScriptRef} preserving row identity fields.
+ */
+export function linkScriptRefToSnippet(script, snippetUuid, name) {
+    const trimmedUuid = snippetUuid.trim();
+    const trimmedName = name.trim();
+    return {
+        id: script.id,
+        enabled: script.enabled,
+        kind: 'snippet',
+        snippetUuid: trimmedUuid,
+        stage: normalizeScriptStage(readScriptRefStage(script)),
+        ...(typeof script.expanded === 'boolean' ? { expanded: script.expanded } : {}),
+        ...(trimmedName ? { name: trimmedName } : {})
+    };
+}
+/**
+ * Returns whether a value is a well-formed script reference object.
+ *
+ * @param value - Candidate parsed from storage or IPC.
+ * @returns True when the value matches the {@link ScriptRef} shape.
+ */
+function isScriptRef(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const record = value;
+    if (typeof record.id !== 'string' || record.id.trim() === '') {
+        return false;
+    }
+    if (typeof record.enabled !== 'boolean') {
+        return false;
+    }
+    if (record.kind !== 'inline' && record.kind !== 'snippet') {
+        return false;
+    }
+    if (record.kind === 'inline') {
+        return typeof record.code === 'string';
+    }
+    return typeof record.snippetUuid === 'string' && record.snippetUuid.trim() !== '';
+}
+/**
+ * Sanitizes script reference arrays loaded from storage or the editor.
+ *
+ * @param refs - Raw script references.
+ * @returns Valid script references with trimmed inline code and snippet uuids.
+ */
+export function normalizeScriptRefs(refs) {
+    if (!Array.isArray(refs)) {
+        return [];
+    }
+    return refs.filter(isScriptRef).map((ref) => ({
+        ...ref,
+        id: ref.id.trim(),
+        enabled: ref.enabled,
+        kind: ref.kind,
+        stage: normalizeScriptStage(readScriptRefStage(ref)),
+        ...(ref.name?.trim() ? { name: ref.name.trim() } : {}),
+        ...(typeof ref.expanded === 'boolean' ? { expanded: ref.expanded } : {}),
+        ...(ref.kind === 'inline'
+            ? { code: ref.code ?? '' }
+            : { snippetUuid: ref.snippetUuid?.trim() ?? '' })
+    }));
+}
+/**
+ * Normalizes script references for dirty-state and equality checks.
+ *
+ * Omits {@link ScriptRef.expanded}, which is editor UI state and is not
+ * persisted to storage.
+ *
+ * @param refs - Raw script references from drafts or forms.
+ * @returns Comparable script references without ephemeral UI fields.
+ */
+export function normalizeScriptRefsForCompare(refs) {
+    return normalizeScriptRefs(refs).map((ref) => {
+        const comparable = { ...ref };
+        delete comparable.expanded;
+        return comparable;
+    });
+}
+/**
+ * Resolves canonical script references, falling back to a legacy single string.
+ *
+ * @param refs - Stored script reference array, possibly empty.
+ * @param legacyScript - Legacy single-script column value.
+ * @returns Normalized script references for the editor and send pipeline.
+ */
+export function resolveScriptRefs(refs, legacyScript) {
+    const normalized = normalizeScriptRefs(refs);
+    if (normalized.length > 0) {
+        return normalized;
+    }
+    const legacy = legacyScript.trim();
+    if (!legacy) {
+        return [];
+    }
+    return [createInlineScriptRef(legacy)];
+}
+/**
+ * Parses script references from a JSON column with legacy fallback.
+ *
+ * @param raw - JSON string or already-parsed array from storage.
+ * @param legacyScript - Legacy single-script column value.
+ * @returns Resolved script references.
+ */
+export function readScriptRefsFromJson(raw, legacyScript) {
+    if (typeof raw === 'string') {
+        const trimmed = raw.trim();
+        if (!trimmed || trimmed === '[]') {
+            return resolveScriptRefs([], legacyScript);
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            return resolveScriptRefs(Array.isArray(parsed) ? parsed : [], legacyScript);
+        }
+        catch {
+            return resolveScriptRefs([], legacyScript);
+        }
+    }
+    if (Array.isArray(raw)) {
+        return resolveScriptRefs(raw, legacyScript);
+    }
+    return resolveScriptRefs([], legacyScript);
+}
+/**
+ * Serializes script references for JSON storage columns.
+ *
+ * @param refs - Script references to persist.
+ * @returns JSON string suitable for SQLite/Postgres TEXT columns.
+ */
+export function serializeScriptRefs(refs) {
+    return JSON.stringify(normalizeScriptRefs(refs));
+}
+/**
+ * Builds the legacy single-script mirror from enabled inline scripts only.
+ *
+ * Snippet references are excluded because their source is resolved at send time.
+ *
+ * @param refs - Canonical script reference array.
+ * @returns Concatenated inline script source for legacy export paths.
+ */
+export function mirrorLegacyScriptString(refs) {
+    return normalizeScriptRefs(refs)
+        .filter((ref) => ref.enabled && ref.kind === 'inline')
+        .map((ref) => (ref.code ?? '').trim())
+        .filter((code) => code.length > 0)
+        .join('\n\n');
+}
+/**
+ * Converts a legacy single-script string into a one-item inline script list.
+ *
+ * @param legacyScript - Legacy script column value.
+ * @returns Inline script references, or an empty list when blank.
+ */
+export function scriptRefsFromLegacyString(legacyScript) {
+    const trimmed = legacyScript.trim();
+    if (!trimmed) {
+        return [];
+    }
+    return [createInlineScriptRef(trimmed)];
+}
+/**
+ * Ensures at least one empty inline script exists for the script tab editor.
+ *
+ * @param refs - Current script references, possibly empty.
+ * @returns The existing list when non-empty, otherwise a single blank inline script.
+ */
+export function ensureDefaultScriptRef(refs) {
+    const normalized = normalizeScriptRefs(refs);
+    if (normalized.length > 0) {
+        return normalized;
+    }
+    return [{ ...createInlineScriptRef(''), expanded: true }];
+}
+/**
+ * Resolves JavaScript source for one script reference.
+ *
+ * @param script - Script reference entry.
+ * @param snippets - Snippet library lookup source.
+ * @returns Inline code or referenced snippet source.
+ */
+export function resolveScriptSourceCode(script, snippets) {
+    if (script.kind === 'inline') {
+        return script.code ?? '';
+    }
+    return snippets.find((entry) => entry.uuid === script.snippetUuid)?.code ?? '';
+}
+/**
+ * Derives an auto-generated script name from the first non-empty source line.
+ *
+ * @param code - JavaScript source to inspect.
+ * @returns Trimmed first line up to {@link SCRIPT_AUTO_NAME_MAX_LENGTH}, or null when empty.
+ */
+export function scriptAutoNameFromCode(code) {
+    if (!code.trim()) {
+        return null;
+    }
+    const firstLine = (code.split('\n')[0] ?? '').trim();
+    if (!firstLine) {
+        return null;
+    }
+    return firstLine.slice(0, SCRIPT_AUTO_NAME_MAX_LENGTH);
+}
+/**
+ * Renames unnamed script rows using the first line of their resolved source code.
+ *
+ * @param refs - Script references to normalize and inspect.
+ * @param snippets - Snippet library lookup source.
+ * @param unnamedLabel - Placeholder label that triggers auto-naming.
+ * @returns Script references with auto names applied where applicable.
+ */
+export function autoNameUnnamedScripts(refs, snippets, unnamedLabel = UNNAMED_SCRIPT_NAME) {
+    return normalizeScriptRefs(refs).map((ref) => {
+        if (ref.name?.trim() !== unnamedLabel) {
+            return ref;
+        }
+        const autoName = scriptAutoNameFromCode(resolveScriptSourceCode(ref, snippets));
+        if (!autoName) {
+            return ref;
+        }
+        return { ...ref, name: autoName };
+    });
+}
+/**
+ * Copies ephemeral {@link ScriptRef.expanded} from a pre-save list onto a saved list.
+ *
+ * Matches rows by id first, then by index when storage regenerates ids. Reports id
+ * changes so callers can migrate localStorage editor UI keys.
+ *
+ * @param before - Script references from the editor draft before save.
+ * @param after - Script references returned from storage after save.
+ * @returns Merged list and any id migrations detected during index fallback matching.
+ */
+export function mergeScriptRefsUiState(before, after) {
+    const previous = normalizeScriptRefs(before);
+    const saved = normalizeScriptRefs(after);
+    const beforeById = new Map(previous.map((ref) => [ref.id, ref]));
+    const idMigrations = [];
+    const consumedBeforeIds = new Set();
+    const merged = saved.map((savedRef, index) => {
+        let beforeRef = beforeById.get(savedRef.id);
+        if (beforeRef) {
+            consumedBeforeIds.add(beforeRef.id);
+        }
+        else {
+            const indexMatch = previous[index];
+            if (indexMatch && !consumedBeforeIds.has(indexMatch.id)) {
+                beforeRef = indexMatch;
+                consumedBeforeIds.add(indexMatch.id);
+                if (indexMatch.id !== savedRef.id) {
+                    idMigrations.push({ from: indexMatch.id, to: savedRef.id });
+                }
+            }
+        }
+        if (!beforeRef || typeof beforeRef.expanded !== 'boolean') {
+            return savedRef;
+        }
+        if (typeof savedRef.expanded === 'boolean') {
+            return savedRef;
+        }
+        return { ...savedRef, expanded: beforeRef.expanded };
+    });
+    return { merged, idMigrations };
+}
+/**
+ * Returns whether any enabled script references exist in the list.
+ *
+ * @param refs - Script references to inspect.
+ * @returns True when at least one enabled inline or snippet reference is present.
+ */
+export function hasScriptContent(refs) {
+    return normalizeScriptRefs(refs).some((ref) => {
+        if (!ref.enabled) {
+            return false;
+        }
+        if (ref.kind === 'snippet') {
+            return Boolean(ref.snippetUuid?.trim());
+        }
+        return Boolean((ref.code ?? '').trim());
+    });
+}
+//# sourceMappingURL=scriptRefs.js.map

package/dist/scriptRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptRefs.js","sourceRoot":"","sources":["../src/scriptRefs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE/F;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAI,GAAG,EAAE,EACT,IAAa,EACb,KAAK,GAAG,oBAAoB;IAE5B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,IAAI;QACJ,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC;QAClC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,IAAa,EACb,KAAK,GAAG,oBAAoB;IAE5B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC;QAClC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvD,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAuB,EACvB,QAAmB;IAEnB,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,GAAG,sBAAsB,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;YACnE,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC;QAChE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,WAAmB,EACnB,IAAY;IAEZ,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAEhC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,WAAW;QACxB,KAAK,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACvD,GAAG,CAAC,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;IACzC,CAAC;IACD,OAAO,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AACpF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoC;IACtE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5C,GAAG,GAAG;QACN,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE;QACjB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,oBAAoB,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACpD,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ;YACvB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE;YAC1B,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;KACpD,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAoC;IAChF,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3C,MAAM,UAAU,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAC,QAAQ,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAoC,EACpC,YAAoB;IAEpB,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAY,EAAE,YAAoB;IACvE,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACjC,OAAO,iBAAiB,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,OAAO,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAsB,CAAC,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC/F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,iBAAiB,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,iBAAiB,CAAC,GAAkB,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,iBAAiB,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAoC;IACtE,OAAO,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAoC;IAC3E,OAAO,mBAAmB,CAAC,IAAI,CAAC;SAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACrC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAC7D,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAoC;IACzE,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,CAAC,EAAE,GAAG,qBAAqB,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,QAAmB;IAC5E,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAoC,EACpC,QAAmB,EACnB,eAAuB,mBAAmB;IAE1C,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3C,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,YAAY,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,QAAQ,GAAG,sBAAsB,CAAC,uBAAuB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC;QAED,OAAO,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAgCD;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAsC,EACtC,KAAqC;IAErC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC3C,IAAI,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,SAAS,EAAE,CAAC;YACd,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,UAAU,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxD,SAAS,GAAG,UAAU,CAAC;gBACvB,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,UAAU,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,EAAE,CAAC;oBAClC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC1D,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAoC;IACnE,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAC5C,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/scriptStage.d.ts

@@ -0,0 +1,118 @@
+import type { ScriptStage } from '@harborclient/sdk';
+/**
+ * Default stage for script rows and snippets without an explicit stage.
+ */
+export declare const DEFAULT_SCRIPT_STAGE: ScriptStage;
+/**
+ * Select options for script stage fields in editors and modals.
+ */
+export declare const SCRIPT_STAGE_OPTIONS: {
+    value: ScriptStage;
+    label: string;
+}[];
+/**
+ * Visual and drag-reorder grouping for script stages in the script list editor.
+ */
+export type ScriptEditorGroup = 'before' | 'main' | 'after';
+/**
+ * Visible section headings for each editor script group.
+ */
+export declare const SCRIPT_EDITOR_GROUP_HEADINGS: Record<ScriptEditorGroup, string>;
+/**
+ * Returns whether the script list editor should show Before/Main/After section headings.
+ *
+ * Headings appear only when scripts span two or more non-empty groups.
+ *
+ * @param groups - Before, main, and after script groups from the editor.
+ * @returns True when multiple non-empty groups should show section labels.
+ */
+export declare function shouldShowScriptSectionHeadings(groups: {
+    before: unknown[];
+    main: unknown[];
+    after: unknown[];
+}): boolean;
+/**
+ * Maps a script stage to its editor list group.
+ *
+ * @param stage - Script execution stage.
+ * @returns Group used for the three-list script editor layout.
+ */
+export declare function scriptStageGroup(stage: ScriptStage): ScriptEditorGroup;
+/**
+ * Coerces an unknown value to a valid script stage.
+ *
+ * @param value - Raw stage from storage or IPC.
+ * @returns Valid stage, defaulting to {@link DEFAULT_SCRIPT_STAGE} for legacy rows.
+ */
+export declare function normalizeScriptStage(value: unknown): ScriptStage;
+/**
+ * Returns the display label for a script stage.
+ *
+ * @param stage - Script execution stage.
+ * @returns Human-readable label for selects and listings.
+ */
+export declare function scriptStageLabel(stage: ScriptStage): string;
+/**
+ * Returns the display-only suffix appended to script row titles in the list editor.
+ *
+ * Not persisted on {@link ScriptRef} names — only clarifies timing for before/after stages.
+ *
+ * @param stage - Script execution stage.
+ * @returns Title-case suffix such as ` (Before Each)`, or an empty string for `main`.
+ */
+export declare function scriptRowStageSuffix(stage: ScriptStage): string;
+/**
+ * Returns the theme CSS variable for a script row's stage-colored left border.
+ *
+ * @param stage - Script execution stage.
+ * @returns `var(--mac-script-stage-*)` token for inline border styling.
+ */
+export declare function scriptStageBorderColor(stage: ScriptStage): string;
+/**
+ * Reorders script references into execution order for one phase list.
+ *
+ * Order: all `before-all`, then for each `main` script all `before-each`, the main
+ * script, and all `after-each`, then all `after-all`. Relative order within each
+ * stage is preserved from the stored list.
+ *
+ * @param refs - Normalized script references for one phase.
+ * @returns References ordered for send-time execution.
+ */
+export declare function orderScriptRefsByStage<T extends {
+    stage?: ScriptStage;
+}>(refs: T[]): T[];
+/**
+ * Splits script references into the three editor groups while preserving list order.
+ *
+ * @param refs - Normalized script references for one phase.
+ * @returns Before, main, and after groups for the script list editor.
+ */
+export declare function splitScriptRefsByGroup<T extends {
+    stage?: ScriptStage;
+}>(refs: T[]): {
+    before: T[];
+    main: T[];
+    after: T[];
+};
+/**
+ * Concatenates editor groups back into canonical stored order.
+ *
+ * @param groups - Before, main, and after script groups from the editor.
+ * @returns Combined script reference list for persistence.
+ */
+export declare function mergeScriptRefGroups<T>(groups: {
+    before: T[];
+    main: T[];
+    after: T[];
+}): T[];
+/**
+ * Reads a script reference stage, accepting legacy `role` JSON keys.
+ *
+ * @param ref - Script reference or legacy-shaped object from storage.
+ * @returns Normalized script stage.
+ */
+export declare function readScriptRefStage(ref: {
+    stage?: ScriptStage;
+    role?: unknown;
+}): ScriptStage;
+//# sourceMappingURL=scriptStage.d.ts.map

package/dist/scriptStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptStage.d.ts","sourceRoot":"","sources":["../src/scriptStage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAoB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAMvE,CAAC;AAIF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAI1E,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB,GAAG,OAAO,CAMV;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAQtE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAKhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAa/D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAajE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAwCxF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,EACtE,IAAI,EAAE,CAAC,EAAE,GACR;IAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,CAiBxC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,CAAA;CAAE,GAAG,CAAC,EAAE,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CAE5F"}