@payloadcms/typescript-plugin 3.78.0

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2018-2025 Payload CMS, Inc. <info@payloadcms.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/__tests__/fixtures/components/MyField.d.ts

@@ -0,0 +1,3 @@
+export declare const MyField: () => null;
+export declare const MyLabel: () => null;
+//# sourceMappingURL=MyField.d.ts.map

package/dist/__tests__/fixtures/components/MyField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MyField.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/fixtures/components/MyField.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,YAAa,CAAA;AACjC,eAAO,MAAM,OAAO,YAAa,CAAA"}

package/dist/__tests__/fixtures/components/MyField.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get MyField () {
+        return MyField;
+    },
+    get MyLabel () {
+        return MyLabel;
+    }
+});
+const MyField = ()=>null;
+const MyLabel = ()=>null;
+
+//# sourceMappingURL=MyField.js.map

package/dist/__tests__/fixtures/components/MyField.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/__tests__/fixtures/components/MyField.tsx"],"sourcesContent":["export const MyField = () => null\nexport const MyLabel = () => null\n"],"names":["MyField","MyLabel"],"mappings":";;;;;;;;;;;QAAaA;eAAAA;;QACAC;eAAAA;;;AADN,MAAMD,UAAU,IAAM;AACtB,MAAMC,UAAU,IAAM"}

package/dist/__tests__/fixtures/components/icons/Icon/index.d.ts

@@ -0,0 +1,3 @@
+export declare const Icon: () => null;
+export declare const IconSmall: () => null;
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/components/icons/Icon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/__tests__/fixtures/components/icons/Icon/index.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,YAAa,CAAA;AAC9B,eAAO,MAAM,SAAS,YAAa,CAAA"}

package/dist/__tests__/fixtures/components/icons/Icon/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get Icon () {
+        return Icon;
+    },
+    get IconSmall () {
+        return IconSmall;
+    }
+});
+const Icon = ()=>null;
+const IconSmall = ()=>null;
+
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/components/icons/Icon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/__tests__/fixtures/components/icons/Icon/index.tsx"],"sourcesContent":["export const Icon = () => null\nexport const IconSmall = () => null\n"],"names":["Icon","IconSmall"],"mappings":";;;;;;;;;;;QAAaA;eAAAA;;QACAC;eAAAA;;;AADN,MAAMD,OAAO,IAAM;AACnB,MAAMC,YAAY,IAAM"}

package/dist/__tests__/fixtures/components/views/CustomView/index.d.ts

@@ -0,0 +1,3 @@
+export declare const CustomView: () => null;
+export default CustomView;
+//# sourceMappingURL=index.d.ts.map

package/dist/__tests__/fixtures/components/views/CustomView/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/__tests__/fixtures/components/views/CustomView/index.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,YAAa,CAAA;AACpC,eAAe,UAAU,CAAA"}

package/dist/__tests__/fixtures/components/views/CustomView/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get CustomView () {
+        return CustomView;
+    },
+    get default () {
+        return _default;
+    }
+});
+const CustomView = ()=>null;
+const _default = CustomView;
+
+//# sourceMappingURL=index.js.map

package/dist/__tests__/fixtures/components/views/CustomView/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/__tests__/fixtures/components/views/CustomView/index.tsx"],"sourcesContent":["export const CustomView = () => null\nexport default CustomView\n"],"names":["CustomView"],"mappings":";;;;;;;;;;;QAAaA;eAAAA;;QACb;eAAA;;;AADO,MAAMA,aAAa,IAAM;MAChC,WAAeA"}

package/dist/__tests__/fixtures/payload-types.d.js

@@ -0,0 +1,3 @@
+"use strict";
+
+//# sourceMappingURL=payload-types.d.js.map

package/dist/__tests__/fixtures/payload-types.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/fixtures/payload-types.d.ts"],"names":[],"mappings":""}

package/dist/__tests__/fixtures/payload.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: {};
+export default _default;
+//# sourceMappingURL=payload.config.d.ts.map

package/dist/__tests__/fixtures/payload.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.config.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/payload.config.ts"],"names":[],"mappings":";AAAA,wBAAiB"}

package/dist/__tests__/fixtures/payload.config.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+const _default = {};
+
+//# sourceMappingURL=payload.config.js.map

package/dist/__tests__/fixtures/payload.config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/fixtures/payload.config.ts"],"sourcesContent":["export default {}\n"],"names":[],"mappings":";;;;+BAAA;;;eAAA;;;MAAA,WAAe,CAAC"}

package/dist/__tests__/fixtures/src/components/NavIcon.d.ts

@@ -0,0 +1,3 @@
+export declare const NavIcon: () => null;
+export declare const NavIconSmall: () => null;
+//# sourceMappingURL=NavIcon.d.ts.map

package/dist/__tests__/fixtures/src/components/NavIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavIcon.d.ts","sourceRoot":"","sources":["../../../../../src/__tests__/fixtures/src/components/NavIcon.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,YAAa,CAAA;AACjC,eAAO,MAAM,YAAY,YAAa,CAAA"}

package/dist/__tests__/fixtures/src/components/NavIcon.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get NavIcon () {
+        return NavIcon;
+    },
+    get NavIconSmall () {
+        return NavIconSmall;
+    }
+});
+const NavIcon = ()=>null;
+const NavIconSmall = ()=>null;
+
+//# sourceMappingURL=NavIcon.js.map

package/dist/__tests__/fixtures/src/components/NavIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../src/__tests__/fixtures/src/components/NavIcon.tsx"],"sourcesContent":["export const NavIcon = () => null\nexport const NavIconSmall = () => null\n"],"names":["NavIcon","NavIconSmall"],"mappings":";;;;;;;;;;;QAAaA;eAAAA;;QACAC;eAAAA;;;AADN,MAAMD,UAAU,IAAM;AACtB,MAAMC,eAAe,IAAM"}

package/dist/__tests__/fixtures/src/components/ui/Badge.d.ts

@@ -0,0 +1,4 @@
+export declare const Badge: () => null;
+export declare const BadgeIcon: () => null;
+export default Badge;
+//# sourceMappingURL=Badge.d.ts.map

package/dist/__tests__/fixtures/src/components/ui/Badge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../../../../src/__tests__/fixtures/src/components/ui/Badge.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,YAAa,CAAA;AAC/B,eAAO,MAAM,SAAS,YAAa,CAAA;AACnC,eAAe,KAAK,CAAA"}

package/dist/__tests__/fixtures/src/components/ui/Badge.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get Badge () {
+        return Badge;
+    },
+    get BadgeIcon () {
+        return BadgeIcon;
+    },
+    get default () {
+        return _default;
+    }
+});
+const Badge = ()=>null;
+const BadgeIcon = ()=>null;
+const _default = Badge;
+
+//# sourceMappingURL=Badge.js.map

package/dist/__tests__/fixtures/src/components/ui/Badge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../src/__tests__/fixtures/src/components/ui/Badge.tsx"],"sourcesContent":["export const Badge = () => null\nexport const BadgeIcon = () => null\nexport default Badge\n"],"names":["Badge","BadgeIcon"],"mappings":";;;;;;;;;;;QAAaA;eAAAA;;QACAC;eAAAA;;QACb;eAAA;;;AAFO,MAAMD,QAAQ,IAAM;AACpB,MAAMC,YAAY,IAAM;MAC/B,WAAeD"}

package/dist/__tests__/fixtures/test-config.d.ts

@@ -0,0 +1,2 @@
+import './payload-types.d.ts';
+//# sourceMappingURL=test-config.d.ts.map

package/dist/__tests__/fixtures/test-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-config.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/test-config.ts"],"names":[],"mappings":"AACA,OAAO,sBAAsB,CAAA"}

package/dist/__tests__/fixtures/test-config.js

@@ -0,0 +1,146 @@
+// @ts-ignore - ambient type declarations
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+require("./payload-types.d.ts");
+const validField = {
+    name: 'test',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '/components/MyField.tsx#MyField',
+            Label: '/components/MyField.tsx#MyLabel'
+        }
+    }
+};
+const invalidPath = {
+    name: 'broken',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '/components/DoesNotExist.tsx#Nope'
+        }
+    }
+};
+const invalidExport = {
+    name: 'wrongExport',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '/components/MyField.tsx#WrongExport'
+        }
+    }
+};
+const defaultExport = {
+    name: 'defaultExport',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '/components/views/CustomView/index.tsx'
+        }
+    }
+};
+const objectForm = {
+    name: 'objectForm',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                exportName: 'MyField',
+                path: '/components/MyField.tsx'
+            }
+        }
+    }
+};
+const objectFormInvalidExport = {
+    name: 'objectFormBad',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                exportName: 'DoesNotExist',
+                path: '/components/MyField.tsx'
+            }
+        }
+    }
+};
+const objectFormWithHash = {
+    name: 'objectFormHash',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                path: '/components/MyField.tsx#MyField'
+            }
+        }
+    }
+};
+const objectFormDirIndex = {
+    name: 'objectFormDirIndex',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                path: '/components/views/CustomView#CustomView'
+            }
+        }
+    }
+};
+const noDefaultExport = {
+    name: 'noDefault',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '/components/icons/Icon'
+        }
+    }
+};
+const noDefaultExportObjectForm = {
+    name: 'noDefaultObj',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                path: '/components/icons/Icon'
+            }
+        }
+    }
+};
+const objectFormWithExportName = {
+    name: 'withExportName',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                exportName: 'Icon',
+                path: '/components/icons/Icon'
+            }
+        }
+    }
+};
+const slashOnly = {
+    name: 'slashOnly',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '/'
+        }
+    }
+};
+const adminConfig = {
+    components: {
+        actions: [
+            '/components/MyField.tsx#MyField'
+        ],
+        Nav: '/components/MyField.tsx#MyField',
+        views: {
+            custom: {
+                Component: '/components/views/CustomView/index.tsx#CustomView',
+                path: '/custom'
+            }
+        }
+    }
+};
+
+//# sourceMappingURL=test-config.js.map

package/dist/__tests__/fixtures/test-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/fixtures/test-config.ts"],"sourcesContent":["// @ts-ignore - ambient type declarations\nimport './payload-types.d.ts'\n\nconst validField: FieldConfig = {\n  name: 'test',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '/components/MyField.tsx#MyField',\n      Label: '/components/MyField.tsx#MyLabel',\n    },\n  },\n}\n\nconst invalidPath: FieldConfig = {\n  name: 'broken',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '/components/DoesNotExist.tsx#Nope',\n    },\n  },\n}\n\nconst invalidExport: FieldConfig = {\n  name: 'wrongExport',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '/components/MyField.tsx#WrongExport',\n    },\n  },\n}\n\nconst defaultExport: FieldConfig = {\n  name: 'defaultExport',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '/components/views/CustomView/index.tsx',\n    },\n  },\n}\n\nconst objectForm: FieldConfig = {\n  name: 'objectForm',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        exportName: 'MyField',\n        path: '/components/MyField.tsx',\n      },\n    },\n  },\n}\n\nconst objectFormInvalidExport: FieldConfig = {\n  name: 'objectFormBad',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        exportName: 'DoesNotExist',\n        path: '/components/MyField.tsx',\n      },\n    },\n  },\n}\n\nconst objectFormWithHash: FieldConfig = {\n  name: 'objectFormHash',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        path: '/components/MyField.tsx#MyField',\n      },\n    },\n  },\n}\n\nconst objectFormDirIndex: FieldConfig = {\n  name: 'objectFormDirIndex',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        path: '/components/views/CustomView#CustomView',\n      },\n    },\n  },\n}\n\nconst noDefaultExport: FieldConfig = {\n  name: 'noDefault',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '/components/icons/Icon',\n    },\n  },\n}\n\nconst noDefaultExportObjectForm: FieldConfig = {\n  name: 'noDefaultObj',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        path: '/components/icons/Icon',\n      },\n    },\n  },\n}\n\nconst objectFormWithExportName: FieldConfig = {\n  name: 'withExportName',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        exportName: 'Icon',\n        path: '/components/icons/Icon',\n      },\n    },\n  },\n}\n\nconst slashOnly: FieldConfig = {\n  name: 'slashOnly',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '/',\n    },\n  },\n}\n\nconst adminConfig: AdminConfig = {\n  components: {\n    actions: ['/components/MyField.tsx#MyField'],\n    Nav: '/components/MyField.tsx#MyField',\n    views: {\n      custom: {\n        Component: '/components/views/CustomView/index.tsx#CustomView',\n        path: '/custom',\n      },\n    },\n  },\n}\n"],"names":["validField","name","type","admin","components","Field","Label","invalidPath","invalidExport","defaultExport","objectForm","exportName","path","objectFormInvalidExport","objectFormWithHash","objectFormDirIndex","noDefaultExport","noDefaultExportObjectForm","objectFormWithExportName","slashOnly","adminConfig","actions","Nav","views","custom","Component"],"mappings":"AAAA,yCAAyC;;;;;QAClC;AAEP,MAAMA,aAA0B;IAC9BC,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;YACPC,OAAO;QACT;IACF;AACF;AAEA,MAAMC,cAA2B;IAC/BN,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,MAAMG,gBAA6B;IACjCP,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,MAAMI,gBAA6B;IACjCR,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,MAAMK,aAA0B;IAC9BT,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLM,YAAY;gBACZC,MAAM;YACR;QACF;IACF;AACF;AAEA,MAAMC,0BAAuC;IAC3CZ,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLM,YAAY;gBACZC,MAAM;YACR;QACF;IACF;AACF;AAEA,MAAME,qBAAkC;IACtCb,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLO,MAAM;YACR;QACF;IACF;AACF;AAEA,MAAMG,qBAAkC;IACtCd,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLO,MAAM;YACR;QACF;IACF;AACF;AAEA,MAAMI,kBAA+B;IACnCf,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,MAAMY,4BAAyC;IAC7ChB,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLO,MAAM;YACR;QACF;IACF;AACF;AAEA,MAAMM,2BAAwC;IAC5CjB,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLM,YAAY;gBACZC,MAAM;YACR;QACF;IACF;AACF;AAEA,MAAMO,YAAyB;IAC7BlB,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,MAAMe,cAA2B;IAC/BhB,YAAY;QACViB,SAAS;YAAC;SAAkC;QAC5CC,KAAK;QACLC,OAAO;YACLC,QAAQ;gBACNC,WAAW;gBACXb,MAAM;YACR;QACF;IACF;AACF"}

package/dist/__tests__/fixtures/test-paths.d.ts

@@ -0,0 +1,2 @@
+import './payload-types.d.ts';
+//# sourceMappingURL=test-paths.d.ts.map

package/dist/__tests__/fixtures/test-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-paths.d.ts","sourceRoot":"","sources":["../../../src/__tests__/fixtures/test-paths.ts"],"names":[],"mappings":"AACA,OAAO,sBAAsB,CAAA"}

package/dist/__tests__/fixtures/test-paths.js

@@ -0,0 +1,115 @@
+// @ts-ignore - ambient type declarations
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+require("./payload-types.d.ts");
+// --- Valid: @/ alias with named export ---
+const aliasNamedExport = {
+    name: 'aliasNamed',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '@/components/NavIcon#NavIcon'
+        }
+    }
+};
+// --- Valid: @/ alias with second named export ---
+const aliasSecondExport = {
+    name: 'aliasSecond',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '@/components/NavIcon#NavIconSmall'
+        }
+    }
+};
+// --- Valid: @/ alias to nested path with default export ---
+const aliasDefaultExport = {
+    name: 'aliasDefault',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '@/components/ui/Badge'
+        }
+    }
+};
+// --- Valid: @/ alias in object form with exportName ---
+const aliasObjectForm = {
+    name: 'aliasObj',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                exportName: 'Badge',
+                path: '@/components/ui/Badge'
+            }
+        }
+    }
+};
+// --- Valid: @/ alias in object form with # in path ---
+const aliasObjectHash = {
+    name: 'aliasObjHash',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                path: '@/components/NavIcon#NavIcon'
+            }
+        }
+    }
+};
+// --- Invalid: @/ alias with wrong export ---
+const aliasWrongExport = {
+    name: 'aliasWrongExport',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '@/components/NavIcon#DoesNotExist'
+        }
+    }
+};
+// --- Invalid: @/ alias to non-existent file ---
+const aliasInvalidPath = {
+    name: 'aliasBadPath',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '@/components/NotAFile#Nope'
+        }
+    }
+};
+// --- Invalid: @/ alias no default export ---
+const aliasNoDefault = {
+    name: 'aliasNoDefault',
+    type: 'text',
+    admin: {
+        components: {
+            Field: '@/components/NavIcon'
+        }
+    }
+};
+// --- Invalid: @/ alias in object form with wrong exportName ---
+const aliasObjectWrongExport = {
+    name: 'aliasObjWrong',
+    type: 'text',
+    admin: {
+        components: {
+            Field: {
+                exportName: 'Fake',
+                path: '@/components/ui/Badge'
+            }
+        }
+    }
+};
+// --- Valid: @/ alias in array context ---
+const aliasInArray = {
+    components: {
+        actions: [
+            '@/components/NavIcon#NavIcon'
+        ],
+        Nav: '@/components/ui/Badge#Badge'
+    }
+};
+
+//# sourceMappingURL=test-paths.js.map

package/dist/__tests__/fixtures/test-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/__tests__/fixtures/test-paths.ts"],"sourcesContent":["// @ts-ignore - ambient type declarations\nimport './payload-types.d.ts'\n\n// --- Valid: @/ alias with named export ---\nconst aliasNamedExport: FieldConfig = {\n  name: 'aliasNamed',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '@/components/NavIcon#NavIcon',\n    },\n  },\n}\n\n// --- Valid: @/ alias with second named export ---\nconst aliasSecondExport: FieldConfig = {\n  name: 'aliasSecond',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '@/components/NavIcon#NavIconSmall',\n    },\n  },\n}\n\n// --- Valid: @/ alias to nested path with default export ---\nconst aliasDefaultExport: FieldConfig = {\n  name: 'aliasDefault',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '@/components/ui/Badge',\n    },\n  },\n}\n\n// --- Valid: @/ alias in object form with exportName ---\nconst aliasObjectForm: FieldConfig = {\n  name: 'aliasObj',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        exportName: 'Badge',\n        path: '@/components/ui/Badge',\n      },\n    },\n  },\n}\n\n// --- Valid: @/ alias in object form with # in path ---\nconst aliasObjectHash: FieldConfig = {\n  name: 'aliasObjHash',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        path: '@/components/NavIcon#NavIcon',\n      },\n    },\n  },\n}\n\n// --- Invalid: @/ alias with wrong export ---\nconst aliasWrongExport: FieldConfig = {\n  name: 'aliasWrongExport',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '@/components/NavIcon#DoesNotExist',\n    },\n  },\n}\n\n// --- Invalid: @/ alias to non-existent file ---\nconst aliasInvalidPath: FieldConfig = {\n  name: 'aliasBadPath',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '@/components/NotAFile#Nope',\n    },\n  },\n}\n\n// --- Invalid: @/ alias no default export ---\nconst aliasNoDefault: FieldConfig = {\n  name: 'aliasNoDefault',\n  type: 'text',\n  admin: {\n    components: {\n      Field: '@/components/NavIcon',\n    },\n  },\n}\n\n// --- Invalid: @/ alias in object form with wrong exportName ---\nconst aliasObjectWrongExport: FieldConfig = {\n  name: 'aliasObjWrong',\n  type: 'text',\n  admin: {\n    components: {\n      Field: {\n        exportName: 'Fake',\n        path: '@/components/ui/Badge',\n      },\n    },\n  },\n}\n\n// --- Valid: @/ alias in array context ---\nconst aliasInArray: AdminConfig = {\n  components: {\n    actions: ['@/components/NavIcon#NavIcon'],\n    Nav: '@/components/ui/Badge#Badge',\n  },\n}\n"],"names":["aliasNamedExport","name","type","admin","components","Field","aliasSecondExport","aliasDefaultExport","aliasObjectForm","exportName","path","aliasObjectHash","aliasWrongExport","aliasInvalidPath","aliasNoDefault","aliasObjectWrongExport","aliasInArray","actions","Nav"],"mappings":"AAAA,yCAAyC;;;;;QAClC;AAEP,4CAA4C;AAC5C,MAAMA,mBAAgC;IACpCC,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,mDAAmD;AACnD,MAAMC,oBAAiC;IACrCL,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,6DAA6D;AAC7D,MAAME,qBAAkC;IACtCN,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,yDAAyD;AACzD,MAAMG,kBAA+B;IACnCP,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLI,YAAY;gBACZC,MAAM;YACR;QACF;IACF;AACF;AAEA,wDAAwD;AACxD,MAAMC,kBAA+B;IACnCV,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLK,MAAM;YACR;QACF;IACF;AACF;AAEA,8CAA8C;AAC9C,MAAME,mBAAgC;IACpCX,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,iDAAiD;AACjD,MAAMQ,mBAAgC;IACpCZ,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,8CAA8C;AAC9C,MAAMS,iBAA8B;IAClCb,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;QACT;IACF;AACF;AAEA,iEAAiE;AACjE,MAAMU,yBAAsC;IAC1Cd,MAAM;IACNC,MAAM;IACNC,OAAO;QACLC,YAAY;YACVC,OAAO;gBACLI,YAAY;gBACZC,MAAM;YACR;QACF;IACF;AACF;AAEA,2CAA2C;AAC3C,MAAMM,eAA4B;IAChCZ,YAAY;QACVa,SAAS;YAAC;SAA+B;QACzCC,KAAK;IACP;AACF"}

package/dist/helpers.d.ts

@@ -0,0 +1,26 @@
+import type tslib from 'typescript/lib/tsserverlibrary';
+export type PayloadComponentContext = {
+    exportNameValue?: string;
+    node: tslib.StringLiteral;
+    type: 'path';
+} | {
+    node: tslib.StringLiteral;
+    pathValue?: string;
+    type: 'exportName';
+} | {
+    node: tslib.StringLiteral;
+    type: 'string';
+};
+/**
+ * Determines if a string literal is in a PayloadComponent context and what kind.
+ *
+ * - `'string'`: direct string form, e.g. `Field: '@/components/MyField#MyField'`
+ * - `'path'`: the `path` property in the object form, e.g. `{ path: '@/components/MyField' }`
+ * - `'exportName'`: the `exportName` property in the object form, e.g. `{ exportName: 'MyField' }`
+ */
+export declare function getPayloadComponentContext(ts: typeof tslib, node: tslib.StringLiteral, checker: tslib.TypeChecker): PayloadComponentContext | undefined;
+/**
+ * Returns the deepest token at a given position, reusing TypeScript's internal traversal.
+ */
+export declare function findNodeAtPosition(ts: typeof tslib, sourceFile: tslib.SourceFile, position: number): tslib.Node | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gCAAgC,CAAA;AAEvD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAA;AAEjD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,OAAO,KAAK,EAChB,IAAI,EAAE,KAAK,CAAC,aAAa,EACzB,OAAO,EAAE,KAAK,CAAC,WAAW,GACzB,uBAAuB,GAAG,SAAS,CA2BrC;AA+ED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,OAAO,KAAK,EAChB,UAAU,EAAE,KAAK,CAAC,UAAU,EAC5B,QAAQ,EAAE,MAAM,GACf,KAAK,CAAC,IAAI,GAAG,SAAS,CA0BxB"}