@phoenix-wing/code-core 0.4.1

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024–2026 上海锟钛
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,4 @@
+Phoenix Wing Code Core
+Copyright 2025-2026 上海锟钛
+
+Licensed under the Apache License, Version 2.0.

package/README.md

@@ -0,0 +1,14 @@
+# @phoenix-wing/code-core
+
+Phoenix Code 可跨宿主复用的纯 TypeScript 算法与数据契约。包内不依赖 Vue、Element Plus、Node 运行时 API、VS Code、Tauri、数据库驱动或平台二进制。
+
+当前公共能力包括：
+
+- C++ 实现文件与头文件成员排序、锁定区保护；
+- UUID 识别、格式保持、替换计划与纯文本 apply；
+- Code Rename 计划与纯文本 apply；
+- 工作集 Schema 与安全相对路径校验；
+- CAA 工程环境和对话框 handoff 数据契约；
+- 跨宿主文件结果分组与排序 ViewModel。
+
+`kt-auto-code` 与 Desk Tools 应直接消费本包。旧 `phoenix-wing/code-core` subpath 仅保留兼容 re-export，不再持有算法真源。

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { type PnwCppReorderResult, pnwReorderCppText, } from "./pnwReorderCpp.js";
+export { type PnwHeaderReorderOptions, type PnwHeaderReorderResult, type PnwLockedRegion, pnwExtractLockedRegionContents, pnwFindLockedRegions, pnwReorderHeaderText, } from "./pnwReorderHeader.js";
+export { type PnwFileResultGroup, type PnwFileResultGroupId, type PnwFileResultItem, type PnwFileResultSortMode, type PnwGroupFileResultOptions, pnwCompareFileResults, pnwGroupFileResults, } from "./pnwFileResultTree.js";
+export { type PnwUuidOccurrence, type PnwUuidKind, type PnwUuidReplacement, pnwFindUuidOccurrences, pnwFormatUuidForTemplate, pnwIsUuid, pnwNormalizeUuid, pnwReplaceUuidOccurrences, } from "./pnwUuid.js";
+export { type PnwUuidPlanApplyResult, type PnwUuidPlanFile, type PnwUuidReplacementPlan, type PnwUuidReplacementPlanGroup, type PnwUuidReplacementPlanHit, type PnwUuidReplacementPlanOptions, type PnwUuidReplacementStrategy, pnwApplyUuidReplacementPlan, pnwPlanUuidReplacements, } from "./pnwUuidReplacementPlan.js";
+export { type PnwCaaDialogHandoff, type PnwCaaDialogHandoffFile, pnwIsCaaDialogHandoff, } from "./pnwCaaDialogHandoff.js";
+export { type PnwCodeRenameChange, type PnwCodeRenameEntry, type PnwCodeRenameLevel, type PnwCodeRenameOptions, type PnwCodeRenamePlan, pnwApplyCodeRenameText, pnwPlanCodeRename, } from "./pnwCodeRenamePlan.js";
+export { type PnwWorkset, type PnwWorksetDocument, type PnwWorksetParseResult, pnwIsSafeWorkspacePath, pnwParseWorksetDocument, } from "./pnwWorkset.js";
+export { type PnwCaaEnvironment, type PnwCaaEnvironmentKey, type PnwCaaEnvironmentSource, type PnwCaaEnvironmentValue, pnwResolveCaaEnvironment, } from "./pnwCaaEnvironment.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,8BAA8B,EAC9B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,SAAS,EACT,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,wBAAwB,GACzB,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { pnwReorderCppText, } from "./pnwReorderCpp.js";
+export { pnwExtractLockedRegionContents, pnwFindLockedRegions, pnwReorderHeaderText, } from "./pnwReorderHeader.js";
+export { pnwCompareFileResults, pnwGroupFileResults, } from "./pnwFileResultTree.js";
+export { pnwFindUuidOccurrences, pnwFormatUuidForTemplate, pnwIsUuid, pnwNormalizeUuid, pnwReplaceUuidOccurrences, } from "./pnwUuid.js";
+export { pnwApplyUuidReplacementPlan, pnwPlanUuidReplacements, } from "./pnwUuidReplacementPlan.js";
+export { pnwIsCaaDialogHandoff, } from "./pnwCaaDialogHandoff.js";
+export { pnwApplyCodeRenameText, pnwPlanCodeRename, } from "./pnwCodeRenamePlan.js";
+export { pnwIsSafeWorkspacePath, pnwParseWorksetDocument, } from "./pnwWorkset.js";
+export { pnwResolveCaaEnvironment, } from "./pnwCaaEnvironment.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAIL,8BAA8B,EAC9B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAML,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAIL,sBAAsB,EACtB,wBAAwB,EACxB,SAAS,EACT,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAQL,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAGL,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAML,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAIL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAKL,wBAAwB,GACzB,MAAM,wBAAwB,CAAC"}

package/dist/pnwCaaDialogHandoff.d.ts

@@ -0,0 +1,17 @@
+export type PnwCaaDialogHandoffFile = {
+    readonly uri: string;
+    readonly relativePath: string;
+};
+/** Versioned, data-only handoff from a file selector to a CAA editor host. */
+export type PnwCaaDialogHandoff = {
+    readonly protocol: "phoenix-desk-tools.caa-dialog.v1";
+    readonly workspaceUri: string;
+    readonly selectedFiles: readonly PnwCaaDialogHandoffFile[];
+};
+/**
+ * Validates the v1 handoff shape before a local bridge accepts file paths.
+ * It deliberately only allows file URIs and relative display paths without
+ * parent traversal; the receiving host must still authorize file access.
+ */
+export declare function pnwIsCaaDialogHandoff(value: unknown): value is PnwCaaDialogHandoff;
+//# sourceMappingURL=pnwCaaDialogHandoff.d.ts.map

package/dist/pnwCaaDialogHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwCaaDialogHandoff.d.ts","sourceRoot":"","sources":["../src/pnwCaaDialogHandoff.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,QAAQ,EAAE,kCAAkC,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC5D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAQlF"}

package/dist/pnwCaaDialogHandoff.js

@@ -0,0 +1,34 @@
+/**
+ * Validates the v1 handoff shape before a local bridge accepts file paths.
+ * It deliberately only allows file URIs and relative display paths without
+ * parent traversal; the receiving host must still authorize file access.
+ */
+export function pnwIsCaaDialogHandoff(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const handoff = value;
+    return handoff.protocol === "phoenix-desk-tools.caa-dialog.v1"
+        && pnwIsFileUri(handoff.workspaceUri)
+        && Array.isArray(handoff.selectedFiles)
+        && handoff.selectedFiles.length > 0
+        && handoff.selectedFiles.every((file) => pnwIsCaaDialogHandoffFile(file));
+}
+function pnwIsCaaDialogHandoffFile(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const file = value;
+    return pnwIsFileUri(file.uri)
+        && typeof file.relativePath === "string"
+        && file.relativePath.length > 0
+        && !file.relativePath.startsWith("/")
+        && !file.relativePath.split(/[\\/]+/).includes("..");
+}
+function pnwIsFileUri(value) {
+    try {
+        return typeof value === "string" && new URL(value).protocol === "file:";
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=pnwCaaDialogHandoff.js.map

package/dist/pnwCaaDialogHandoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwCaaDialogHandoff.js","sourceRoot":"","sources":["../src/pnwCaaDialogHandoff.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,OAAO,GAAG,KAAqC,CAAC;IACtD,OAAO,OAAO,CAAC,QAAQ,KAAK,kCAAkC;WACzD,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC;WAClC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;WACpC,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC;WAChC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,IAAI,GAAG,KAAyC,CAAC;IACvD,OAAO,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC;WACxB,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;WACrC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;WAC5B,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;WAClC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,CAAC;QAAC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC1G,CAAC"}

package/dist/pnwCaaEnvironment.d.ts

@@ -0,0 +1,17 @@
+export type PnwCaaEnvironmentKey = "customRoot" | "thirdPartyRoot" | "coreRoot" | "caaMkVersion";
+export type PnwCaaEnvironmentSource = "workspace" | "system" | "missing";
+export type PnwCaaEnvironmentValue = {
+    readonly key: PnwCaaEnvironmentKey;
+    readonly environmentVariable: "ROOT_DIR" | "ROOT_DIR_3rdParty" | "ROOT_DIR_CORE" | "CAA_MK_VERSION";
+    readonly required: boolean;
+    readonly source: PnwCaaEnvironmentSource;
+    readonly value?: string;
+    readonly suggestedValue?: string;
+};
+export type PnwCaaEnvironment = {
+    readonly values: readonly PnwCaaEnvironmentValue[];
+    readonly complete: boolean;
+};
+/** Resolves explicit workspace overrides before inherited system values; it never mutates `process.env`. */
+export declare function pnwResolveCaaEnvironment(system: Readonly<Record<string, string | undefined>>, workspaceOverrides?: Partial<Record<PnwCaaEnvironmentKey, string | undefined>>): PnwCaaEnvironment;
+//# sourceMappingURL=pnwCaaEnvironment.d.ts.map

package/dist/pnwCaaEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwCaaEnvironment.d.ts","sourceRoot":"","sources":["../src/pnwCaaEnvironment.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,gBAAgB,GAAG,UAAU,GAAG,cAAc,CAAC;AACjG,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,UAAU,GAAG,mBAAmB,GAAG,eAAe,GAAG,gBAAgB,CAAC;IACpG,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnH,4GAA4G;AAC5G,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACpD,kBAAkB,GAAE,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC,CAAM,GACjF,iBAAiB,CAoBnB"}

package/dist/pnwCaaEnvironment.js

@@ -0,0 +1,23 @@
+/** Resolves explicit workspace overrides before inherited system values; it never mutates `process.env`. */
+export function pnwResolveCaaEnvironment(system, workspaceOverrides = {}) {
+    const definitions = [
+        { key: "customRoot", environmentVariable: "ROOT_DIR", required: true },
+        { key: "thirdPartyRoot", environmentVariable: "ROOT_DIR_3rdParty", required: true },
+        { key: "coreRoot", environmentVariable: "ROOT_DIR_CORE", required: true },
+        { key: "caaMkVersion", environmentVariable: "CAA_MK_VERSION", required: false },
+    ];
+    const values = definitions.map((definition) => {
+        const override = workspaceOverrides[definition.key]?.trim();
+        const inherited = system[definition.environmentVariable]?.trim();
+        const value = override || inherited;
+        const source = value ? (override ? "workspace" : "system") : "missing";
+        return {
+            ...definition,
+            source,
+            ...(value ? { value } : {}),
+            ...(!value && definition.key === "caaMkVersion" ? { suggestedValue: "19" } : {}),
+        };
+    });
+    return { values, complete: values.filter((value) => value.required).every((value) => Boolean(value.value)) };
+}
+//# sourceMappingURL=pnwCaaEnvironment.js.map

package/dist/pnwCaaEnvironment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwCaaEnvironment.js","sourceRoot":"","sources":["../src/pnwCaaEnvironment.ts"],"names":[],"mappings":"AAYA,4GAA4G;AAC5G,MAAM,UAAU,wBAAwB,CACtC,MAAoD,EACpD,qBAAgF,EAAE;IAElF,MAAM,WAAW,GAAwF;QACvG,EAAE,GAAG,EAAE,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE;QACtE,EAAE,GAAG,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnF,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzE,EAAE,GAAG,EAAE,cAAc,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;KAChF,CAAC;IACF,MAAM,MAAM,GAA6B,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAA0B,EAAE;QAC9F,MAAM,QAAQ,GAAG,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,QAAQ,IAAI,SAAS,CAAC;QACpC,MAAM,MAAM,GAA4B,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChG,OAAO;YACL,GAAG,UAAU;YACb,MAAM;YACN,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjF,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AAC/G,CAAC"}

package/dist/pnwCodeRenamePlan.d.ts

@@ -0,0 +1,47 @@
+export type PnwCodeRenameLevel = "dir" | "file" | "text";
+export type PnwCodeRenameEntry = {
+    readonly relativePath: string;
+    readonly kind: "file" | "dir";
+    /** Required only for file entries when text replacement is requested. */
+    readonly text?: string;
+};
+export type PnwCodeRenameOptions = {
+    readonly oldText: string;
+    readonly newText: string;
+    readonly levels?: readonly PnwCodeRenameLevel[];
+    /** Default true. Set false for Windows/macOS case-insensitive target checks. */
+    readonly caseSensitivePaths?: boolean;
+};
+export type PnwCodeRenameChange = {
+    readonly level: PnwCodeRenameLevel;
+    readonly relativePath: string;
+    readonly targetPath?: string;
+    readonly occurrences: number;
+    readonly lines?: readonly number[];
+    readonly status: "preview" | "conflict" | "invalid";
+    readonly detail?: string;
+};
+export type PnwCodeRenamePlan = {
+    readonly valid: boolean;
+    readonly oldText: string;
+    readonly newText: string;
+    readonly levels: readonly PnwCodeRenameLevel[];
+    readonly changes: readonly PnwCodeRenameChange[];
+    readonly summary: {
+        readonly dirs: number;
+        readonly files: number;
+        readonly textFiles: number;
+        readonly occurrences: number;
+        readonly conflicts: number;
+    };
+    readonly diagnostics: readonly string[];
+};
+/**
+ * Produces a side-effect-free plan for literal source text, filename and
+ * directory-basename renames. Hosts remain responsible for filesystem reads,
+ * case-only renames, encoding, confirmation and writes.
+ */
+export declare function pnwPlanCodeRename(entries: readonly PnwCodeRenameEntry[], options: PnwCodeRenameOptions): PnwCodeRenamePlan;
+/** Applies only literal text changes after a host has accepted a preview plan. */
+export declare function pnwApplyCodeRenameText(text: string, oldText: string, newText: string): string;
+//# sourceMappingURL=pnwCodeRenamePlan.d.ts.map

package/dist/pnwCodeRenamePlan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwCodeRenamePlan.d.ts","sourceRoot":"","sources":["../src/pnwCodeRenamePlan.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAChD,gFAAgF;IAChF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1J,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,kBAAkB,EAAE,EACtC,OAAO,EAAE,oBAAoB,GAC5B,iBAAiB,CAyDnB;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7F"}

package/dist/pnwCodeRenamePlan.js

@@ -0,0 +1,105 @@
+/**
+ * Produces a side-effect-free plan for literal source text, filename and
+ * directory-basename renames. Hosts remain responsible for filesystem reads,
+ * case-only renames, encoding, confirmation and writes.
+ */
+export function pnwPlanCodeRename(entries, options) {
+    const oldText = options.oldText;
+    const newText = options.newText;
+    const levels = pnwNormalizeRenameLevels(options.levels);
+    const diagnostics = [];
+    if (!oldText || !newText)
+        diagnostics.push("旧值和新值均不能为空");
+    if (oldText === newText)
+        diagnostics.push("旧值与新值相同");
+    if (newText.includes("/") || newText.includes("\\"))
+        diagnostics.push("新名称不能包含路径分隔符");
+    const normalizedEntries = entries.map((entry) => ({ ...entry, relativePath: pnwNormalizeRelativePath(entry.relativePath) }));
+    if (normalizedEntries.some((entry) => !pnwIsSafeRelativePath(entry.relativePath)))
+        diagnostics.push("输入包含越出工作区的相对路径");
+    if (diagnostics.length)
+        return pnwEmptyRenamePlan(oldText, newText, levels, diagnostics);
+    const changes = [];
+    if (levels.includes("text")) {
+        for (const entry of normalizedEntries) {
+            if (entry.kind !== "file" || entry.text === undefined)
+                continue;
+            const occurrences = pnwCountOccurrences(entry.text, oldText);
+            if (!occurrences)
+                continue;
+            changes.push({ level: "text", relativePath: entry.relativePath, occurrences, lines: pnwHitLines(entry.text, oldText), status: "preview" });
+        }
+    }
+    const pathChanges = [];
+    for (const level of ["dir", "file"]) {
+        if (!levels.includes(level))
+            continue;
+        for (const entry of normalizedEntries) {
+            if ((level === "dir" ? "dir" : "file") !== entry.kind)
+                continue;
+            const targetPath = pnwRenameBasename(entry.relativePath, oldText, newText);
+            if (!targetPath)
+                continue;
+            pathChanges.push({ level, relativePath: entry.relativePath, targetPath, occurrences: 1, status: "preview" });
+        }
+    }
+    const caseSensitive = options.caseSensitivePaths !== false;
+    const existing = new Set(normalizedEntries.map((entry) => pnwPathKey(entry.relativePath, caseSensitive)));
+    const targetCounts = new Map();
+    for (const change of pathChanges) {
+        const key = pnwPathKey(change.targetPath, caseSensitive);
+        targetCounts.set(key, (targetCounts.get(key) ?? 0) + 1);
+    }
+    for (const change of pathChanges) {
+        const targetKey = pnwPathKey(change.targetPath, caseSensitive);
+        const sourceKey = pnwPathKey(change.relativePath, caseSensitive);
+        const collides = targetKey !== sourceKey && (existing.has(targetKey) || (targetCounts.get(targetKey) ?? 0) > 1);
+        changes.push(collides
+            ? { ...change, status: "conflict", detail: existing.has(targetKey) ? `目标已存在：${change.targetPath}` : `多个条目指向同一目标：${change.targetPath}` }
+            : change);
+    }
+    changes.sort((left, right) => pnwRenameLevelOrder(left.level) - pnwRenameLevelOrder(right.level) || left.relativePath.localeCompare(right.relativePath));
+    const summary = {
+        dirs: changes.filter((change) => change.level === "dir" && change.status === "preview").length,
+        files: changes.filter((change) => change.level === "file" && change.status === "preview").length,
+        textFiles: changes.filter((change) => change.level === "text" && change.status === "preview").length,
+        occurrences: changes.reduce((count, change) => count + (change.status === "preview" ? change.occurrences : 0), 0),
+        conflicts: changes.filter((change) => change.status === "conflict").length,
+    };
+    return { valid: true, oldText, newText, levels, changes, summary, diagnostics };
+}
+/** Applies only literal text changes after a host has accepted a preview plan. */
+export function pnwApplyCodeRenameText(text, oldText, newText) {
+    return oldText ? text.split(oldText).join(newText) : text;
+}
+function pnwEmptyRenamePlan(oldText, newText, levels, diagnostics) {
+    return { valid: false, oldText, newText, levels, changes: [], summary: { dirs: 0, files: 0, textFiles: 0, occurrences: 0, conflicts: 0 }, diagnostics };
+}
+function pnwNormalizeRenameLevels(levels) {
+    const allowed = ["dir", "file", "text"];
+    const selected = levels?.filter((level) => allowed.includes(level)) ?? [];
+    const resolved = selected.length ? selected : ["text"];
+    return [...new Set(resolved)];
+}
+function pnwNormalizeRelativePath(value) { return value.replace(/\\/g, "/").replace(/^\.\//, ""); }
+function pnwIsSafeRelativePath(value) { return Boolean(value) && !value.startsWith("/") && !value.split("/").includes(".."); }
+function pnwPathKey(value, caseSensitive) { return caseSensitive ? value : value.toLocaleLowerCase(); }
+function pnwRenameBasename(path, oldText, newText) {
+    const slash = path.lastIndexOf("/");
+    const base = path.slice(slash + 1);
+    return base === oldText ? `${slash < 0 ? "" : `${path.slice(0, slash + 1)}`}${newText}` : undefined;
+}
+function pnwCountOccurrences(text, needle) {
+    let count = 0;
+    let offset = 0;
+    while ((offset = text.indexOf(needle, offset)) >= 0) {
+        count += 1;
+        offset += needle.length;
+    }
+    return count;
+}
+function pnwHitLines(text, needle) {
+    return text.split(/\r?\n/).flatMap((line, index) => line.includes(needle) ? [index + 1] : []);
+}
+function pnwRenameLevelOrder(level) { return level === "dir" ? 0 : level === "file" ? 1 : 2; }
+//# sourceMappingURL=pnwCodeRenamePlan.js.map

package/dist/pnwCodeRenamePlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwCodeRenamePlan.js","sourceRoot":"","sources":["../src/pnwCodeRenamePlan.ts"],"names":[],"mappings":"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"}

package/dist/pnwFileResultTree.d.ts

@@ -0,0 +1,25 @@
+/** A serializable file result which can be displayed by any host UI. */
+export type PnwFileResultItem = {
+    readonly relativePath: string;
+    readonly changed: boolean;
+};
+export type PnwFileResultGroupId = "changed" | "unchanged";
+export type PnwFileResultSortMode = "filename" | "directory";
+export type PnwFileResultGroup<T extends PnwFileResultItem> = {
+    readonly id: PnwFileResultGroupId;
+    readonly items: readonly T[];
+};
+export type PnwGroupFileResultOptions = {
+    /** Default: filename. Ties are always resolved by the full relative path. */
+    readonly sortMode?: PnwFileResultSortMode;
+    /** Default: true. Hosts may hide the unchanged group without losing its data. */
+    readonly includeUnchanged?: boolean;
+};
+/**
+ * Groups file-operation results for native or web UIs without depending on a
+ * specific editor framework. Changed files are always returned first.
+ */
+export declare function pnwGroupFileResults<T extends PnwFileResultItem>(items: readonly T[], options?: PnwGroupFileResultOptions): readonly PnwFileResultGroup<T>[];
+/** Compares file-operation results deterministically for a requested display mode. */
+export declare function pnwCompareFileResults(left: PnwFileResultItem, right: PnwFileResultItem, sortMode?: PnwFileResultSortMode): number;
+//# sourceMappingURL=pnwFileResultTree.d.ts.map

package/dist/pnwFileResultTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwFileResultTree.d.ts","sourceRoot":"","sources":["../src/pnwFileResultTree.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,CAAC;AAC3D,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAC5D,QAAQ,CAAC,EAAE,EAAE,oBAAoB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IAC1C,iFAAiF;IACjF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,EAC7D,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,GAAE,yBAA8B,GACtC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAOlC;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,iBAAiB,EACxB,QAAQ,GAAE,qBAAkC,GAC3C,MAAM,CAMR"}

package/dist/pnwFileResultTree.js

@@ -0,0 +1,37 @@
+/**
+ * Groups file-operation results for native or web UIs without depending on a
+ * specific editor framework. Changed files are always returned first.
+ */
+export function pnwGroupFileResults(items, options = {}) {
+    const sortMode = options.sortMode ?? "filename";
+    const changed = items.filter((item) => item.changed).sort((a, b) => pnwCompareFileResults(a, b, sortMode));
+    const unchanged = items.filter((item) => !item.changed).sort((a, b) => pnwCompareFileResults(a, b, sortMode));
+    const groups = [{ id: "changed", items: changed }];
+    if (options.includeUnchanged !== false)
+        groups.push({ id: "unchanged", items: unchanged });
+    return groups;
+}
+/** Compares file-operation results deterministically for a requested display mode. */
+export function pnwCompareFileResults(left, right, sortMode = "filename") {
+    const leftPath = pnwNormalizeRelativePath(left.relativePath);
+    const rightPath = pnwNormalizeRelativePath(right.relativePath);
+    const leftKey = sortMode === "filename" ? pnwFileName(leftPath) : pnwDirectoryName(leftPath);
+    const rightKey = sortMode === "filename" ? pnwFileName(rightPath) : pnwDirectoryName(rightPath);
+    return pnwCompareText(leftKey, rightKey) || pnwCompareText(leftPath, rightPath);
+}
+function pnwNormalizeRelativePath(value) {
+    return value.replace(/\\/g, "/");
+}
+function pnwFileName(value) {
+    return value.slice(value.lastIndexOf("/") + 1);
+}
+function pnwDirectoryName(value) {
+    const index = value.lastIndexOf("/");
+    return index < 0 ? "" : value.slice(0, index);
+}
+function pnwCompareText(left, right) {
+    const leftFolded = left.toLocaleLowerCase();
+    const rightFolded = right.toLocaleLowerCase();
+    return leftFolded < rightFolded ? -1 : leftFolded > rightFolded ? 1 : left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=pnwFileResultTree.js.map

package/dist/pnwFileResultTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnwFileResultTree.js","sourceRoot":"","sources":["../src/pnwFileResultTree.ts"],"names":[],"mappings":"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"}

package/dist/pnwReorderCpp.d.ts

@@ -0,0 +1,7 @@
+export type PnwCppReorderResult = {
+    text: string;
+    changed: boolean;
+    className?: string;
+};
+export declare function pnwReorderCppText(text: string, fileStem: string): PnwCppReorderResult;
+//# sourceMappingURL=pnwReorderCpp.d.ts.map