AniNote.jsx

// AniNote
// Layer Notes Panel for Adobe After Effects 2025
// Notes stored as named Checkbox Controls visible in ECP, travel with .ffx presets
// Place in: AE 2025/Support Files/Scripts/ScriptUI Panels/
// Made by Moongetsu for SAKU.XV

(function NotelyPanel(thisObj) {
    var SCRIPT_NAME   = "AniNote";
    var FX_MATCH      = "ADBE Checkbox Control";
    var NOTELY_EXPR   = "//notely";
    var STAMP_PREFIX  = "//stamp:";
    var EMPTY_NAME    = " ";
    var MAX_LINE_LEN  = 200;

    var panel = (thisObj instanceof Panel)
        ? thisObj
        : new Window("palette", SCRIPT_NAME, undefined, { resizeable: true });

    panel.orientation = "column";
    panel.alignChildren = ["fill", "fill"];
    panel.margins = [5, 5, 5, 5];
    panel.spacing = 2;

    var darkBg = panel.graphics.newBrush(panel.graphics.BrushType.SOLID_COLOR, [0.176, 0.176, 0.176, 1]);
    panel.graphics.backgroundColor = darkBg;
    var headerGroup = panel.add("group");
    headerGroup.orientation = "row";
    headerGroup.alignChildren = ["fill", "center"];
    headerGroup.alignment = ["fill", "top"];

    var titleText = headerGroup.add("statictext", undefined, SCRIPT_NAME);
    titleText.alignment = ["left", "center"];
    titleText.graphics.font = ScriptUI.newFont(
        titleText.graphics.font.name, ScriptUI.FontStyle.BOLD, 14
    );
    titleText.graphics.foregroundColor = titleText.graphics.newPen(
        titleText.graphics.PenType.SOLID_COLOR, [0.9, 0.9, 0.9, 1], 1
    );

    var noteCountText = headerGroup.add("statictext", undefined, "");
    noteCountText.alignment = ["fill", "center"];
    noteCountText.graphics.foregroundColor = noteCountText.graphics.newPen(
        noteCountText.graphics.PenType.SOLID_COLOR, [0.45, 0.45, 0.45, 1], 1
    );

    var refreshBtn = headerGroup.add("button", undefined, "⟳");
    refreshBtn.preferredSize = [22, 20];
    refreshBtn.alignment = ["right", "center"];
    refreshBtn.helpTip = "Refresh";
    var tabs = panel.add("tabbedpanel");
    tabs.alignment = ["fill", "fill"];

    var noteTab = tabs.add("tab", undefined, "Note");
    noteTab.orientation = "column";
    noteTab.alignChildren = ["fill", "top"];
    noteTab.spacing = 2;
    noteTab.margins = [2, 3, 2, 2];

    var layerNavGroup = noteTab.add("group");
    layerNavGroup.orientation = "row";
    layerNavGroup.alignChildren = ["fill", "center"];
    layerNavGroup.alignment = ["fill", "top"];
    layerNavGroup.spacing = 2;

    var layerInfoText = layerNavGroup.add("statictext", undefined, "No composition open");
    layerInfoText.alignment = ["fill", "center"];
    layerInfoText.graphics.foregroundColor = layerInfoText.graphics.newPen(
        layerInfoText.graphics.PenType.SOLID_COLOR, [0.6, 0.6, 0.6, 1], 1
    );

    var prevNoteBtn = layerNavGroup.add("button", undefined, "◀");
    var nextNoteBtn = layerNavGroup.add("button", undefined, "▶");
    prevNoteBtn.preferredSize = [22, 20];
    nextNoteBtn.preferredSize = [22, 20];
    prevNoteBtn.helpTip = "Previous layer with a note";
    nextNoteBtn.helpTip = "Next layer with a note";
    prevNoteBtn.enabled = false;
    nextNoteBtn.enabled = false;

    var titleEdit = noteTab.add("edittext", undefined, "");
    titleEdit.preferredSize = [260, 22];
    titleEdit.alignment = ["fill", "top"];
    titleEdit.helpTip = "Note title (appears as effect name in Effects panel)";

    var noteEdit = noteTab.add("edittext", undefined, "", { multiline: true, wantReturn: true });
    noteEdit.preferredSize = [260, 155];
    noteEdit.alignment = ["fill", "fill"];
    noteEdit.helpTip = "Description text (multi-line)";

    var footerGroup = noteTab.add("group");
    footerGroup.orientation = "row";
    footerGroup.alignChildren = ["fill", "center"];
    footerGroup.alignment = ["fill", "top"];
    footerGroup.spacing = 2;

    var charCount = footerGroup.add("statictext", undefined, "");
    charCount.preferredSize = [120, -1];
    charCount.alignment = ["left", "center"];
    charCount.graphics.foregroundColor = charCount.graphics.newPen(
        charCount.graphics.PenType.SOLID_COLOR, [0.5, 0.5, 0.5, 1], 1
    );

    var copyBtn  = footerGroup.add("button", undefined, "Copy");
    var clearBtn = footerGroup.add("button", undefined, "Clear");
    var saveBtn  = footerGroup.add("button", undefined, "Save");
    copyBtn.preferredSize  = [40, 20];
    clearBtn.preferredSize = [40, 20];
    saveBtn.preferredSize  = [40, 20];
    copyBtn.helpTip  = "Copy note text to clipboard";
    clearBtn.helpTip = "Remove all Notely effects from this layer";
    saveBtn.helpTip  = "Save note (Ctrl/Cmd+S)";

    var ovTab = tabs.add("tab", undefined, "Overview");
    ovTab.orientation = "column";
    ovTab.alignChildren = ["fill", "top"];
    ovTab.spacing = 2;
    ovTab.margins = [2, 3, 2, 2];

    var searchGroup = ovTab.add("group");
    searchGroup.orientation = "row";
    searchGroup.alignChildren = ["fill", "center"];
    searchGroup.alignment = ["fill", "top"];
    searchGroup.spacing = 2;

    var searchInput = searchGroup.add("edittext", undefined, "");
    searchInput.preferredSize = [-1, 22];
    searchInput.alignment = ["fill", "center"];
    searchInput.helpTip = "Filter by layer name or note content";

    var searchBtn      = searchGroup.add("button", undefined, "Find");
    var clearSearchBtn = searchGroup.add("button", undefined, "×");
    searchBtn.preferredSize      = [32, 20];
    clearSearchBtn.preferredSize = [18, 20];
    clearSearchBtn.helpTip = "Clear search";

    var layerList = ovTab.add("listbox", undefined, [], {
        numberOfColumns: 2,
        showHeaders: true,
        columnTitles: ["Layer", "Note"],
        columnWidths: [110, 140]
    });
    layerList.preferredSize = [260, 165];
    layerList.alignment = ["fill", "fill"];
    layerList.helpTip = "Click to select layer  |  Double-click to edit note";

    var ovFooterGroup = ovTab.add("group");
    ovFooterGroup.orientation = "row";
    ovFooterGroup.alignChildren = ["fill", "center"];
    ovFooterGroup.alignment = ["fill", "top"];
    ovFooterGroup.spacing = 4;

    var deleteNoteBtn = ovFooterGroup.add("button", undefined, "✕ Delete Note");
    deleteNoteBtn.preferredSize = [-1, 22];
    deleteNoteBtn.alignment = ["fill", "center"];
    deleteNoteBtn.helpTip = "Remove note from selected layer";
    deleteNoteBtn.enabled = false;

    var exportBtn = ovFooterGroup.add("button", undefined, "Export .txt");
    exportBtn.preferredSize = [-1, 22];
    exportBtn.alignment = ["fill", "center"];

    tabs.selection = noteTab;

    function activeComp() {
        try {
            var item = app.project.activeItem;
            return (item && item instanceof CompItem) ? item : null;
        } catch (e) { return null; }
    }

    function activeLayer() {
        try {
            var comp = activeComp();
            if (!comp) return null;
            var sel = comp.selectedLayers;
            if (sel.length !== 1) return null;
            return (sel[0] instanceof AVLayer) ? sel[0] : null;
        } catch (e) { return null; }
    }

    function getLayerKey(layer) {
        try { return layer.containingComp.name + "|" + layer.index; }
        catch (e) { return null; }
    }

    function isNotelyFx(fx) {
        try {
            if (fx.matchName !== FX_MATCH) return false;
            var prop = fx.property(1);
            return prop.expressionEnabled &&
                   prop.expression.indexOf(NOTELY_EXPR) === 0;
        } catch (e) { return false; }
    }

    function findLineEffects(layer) {
        var out = [];
        try {
            for (var i = 1; i <= layer.Effects.numProperties; i++) {
                var fx = layer.Effects.property(i);
                if (isNotelyFx(fx)) out.push(fx);
            }
        } catch (e) {}
        return out;
    }

    function readNote(layer) {
        var fxArr = findLineEffects(layer);
        if (!fxArr.length) return "";
        try {
            var expr  = fxArr[0].property(1).expression;
            var start = expr.indexOf("\n");
            if (start < 0) return "";
            start++;
            if (expr.indexOf(STAMP_PREFIX, start) === start) {
                var nl = expr.indexOf("\n", start);
                start  = (nl >= 0) ? nl + 1 : expr.length;
            }
            var content = expr.substring(start);
            if (content.slice(-2) === "\n0") content = content.slice(0, -2);
            else if (content === "0")        return "";
            var dLines = content.split("\n");
            for (var i = 0; i < dLines.length; i++) {
                if (dLines[i].indexOf("//") === 0) dLines[i] = dLines[i].substring(2);
            }
            return dLines.join("\n");
        } catch (e) { return ""; }
    }

    function readNoteTitle(layer) {
        var fxArr = findLineEffects(layer);
        if (!fxArr.length) return "";
        return fxArr[0].name === EMPTY_NAME ? "" : fxArr[0].name;
    }

    function readTimestamp(layer) {
        var fxArr = findLineEffects(layer);
        if (!fxArr.length) return null;
        try {
            var lines = fxArr[0].property(1).expression.split("\n");
            for (var i = 0; i < lines.length; i++) {
                if (lines[i].indexOf(STAMP_PREFIX) === 0)
                    return lines[i].substring(STAMP_PREFIX.length);
            }
        } catch (e) {}
        return null;
    }

    function removeLineEffects(layer) {
        var fxArr = findLineEffects(layer);
        for (var i = fxArr.length - 1; i >= 0; i--) {
            try { fxArr[i].remove(); } catch (e) {}
        }
    }

    function truncate(s, max) {
        return s.length <= max ? s : s.substring(0, max - 3) + "...";
    }

    function getDateString() {
        var d   = new Date();
        var m   = ("0" + (d.getMonth() + 1)).slice(-2);
        var day = ("0" + d.getDate()).slice(-2);
        return d.getFullYear() + "-" + m + "-" + day;
    }

    function checkLineLengths(text) {
        var lines = text.split("\n");
        for (var i = 0; i < lines.length; i++) {
            if (lines[i].length > MAX_LINE_LEN) return i + 1;
        }
        return 0;
    }

    function getNotedLayerIndices() {
        var comp = activeComp();
        if (!comp) return [];
        var result = [];
        for (var i = 1; i <= comp.numLayers; i++) {
            try {
                var layer = comp.layer(i);
                if (layer instanceof AVLayer && findLineEffects(layer).length > 0)
                    result.push(i);
            } catch (e) {}
        }
        return result;
    }

    function updateNoteCount() {
        var indices = getNotedLayerIndices();
        noteCountText.text = indices.length ? indices.length + " notes" : "";
        prevNoteBtn.enabled = indices.length > 0;
        nextNoteBtn.enabled = indices.length > 0;
    }

    function navigateNote(direction) {
        var comp = activeComp();
        if (!comp) return;
        var indices = getNotedLayerIndices();
        if (!indices.length) return;
        var layer   = activeLayer();
        var current = layer ? layer.index : -1;
        var target  = -1;

        if (direction === "next") {
            for (var i = 0; i < indices.length; i++) {
                if (indices[i] > current) { target = indices[i]; break; }
            }
            if (target === -1) target = indices[0];
        } else {
            for (var i = indices.length - 1; i >= 0; i--) {
                if (indices[i] < current) { target = indices[i]; break; }
            }
            if (target === -1) target = indices[indices.length - 1];
        }

        try {
            for (var i = 1; i <= comp.numLayers; i++) comp.layer(i).selected = false;
            comp.layer(target).selected = true;
            _prevLayerKey = null;
            refreshPanel();
            titleEdit.active = true;
        } catch (e) {}
    }

    var _prevLayerKey = null;
    var _prevLayerRef = null;
    var _isDirty      = false;
    var _overviewData = [];

    function _writeToLayer(layer, title, desc) {
        try { if (layer.locked) return false; } catch (e) { return false; }
        var date = getDateString();

        app.beginUndoGroup(SCRIPT_NAME + ": Save Note");
        try {
            removeLineEffects(layer);
            if (!title && !desc) { return date; }

            var fx  = layer.Effects.addProperty(FX_MATCH);
            fx.name = title || EMPTY_NAME;

            var expr = NOTELY_EXPR + "\n" + STAMP_PREFIX + date + "\n";
            if (desc) {
                var descLines = desc.split("\n");
                for (var i = 0; i < descLines.length; i++) {
                    expr += "//" + descLines[i] + "\n";
                }
            }
            expr += "0";

            fx.property(1).expression        = expr;
            fx.property(1).expressionEnabled = true;

            return date;
        } catch (e) {
            return false;
        } finally {
            app.endUndoGroup();
        }
    }

    function refreshPanel() {
        var comp  = activeComp();
        var layer = activeLayer();
        var key   = layer ? getLayerKey(layer) : null;
        var layerChanged = (key !== _prevLayerKey);

        if (layerChanged && _isDirty && _prevLayerRef) {
            try { _writeToLayer(_prevLayerRef, titleEdit.text, noteEdit.text); } catch (e) {}
            _isDirty = false;
        }

        if (!comp) {
            layerInfoText.text = "No composition open";
            if (layerChanged) {
                titleEdit.text = "";
                noteEdit.text = "";
                titleEdit.enabled = false;
                noteEdit.enabled = false;
                saveBtn.enabled = clearBtn.enabled = copyBtn.enabled = false;
                charCount.text = "";
            }
            _prevLayerKey = null;
            _prevLayerRef = null;
            return;
        }

        if (!layer) {
            var sel = comp.selectedLayers;
            layerInfoText.text = (sel.length > 1)
                ? "Select a single layer (" + sel.length + " selected)"
                : "No layer selected";
            if (layerChanged) {
                titleEdit.text = "";
                noteEdit.text = "";
                titleEdit.enabled = false;
                noteEdit.enabled = false;
                saveBtn.enabled = clearBtn.enabled = copyBtn.enabled = false;
                charCount.text = "";
            }
            _prevLayerKey = null;
            _prevLayerRef = null;
            return;
        }

        layerInfoText.text = "Layer: " + truncate(layer.name, 55);

        if (layerChanged) {
            var note  = readNote(layer);
            var title = readNoteTitle(layer);
            var stamp = readTimestamp(layer);
            titleEdit.text    = title;
            noteEdit.text     = note;
            titleEdit.enabled = true;
            noteEdit.enabled  = true;
            saveBtn.enabled   = true;
            copyBtn.enabled   = true;
            clearBtn.enabled  = findLineEffects(layer).length > 0;
            charCount.text    = (note ? note.length : 0) + " chars" +
                                (stamp ? " · " + stamp : "");
            _isDirty      = false;
            _prevLayerKey = key;
            _prevLayerRef = layer;
            updateNoteCount();
        }
    }

    function refreshOverview(filterText) {
        var comp = activeComp();
        _overviewData = [];
        layerList.removeAll();
        if (!comp) return;

        var query = (filterText || "").toLowerCase();

        for (var i = 1; i <= comp.numLayers; i++) {
            var layer;
            try { layer = comp.layer(i); } catch (e) { continue; }
            if (!(layer instanceof AVLayer)) continue;
            if (findLineEffects(layer).length === 0) continue;

            var title = readNoteTitle(layer);
            var note  = readNote(layer);
            var lines = note.split("\n");
            var firstLine = "";
            for (var j = 0; j < lines.length; j++) {
                if (lines[j].replace(/\s+/g, "")) { firstLine = lines[j]; break; }
            }

            if (query) {
                var nameHit  = layer.name.toLowerCase().indexOf(query) >= 0;
                var titleHit = title.toLowerCase().indexOf(query) >= 0;
                var noteHit  = note.toLowerCase().indexOf(query) >= 0;
                if (!nameHit && !titleHit && !noteHit) continue;
            }

            _overviewData.push({ layerIndex: i, title: title, note: note });
            var item = layerList.add("item", truncate(layer.name, 18));
            item.subItems[0].text = truncate(title || firstLine || "(empty)", 22);
        }

        if (_overviewData.length === 0 && query) {
            layerList.add("item", "No results");
        }
    }

    function saveNote() {
        var layer = activeLayer();
        if (!layer) return refreshPanel();

        try {
            if (layer.locked) {
                alert("Layer '" + layer.name + "' is locked.", SCRIPT_NAME);
                return;
            }
        } catch (e) {}

        var longLine = checkLineLengths(titleEdit.text);
        if (longLine) {
            var ok = confirm(
                "Line " + longLine + " exceeds " + MAX_LINE_LEN + " characters.\n" +
                "AE may truncate long property names. Save anyway?",
                false, SCRIPT_NAME
            );
            if (!ok) return;
        }

        var date = _writeToLayer(layer, titleEdit.text, noteEdit.text);
        if (date === false) {
            alert("Failed to save note.", SCRIPT_NAME);
            return;
        }

        _isDirty         = false;
        clearBtn.enabled = true;
        charCount.text   = noteEdit.text.length + " chars · saved " + date;
        updateNoteCount();
    }

    function clearNote() {
        var layer = activeLayer();
        if (!layer) return refreshPanel();

        try {
            if (layer.locked) {
                alert("Layer '" + layer.name + "' is locked.", SCRIPT_NAME);
                return;
            }
        } catch (e) {}

        app.beginUndoGroup(SCRIPT_NAME + ": Clear Note");
        try {
            removeLineEffects(layer);
            titleEdit.text   = "";
            noteEdit.text    = "";
            _isDirty         = false;
            clearBtn.enabled = false;
            charCount.text   = "0 chars · cleared";
            updateNoteCount();
        } catch (e) {
            alert("Failed to clear:\n" + e.toString(), SCRIPT_NAME);
        } finally {
            app.endUndoGroup();
        }
    }

    function copyNote() {
        var text = noteEdit.text;
        if (!text) return;
        try {
            app.clipBoard = text;
            charCount.text = text.length + " chars · copied";
        } catch (e) {
            prompt("Copy note text:", text);
        }
    }

    function exportNotes() {
        var comp = activeComp();
        if (!comp) { alert("No composition open.", SCRIPT_NAME); return; }

        var out   = "AniNote Export\n";
        out += "Composition: " + comp.name + "\n";
        out += "Date: " + getDateString() + "\n";
        out += "========================================\n\n";

        var found = 0;
        for (var i = 1; i <= comp.numLayers; i++) {
            var layer;
            try { layer = comp.layer(i); } catch (e) { continue; }
            if (!(layer instanceof AVLayer)) continue;
            if (findLineEffects(layer).length === 0) continue;

            out += "Layer " + i + ": " + layer.name + "\n";
            var title = readNoteTitle(layer);
            var note  = readNote(layer);
            if (title) out += "Title: " + title + "\n";
            if (note)  out += "Description:\n" + note + "\n";
            out += "\n";
            found++;
        }

        if (!found) { alert("No notes found in this composition.", SCRIPT_NAME); return; }

        var file = File.saveDialog("Export notes", "Text files:*.txt");
        if (!file) return;

        try {
            file.encoding = "UTF-8";
            file.open("w");
            file.write(out);
            file.close();
            charCount.text = "Exported " + found + " note(s)";
            tabs.selection = noteTab;
        } catch (e) {
            alert("Export failed:\n" + e.toString(), SCRIPT_NAME);
        }
    }

    prevNoteBtn.onClick = function() { navigateNote("prev"); };
    nextNoteBtn.onClick = function() { navigateNote("next"); };

    saveBtn.onClick   = function() { saveNote();  noteEdit.active = true; };
    clearBtn.onClick  = function() { clearNote(); noteEdit.active = true; };
    copyBtn.onClick   = function() { copyNote();  noteEdit.active = true; };
    exportBtn.onClick = function() { exportNotes(); searchInput.active = true; };

    deleteNoteBtn.onClick = function() {
        var sel = layerList.selection;
        if (!sel || !_overviewData[sel.index]) return;
        var comp = activeComp();
        if (!comp) return;
        try {
            var layer = comp.layer(_overviewData[sel.index].layerIndex);
            if (layer.locked) {
                alert("Layer '" + layer.name + "' is locked.", SCRIPT_NAME);
                return;
            }
            app.beginUndoGroup(SCRIPT_NAME + ": Clear Note");
            removeLineEffects(layer);
            app.endUndoGroup();
        } catch (e) {}
        deleteNoteBtn.enabled = false;
        refreshOverview(searchInput.text);
        searchInput.active = true;
    };

    refreshBtn.onClick = function() {
        if (tabs.selection === ovTab) {
            refreshOverview(searchInput.text);
            searchInput.active = true;
        } else {
            refreshPanel();
            noteEdit.active = true;
        }
    };

    noteEdit.onChanging = function() {
        _isDirty = true;
        charCount.text = noteEdit.text.length + " chars*";
    };

    titleEdit.onChanging = function() {
        _isDirty = true;
    };

    searchBtn.onClick = function() { refreshOverview(searchInput.text); searchInput.active = true; };
    clearSearchBtn.onClick = function() { searchInput.text = ""; refreshOverview(""); searchInput.active = true; };
    searchInput.addEventListener("keydown", function(e) {
        if (e.keyName === "Enter") refreshOverview(searchInput.text);
    });

    layerList.onChange = function() {
        var sel = layerList.selection;
        deleteNoteBtn.enabled = !!(sel && _overviewData[sel.index]);
        if (!sel || !_overviewData[sel.index]) return;
        var comp = activeComp();
        if (!comp) return;
        try {
            var idx = _overviewData[sel.index].layerIndex;
            for (var i = 1; i <= comp.numLayers; i++) comp.layer(i).selected = false;
            comp.layer(idx).selected = true;
        } catch (e) {}
    };

    layerList.onDoubleClick = function() {
        var sel = layerList.selection;
        if (!sel || !_overviewData[sel.index]) return;
        var comp = activeComp();
        if (!comp) return;
        try {
            var idx = _overviewData[sel.index].layerIndex;
            for (var i = 1; i <= comp.numLayers; i++) comp.layer(i).selected = false;
            comp.layer(idx).selected = true;
            tabs.selection = noteTab;
            refreshPanel();
        } catch (e) {}
    };

    tabs.onChange = function() {
        if (tabs.selection === ovTab) refreshOverview(searchInput.text);
    };

    panel.onShow = function() { refreshPanel(); };

    panel.addEventListener("keydown", function(event) {
        if ((event.ctrlKey || event.metaKey) && event.keyName === "s") {
            event.preventDefault();
            saveNote();
        }
    });

    var _taskId = -1;
    try {
        if (typeof app.scheduleTask === "function") {
            _taskId = app.scheduleTask("AniNotePanel_refresh()", 2000, 2000);
        }
    } catch (e) {}

    $.global.AniNotePanel_refresh = function() {
        try {
            if (tabs.selection !== ovTab) refreshPanel();
        } catch (e) {}
    };

    panel.onClose = function() {
        try {
            if (_taskId >= 0) app.cancelTask(_taskId);
            delete $.global.AniNotePanel_refresh;
        } catch (e) {}
    };

    panel.onResizing = panel.onResize = function() { panel.layout.resize(); };
    panel.layout.layout(true);
    refreshPanel();

    if (panel instanceof Window) {
        panel.center();
        panel.show();
    } else {
        panel.layout.layout(true);
    }

})(this);