@phoenix-wing/code-core 0.4.1

package/src/fixtures/clang_format_class_tail.h

@@ -0,0 +1,23 @@
+class FunctionTail {
+public:
+    void zeta();
+    void alpha();
+
+};
+
+class MemberTail {
+private:
+    int zebra_;
+    int alpha_;
+
+};
+
+class LockedWizardTail {
+public:
+    // clang-format off
+    //START KEVIN CAA WIZARD SECTION LockedWizardTail PARAM DECLARATION
+    int TimeCounter;
+    //END KEVIN CAA WIZARD SECTION LockedWizardTail PARAM DECLARATION
+
+    // clang-format on
+};

package/src/fixtures/clang_format_doubled.h

@@ -0,0 +1,16 @@
+#ifndef SampleClangFormatDoubled_H
+#define SampleClangFormatDoubled_H
+
+class SampleClangFormatDoubled {
+public:
+    // clang-format off
+    int outer_keep_first;
+    // clang-format off
+    int inner_keep_alpha;
+    int inner_keep_beta;
+    // clang-format on
+    int outer_keep_last;
+    // clang-format on
+};
+
+#endif

package/src/fixtures/clang_format_nested_markers.h

@@ -0,0 +1,24 @@
+#ifndef SampleClangFormatNested_H
+#define SampleClangFormatNested_H
+
+class SampleClangFormatNested {
+public:
+    void outerMethod();
+
+public:
+    // clang-format off
+    //START KEVIN CAA WIZARD SECTION SampleNested PARAM DECLARATION
+    int KevinFirst;
+    int KevinSecond;
+    //END KEVIN CAA WIZARD SECTION SampleNested PARAM DECLARATION
+
+    //CAA2 WIZARD
+    void* _WidgetA;
+    void* _WidgetB;
+    //END CAA2 WIZARD
+    // clang-format on
+
+    void zebra();
+};
+
+#endif

package/src/fixtures/clang_format_off_on.h

@@ -0,0 +1,18 @@
+#ifndef SampleClangFormat_H
+#define SampleClangFormat_H
+
+class SampleClangFormat {
+public:
+    void alpha();
+    void beta();
+
+public:
+    // clang-format off
+    int zebra_first;
+    int apple_second;
+    // clang-format on
+
+    void gamma();
+};
+
+#endif

package/src/fixtures/internal_calls.cpp

@@ -0,0 +1,29 @@
+/**
+ * @brief 回归用例：函数体内调用同类方法
+ * 验证函数体内的 ClassName::method() 调用（如 copy() 内调用 safeDelete()）
+ * 不会被提取为独立函数块。
+ */
+#include "FooString.h"
+
+//--------------------------------------------------------------------
+FooString::FooString()
+{
+    FooString::init(nullptr);
+}
+//--------------------------------------------------------------------
+void FooString::init(void *ptr)
+{
+    m_ptr = ptr;
+    if (ptr != nullptr)
+    {
+        FooString::safeDelete(m_ptr);
+    }
+}
+//----static----------------------------------------------------------------
+void FooString::safeDelete(void *ipData)
+{
+    if (ipData != nullptr)
+    {
+        delete[] (char *)ipData;
+    }
+}

package/src/fixtures/kevin_wizard_section.h

@@ -0,0 +1,23 @@
+#ifndef SampleKevinWizard_H
+#define SampleKevinWizard_H
+
+class SampleKevinWizard {
+public:
+    void setZebra(int v);
+    void getApple() const;
+
+public:
+    // clang-format off
+    //START KEVIN CAA WIZARD SECTION SampleKevinWizard PARAM DECLARATION
+
+    /** @brief Zebra field @id 1 */
+    int ZebraField;
+
+    /** @brief Apple field @id 2 */
+    int AppleField;
+
+    //END KEVIN CAA WIZARD SECTION SampleKevinWizard PARAM DECLARATION
+    // clang-format on
+};
+
+#endif

package/src/fixtures/ktalarmclock.clang-format.yaml

@@ -0,0 +1,57 @@
+# version 1.0
+BasedOnStyle: LLVM
+Language: Cpp
+AccessModifierOffset: -4
+AlignAfterOpenBracket: Align
+AlignConsecutiveAssignments: true
+AlignConsecutiveDeclarations: true
+AlignEscapedNewlinesLeft: true
+AlignOperands: true
+AlignTrailingComments: true
+AllowAllParametersOfDeclarationOnNextLine: true
+AllowShortBlocksOnASingleLine : false
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortEnumsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: Empty
+AllowShortIfStatementsOnASingleLine: true
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterDefinitionReturnType: None
+BreakConstructorInitializersBeforeComma: true
+BreakBeforeBraces: Custom
+BraceWrapping:
+  AfterClass:        false
+  AfterControlStatement:        false
+  AfterEnum:        false
+  AfterFunction:        false
+  AfterNamespace:        false
+  AfterObjCDeclaration:        false
+  AfterStruct:        false
+  AfterUnion:        true
+  AfterExternBlock: false
+  BeforeCatch:        true
+  BeforeElse:        true
+  IndentBraces:        false
+  SplitEmptyFunction: true
+  SplitEmptyRecord: true
+  SplitEmptyNamespace: true
+  #use with BraceWrapping: AfterFunction has conflict
+  #BreakBeforeBraces: Stroustrup
+
+
+ColumnLimit: 100
+CommentPragmas: '^ IWYU pragma:'
+IndentCaseLabels: false
+IndentWidth: 4
+IndentWrappedFunctionNames: true
+KeepEmptyLinesAtTheStartOfBlocks: true
+MaxEmptyLinesToKeep: 1
+ObjCBlockIndentWidth: 4
+ObjCSpaceAfterProperty: true
+PointerAlignment: Left
+SpaceAfterCStyleCast: false
+SpaceBeforeAssignmentOperators: true
+SpacesInContainerLiterals: true
+SpacesInParentheses : false
+SpacesInSquareBrackets: true
+TabWidth: 4
+UseTab: Never

package/src/fixtures/ktca_KTCAutoCodeFrm_KTCAutoCodeUI.m_src_KTCAutoDialog.cpp

@@ -0,0 +1,242 @@
+/**
+ * @copyright   Copyright 2021 Kevin Time Toolkit
+ * @license     MIT
+ * @author      Phoenix Wing
+ * @file
+ * @version		V1.0
+ * @brief
+ * @details
+ * @date		2025-12-17
+ */
+
+// cat
+#include "CATApplicationFrame.h"
+#include "CATDialogAgent.h"
+#include "CATDlgNotify.h"
+#include "CATDlgWindow.h"
+#include "CATIAlias.h"
+#include "CATLISTV_CATISpecObject.h"
+#include "CATListOfCATUnicodeString.h"
+#include "CATMMUIPanelStateCmd.h"
+#include "iostream.h"
+
+// Auto Code
+#include "KTCAutoDialog.h"
+#include "KTCAutoSelectorCtx.h"
+
+//-------------------------------------------------------------------------
+KTCAutoDialog::KTCAutoDialog(CATDialog* iParent, CATMMUIPanelStateCmd* iFatherCmd,
+                             const CATString& iObjectName, CATDlgStyle iStyle)
+    // CATDialog *iParent, CATCommand *iEventMgr, const CATString& iObjectName, CATDlgStyle
+    // iStyle=NULL
+    : CATDlgDialog(iParent, iFatherCmd, iObjectName, iStyle)
+    , optionDialog_(NULL)
+    , activeField_(0)
+    , catHSO_(NULL)
+    , actionMode_(KTC::ValueNormal)
+    , selectorMap_(NULL)
+    , valueChangeNtf_(NULL) {
+    selectorMap_    = new std::map<int, KTCAutoSelectorCtx*>();
+    valueChangeNtf_ = new KTCAutoValueChangedNtf();
+}
+//-------------------------------------------------------------------------
+KTCAutoDialog::~KTCAutoDialog() {
+    optionDialog_ = NULL;
+    catHSO_       = NULL;
+    // activeField_ = 0;
+
+    if (selectorMap_) {
+        KTCAutoSelectorCtx* ctx;
+        for (size_t i = 0; i < selectorMap_->size(); i++) {
+            ctx = (*selectorMap_)[ i ]; // get
+            delete ctx;                 // delete
+        }
+        delete selectorMap_, selectorMap_ = NULL; // �ֶ��ͷ�
+    }
+
+    delete valueChangeNtf_, valueChangeNtf_ = NULL; // �ֶ��ͷ�
+}
+//-------------------------------------------------------------------------
+int KTCAutoDialog::ActionSubCommandReturn() {
+    // TODO ʵ�ִ���
+    cout << " - û��ʵ�� " << __FUNCTION__ << endl;
+    return 0;
+}
+//-----------------------------------------------------------------------------
+CATUnicodeString KTCAutoDialog::checkout_title(CATISpecObject_var object) {
+    if (!object) return ""; // û������
+
+    // ���ڣ��������
+    CATIAlias_var alias = object;
+    if (!!alias) // get alias
+        return alias->GetAlias();
+    else // or get display name
+        return object->GetDisplayName();
+}
+//-------------------------------------------------------------------------
+int KTCAutoDialog::InitialMenuRightClick() {
+    // TODO ʵ�ִ���
+    return 0;
+}
+//-------------------------------------------------------------------------
+void KTCAutoDialog::on_show_option_dialog(CATCommand*, CATNotification*, CATCommandClientData) {
+    if (!optionDialog_) return;
+
+    // change state
+    CATULong state = (optionDialog_->GetVisibility() == CATDlgShow) ? CATDlgHide : CATDlgShow;
+    optionDialog_->SetVisibility(state);
+}
+//-------------------------------------------------------------------------
+void KTCAutoDialog::register_option_dialog(CATDlgDialog* dlg) {
+    optionDialog_ = dlg;
+}
+//-------------------------------------------------------------------------
+void KTCAutoDialog::register_option_dialog(CATDlgDialog* dlg, CATDlgPushButton* optionBtn) {
+    optionDialog_ = dlg;
+    // option dialog
+    if (!optionBtn) return;
+
+    AddAnalyseNotificationCB(optionBtn, optionBtn->GetPushBActivateNotification(),
+                             (CATCommandMethod)&KTCAutoDialog::on_show_option_dialog, NULL);
+
+    // close
+    AddAnalyseNotificationCB(optionDialog_, optionDialog_->GetDiaCLOSENotification(),
+                             (CATCommandMethod)&KTCAutoDialog::on_show_option_dialog, NULL);
+}
+//-------------------------------------------------------------------------
+KTCAutoSelectorCtx* KTCAutoDialog::regitster_field(int field, CATDlgSelectorList* selector,
+                                                   const KtString& name) {
+    if (!selector) return NULL;
+    if (!selectorMap_) selectorMap_ = new KTCAutoSelectorCtxMap(); // ��һ��ע��ʱ������map
+
+    // C++98 ��Ҫ��ʽָ������������
+    KTCAutoSelectorCtxMap::iterator it = selectorMap_->find(field);
+    if (it != selectorMap_->end()) {
+        cout << "- [ERROR] Field " << field << " already registered!" << endl;
+        return NULL; // �ҵ�Ԫ��,�Ѿ�ע�����
+    }
+
+    // δ�ҵ�Ԫ�أ�ע��
+    KTCAutoSelectorCtx* ctx = new KTCAutoSelectorCtx(field, selector);
+    // ctx->selector        = selector;
+    ctx->fieldName = name;
+
+    (*selectorMap_)[ field ] = ctx;
+    return ctx;
+}
+//-----------------------------------------------------------------------------
+int KTCAutoDialog::selectorlist_setline(CATDlgSelectorList*     selectorList,
+                                        CATISpecObject_var      inputObject,
+                                        const CATUnicodeString& noneSel) {
+    if (!selectorList) return 1;                                     // return error code
+    if (selectorList->GetLineCount() > 1) selectorList->ClearLine(); // clear multi line
+
+    // set diaplay name or no selection
+    if (!!inputObject) {
+        selectorList->SetLine(checkout_title(inputObject), 0, CATDlgDataModify);
+    }
+    else
+        selectorList->SetLine(noneSel, 0, CATDlgDataModify);
+
+    return 0; // ok
+}
+//-----------------------------------------------------------------------------
+int KTCAutoDialog::selectorlist_setline(CATDlgSelectorList*                 selectorList,
+                                        const CATListValCATISpecObject_var& iList,
+                                        const CATUnicodeString&             noneSel) {
+    if (!selectorList) return 1;                                     // return error code
+    if (selectorList->GetLineCount() > 1) selectorList->ClearLine(); // clear multi line
+
+    if (iList.Size() == 0) {
+        selectorList->ClearLine(); // clear multi line
+        selectorList->SetLine(noneSel, 0, CATDlgDataModify);
+        return 0;
+    }
+
+    CATISpecObject_var object;
+    CATUnicodeString   title;
+
+    // loop ,list index from 1
+    for (size_t i = 1; i <= iList.Size(); i++) {
+        object = iList[ i ]; // get object
+
+        if (!!object)
+            title = checkout_title(object);
+        else
+            title = "(NULL Object)";
+
+        // selector index from 0
+        selectorList->SetLine(title, i - 1, CATDlgDataModify);
+    }
+
+    return iList.Size();
+
+} //-----------------------------------------------------------------------------
+//----------------------------------------
+void KTCAutoDialog::SendValueCHangeNotification() {
+    CATCommand* cmd = GetFather();                   // get command
+    if (cmd) SendNotification(cmd, valueChangeNtf_); // set notification
+}
+//-------------------------------------------------------------------------
+void KTCAutoDialog::SetActiveField(int feild) {
+    if (selectorMap_ == NULL) return;
+    activeField_ = feild;
+
+    // clear other field select
+    for (KTCAutoSelectorCtxMap::iterator it = selectorMap_->begin(); it != selectorMap_->end();
+         it++) {
+        if (it->second == NULL || it->second->fieldKey == activeField_)
+            continue; // ��ǰ�ֶβ�����������
+
+        it->second->ClearSelect(); // ��������ֶε�ѡ��
+    }
+}
+//-------------------------------------------------------------------------
+void KTCAutoDialog::SetActiveFieldFocus() {
+    if (selectorMap_ == NULL) return;
+    KTCAutoSelectorCtxMap::iterator it = selectorMap_->find(activeField_);
+    if (it != selectorMap_->end()) it->second->SetSelect();
+}
+//-----------------------------------------------------------------------------
+void KTCAutoDialog::ShowMessageBox(const CATUnicodeString& msg, CATDialog* dialog) {
+    ShowMessageBox(0, msg, dialog);
+}
+//-----------------------------------------------------------------------------
+void KTCAutoDialog::ShowMessageBox(int code, const CATUnicodeString& msg, CATDialog* dialog) {
+    if (0 == code && msg.GetLengthInChar() == 0) return; // û�д�����Ϣ��������
+
+    if (!dialog) dialog = (CATApplicationFrame::GetApplicationFrame())->GetMainWindow();
+
+    // ������Ϣ֪ͨ�Ի���
+    CATDlgNotify* notify = NULL;
+    if (code != 0) { // ���
+        // message
+        CATUnicodeString num;   // code
+        num.BuildFromNum(code); // code to string
+
+        // û������msg����ʾ����Ϣ��code��
+        CATUnicodeString message = "[ERROR " + num + "]\n" + msg;
+
+        // ����
+        notify = new CATDlgNotify(dialog, "Error", CATDlgNfyError);
+        notify->DisplayBlocked(message, "Error"); // ��ʾ�Ի���ģ̬��
+    }
+    else { // û�д���
+        notify = new CATDlgNotify(dialog, "Information", CATDlgNfyInformation);
+        notify->DisplayBlocked(msg, "Information"); // ��ʾ�Ի���ģ̬��
+    }
+
+    KTCRequestDelayedDestruction(notify); // �ͷ���Դ
+}
+//-----------------------------------------------------------------------------
+void KTCAutoDialog::ShowMessageBox(int code, const KtString& msg, CATDialog* dialog) {
+    if (0 == code && msg.size() == 0) return; // û�д�����Ϣ��������
+    CATUnicodeString message = msg.str();     // �ӱ�����ת��
+    ShowMessageBox(code, message, dialog);    // ����CAA��������Ϣ��
+}
+//-----------------------------------------------------------------------------
+void KTCAutoDialog::ShowMessageBox(int code, const char* msg, CATDialog* dialog) {
+    if (0 == code && msg == NULL) return;  // û�д�����Ϣ��������
+    CATUnicodeString message = msg;        // �ӱ�����ת��
+    ShowMessageBox(code, message, dialog); // ����CAA��������Ϣ��
+}

package/src/fixtures/ktca_KTCAutoCodeFrm_PublicInterfaces_KTCAutoDialog.h

@@ -0,0 +1,165 @@
+/**
+ * @copyright   Shanghai Kuntai Software Technology Co., Ltd. 2025
+ * @license     MIT
+ * @author      Phoenix Wing
+ * @file
+ * @version		V1.0
+ * @brief
+ * @details
+ * @date		2025-12-17
+ */
+
+#ifndef KTCAutoDialog_H
+#define KTCAutoDialog_H
+
+// Dialog Framework
+#include "CATDialogAgent.h"
+#include "CATDlgDialog.h"
+#include "CATDlgInclude.h"
+#include "CATISpecObject.h"
+#include "CATString.h"
+
+// auto code
+#include "KTCAutoCode.h"
+#include "KTCAutoCodeUI.h"
+#include "KTCAutoHSO.h"
+#include "KTCAutoSelectorCtx.h"
+#include "KTCAutoValueChangedNtf.h"
+
+/** @brief KTCAutoDialog Dialog */
+class ExportedByKTCAutoCodeUI KTCAutoDialog : public CATDlgDialog {
+    DeclareResource(KTCAutoDialog, CATDlgDialog);
+
+public:
+    KTCAutoDialog(CATDialog* iParent, CATMMUIPanelStateCmd* iFatherCmd,
+                  const CATString& iObjectName, CATDlgStyle iStyle = NULL);
+    virtual ~KTCAutoDialog();
+
+public:
+    /** @brief nodoc
+     *  returned sub command, 0 for no Sub Command
+     */
+    int ActionSubCommandReturn();
+
+    /**
+     * @brief checkout title
+     * @param object input object
+     * @return title string for dialog, if null ,return ""
+     */
+    static CATUnicodeString checkout_title(CATISpecObject_var object);
+
+    /** @brief Get Active Field */
+    inline int GetActiveField() const {
+        return activeField_;
+    };
+
+    /** @brief Get Active Field */
+    inline KTC::ValueActionMode GetValueMode() const {
+        return actionMode_;
+    };
+
+    /**
+     * @brief nodoc
+     */
+    int InitialMenuRightClick();
+
+    /** @brief Callback on show option dialog */
+    virtual void on_show_option_dialog(CATCommand*, CATNotification*, CATCommandClientData);
+
+    /** @brief Register Parameter Dialog */
+    void register_option_dialog(CATDlgDialog* dlg);
+
+    /** @brief Register Parameter Dialog */
+    void register_option_dialog(CATDlgDialog* dlg, CATDlgPushButton* optionBtn);
+
+    /**
+     * @brief register field
+     * @param field field id
+     * @param selector CATDlgSelectorList pointer
+     * @param name selector name
+     * @return KTCAutoSelectorCtx pointer
+     */
+    KTCAutoSelectorCtx* regitster_field(int field, CATDlgSelectorList* selector,
+                                        const KtString& name = "");
+
+    /** @brief nodoc */
+    static int selectorlist_setline(CATDlgSelectorList*     selectorList,
+                                    CATISpecObject_var      inputObject,
+                                    const CATUnicodeString& noneSel = "(No Selection)");
+
+    /** @brief nodoc */
+    static int selectorlist_setline(CATDlgSelectorList*                 selectorList,
+                                    const CATListValCATISpecObject_var& iList,
+                                    const CATUnicodeString&             noneSel = "(No Selection)");
+
+    /** @brief send value change notification */
+    void SendValueCHangeNotification();
+
+    /**
+     * @brief Set Accept On Notify Of Value Change
+     * @param[in] ipDialogAgent Value Change Agent
+     */
+    virtual void SetAcceptOnNotifyOfValueChange(CATDialogAgent* ipDialogAgent) = 0;
+
+    /** @brief Set Active Field */
+    void SetActiveField(int feild);
+
+    /** @brief Set Active Field Focus */
+    void SetActiveFieldFocus();
+
+    /**
+     * @brief Show Message Box
+     * @param[in] msg message
+     * @param[in] dialog Parrent dialo
+     */
+    static void ShowMessageBox(const CATUnicodeString& msg, CATDialog* dialog = NULL);
+
+    /**
+     * @brief Show Message Box
+     * @param[in] code Error Code
+     * @param[in] msg message
+     * @param[in] dialog Parrent dialo
+     * @note DONOT show message if code == 0 and msg is empty
+     */
+    static void ShowMessageBox(int code, const CATUnicodeString& msg, CATDialog* dialog = NULL);
+
+    /**
+     * @brief Show Message Box
+     * @param[in] code Error Code
+     * @param[in] msg Kt String, Local charset
+     * @param[in] dialog Parrent dialo
+     * @note DONOT show message if code == 0 and msg is empty
+     */
+    static void ShowMessageBox(int code, const KtString& msg, CATDialog* dialog = NULL);
+
+    /**
+     * @brief Show Message Box
+     * @param[in] code Error Code
+     * @param[in] msg  const char*, Local charset
+     * @param[in] dialog Parrent dialo
+     * @note DONOT show message if code == 0 and msg is empty
+     */
+    static void ShowMessageBox(int code, const char* msg, CATDialog* dialog = NULL);
+
+    /** @brief Set Params to Dialog */
+    virtual void UpdateDialog() = 0;
+
+    /** @brief Update Params From Dialog */
+    virtual void UpdateInfos() = 0;
+
+    /** @brief Update dialog Sensitivity */
+    virtual void UpdateSensitivity() = 0;
+
+protected:
+public:
+    CATDlgDialog* optionDialog_; // sub dialog
+    CATHSO*       catHSO_;       // catia HSO
+
+private:
+    int                     activeField_;    // current field
+    KTC::ValueActionMode    actionMode_;     // action mode
+    KTCAutoSelectorCtxMap*  selectorMap_;    // selector map
+    KTCAutoValueChangedNtf* valueChangeNtf_; // value change notification
+};
+
+#endif