asecli 0.6.2__py3-none-any.whl

asecli/bridge/resources/asecli_material_gui.authoring.part00.cs.txt

@@ -0,0 +1,238 @@
+
+#if UNITY_EDITOR
+namespace ASECLI.MaterialGUI.Authoring
+{
+    using System;
+    using System.Collections;
+    using System.Collections.Generic;
+    using System.Globalization;
+    using System.Reflection;
+    using System.Text;
+    using System.Text.RegularExpressions;
+    using UnityEditor;
+    using UnityEngine;
+
+    // Clean-room ASE integration. It uses the public Custom Attributes storage
+    // through a capability-checked reflection adapter and never patches ASE source.
+    public sealed class ASECLIGUIAttributesWindow : EditorWindow
+    {
+        private UnityEngine.Object selectedNode;
+        private string nodeLabel = String.Empty;
+        private string aseVersion = "unknown";
+        private string adapterError = String.Empty;
+        private bool useFoldout;
+        private bool useTooltip;
+        private bool useHelpBox;
+        private bool useEnabledIf;
+        private bool assignFallbackEditor = true;
+        private string foldout = String.Empty;
+        private string tooltip = String.Empty;
+        private string helpBox = String.Empty;
+        private string enabledIfProperty = String.Empty;
+        private int enabledIfOperatorIndex = 2;
+        private float enabledIfValue = 1f;
+        private Vector2 scroll;
+        [MenuItem("Window/Amplify Shader Editor/MZGUI Attributes (ASECLI)")]
+        public static void Open()
+        {
+            ASECLIGUIAttributesWindow window = GetWindow<ASECLIGUIAttributesWindow>();
+            window.titleContent = new GUIContent("MZGUI Attributes");
+            window.minSize = new Vector2(340f, 360f);
+            window.Show();
+        }
+
+        private void OnEnable() { EditorApplication.update += TrackSelection; }
+        private void OnDisable() { EditorApplication.update -= TrackSelection; }
+
+        private void TrackSelection()
+        {
+            UnityEngine.Object node;
+            string label;
+            string version;
+            string error;
+            if (!ASEReflection.TrySelectedProperty(out node, out label, out version, out error))
+            {
+                if (selectedNode != null || adapterError != error)
+                {
+                    selectedNode = null;
+                    adapterError = error;
+                    aseVersion = version;
+                    Repaint();
+                }
+                return;
+            }
+            if (node == selectedNode)
+                return;
+            selectedNode = node;
+            nodeLabel = label;
+            aseVersion = version;
+            adapterError = String.Empty;
+            LoadValues();
+            Repaint();
+        }
+
+        private void OnGUI()
+        {
+            EditorGUILayout.LabelField("ASE GUI 属性", EditorStyles.boldLabel);
+            EditorGUILayout.LabelField("ASE 版本", aseVersion);
+            GUILayout.Label(
+                "选择一个 ASE Property 节点后，在这里直接编辑兼容 MZGUI 的 Foldout、Tooltip 和 HelpBox。",
+                EditorStyles.wordWrappedLabel);
+            if (selectedNode == null)
+            {
+                GUILayout.Label(
+                    String.IsNullOrEmpty(adapterError) ? "请打开 ASE 并选择一个 Property 节点。" : adapterError,
+                    EditorStyles.wordWrappedLabel);
+                if (GUILayout.Button("重新检测")) TrackSelection();
+                return;
+            }
+
+            EditorGUILayout.LabelField("当前属性", nodeLabel);
+            scroll = EditorGUILayout.BeginScrollView(scroll);
+            useFoldout = EditorGUILayout.ToggleLeft("Foldout", useFoldout);
+            using (new EditorGUI.DisabledScope(!useFoldout))
+                foldout = EditorGUILayout.TextField("分组标题", foldout);
+            EditorGUILayout.Space(8f);
+            useTooltip = EditorGUILayout.ToggleLeft("Tooltip", useTooltip);
+            using (new EditorGUI.DisabledScope(!useTooltip))
+                tooltip = EditorGUILayout.TextArea(tooltip, GUILayout.MinHeight(64f));
+            EditorGUILayout.Space(8f);
+            useHelpBox = EditorGUILayout.ToggleLeft("HelpBox", useHelpBox);
+            using (new EditorGUI.DisabledScope(!useHelpBox))
+                helpBox = EditorGUILayout.TextArea(helpBox, GUILayout.MinHeight(80f));
+            EditorGUILayout.Space(8f);
+            useEnabledIf = EditorGUILayout.ToggleLeft(
+                "条件启用（不满足时置灰）", useEnabledIf);
+            using (new EditorGUI.DisabledScope(!useEnabledIf))
+            {
+                enabledIfProperty = EditorGUILayout.TextField("控制属性", enabledIfProperty);
+                enabledIfOperatorIndex = EditorGUILayout.Popup(
+                    "比较", enabledIfOperatorIndex, ASEAttributeStore.EnabledIfOperators);
+                enabledIfValue = EditorGUILayout.FloatField("比较值", enabledIfValue);
+            }
+            EditorGUILayout.Space(8f);
+            assignFallbackEditor = EditorGUILayout.ToggleLeft(
+                "使用 MZGUI.MZGUI 材质面板", assignFallbackEditor);
+            EditorGUILayout.EndScrollView();
+
+            EditorGUILayout.BeginHorizontal();
+            if (GUILayout.Button("应用到节点")) Apply(false);
+            if (GUILayout.Button("应用并保存 Shader")) Apply(true);
+            EditorGUILayout.EndHorizontal();
+        }
+
+        private void LoadValues()
+        {
+            Dictionary<string, string> values;
+            string error;
+            if (!ASEAttributeStore.TryRead(selectedNode, out values, out error))
+            {
+                adapterError = error;
+                selectedNode = null;
+                return;
+            }
+            useFoldout = values.TryGetValue("FoldoutMzgui", out foldout);
+            useTooltip = values.TryGetValue("TooltipMzgui", out tooltip);
+            useHelpBox = values.TryGetValue("HelpBoxMzgui", out helpBox);
+            string condition;
+            useEnabledIf = values.TryGetValue("EnableIfMzgui", out condition);
+            if (useEnabledIf && !ASEAttributeStore.TryParseCondition(
+                    condition, out enabledIfProperty, out enabledIfOperatorIndex,
+                    out enabledIfValue, out error))
+            {
+                adapterError = error;
+                selectedNode = null;
+            }
+        }
+
+        private void Apply(bool save)
+        {
+            string error;
+            if (!ASEApplyTransaction.TryApply(
+                selectedNode, useFoldout ? foldout : null,
+                useTooltip ? tooltip : null, useHelpBox ? helpBox : null,
+                useEnabledIf ? ASEAttributeStore.FormatCondition(
+                    enabledIfProperty, enabledIfOperatorIndex, enabledIfValue) : null,
+                assignFallbackEditor, save, out error))
+            { ShowNotification(new GUIContent(error)); return; }
+            ShowNotification(new GUIContent(save ? "已应用并保存" : "已应用"));
+        }
+    }
+
+    internal static class ASEAttributeStore
+    {
+        internal static readonly string[] EnabledIfOperators = {
+            "Less", "LessEqual", "Equal", "NotEqual", "GreaterEqual", "Greater"
+        };
+        private static readonly Regex Managed = new Regex(
+            @"^\[?(FoldoutMzgui|TooltipMzgui|HelpBoxMzgui|EnableIfMzgui|ASECLIFoldout|ASECLITooltip|ASECLIHelpBox|ASECLIEnableIf)(?:\((.*)\))?\]?$",
+            RegexOptions.CultureInvariant);
+
+        internal static bool TryRead(
+            UnityEngine.Object node, out Dictionary<string, string> values, out string error)
+        {
+            values = new Dictionary<string, string>(StringComparer.Ordinal);
+            IList attributes;
+            FieldInfo listField;
+            FieldInfo countField;
+            if (!TryStorage(node, out attributes, out listField, out countField, out error))
+                return false;
+            foreach (object item in attributes)
+            {
+                Match match = Managed.Match(item as string ?? String.Empty);
+                if (!match.Success) continue;
+                string encoded = match.Groups[2].Success ? match.Groups[2].Value : String.Empty;
+                string canonical = Canonical(match.Groups[1].Value);
+                string decoded = Decode(encoded);
+                string existing;
+                if (values.TryGetValue(canonical, out existing) && existing != decoded &&
+                    match.Groups[1].Value == canonical)
+                {
+                    error = "同一 MZGUI 属性存在冲突的 canonical 值；已停止写入";
+                    return false;
+                }
+                if (!values.ContainsKey(canonical) || match.Groups[1].Value == canonical)
+                    values[canonical] = decoded;
+            }
+            return true;
+        }
+
+        internal static bool TryWrite(
+            UnityEngine.Object node, string foldout, string tooltip, string help,
+            string enabledIf, out string error)
+        {
+            IList attributes;
+            FieldInfo listField;
+            FieldInfo countField;
+            if (!TryStorage(node, out attributes, out listField, out countField, out error))
+                return false;
+            if (foldout != null && foldout.IndexOfAny(";\r\n\\><'\"[]{}=+`~/?!@#$%^&*:".ToCharArray()) >= 0)
+            {
+                error = "Foldout 标题包含 ASE 不接受的字符";
+                return false;
+            }
+            if (enabledIf != null)
+            {
+                string propertyName; int operatorIndex; float value;
+                if (!TryParseCondition(
+                        enabledIf, out propertyName, out operatorIndex, out value, out error))
+                    return false;
+            }
+            Undo.RecordObject(node, "Edit ASE GUI attributes");
+            List<string> kept = new List<string>();
+            foreach (object item in attributes)
+            {
+                string raw = item as string ?? String.Empty;
+                if (!Managed.IsMatch(raw)) kept.Add(raw);
+            }
+            if (foldout != null) kept.Add("FoldoutMzgui(" + EncodeFoldout(foldout) + ")");
+            if (tooltip != null) kept.Add("TooltipMzgui(" + EncodeUnicode(tooltip) + ")");
+            if (help != null) kept.Add("HelpBoxMzgui(" + EncodeUnicode(help) + ")");
+            if (enabledIf != null) kept.Add("EnableIfMzgui(" + enabledIf + ")");
+            attributes.Clear();
+            foreach (string raw in kept) attributes.Add(raw);
+            countField.SetValue(node, attributes.Count);
+            EditorUtility.SetDirty(node);
+            error = String.Empty;
+            return true;
+        }

asecli/bridge/resources/asecli_material_gui.authoring.part01.cs.txt

@@ -0,0 +1,235 @@
+    internal static class ASEReflection
+    {
+        private const BindingFlags All = BindingFlags.Public | BindingFlags.NonPublic |
+            BindingFlags.Instance | BindingFlags.Static;
+        private static EditorWindow currentWindow;
+        private static object currentGraph;
+
+        internal static bool TryGraph(out EditorWindow window, out object graph)
+        {
+            window = FindWindow();
+            graph = window != null
+                ? Member(window, "CurrentGraph", "OutsideGraph", "m_mainGraphInstance") : null;
+            return window != null && graph != null;
+        }
+
+        internal static IList PropertyNodes(object graph)
+        {
+            IList nodes = graph != null ? Member(graph, "Nodes", "m_nodes") as IList : null;
+            if (nodes == null) return null;
+            ArrayList properties = new ArrayList();
+            foreach (object node in nodes)
+                if (IsPropertyNode(node)) properties.Add(node);
+            return properties;
+        }
+
+        internal static object Value(object target, params string[] names)
+        {
+            return target != null ? Member(target, names) : null;
+        }
+
+        internal static bool TrySelectedProperty(
+            out UnityEngine.Object node, out string label, out string version, out string error)
+        {
+            node = null;
+            label = String.Empty;
+            version = Version();
+            if (!TryGraph(out currentWindow, out currentGraph))
+            {
+                error = "未检测到打开的 Amplify Shader Editor 窗口";
+                return false;
+            }
+            IList selected = currentGraph != null
+                ? Member(currentGraph, "SelectedNodes", "m_selectedNodes") as IList : null;
+            if (selected == null)
+            {
+                error = "当前 ASE 版本无法读取节点选择；已停止写入";
+                return false;
+            }
+            foreach (object candidate in selected)
+            {
+                if (!IsPropertyNode(candidate)) continue;
+                if (node != null)
+                {
+                    node = null;
+                    error = "请只选择一个 Property 节点";
+                    return false;
+                }
+                node = candidate as UnityEngine.Object;
+            }
+            if (node == null)
+            {
+                error = "请在 ASE 中选择一个 Property 节点";
+                return false;
+            }
+            object name = Member(node, "PropertyInspectorName", "PropertyName", "m_propertyName");
+            label = name as string ?? node.name;
+            error = String.Empty;
+            return true;
+        }
+
+        internal static bool TryAssignFallbackEditor(out string error)
+        {
+            object master = currentGraph != null
+                ? Member(currentGraph, "CurrentMasterNode", "CurrentOutputNode", "m_currentMasterNode") : null;
+            FieldInfo field = master != null ? Field(master.GetType(), "m_customInspectorName") : null;
+            if (field == null)
+            {
+                error = "当前 ASE 版本无法设置 Custom Editor；属性已保留，请在 Master 节点手动选择 ASECLI GUI";
+                return false;
+            }
+            UnityEngine.Object target = master as UnityEngine.Object;
+            if (target != null) Undo.RecordObject(target, "Select ASECLI material GUI");
+            field.SetValue(master, "MZGUI.MZGUI");
+            if (target != null) EditorUtility.SetDirty(target);
+            error = String.Empty;
+            return true;
+        }
+
+        internal static bool TryMasterSnapshot(
+            bool required, out object master, out FieldInfo field, out string value, out string error)
+        {
+            master = currentGraph != null
+                ? Member(currentGraph, "CurrentMasterNode", "CurrentOutputNode", "m_currentMasterNode") : null;
+            field = master != null ? Field(master.GetType(), "m_customInspectorName") : null;
+            value = field != null ? field.GetValue(master) as string : null;
+            if (!required || field != null)
+            {
+                error = String.Empty;
+                return true;
+            }
+            error = "当前 ASE 版本无法设置 Custom Editor；事务未开始";
+            return false;
+        }
+
+        internal static bool TryRestoreMaster(object master, FieldInfo field, string value, out string error)
+        {
+            try
+            {
+                if (field != null) field.SetValue(master, value);
+                UnityEngine.Object target = master as UnityEngine.Object;
+                if (target != null) EditorUtility.SetDirty(target);
+                error = String.Empty;
+                return true;
+            }
+            catch (Exception exception)
+            {
+                error = exception.GetBaseException().Message;
+                return false;
+            }
+        }
+
+        internal static bool CanSave(bool required, out string error)
+        {
+            if (!required || SaveMethod() != null)
+            {
+                error = String.Empty;
+                return true;
+            }
+            error = "当前 ASE 版本无法调用保存；事务未开始";
+            return false;
+        }
+
+        internal static bool TryDiskSnapshot(
+            bool required, out string path, out byte[] content, out string error)
+        {
+            path = null;
+            content = null;
+            if (!required) { error = String.Empty; return true; }
+            Shader shader = currentGraph != null ? Member(currentGraph, "CurrentShader") as Shader : null;
+            path = shader != null ? AssetDatabase.GetAssetPath(shader) : null;
+            string projectRoot = System.IO.Path.GetDirectoryName(Application.dataPath);
+            string fullPath = !String.IsNullOrEmpty(path)
+                ? System.IO.Path.GetFullPath(System.IO.Path.Combine(projectRoot, path)) : null;
+            if (String.IsNullOrEmpty(fullPath) || !System.IO.File.Exists(fullPath))
+            { error = "无法建立 Shader 磁盘快照；事务未开始"; return false; }
+            content = System.IO.File.ReadAllBytes(fullPath);
+            path = fullPath;
+            error = String.Empty;
+            return true;
+        }
+
+        internal static bool TryRestoreDisk(string path, byte[] content, out string error)
+        {
+            try
+            {
+                if (path != null && content != null) System.IO.File.WriteAllBytes(path, content);
+                AssetDatabase.Refresh();
+                error = String.Empty;
+                return true;
+            }
+            catch (Exception exception)
+            { error = exception.GetBaseException().Message; return false; }
+        }
+
+        internal static bool TrySave(out string error)
+        {
+            MethodInfo save = SaveMethod();
+            if (save == null)
+            {
+                error = "当前 ASE 版本无法调用保存；属性已应用，请使用 ASE 的 Save 按钮";
+                return false;
+            }
+            save.Invoke(currentWindow, new object[] { false });
+            error = String.Empty;
+            return true;
+        }
+
+        private static MethodInfo SaveMethod()
+        {
+            return currentWindow != null
+                ? currentWindow.GetType().GetMethod("SaveToDisk", All, null, new[] { typeof(bool) }, null) : null;
+        }
+
+        internal static FieldInfo Field(Type type, params string[] names)
+        {
+            for (Type current = type; current != null; current = current.BaseType)
+                foreach (string name in names)
+                {
+                    FieldInfo field = current.GetField(name, All);
+                    if (field != null) return field;
+                }
+            return null;
+        }
+
+        private static object Member(object target, params string[] names)
+        {
+            Type type = target.GetType();
+            foreach (string name in names)
+            {
+                PropertyInfo property = type.GetProperty(name, All);
+                if (property != null) return property.GetValue(target, null);
+                FieldInfo field = Field(type, name);
+                if (field != null) return field.GetValue(target);
+            }
+            return null;
+        }
+
+        private static EditorWindow FindWindow()
+        {
+            foreach (EditorWindow window in Resources.FindObjectsOfTypeAll<EditorWindow>())
+                if (window != null && window.GetType().FullName == "AmplifyShaderEditor.AmplifyShaderEditorWindow")
+                    return window;
+            return null;
+        }
+
+        private static bool IsPropertyNode(object node)
+        {
+            for (Type type = node != null ? node.GetType() : null; type != null; type = type.BaseType)
+                if (type.FullName == "AmplifyShaderEditor.PropertyNode") return true;
+            return false;
+        }
+
+        private static string Version()
+        {
+            foreach (Assembly assembly in AppDomain.CurrentDomain.GetAssemblies())
+            {
+                Type type = assembly.GetType("AmplifyShaderEditor.VersionInfo", false);
+                MethodInfo method = type != null ? type.GetMethod("StaticToString", All) : null;
+                if (method != null) return method.Invoke(null, null) as string ?? "unknown";
+            }
+            return "not detected";
+        }
+    }
+}
+#endif

asecli/bridge/resources/asecli_material_gui.authoring.store.cs.txt

@@ -0,0 +1,125 @@
+        internal static bool TryMergeRaw(
+            UnityEngine.Object node, IEnumerable<string> source, out bool changed, out string error)
+        {
+            changed = false;
+            bool handled;
+            if (!ASENativeMzguiReconciler.TryMerge(
+                    node, source, out handled, out changed, out error))
+                return false;
+            IList attributes;
+            FieldInfo listField;
+            FieldInfo countField;
+            if (!TryStorage(node, out attributes, out listField, out countField, out error))
+                return false;
+            HashSet<string> existing = new HashSet<string>(StringComparer.Ordinal);
+            foreach (object item in attributes)
+            {
+                Match match = Managed.Match(item as string ?? String.Empty);
+                if (match.Success) existing.Add(Canonical(match.Groups[1].Value));
+            }
+            foreach (string item in source)
+            {
+                string raw = (item ?? String.Empty).Trim();
+                if (raw.StartsWith("[", StringComparison.Ordinal) && raw.EndsWith("]", StringComparison.Ordinal))
+                    raw = raw.Substring(1, raw.Length - 2);
+                Match match = Managed.Match(raw);
+                if (!match.Success || existing.Contains(Canonical(match.Groups[1].Value))) continue;
+                if (handled && Canonical(match.Groups[1].Value) != "EnableIfMzgui") continue;
+                raw = Canonical(match.Groups[1].Value) +
+                    (match.Groups[2].Success ? "(" + match.Groups[2].Value + ")" : String.Empty);
+                if (!changed) Undo.RecordObject(node, "Restore ASE GUI attributes");
+                attributes.Add(raw);
+                existing.Add(Canonical(match.Groups[1].Value));
+                changed = true;
+            }
+            if (changed)
+            {
+                countField.SetValue(node, attributes.Count);
+                EditorUtility.SetDirty(node);
+            }
+            error = String.Empty;
+            return true;
+        }
+
+        internal static bool TryStorage(
+            object node, out IList values, out FieldInfo listField, out FieldInfo countField, out string error)
+        {
+            listField = ASEReflection.Field(node.GetType(), "m_customAttr", "m_customAttributes");
+            countField = ASEReflection.Field(node.GetType(), "m_customAttrCount", "m_customAttributesCount");
+            values = listField != null ? listField.GetValue(node) as IList : null;
+            if (values != null && countField != null)
+            {
+                error = String.Empty;
+                return true;
+            }
+            error = "当前 ASE 版本未暴露兼容的 Custom Attributes 存储；已停止写入";
+            return false;
+        }
+
+        private static string EncodeFoldout(string value)
+        {
+            StringBuilder output = new StringBuilder();
+            foreach (char c in value) output.Append(c <= 127 ? c.ToString() : "#" + ((int)c).ToString("x4"));
+            return output.ToString();
+        }
+
+        private static string EncodeUnicode(string value)
+        {
+            StringBuilder output = new StringBuilder();
+            foreach (char c in value) output.Append("#" + ((int)c).ToString("X4"));
+            return output.ToString();
+        }
+
+        private static string Decode(string value)
+        {
+            return Regex.Replace(value, @"#([0-9A-Fa-f]{4})", delegate(Match match)
+            {
+                return ((char)Convert.ToInt32(match.Groups[1].Value, 16)).ToString();
+            });
+        }
+
+        private static string Canonical(string value)
+        {
+            if (value == "ASECLIFoldout") return "FoldoutMzgui";
+            if (value == "ASECLITooltip") return "TooltipMzgui";
+            if (value == "ASECLIHelpBox") return "HelpBoxMzgui";
+            if (value == "ASECLIEnableIf") return "EnableIfMzgui";
+            return value;
+        }
+
+        internal static string FormatCondition(
+            string propertyName, int operatorIndex, float value)
+        {
+            string comparison = operatorIndex >= 0 && operatorIndex < EnabledIfOperators.Length
+                ? EnabledIfOperators[operatorIndex] : "Equal";
+            return propertyName + "," + comparison + "," +
+                value.ToString("R", CultureInfo.InvariantCulture);
+        }
+
+        internal static bool TryParseCondition(
+            string raw, out string propertyName, out int operatorIndex,
+            out float value, out string error)
+        {
+            propertyName = String.Empty;
+            operatorIndex = 2;
+            value = 0f;
+            string[] parts = (raw ?? String.Empty).Split(',');
+            if (parts.Length != 3 ||
+                !Regex.IsMatch(parts[0].Trim(), @"^_[A-Za-z][A-Za-z0-9_]{0,127}$"))
+            {
+                error = "条件启用需要有效的控制属性、比较方式和数值";
+                return false;
+            }
+            propertyName = parts[0].Trim();
+            operatorIndex = Array.IndexOf(EnabledIfOperators, parts[1].Trim());
+            if (operatorIndex < 0 || !Single.TryParse(
+                    parts[2].Trim(), NumberStyles.Float, CultureInfo.InvariantCulture,
+                    out value) || Single.IsNaN(value) || Single.IsInfinity(value))
+            {
+                error = "条件启用的比较方式或数值无效";
+                return false;
+            }
+            error = String.Empty;
+            return true;
+        }
+    }