archicat 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BuildPlease
+
+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/README.md

@@ -0,0 +1,206 @@
+# ArchiCat
+
+**M²: Modular Mirroring.**
+
+ArchiCat is a Gradle-like generative architecture framework for TypeScript.
+
+TypeScript asks: **will this import resolve?**  
+ArchiCat asks: **should this import exist?**
+
+```bash
+npm i -D archicat
+```
+
+## Core rule
+
+```txt
+dependency graph = import permission graph
+```
+
+A source may import another ArchiCat target only when the dependency graph allows it.
+
+ArchiCat validates:
+
+```txt
+- unknown dependencies
+- self dependencies
+- API -> implementation dependencies
+- circular dependencies
+- cross-target source-path imports
+```
+
+## Targets
+
+A module or library has two targets:
+
+```txt
+module.dummy.api
+module.dummy.impl
+library.sample.api
+library.sample.impl
+```
+
+An app is a composition root:
+
+```txt
+app.test
+```
+
+## Dependency rules
+
+```txt
+api  -> api targets only
+impl -> own api + declared targets
+app  -> declared api/impl targets
+```
+
+Implementation targets are not public by default. They are importable only when declared as dependencies.
+
+## Module
+
+```ts
+import { defineModule } from 'archicat';
+
+export default defineModule({
+  name: 'dummy',
+
+  api: {
+    root: './api',
+    dependencies: ['module.mock.api'],
+  },
+
+  impl: {
+    root: './impl',
+    dependencies: ['module.mock.api', 'library.sample.api'],
+  },
+});
+```
+
+## Library
+
+```ts
+import { defineLibrary } from 'archicat';
+
+export default defineLibrary({
+  name: 'sample',
+
+  api: './api',
+  impl: './impl',
+});
+```
+
+## App
+
+```ts
+import { defineApp } from 'archicat';
+
+export default defineApp({
+  name: 'test',
+  root: './src/app',
+
+  dependencies: ['module.dummy.impl', 'library.sample.impl'],
+});
+```
+
+## Imports
+
+Public API:
+
+```ts
+import { dummyApi } from '#modules/dummy/api/index.js';
+```
+
+Declared implementation dependency:
+
+```ts
+import { dummyImpl } from '#modules/dummy/impl/index.js';
+```
+
+Blocked without dependency:
+
+```ts
+import { dummyImpl } from '#modules/dummy/impl/index.js';
+```
+
+Blocked source-path boundary bypass:
+
+```ts
+import { dummyImpl } from '../../dummy/impl/index.js';
+```
+
+Local same-target imports stay normal:
+
+```ts
+import { dto } from './dto.js';
+```
+
+## Config
+
+```ts
+import { defineArchicatConfig } from 'archicat';
+
+export default defineArchicatConfig({
+  typescript: {
+    tsConfig: {
+      extends: '../../tsconfig.node.json',
+      include: ['bootstrap.ts', 'src/app', 'src/libraries', 'src/modules', 'types'],
+      exclude: ['node_modules', 'dist'],
+    },
+  },
+
+  alias: {
+    '@app': './src/app/index.ts',
+    '@app/*': './src/app/*',
+  },
+
+  modules: {
+    include: ['./src/modules'],
+    alias: '#modules',
+  },
+
+  libraries: {
+    include: ['./src/libraries'],
+    alias: '#library',
+  },
+
+  apps: {
+    include: ['./src/app'],
+  },
+});
+```
+
+App `tsconfig.json`:
+
+```json
+{
+  "extends": "./.archicat/tsconfig.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "./dist"
+  }
+}
+```
+
+User aliases belong in `archicat.config.ts`, not in `compilerOptions.paths`.
+
+## Output
+
+```txt
+.archicat/
+  tsconfig.json
+  modules/
+  libraries/
+  types/
+  reports/
+    build.report.json
+    graph.report.json
+```
+
+## Commands
+
+```bash
+archicat generate
+archicat validate
+archicat graph
+archicat doctor
+```

package/bin/archicat.mjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runMain } from '../dist/cli/index.mjs';
+
+await runMain();

package/dist/cli/index.mjs

@@ -0,0 +1,28 @@
+import{createRequire as e}from"node:module";import{Console as t}from"@buildplease/core/node";import n from"node:fs";import r from"node:path";import i from"typescript";import{createJiti as a}from"jiti";const o={packageName:`archicat`,configFileName:`archicat.config.ts`,root:`.`,outDir:`.archicat`,alias:{},definitions:{moduleFileName:`archicat.module.ts`,libraryFileName:`archicat.library.ts`,appFileName:`archicat.app.ts`},generated:{modulesDirName:`modules`,librariesDirName:`libraries`,typesDirName:`types`,reportsDirName:`reports`,buildReportFileName:`build.report.json`,graphReportFileName:`graph.report.json`,tsconfigFileName:`tsconfig.json`,typesInclude:`./types/**/*.d.ts`,ignoredDirectoryNames:[`node_modules`,`.git`,`.archicat`,`dist`,`build`,`coverage`]},typescript:{consumerTsconfigFileName:`tsconfig.json`,tsConfig:{include:[],exclude:[],files:[]}},modules:{include:[`./src/modules`],alias:`#modules`},libraries:{include:[],alias:`#library`},apps:{include:[]}};function s(e){let t=n.readFileSync(e,`utf8`),r=i.parseConfigFileTextToJson(e,t);if(r.error)throw Error(te(r.error));if(r.config==null||typeof r.config!=`object`||Array.isArray(r.config))throw Error(`Invalid tsconfig object: ${e}`);return r.config}function c(e,t=`tsconfig`){let n=e.compilerOptions;if(n==null)return{};if(typeof n!=`object`||Array.isArray(n))throw Error(`Tsconfig compilerOptions must be an object: ${t}`);return n}function l(e,t){let n=e.extends;if(n===void 0)return[];if(typeof n==`string`)return[d(t,n)];if(Array.isArray(n)&&n.every(e=>typeof e==`string`))return n.map(e=>d(t,e));throw Error(`Tsconfig extends must be a string or string array: ${t}`)}function u(t,n){return r.isAbsolute(n)||n.startsWith(`.`)?ee(r.resolve(t,n),n):f(e(r.join(t,o.configFileName)),n,n)}function d(t,n){return r.isAbsolute(n)||n.startsWith(`.`)?ee(r.resolve(r.dirname(t),n),t):f(e(t),n,t)}function f(e,t,n){for(let n of p(t))try{return e.resolve(n)}catch{continue}throw Error(`Unable to resolve tsconfig extends "${t}": ${n}`)}function ee(e,t){for(let t of p(e))if(n.existsSync(t)&&n.statSync(t).isFile())return t;throw Error(`Unable to resolve tsconfig extends "${e}": ${t}`)}function p(e){return[e,`${e}.json`,r.join(e,o.typescript.consumerTsconfigFileName)]}function te(e){let t=i.flattenDiagnosticMessageText(e.messageText,`
+`);if(e.file&&e.start!==void 0){let n=e.file.getLineAndCharacterOfPosition(e.start);return`${e.file.fileName}:${n.line+1}:${n.character+1} - ${t}`}return t}async function ne(e,t=o.configFileName){let i=r.resolve(e,t);if(!n.existsSync(i))throw Error(`Archicat config was not found: ${i}`);let a=await re(i,e);ue(a,i);let s=ie(a);me(s.modules.alias,s.libraries.alias,i);let c=r.resolve(e,s.root),l=r.resolve(c,s.outDir),u=r.resolve(l,o.generated.reportsDirName),d=le(c,s.typescript.tsConfig.extends);return{configFilePath:i,rootDir:c,outDir:l,reportsDir:u,...d?{tsconfigPath:d}:{},resolvedConfig:s}}async function re(e,t){return await a(t,{interopDefault:!0,extensions:[`.js`,`.cjs`,`.mjs`,`.ts`,`.cts`,`.mts`,`.json`]}).import(e,{default:!0})}function ie(e){return{root:e.root??o.root,outDir:e.outDir??o.outDir,typescript:ae(e),alias:{...o.alias,...e.alias??{}},modules:oe(e.modules),libraries:se(e.libraries),apps:ce(e.apps)}}function ae(e){let t=e.typescript?.tsConfig,n=o.typescript.tsConfig,r={include:[...t?.include??n.include],exclude:[...t?.exclude??n.exclude],files:[...t?.files??n.files]};return t?.extends&&(r.extends=t.extends),{tsConfig:r}}function oe(e){return{include:[...e?.include??o.modules.include],alias:e?.alias??o.modules.alias}}function se(e){return{include:[...e?.include??o.libraries.include],alias:e?.alias??o.libraries.alias}}function ce(e){return{include:[...e?.include??o.apps.include]}}function le(e,t){if(t)return u(e,t)}function ue(e,t){if(typeof e!=`object`||!e)throw Error(`Invalid Archicat config: ${t}`);let n=e;m(n.root,`root`,t),m(n.outDir,`outDir`,t),_(n.typescript,`typescript`,t),_(n.modules,`modules`,t),_(n.libraries,`libraries`,t),_(n.apps,`apps`,t),de(n.typescript?.tsConfig,t),h(n.modules?.include,`modules.include`,t),h(n.libraries?.include,`libraries.include`,t),h(n.apps?.include,`apps.include`,t),g(n.modules?.alias,`modules.alias`,t),g(n.libraries?.alias,`libraries.alias`,t),pe(n.alias,`alias`,t)}function de(e,t){if(e===void 0)return;if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Archicat config typescript.tsConfig must be an object: ${t}`);let n=e;m(n.extends,`typescript.tsConfig.extends`,t),h(n.include,`typescript.tsConfig.include`,t),h(n.exclude,`typescript.tsConfig.exclude`,t),h(n.files,`typescript.tsConfig.files`,t),fe(n.compilerOptions,t)}function fe(e,t){if(e===void 0)return;if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Archicat config typescript.tsConfig.compilerOptions must be an object: ${t}`);let n=e;if(Object.hasOwn(n,`paths`))throw Error(`Archicat config typescript.tsConfig.compilerOptions.paths is not supported. Move aliases into archicat.config.ts alias.`);if(Object.hasOwn(n,`baseUrl`))throw Error(`Archicat config typescript.tsConfig.compilerOptions.baseUrl is not supported. Move aliases into archicat.config.ts alias.`);if(Object.keys(n).length>0)throw Error(`Archicat config typescript.tsConfig.compilerOptions is not supported. Put compiler options in the base or app tsconfig.`)}function m(e,t,n){if(e!==void 0&&(typeof e!=`string`||e.trim()===``))throw Error(`Archicat ${t} must be a non-empty string when defined: ${n}`)}function h(e,t,n){if(e!==void 0&&(!Array.isArray(e)||e.some(e=>typeof e!=`string`||e.trim()===``)))throw Error(`Archicat config ${t} must be an array of non-empty strings: ${n}`)}function g(e,t,n){if(e!==void 0&&(typeof e!=`string`||e.trim()===``||e.includes(`*`)||e.endsWith(`/`)))throw Error(`Archicat config ${t} must be a non-empty alias without wildcard or trailing slash: ${n}`)}function pe(e,t,n){if(e!==void 0){if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Archicat config ${t} must be an object of non-empty string aliases: ${n}`);for(let[r,i]of Object.entries(e))if(r.trim()===``||typeof i!=`string`||i.trim()===``)throw Error(`Archicat config ${t} must contain non-empty string aliases: ${n}`)}}function _(e,t,n){if(e!==void 0&&(typeof e!=`object`||!e||Array.isArray(e)))throw Error(`Archicat config ${t} must be an object: ${n}`)}function me(e,t,n){if(e===t||e.startsWith(`${t}/`)||t.startsWith(`${e}/`))throw Error(`Archicat module and library aliases must use separate roots: "${e}" and "${t}" (${n})`)}function v(e){return e.split(r.sep).join(`/`)}function he(e,t){let n=r.dirname(e),i=r.parse(t),a=r.join(i.dir,i.name),o=v(r.relative(n,a));return o.startsWith(`.`)||(o=`./${o}`),`${o}.js`}function y(e,t){let n=r.relative(t,e);return n===``||!!n&&!n.startsWith(`..`)&&!r.isAbsolute(n)}function ge(e,t){let n=b(e),r=b(t);if(r===n||!y(r,n))throw Error(`Archicat outDir must be a directory inside the project root: ${t}`)}function b(e){let t=r.resolve(e),i=[],a=t;for(;!n.existsSync(a);){let e=r.dirname(a);if(e===a)return t;i.unshift(r.basename(a)),a=e}return r.join(n.realpathSync(a),...i)}function x(e){return e.replace(/\.(?:js|mjs|cjs|ts|mts|cts|tsx)$/u,``)}function S(e,t){return v(r.relative(e,t))}function C(e,t,n,r=[]){let i=t.flatMap(t=>_e(e,t,n,r));return Array.from(new Set(i)).sort((e,t)=>e.localeCompare(t))}function _e(e,t,i,a){let o=r.resolve(e,t);if(t.includes(`*`))return ye(e,t).filter(e=>!a.some(t=>y(e,t))).filter(e=>r.basename(e)===i);if(!n.existsSync(o))return[];let s=n.statSync(o);return s.isFile()?r.basename(o)===i?[o]:[]:s.isDirectory()?ve(o,i,a):[]}function ve(e,t,i){let a=[],o=n.readdirSync(e,{withFileTypes:!0});for(let n of o){if(xe(n.name))continue;let o=r.join(e,n.name);if(!i.some(e=>y(o,e))){if(n.isDirectory()){a.push(...ve(o,t,i));continue}n.isFile()&&n.name===t&&a.push(o)}}return a}function ye(e,t){let i=r.resolve(e,t).split(r.sep);if(i.filter(e=>e.includes(`*`)).length!==1)throw Error(`Archicat supports exactly one wildcard segment per include pattern: ${t}`);let a=i.findIndex(e=>e.includes(`*`)),o=i.slice(0,a).join(r.sep)||r.sep,s=i[a]??`*`,c=i.slice(a+1),l=be(s);return n.existsSync(o)?n.readdirSync(o,{withFileTypes:!0}).filter(e=>e.isDirectory()).filter(e=>l.test(e.name)).map(e=>r.join(o,e.name,...c)).filter(e=>n.existsSync(e)&&n.statSync(e).isFile()):[]}function be(e){let t=e.replace(/[.+?^${}()|[\]\\]/gu,`\\$&`).replace(/\*/gu,`.*`);return RegExp(`^${t}$`,`u`)}function xe(e){return o.generated.ignoredDirectoryNames.includes(e)}async function w(e,t){switch(t){case`module`:return Se(e);case`library`:return Ce(e);case`app`:return we(e)}}async function Se(e){let t=await T(e,r.dirname(e));return E(t,e,`module`),{kind:`module`,contractFilePath:e,definitionDir:r.dirname(e),contract:t}}async function Ce(e){let t=await T(e,r.dirname(e));return E(t,e,`library`),{kind:`library`,contractFilePath:e,definitionDir:r.dirname(e),contract:t}}async function we(e){let t=await T(e,r.dirname(e));return E(t,e,`app`),{kind:`app`,contractFilePath:e,definitionDir:r.dirname(e),contract:t}}async function T(e,t){return await a(t,{interopDefault:!0,extensions:[`.js`,`.cjs`,`.mjs`,`.ts`,`.cts`,`.mts`,`.json`]}).import(e,{default:!0})}function E(e,t,n){if(typeof e!=`object`||!e)throw Error(`Invalid Archicat ${n} definition: ${t}`);let r=e;if(r.kind!==n)throw Error(`Archicat ${n} file must export a ${n} definition: ${t}`);if(typeof r.name!=`string`||r.name.trim()===``)throw Error(`Archicat ${n} must define a non-empty name: ${t}`);if(n===`app`){k(r.root,`root`,t),O(r.dependencies,t,n);return}let i=r;D(i.api,`api`,t,n),D(i.impl,`impl`,t,n)}function D(e,t,n,r){if(typeof e!=`object`||!e)throw Error(`Archicat ${r}.${t} must be a surface object: ${n}`);k(e.root,`${t}.root`,n),O(e.dependencies,n,`${r}.${t}`)}function O(e,t,n){if(!Array.isArray(e)||e.some(e=>typeof e!=`string`||e.trim()===``))throw Error(`Archicat ${n} dependencies must be an array of non-empty strings: ${t}`)}function k(e,t,n){if(e!==void 0&&(typeof e!=`string`||e.trim()===``))throw Error(`Archicat ${t} must be a non-empty string when defined: ${n}`)}function Te(e){let t=new Map;for(let n of e){let e=t.get(n.from)??[];e.push(n.to),t.set(n.from,e)}let n=new Set,r=new Set;for(let e of t.keys())A(e,t,n,r,[])}function A(e,t,n,r,i){if(!r.has(e)){if(n.has(e)){let t=i.indexOf(e),n=[...i.slice(t<0?0:t),e];throw Error(`Cyclic Archicat dependency detected: ${n.join(` -> `)}`)}n.add(e);for(let a of t.get(e)??[])A(a,t,n,r,[...i,e]);n.delete(e),r.add(e)}}function Ee(e){let t=/^(module|library)\.([a-z][a-z0-9-]*)\.(api|impl)$/u.exec(e);if(t)return{kind:t[1],name:t[2],surface:t[3]}}function j(e,t,n){let r=Ee(t);if(!r)throw Error(`${M(e)} declares invalid dependency target "${t}".`);if(!n.has(t))throw Error(`${M(e)} declares unknown dependency "${t}".`);if(e.target===t)throw Error(`${M(e)} cannot depend on itself: ${t}`);if(e.surface===`api`&&r.surface===`impl`)throw Error(`${M(e)} cannot depend on implementation target "${t}" from an API surface.`)}function M(e){return e.kind===`app`?`App "${e.name}"`:`${De(e.kind)} "${e.name}" ${e.surface}`}function De(e){return`${e.charAt(0).toUpperCase()}${e.slice(1)}`}function Oe(e,t){let n=t.filter(e=>e.kind===`module`).map(t=>ke(e,t)),r=t.filter(e=>e.kind===`library`).map(t=>Ae(e,t)),i=t.filter(e=>e.kind===`app`).map(e=>je(e)),a=[...n,...r];Ne([...a,...i]);let o=Me(a,i);return Pe(a,i,o.targets),Te(o.dependencies),{rootDir:e.rootDir,outDir:e.outDir,reportsDir:e.reportsDir,...e.tsconfigPath?{tsconfigPath:e.tsconfigPath}:{},configFilePath:e.configFilePath,config:e.resolvedConfig,modules:n,libraries:r,apps:i,definitions:a,graph:o}}function ke(e,t){let{contract:n,contractFilePath:i,definitionDir:a}=t;F(n.name,i,`module`);let s=n.api.root?P(a,n.api.root,`api`,n.name):void 0,c=n.impl.root?P(a,n.impl.root,`impl`,n.name):void 0,l=`${e.resolvedConfig.modules.alias}/${n.name}`,u=`${l}/api`,d=`${l}/impl`;return{kind:`module`,name:n.name,apiTarget:`module.${n.name}.api`,implTarget:`module.${n.name}.impl`,alias:u,aliasGlob:`${u}/*`,implAlias:d,implAliasGlob:`${d}/*`,contractFilePath:i,definitionDir:a,api:N(s,n.api.dependencies,r.join(e.outDir,o.generated.modulesDirName,n.name,`api`)),impl:N(c,n.impl.dependencies,r.join(e.outDir,o.generated.modulesDirName,n.name,`impl`))}}function Ae(e,t){let{contract:n,contractFilePath:i,definitionDir:a}=t;F(n.name,i,`library`);let s=n.api.root?P(a,n.api.root,`api`,n.name):void 0,c=n.impl.root?P(a,n.impl.root,`impl`,n.name):void 0,l=`${e.resolvedConfig.libraries.alias}/${n.name}`,u=`${l}/api`,d=`${l}/impl`;return{kind:`library`,name:n.name,apiTarget:`library.${n.name}.api`,implTarget:`library.${n.name}.impl`,alias:u,aliasGlob:`${u}/*`,implAlias:d,implAliasGlob:`${d}/*`,contractFilePath:i,definitionDir:a,api:N(s,n.api.dependencies,r.join(e.outDir,o.generated.librariesDirName,n.name,`api`)),impl:N(c,n.impl.dependencies,r.join(e.outDir,o.generated.librariesDirName,n.name,`impl`))}}function je(e){let{contract:t,contractFilePath:n,definitionDir:r}=e;return F(t.name,n,`app`),{kind:`app`,name:t.name,target:`app.${t.name}`,contractFilePath:n,rootPath:t.root?P(r,t.root,`app`,t.name):r,dependencies:[...t.dependencies]}}function N(e,t,n){return{...e?{rootPath:e}:{},mirrorRootPath:n,dependencies:[...t]}}function P(e,t,i,a){let o=r.resolve(e,t);if(!n.existsSync(o))throw Error(`Definition "${a}" declares ${i} root that does not exist: ${o}`);if(!n.statSync(o).isDirectory())throw Error(`Definition "${a}" declares ${i} root that is not a directory: ${o}`);return o}function Me(e,t){let n=e.flatMap(e=>[{key:e.apiTarget,surface:`api`},{key:e.implTarget,surface:`impl`}]),r=[...e.flatMap(e=>[...e.api.dependencies.map(t=>({from:e.apiTarget,to:t,origin:`declared`})),...e.impl.dependencies.map(t=>({from:e.implTarget,to:t,origin:`declared`}))]),...t.flatMap(e=>e.dependencies.map(t=>({from:e.target,to:t,origin:`declared`})))];return{targets:n,dependencies:[...e.map(e=>({from:e.implTarget,to:e.apiTarget,origin:`derived`})),...r]}}function F(e,t,n){if(!/^[a-z][a-z0-9-]*$/u.test(e))throw Error(`Invalid Archicat ${n} name "${e}" in ${t}. Use ^[a-z][a-z0-9-]*$`)}function Ne(e){let t=new Map;for(let n of e){let e=`${n.kind}.${n.name}`,r=t.get(e);if(r)throw Error(`Duplicate Archicat ${n.kind} name "${n.name}" in ${r} and ${n.contractFilePath}`);t.set(e,n.contractFilePath)}}function Pe(e,t,n){let r=new Set(n.map(e=>e.key));for(let t of e){for(let e of t.api.dependencies)j(Fe(t,`api`),e,r);for(let e of t.impl.dependencies)j(Fe(t,`impl`),e,r)}for(let e of t)for(let t of e.dependencies)j({kind:`app`,name:e.name,surface:`app`,target:e.target},t,r)}function Fe(e,t){return{kind:e.kind,name:e.name,surface:t,target:t===`api`?e.apiTarget:e.implTarget}}async function Ie(e,t){let n=await ne(e,t),r=C(n.rootDir,n.resolvedConfig.modules.include,o.definitions.moduleFileName,[n.outDir]),i=C(n.rootDir,n.resolvedConfig.libraries.include,o.definitions.libraryFileName,[n.outDir]),a=C(n.rootDir,n.resolvedConfig.apps.include,o.definitions.appFileName,[n.outDir]);if(r.length===0&&i.length===0&&a.length===0)throw Error(`No Archicat definition files matched configured include roots.`);return Oe(n,[...await Promise.all(r.map(e=>w(e,`module`))),...await Promise.all(i.map(e=>w(e,`library`))),...await Promise.all(a.map(e=>w(e,`app`)))])}function Le(e){let t=[];Re(t,`Modules`,e.modules.length,e.modules,e.graph.dependencies),Re(t,`Libraries`,e.libraries.length,e.libraries,e.graph.dependencies),t.push(`Apps: ${e.apps.length}`),e.apps.length>0&&t.push(``);for(let n of e.apps)t.push(n.name),t.push(`  app: ${n.target}`),I(t,e.graph.dependencies.filter(e=>e.from===n.target),`  dependsOn`),t.push(``);return ze(t)}function Re(e,t,n,r,i){e.push(`${t}: ${n}`),r.length>0&&e.push(``);for(let t of r)e.push(t.name),e.push(`  api: ${t.apiTarget}`),I(e,i.filter(e=>e.from===t.apiTarget),`  api dependsOn`),e.push(`  impl: ${t.implTarget}`),I(e,i.filter(e=>e.from===t.implTarget),`  impl dependsOn`),e.push(``)}function I(e,t,n){if(t.length===0){e.push(`${n}: none`);return}e.push(`${n}:`);for(let n of t){let t=n.origin===`derived`?` (derived)`:``;e.push(`    ${n.to}${t}`)}}function ze(e){for(;e.at(-1)===``;)e.pop();return e}async function Be(e,t){return{exitCode:0,lines:Le(await Ie(t,e.config)).map(e=>({kind:`info`,message:e}))}}function Ve(e){return[...He(e),...Xe(e)]}function He(e){let t=Ze(e);if(!n.existsSync(t))return[`Consumer tsconfig was not found: ${t}`];let r=[],i=Ue(t,r);if(!i)return r;let a=We(i,t,r);return a?(Ge(r,e,i),Ke(r,a),qe(r,a),Je(r,a),Ye(r,i),r):r}function Ue(e,t){try{return s(e)}catch(e){t.push(`Failed to parse consumer tsconfig: ${tt(e)}`);return}}function We(e,t,n){try{return c(e,t)}catch(e){n.push(tt(e));return}}function Ge(e,t,n){let r=$e(t);n.extends!==r&&e.push(`Consumer tsconfig should extend ${r} for generated Archicat aliases to work.`)}function Ke(e,t){let n=t.rootDir;(n===`src`||n===`./src`)&&e.push(`compilerOptions.rootDir is set to src. Generated Archicat files live outside src and may break tsc.`)}function qe(e,t){Object.hasOwn(t,`paths`)&&e.push(`compilerOptions.paths should move to archicat.config.ts alias. Consumer tsconfig paths can override generated Archicat aliases.`)}function Je(e,t){Object.hasOwn(t,`baseUrl`)&&e.push(`compilerOptions.baseUrl is not supported. Move aliases into archicat.config.ts alias.`)}function Ye(e,t){(t.include!==void 0||t.exclude!==void 0||t.files!==void 0)&&e.push(`Consumer tsconfig include/exclude/files should move to archicat.config.ts typescript.tsConfig so generated Archicat types stay included.`)}function Xe(e){let t=[];for(let i of e.definitions){let e=r.join(i.definitionDir,`api`),a=r.join(i.definitionDir,`impl`);!i.api.rootPath&&n.existsSync(e)&&t.push(`${L(i.kind)} "${i.name}" has a physical api directory but its contract omits api.root. Archicat treats the public API as empty.`),!i.impl.rootPath&&n.existsSync(a)&&t.push(`${L(i.kind)} "${i.name}" has a physical impl directory but its contract omits impl.root. Archicat treats the implementation as no-op.`)}return t}function Ze(e){return r.join(e.rootDir,o.typescript.consumerTsconfigFileName)}function Qe(e){return r.join(e.outDir,o.generated.tsconfigFileName)}function $e(e){let t=v(r.relative(e.rootDir,Qe(e)));return et(t)||(t=`./${t}`),t}function et(e){return e.startsWith(`./`)||e.startsWith(`../`)}function tt(e){return e instanceof Error?e.message:String(e)}function L(e){return`${e.charAt(0).toUpperCase()}${e.slice(1)}`}function nt(e,t){ge(e,t),rt(e,t),n.rmSync(t,{recursive:!0,force:!0}),n.mkdirSync(t,{recursive:!0})}function R(e,t){n.mkdirSync(r.dirname(e),{recursive:!0}),n.writeFileSync(e,t,`utf8`)}function z(e,t){R(e,`${JSON.stringify(t,null,2)}\n`)}function rt(e,t){if(!(!n.existsSync(t)||n.readdirSync(t).length===0)&&!it(e,t))throw Error(`Archicat refuses to replace a non-owned outDir: ${t}`)}function it(e,t){let i=r.join(t,o.generated.reportsDirName,o.generated.buildReportFileName);if(!n.existsSync(i))return!1;try{let a=JSON.parse(n.readFileSync(i,`utf8`));return a.generatedBy===`archicat`&&a.schemaVersion===2&&typeof a.outputs?.outDir==`string`&&r.resolve(e,a.outputs.outDir)===r.resolve(t)}catch{return!1}}function at(e){let t=e.graph.targets.map(e=>e.key),n=e.graph.targets.filter(e=>e.surface===`api`).map(e=>e.key),i=o.packageName,a=`import '${i}';
+
+declare module '${i}' {
+${B(`ArchicatModuleApiDependencies`,n)}
+
+${B(`ArchicatModuleImplDependencies`,t)}
+
+${B(`ArchicatLibraryApiDependencies`,n)}
+
+${B(`ArchicatLibraryImplDependencies`,t)}
+
+${B(`ArchicatAppDependencies`,t)}
+}
+
+export {};
+`;R(r.join(e.outDir,o.generated.typesDirName,`graph.d.ts`),a)}function B(e,t){return`  interface ${e} {\n${Array.from(new Set(t)).sort((e,t)=>e.localeCompare(t)).map(e=>`    '${e}': true;`).join(`
+`)}\n  }`}function V(e){return n.existsSync(e)?n.statSync(e).isFile()?H(e)?[e]:[]:U(e).filter(H).sort((e,t)=>e.localeCompare(t)):[]}function H(e){return/\.(?:ts|mts|cts|tsx)$/u.test(e)&&!/\.d\.(?:ts|mts|cts)$/u.test(e)}function U(e){let t=[],i=n.readdirSync(e,{withFileTypes:!0});for(let n of i){let i=r.join(e,n.name);if(n.isDirectory()){t.push(...U(i));continue}n.isFile()&&t.push(i)}return t}function ot(e){let t=i.createSourceFile(e,n.readFileSync(e,`utf8`),i.ScriptTarget.Latest,!0),r=[],a=e=>{if(i.isImportDeclaration(e)&&i.isStringLiteral(e.moduleSpecifier)&&r.push({moduleSpecifier:e.moduleSpecifier.text,kind:`import`}),i.isExportDeclaration(e)&&e.moduleSpecifier&&i.isStringLiteral(e.moduleSpecifier)&&r.push({moduleSpecifier:e.moduleSpecifier.text,kind:`export`}),i.isCallExpression(e)&&e.expression.kind===i.SyntaxKind.ImportKeyword){let[t]=e.arguments;t&&i.isStringLiteral(t)&&r.push({moduleSpecifier:t.text,kind:`dynamic-import`})}i.forEachChild(e,a)};return a(t),r}function st(e){let t=i.createSourceFile(e,n.readFileSync(e,`utf8`),i.ScriptTarget.Latest,!0),r=!1,a=e=>{if(!r){if(i.isExportAssignment(e)&&!e.isExportEquals){r=!0;return}if(ct(e)){r=!0;return}if(i.isExportDeclaration(e)&&e.exportClause&&i.isNamedExports(e.exportClause))for(let t of e.exportClause.elements){let e=t.name.text,n=t.propertyName?.text;if(e==="default"||n==="default"){r=!0;return}}i.forEachChild(e,a)}};return a(t),r}function ct(e){let t=i.canHaveModifiers(e)?i.getModifiers(e):void 0;if(!t)return!1;let n=t.some(e=>e.kind===i.SyntaxKind.ExportKeyword),r=t.some(e=>e.kind===i.SyntaxKind.DefaultKeyword);return n&&r}function lt(e){for(let t of e)ut(t.api),dt(t)}function ut(e){if(!e.rootPath){W(r.join(e.mirrorRootPath,`index.ts`));return}let t=new Set;for(let n of V(e.rootPath)){let i=v(r.relative(e.rootPath,n));t.add(i),G(r.join(e.mirrorRootPath,i),n)}t.has(`index.ts`)||W(r.join(e.mirrorRootPath,`index.ts`))}function dt(e){let t=e.impl.rootPath?ft(e.impl.rootPath):void 0;if(t){G(r.join(e.impl.mirrorRootPath,`index.ts`),t);return}let n=e.kind===`module`?`ArchicatModuleImplementation`:`ArchicatLibraryImplementation`,i=`${K()}
+export const ${n} = {
+  name: '${e.name}',
+} as const;
+
+export default ${n};
+`;R(r.join(e.impl.mirrorRootPath,`index.ts`),i)}function W(e){R(e,`${K()}export {};\n`)}function G(e,t){let n=he(e,t),r=st(t)?`export { default } from '${n}';\n`:``;R(e,`${K()}
+export * from '${n}';
+${r}`)}function ft(e){for(let t of[`index.ts`,`index.mts`,`index.cts`,`index.tsx`]){let i=r.join(e,t);if(n.existsSync(i)&&n.statSync(i).isFile())return i}}function K(){return`// Mirrored by Archicat.
+`}function pt(e){z(r.join(e.reportsDir,o.generated.buildReportFileName),mt(e)),z(r.join(e.reportsDir,o.generated.graphReportFileName),ht(e))}function mt(e){return{generatedBy:`archicat`,schemaVersion:2,aliases:{module:e.config.modules.alias,library:e.config.libraries.alias},outputs:{outDir:S(e.rootDir,e.outDir),reportsDir:S(e.rootDir,e.reportsDir)},targets:e.graph.targets.map(e=>e.key),definitions:[...e.definitions.map(t=>gt(e,t)),...e.apps.map(t=>({kind:t.kind,name:t.name,targets:{app:t.target},aliases:{},dependencies:t.dependencies,contractFilePath:S(e.rootDir,t.contractFilePath),source:{root:S(e.rootDir,t.rootPath)},mirror:{}}))],dependencies:e.graph.dependencies}}function ht(e){return{generatedBy:`archicat`,schemaVersion:1,targets:e.graph.targets.map(e=>e.key),dependencies:e.graph.dependencies}}function gt(e,t){return{kind:t.kind,name:t.name,targets:{api:t.apiTarget,impl:t.implTarget},aliases:{api:t.alias,impl:t.implAlias},dependencies:{api:t.api.dependencies,impl:t.impl.dependencies},contractFilePath:S(e.rootDir,t.contractFilePath),source:{root:S(e.rootDir,t.definitionDir),api:t.api.rootPath?S(e.rootDir,t.api.rootPath):void 0,impl:t.impl.rootPath?S(e.rootDir,t.impl.rootPath):void 0},mirror:{api:S(e.rootDir,t.api.mirrorRootPath),impl:S(e.rootDir,t.impl.mirrorRootPath)}}}function _t(e){Dt(e.tsconfigPath),z(r.join(e.outDir,o.generated.tsconfigFileName),vt(e))}function vt(e){let t={compilerOptions:yt(e),include:xt(e)},n=bt(e),r=St(e),i=Ct(e);return n&&(t.extends=n),r.length>0&&(t.exclude=r),i.length>0&&(t.files=i),t}function yt(e){let t=Tt(e),n=wt(e);return jt(e,t,n),{paths:{...t,...n}}}function bt(e){return e.tsconfigPath?J(e.outDir,e.tsconfigPath):void 0}function xt(e){return Et([...q(e,e.config.typescript.tsConfig.include),o.generated.typesInclude])}function St(e){return q(e,e.config.typescript.tsConfig.exclude)}function Ct(e){return q(e,e.config.typescript.tsConfig.files)}function wt(e){let t={};for(let n of e.definitions)n.api.rootPath&&(t[n.aliasGlob]=[J(e.outDir,r.join(n.api.rootPath,`*`))]),n.impl.rootPath&&(t[n.implAliasGlob]=[J(e.outDir,r.join(n.impl.rootPath,`*`))]);return t}function Tt(e){let t={};for(let[n,i]of Object.entries(e.config.alias)){let a=r.isAbsolute(i)?i:r.resolve(e.rootDir,i);t[n]=[J(e.outDir,a)]}return t}function q(e,t){return t.map(t=>{let n=r.isAbsolute(t)?t:r.resolve(e.rootDir,t);return J(e.outDir,n)})}function J(e,t){let n=v(r.relative(e,t));return n.startsWith(`.`)||(n=`./${n}`),n}function Et(e){return[...new Set(e)]}function Dt(e){e&&Ot(e,new Set,new Set)}function Ot(e,t,n){let i=r.resolve(e);if(n.has(i))return;if(t.has(i))throw Error(`Circular tsconfig extends chain detected: ${i}`);t.add(i);let a=s(i),o=c(a,i);kt(o,i),At(o,i);for(let e of l(a,i))Ot(e,t,n);t.delete(i),n.add(i)}function kt(e,t){if(Object.hasOwn(e,`paths`))throw Error(`Base tsconfig compilerOptions.paths is not supported by Archicat. Move aliases into archicat.config.ts alias: ${t}`)}function At(e,t){if(Object.hasOwn(e,`baseUrl`))throw Error(`Base tsconfig compilerOptions.baseUrl is not supported by Archicat. Move aliases into archicat.config.ts alias: ${t}`)}function jt(e,t,n){let r=Object.keys(t),i=Object.keys(n),a=[e.config.modules.alias,e.config.libraries.alias];for(let e of r){if(i.includes(e))throw Error(`Alias conflict: archicat.config.ts alias already defines "${e}", but Archicat needs it.`);for(let t of a)if(e===t||e===`${t}/*`||e.startsWith(`${t}/`))throw Error(`Alias conflict: archicat.config.ts alias "${e}" is inside Archicat reserved alias "${t}". Remove the alias or configure another module/library alias.`)}}function Mt(e){nt(e.rootDir,e.outDir),n.mkdirSync(r.join(e.outDir,o.generated.modulesDirName),{recursive:!0}),n.mkdirSync(r.join(e.outDir,o.generated.librariesDirName),{recursive:!0}),n.mkdirSync(r.join(e.outDir,o.generated.typesDirName),{recursive:!0}),n.mkdirSync(e.reportsDir,{recursive:!0}),lt(e.definitions),at(e),_t(e),pt(e)}function Nt(e){let t=Bt(e.graph.dependencies),n=[],r=[...e.definitions.flatMap(e=>[...e.api.rootPath?V(e.api.rootPath):[],...e.impl.rootPath?V(e.impl.rootPath):[]]),...e.apps.flatMap(e=>V(e.rootPath))];for(let i of r){let r=It(e,i);if(r)for(let a of ot(i)){let o=Ft(e,t,r,i,a.moduleSpecifier);o&&n.push(o)}}return n}function Pt(e){return`${e.filePath}\n  import: ${e.importPath}\n  ${e.message}`}function Ft(e,t,n,r,i){let a=Rt(e,i);if(a)return Y(e,r,i,`Unsupported Archicat alias "${i}". Use an explicit file import under "${a.apiAlias}/*" or "${a.implAlias}/*".`);let o=Lt(e,i);if(o)return zt(n,o)||Vt(t,n.target,o.target)?void 0:Y(e,r,i,`${X(n)} imports "${o.target}" but does not declare a dependency that allows it.`);if(!i.startsWith(`.`)&&!i.startsWith(`/`))return;let s=It(e,Ht(r,i));if(!(!s||s.target===n.target))return Y(e,r,i,`${X(n)} imports ${X(s)} through a source path. Use an Archicat alias instead.`)}function It(e,t){let n=x(t);for(let t of e.definitions){if(t.api.rootPath&&y(n,x(t.api.rootPath)))return{kind:t.kind,name:t.name,surface:`api`,target:t.apiTarget};if(t.impl.rootPath&&y(n,x(t.impl.rootPath)))return{kind:t.kind,name:t.name,surface:`impl`,target:t.implTarget}}for(let t of e.apps)if(y(n,x(t.rootPath)))return{kind:`app`,name:t.name,surface:`app`,target:t.target}}function Lt(e,t){for(let n of e.definitions){if(t.startsWith(`${n.implAlias}/`))return{kind:n.kind,name:n.name,surface:`impl`,target:n.implTarget};if(t.startsWith(`${n.alias}/`))return{kind:n.kind,name:n.name,surface:`api`,target:n.apiTarget}}}function Rt(e,t){for(let n of e.definitions){let r=`${n.kind===`module`?e.config.modules.alias:e.config.libraries.alias}/${n.name}`,i=n.implAlias;if(t===r||t===n.alias||t===i||t.startsWith(`${r}/`)&&!t.startsWith(`${n.alias}/`)&&!t.startsWith(`${i}/`))return{apiAlias:n.alias,implAlias:i}}}function zt(e,t){return e.kind===t.kind&&e.name===t.name&&t.surface===`api`}function Bt(e){let t=new Map;for(let n of e){let e=t.get(n.from)??[];e.push(n.to),t.set(n.from,e)}return t}function Vt(e,t,n){let r=new Set,i=[t];for(;i.length>0;){let t=i.shift();if(t){if(t===n)return!0;r.has(t)||(r.add(t),i.push(...e.get(t)??[]))}}return!1}function Ht(e,t){return x(t.startsWith(`/`)?t:r.resolve(r.dirname(e),t))}function Y(e,t,n,r){return{filePath:S(e.rootDir,t),importPath:n,message:r}}function X(e){return e.kind===`app`?`App "${e.name}"`:`${Ut(e.kind)} "${e.name}" ${e.surface}`}function Ut(e){return`${e.charAt(0).toUpperCase()}${e.slice(1)}`}const Wt=new t;async function Z(e,t,n){let r=Date.now(),i=await Ie(n,t.config),a=Jt(e,n,i),o=[],s=[];if((e===`doctor`||e===`generate`)&&s.push(...Gt(i)),e===`validate`||e===`generate`){let e=Kt(i);if(s.push(...e.lines),e.exitCode!==0)return qt(a,o,s,e.exitCode,r)}return e===`generate`&&(Mt(i),o.push({kind:`panel`,title:`mirrored`,rows:[{label:`modules`,value:i.modules.length},{label:`libraries`,value:i.libraries.length},{label:`apps`,value:i.apps.length}]})),qt(a,o,s,0,r)}function Gt(e){let t=Ve(e);return t.length===0?[{kind:`success`,label:`doctor`,message:`Project diagnostics passed`}]:[{kind:`warning`,label:`doctor`,message:`Project diagnostics completed with warnings`},...t.map(e=>({kind:`warning`,message:`  ${e}`}))]}function Kt(e){let t=Nt(e);return t.length===0?{exitCode:0,lines:[{kind:`success`,label:`validate`,message:`Architecture boundaries passed`}]}:{exitCode:1,lines:[{kind:`error`,label:`validate`,message:`Architecture validation failed`},...t.map(e=>({kind:`error`,message:Pt(e)}))]}}function qt(e,t,n,r,i){let a=r===0?{kind:`success`,label:`done`,message:`Completed in ${Wt.duration(Date.now()-i)}`}:{kind:`error`,label:`failed`,message:`Failed in ${Wt.duration(Date.now()-i)}`};return{exitCode:r,lines:[e,...t,...n,a,{kind:`info`,message:``}]}}function Jt(e,t,n){return{kind:`title`,product:`ArchiCat`,command:e,rows:[{label:`config`,value:Yt(t,n.configFilePath)},{label:`output`,value:Yt(t,n.outDir)}]}}function Yt(e,t){let n=r.relative(e,t);return!n||n.startsWith(`..`)?t:n}const Q=new t;async function Xt(e=process.argv.slice(2),t=process.cwd()){let[n,...r]=e;try{let e=await Zt(n,tn(r),t);if(!e)return;Qt(e),process.exitCode=e.exitCode}catch(e){Q.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}async function Zt(e,t,n){switch(e){case`generate`:return await Z(`generate`,t,n);case`validate`:case`check`:return await Z(`validate`,t,n);case`graph`:return await Be(t,n);case`doctor`:return await Z(`doctor`,t,n);case`help`:case`--help`:case`-h`:case void 0:en();return;default:return Q.error(`Unknown command: ${e}`),en(),{exitCode:1,lines:[]}}}function Qt(e){for(let t of e.lines)$t(t)}function $t(e){switch(e.kind){case`title`:Q.title(e.product,e.command,e.rows??[]);return;case`panel`:Q.panel(e.title,e.rows,e.badge);return;case`success`:Q.success($(e));return;case`info`:if(e.message.length===0){Q.emptyLine();return}Q.info($(e));return;case`warning`:Q.warn($(e));return;case`error`:Q.error($(e));return}}function $(e){return e.label?Q.step(e.label,e.message):e.message}function en(){Q.log([`ArchiCat`,``,`Usage:`,`  archicat generate [--config archicat.config.ts]`,`  archicat validate [--config archicat.config.ts]`,`  archicat graph [--config archicat.config.ts]`,`  archicat doctor [--config archicat.config.ts]`,``,`Aliases:`,`  archicat check    -> archicat validate`,``].join(`
+`))}function tn(e){let t={};for(let n=0;n<e.length;n+=1){let r=e[n];if(r===`--config`||r===`-c`){let i=e[n+1];if(!i)throw Error(`${r} requires a value.`);t.config=i,n+=1}}return t}export{Xt as runMain};

package/dist/src/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});function e(e){return Object.freeze({kind:`app`,name:e.name,...e.root===void 0?{}:{root:e.root},dependencies:Object.freeze([...e.dependencies??[]])})}function t(e){let t={...e};for(let e of Object.keys(t))t[e]===void 0&&delete t[e];return Object.freeze(t)}function n(e={}){return t({root:e.root,outDir:e.outDir,typescript:e.typescript?r(e.typescript):void 0,alias:e.alias?Object.freeze({...e.alias}):void 0,modules:e.modules?a(e.modules):void 0,libraries:e.libraries?o(e.libraries):void 0,apps:e.apps?s(e.apps):void 0})}function r(e){return t({tsConfig:e.tsConfig?i(e.tsConfig):void 0})}function i(e){return t({extends:e.extends,include:e.include?Object.freeze([...e.include]):void 0,exclude:e.exclude?Object.freeze([...e.exclude]):void 0,files:e.files?Object.freeze([...e.files]):void 0,compilerOptions:e.compilerOptions?Object.freeze({...e.compilerOptions}):void 0})}function a(e){return t({include:e.include?Object.freeze([...e.include]):void 0,alias:e.alias})}function o(e){return t({include:e.include?Object.freeze([...e.include]):void 0,alias:e.alias})}function s(e){return t({include:e.include?Object.freeze([...e.include]):void 0})}function c(e){return typeof e==`string`?Object.freeze({root:e,dependencies:Object.freeze([])}):t({root:e?.root,dependencies:Object.freeze([...e?.dependencies??[]])})}function l(e){return Object.freeze({kind:`library`,name:e.name,api:c(e.api),impl:c(e.impl)})}function u(e){return Object.freeze({kind:`module`,name:e.name,api:c(e.api),impl:c(e.impl)})}exports.defineApp=e,exports.defineArchicatConfig=n,exports.defineLibrary=l,exports.defineModule=u;

package/dist/src/index.d.cts

@@ -0,0 +1,319 @@
+//#region src/configs/archicat-project-graph.d.ts
+/**
+ * @description Generated dependency targets allowed in module API surfaces.
+ */
+interface ArchicatModuleApiDependencies {}
+/**
+ * @description Generated dependency targets allowed in module implementation surfaces.
+ */
+interface ArchicatModuleImplDependencies {}
+/**
+ * @description Generated dependency targets allowed in library API surfaces.
+ */
+interface ArchicatLibraryApiDependencies {}
+/**
+ * @description Generated dependency targets allowed in library implementation surfaces.
+ */
+interface ArchicatLibraryImplDependencies {}
+/**
+ * @description Generated dependency targets allowed in app composition roots.
+ */
+interface ArchicatAppDependencies {}
+/**
+ * @description Dependency key fallback used before `.archicat/types/graph.d.ts` exists.
+ */
+type ArchicatDependencyKey<Dependencies> = keyof Dependencies extends never ? string : Extract<keyof Dependencies, string>;
+/**
+ * @description Dependency target allowed from a module API surface.
+ */
+type ArchicatModuleApiDependency = ArchicatDependencyKey<ArchicatModuleApiDependencies>;
+/**
+ * @description Dependency target allowed from a module implementation surface.
+ */
+type ArchicatModuleImplDependency = ArchicatDependencyKey<ArchicatModuleImplDependencies>;
+/**
+ * @description Dependency target allowed from a library API surface.
+ */
+type ArchicatLibraryApiDependency = ArchicatDependencyKey<ArchicatLibraryApiDependencies>;
+/**
+ * @description Dependency target allowed from a library implementation surface.
+ */
+type ArchicatLibraryImplDependency = ArchicatDependencyKey<ArchicatLibraryImplDependencies>;
+/**
+ * @description Dependency target allowed from an app composition root.
+ */
+type ArchicatAppDependency = ArchicatDependencyKey<ArchicatAppDependencies>;
+//#endregion
+//#region src/configs/app-config.d.ts
+/**
+ * @description User-facing app composition definition input.
+ */
+interface ArchicatAppInput {
+  /**
+   * @description Stable app name used in the Archicat project graph.
+   */
+  readonly name: string;
+  /**
+   * @description App source root, relative to the app definition file.
+   * @default The directory containing `archicat.app.ts`.
+   */
+  readonly root?: string;
+  /**
+   * @description Dependency targets visible from this app composition root.
+   * @default []
+   */
+  readonly dependencies?: readonly ArchicatAppDependency[];
+}
+/**
+ * @description Immutable app composition contract loaded by Archicat.
+ */
+type ArchicatAppContract = Readonly<{
+  readonly kind: 'app';
+  readonly name: string;
+  readonly root?: string;
+  readonly dependencies: readonly ArchicatAppDependency[];
+}>;
+//#endregion
+//#region src/configs/archicat-config.d.ts
+/**
+ * @description TypeScript config fragment merged into generated `.archicat/tsconfig.json`.
+ */
+interface TsConfigInput {
+  /**
+   * @description Base TypeScript config extended by generated `.archicat/tsconfig.json`.
+   */
+  readonly extends?: string;
+  /**
+   * @description Project source files merged into generated `.archicat/tsconfig.json` include.
+   * Archicat rewrites relative paths to the generated config directory and appends generated type declarations automatically.
+   */
+  readonly include?: readonly string[];
+  /**
+   * @description Project paths merged into generated `.archicat/tsconfig.json` exclude.
+   * Archicat rewrites relative paths to the generated config directory.
+   */
+  readonly exclude?: readonly string[];
+  /**
+   * @description Project files merged into generated `.archicat/tsconfig.json` files.
+   * Archicat rewrites relative paths to the generated config directory.
+   */
+  readonly files?: readonly string[];
+  /**
+   * @description Unsupported. Put compiler options in the base or app tsconfig. Archicat owns generated `compilerOptions.paths` and does not support `baseUrl`.
+   */
+  readonly compilerOptions?: {
+    readonly paths?: never;
+    readonly baseUrl?: never;
+  };
+}
+/**
+ * @description TypeScript integration options used to generate `.archicat/tsconfig.json`.
+ */
+interface TypeScriptConfigInput {
+  /**
+   * @description Partial TypeScript config merged into generated `.archicat/tsconfig.json`.
+   * Archicat rewrites relative paths from the project root to `.archicat`, appends generated type declarations to `include`, and injects generated aliases into `compilerOptions.paths`.
+   * `compilerOptions` is not supported here. Put compiler policy in the base tsconfig and app build overrides in the app tsconfig.
+   * @default {}
+   */
+  readonly tsConfig?: TsConfigInput;
+}
+/**
+ * @description User import aliases generated into `.archicat/tsconfig.json` together with Archicat module and library aliases.
+ * Aliases are resolved relative to the Archicat project root. Do not define TypeScript `compilerOptions.paths` manually for an Archicat project.
+ * @default {}
+ */
+type AliasConfig = Readonly<Record<string, string>>;
+/**
+ * @description Module discovery and generated import alias configuration.
+ */
+interface ModulesConfigInput {
+  /**
+   * @description Directories or files where Archicat searches for module definition markers.
+   */
+  readonly include?: readonly string[];
+  /**
+   * @description Base alias used for generated module imports.
+   */
+  readonly alias?: string;
+}
+/**
+ * @description Library discovery and generated import alias configuration.
+ */
+interface LibrariesConfigInput {
+  /**
+   * @description Directories or files where Archicat searches for library definition markers.
+   */
+  readonly include?: readonly string[];
+  /**
+   * @description Base alias used for generated library imports.
+   */
+  readonly alias?: string;
+}
+/**
+ * @description App discovery configuration.
+ */
+interface AppsConfigInput {
+  /**
+   * @description Directories or files where Archicat searches for app definition markers.
+   */
+  readonly include?: readonly string[];
+}
+/**
+ * @description User-facing Archicat root config input.
+ */
+interface ArchicatConfigInput {
+  /**
+   * @description Project root directory.
+   * @default '.'
+   */
+  readonly root?: string;
+  /**
+   * @description Directory for generated mirror files, generated types, and reports.
+   * @default '.archicat'
+   */
+  readonly outDir?: string;
+  /**
+   * @description TypeScript integration options used to generate `.archicat/tsconfig.json`.
+   * @default {}
+   */
+  readonly typescript?: TypeScriptConfigInput;
+  /**
+   * @description User TypeScript aliases generated by Archicat.
+   * @default {}
+   */
+  readonly alias?: AliasConfig;
+  /**
+   * @description Module discovery and alias config.
+   * @default { include: ['./src/modules'], alias: '#modules' }
+   */
+  readonly modules?: ModulesConfigInput;
+  /**
+   * @description Library discovery and alias config.
+   * @default { include: [], alias: '#library' }
+   */
+  readonly libraries?: LibrariesConfigInput;
+  /**
+   * @description App discovery config.
+   * @default { include: [] }
+   */
+  readonly apps?: AppsConfigInput;
+}
+/**
+ * @description Immutable Archicat config returned by `defineArchicatConfig`.
+ */
+type ArchicatConfig = Readonly<ArchicatConfigInput>;
+//#endregion
+//#region src/configs/surface-config.d.ts
+/**
+ * @description Surface root shorthand or full surface config.
+ */
+type ArchicatSurfaceInput<Dependency extends string> = string | ArchicatSurfaceConfig<Dependency>;
+/**
+ * @description Source surface config.
+ */
+interface ArchicatSurfaceConfig<Dependency extends string> {
+  /**
+   * @description Surface source root, relative to the definition file.
+   * @default Generates an empty mirror for the surface.
+   */
+  readonly root?: string;
+  /**
+   * @description Dependency targets visible from this surface.
+   * @default []
+   */
+  readonly dependencies?: readonly Dependency[];
+}
+/**
+ * @description Immutable normalized surface contract.
+ */
+type ArchicatSurfaceContract<Dependency extends string> = Readonly<{
+  readonly root?: string;
+  readonly dependencies: readonly Dependency[];
+}>;
+//#endregion
+//#region src/configs/library-config.d.ts
+/**
+ * @description User-facing library definition input.
+ */
+interface ArchicatLibraryInput {
+  /**
+   * @description Stable library name used in the Archicat project graph.
+   */
+  readonly name: string;
+  /**
+   * @description Library public API surface.
+   * @default Generates an empty public API mirror.
+   */
+  readonly api?: ArchicatSurfaceInput<ArchicatLibraryApiDependency>;
+  /**
+   * @description Library implementation surface.
+   * @default Generates a no-op implementation mirror.
+   */
+  readonly impl?: ArchicatSurfaceInput<ArchicatLibraryImplDependency>;
+}
+/**
+ * @description Immutable library definition contract loaded by Archicat.
+ */
+type ArchicatLibraryContract = Readonly<{
+  readonly kind: 'library';
+  readonly name: string;
+  readonly api: ArchicatSurfaceContract<ArchicatLibraryApiDependency>;
+  readonly impl: ArchicatSurfaceContract<ArchicatLibraryImplDependency>;
+}>;
+//#endregion
+//#region src/configs/module-config.d.ts
+/**
+ * @description User-facing module definition input.
+ */
+interface ArchicatModuleInput {
+  /**
+   * @description Stable module name used in the Archicat project graph.
+   */
+  readonly name: string;
+  /**
+   * @description Module public API surface.
+   * @default Generates an empty public API mirror.
+   */
+  readonly api?: ArchicatSurfaceInput<ArchicatModuleApiDependency>;
+  /**
+   * @description Module implementation surface.
+   * @default Generates a no-op implementation mirror.
+   */
+  readonly impl?: ArchicatSurfaceInput<ArchicatModuleImplDependency>;
+}
+/**
+ * @description Immutable module definition contract loaded by Archicat.
+ */
+type ArchicatModuleContract = Readonly<{
+  readonly kind: 'module';
+  readonly name: string;
+  readonly api: ArchicatSurfaceContract<ArchicatModuleApiDependency>;
+  readonly impl: ArchicatSurfaceContract<ArchicatModuleImplDependency>;
+}>;
+//#endregion
+//#region src/configs/define-app-config.d.ts
+/**
+ * @description Defines one Archicat app composition root.
+ */
+declare function defineApp(app: ArchicatAppInput): ArchicatAppContract;
+//#endregion
+//#region src/configs/define-archicat-config.d.ts
+/**
+ * @description Defines the root Archicat config.
+ */
+declare function defineArchicatConfig(config?: ArchicatConfigInput): ArchicatConfig;
+//#endregion
+//#region src/configs/define-library-config.d.ts
+/**
+ * @description Defines one Archicat library.
+ */
+declare function defineLibrary(library: ArchicatLibraryInput): ArchicatLibraryContract;
+//#endregion
+//#region src/configs/define-module-config.d.ts
+/**
+ * @description Defines one Archicat module.
+ */
+declare function defineModule(module: ArchicatModuleInput): ArchicatModuleContract;
+//#endregion
+export { type AliasConfig, type AppsConfigInput, type ArchicatAppContract, type ArchicatAppDependencies, type ArchicatAppDependency, type ArchicatAppInput, type ArchicatConfig, type ArchicatConfigInput, type ArchicatLibraryApiDependencies, type ArchicatLibraryApiDependency, type ArchicatLibraryContract, type ArchicatLibraryImplDependencies, type ArchicatLibraryImplDependency, type ArchicatLibraryInput, type ArchicatModuleApiDependencies, type ArchicatModuleApiDependency, type ArchicatModuleContract, type ArchicatModuleImplDependencies, type ArchicatModuleImplDependency, type ArchicatModuleInput, type ArchicatSurfaceConfig, type ArchicatSurfaceContract, type ArchicatSurfaceInput, type LibrariesConfigInput, type ModulesConfigInput, type TsConfigInput, type TypeScriptConfigInput, defineApp, defineArchicatConfig, defineLibrary, defineModule };

package/dist/src/index.d.mts

@@ -0,0 +1,319 @@
+//#region src/configs/archicat-project-graph.d.ts
+/**
+ * @description Generated dependency targets allowed in module API surfaces.
+ */
+interface ArchicatModuleApiDependencies {}
+/**
+ * @description Generated dependency targets allowed in module implementation surfaces.
+ */
+interface ArchicatModuleImplDependencies {}
+/**
+ * @description Generated dependency targets allowed in library API surfaces.
+ */
+interface ArchicatLibraryApiDependencies {}
+/**
+ * @description Generated dependency targets allowed in library implementation surfaces.
+ */
+interface ArchicatLibraryImplDependencies {}
+/**
+ * @description Generated dependency targets allowed in app composition roots.
+ */
+interface ArchicatAppDependencies {}
+/**
+ * @description Dependency key fallback used before `.archicat/types/graph.d.ts` exists.
+ */
+type ArchicatDependencyKey<Dependencies> = keyof Dependencies extends never ? string : Extract<keyof Dependencies, string>;
+/**
+ * @description Dependency target allowed from a module API surface.
+ */
+type ArchicatModuleApiDependency = ArchicatDependencyKey<ArchicatModuleApiDependencies>;
+/**
+ * @description Dependency target allowed from a module implementation surface.
+ */
+type ArchicatModuleImplDependency = ArchicatDependencyKey<ArchicatModuleImplDependencies>;
+/**
+ * @description Dependency target allowed from a library API surface.
+ */
+type ArchicatLibraryApiDependency = ArchicatDependencyKey<ArchicatLibraryApiDependencies>;
+/**
+ * @description Dependency target allowed from a library implementation surface.
+ */
+type ArchicatLibraryImplDependency = ArchicatDependencyKey<ArchicatLibraryImplDependencies>;
+/**
+ * @description Dependency target allowed from an app composition root.
+ */
+type ArchicatAppDependency = ArchicatDependencyKey<ArchicatAppDependencies>;
+//#endregion
+//#region src/configs/app-config.d.ts
+/**
+ * @description User-facing app composition definition input.
+ */
+interface ArchicatAppInput {
+  /**
+   * @description Stable app name used in the Archicat project graph.
+   */
+  readonly name: string;
+  /**
+   * @description App source root, relative to the app definition file.
+   * @default The directory containing `archicat.app.ts`.
+   */
+  readonly root?: string;
+  /**
+   * @description Dependency targets visible from this app composition root.
+   * @default []
+   */
+  readonly dependencies?: readonly ArchicatAppDependency[];
+}
+/**
+ * @description Immutable app composition contract loaded by Archicat.
+ */
+type ArchicatAppContract = Readonly<{
+  readonly kind: 'app';
+  readonly name: string;
+  readonly root?: string;
+  readonly dependencies: readonly ArchicatAppDependency[];
+}>;
+//#endregion
+//#region src/configs/archicat-config.d.ts
+/**
+ * @description TypeScript config fragment merged into generated `.archicat/tsconfig.json`.
+ */
+interface TsConfigInput {
+  /**
+   * @description Base TypeScript config extended by generated `.archicat/tsconfig.json`.
+   */
+  readonly extends?: string;
+  /**
+   * @description Project source files merged into generated `.archicat/tsconfig.json` include.
+   * Archicat rewrites relative paths to the generated config directory and appends generated type declarations automatically.
+   */
+  readonly include?: readonly string[];
+  /**
+   * @description Project paths merged into generated `.archicat/tsconfig.json` exclude.
+   * Archicat rewrites relative paths to the generated config directory.
+   */
+  readonly exclude?: readonly string[];
+  /**
+   * @description Project files merged into generated `.archicat/tsconfig.json` files.
+   * Archicat rewrites relative paths to the generated config directory.
+   */
+  readonly files?: readonly string[];
+  /**
+   * @description Unsupported. Put compiler options in the base or app tsconfig. Archicat owns generated `compilerOptions.paths` and does not support `baseUrl`.
+   */
+  readonly compilerOptions?: {
+    readonly paths?: never;
+    readonly baseUrl?: never;
+  };
+}
+/**
+ * @description TypeScript integration options used to generate `.archicat/tsconfig.json`.
+ */
+interface TypeScriptConfigInput {
+  /**
+   * @description Partial TypeScript config merged into generated `.archicat/tsconfig.json`.
+   * Archicat rewrites relative paths from the project root to `.archicat`, appends generated type declarations to `include`, and injects generated aliases into `compilerOptions.paths`.
+   * `compilerOptions` is not supported here. Put compiler policy in the base tsconfig and app build overrides in the app tsconfig.
+   * @default {}
+   */
+  readonly tsConfig?: TsConfigInput;
+}
+/**
+ * @description User import aliases generated into `.archicat/tsconfig.json` together with Archicat module and library aliases.
+ * Aliases are resolved relative to the Archicat project root. Do not define TypeScript `compilerOptions.paths` manually for an Archicat project.
+ * @default {}
+ */
+type AliasConfig = Readonly<Record<string, string>>;
+/**
+ * @description Module discovery and generated import alias configuration.
+ */
+interface ModulesConfigInput {
+  /**
+   * @description Directories or files where Archicat searches for module definition markers.
+   */
+  readonly include?: readonly string[];
+  /**
+   * @description Base alias used for generated module imports.
+   */
+  readonly alias?: string;
+}
+/**
+ * @description Library discovery and generated import alias configuration.
+ */
+interface LibrariesConfigInput {
+  /**
+   * @description Directories or files where Archicat searches for library definition markers.
+   */
+  readonly include?: readonly string[];
+  /**
+   * @description Base alias used for generated library imports.
+   */
+  readonly alias?: string;
+}
+/**
+ * @description App discovery configuration.
+ */
+interface AppsConfigInput {
+  /**
+   * @description Directories or files where Archicat searches for app definition markers.
+   */
+  readonly include?: readonly string[];
+}
+/**
+ * @description User-facing Archicat root config input.
+ */
+interface ArchicatConfigInput {
+  /**
+   * @description Project root directory.
+   * @default '.'
+   */
+  readonly root?: string;
+  /**
+   * @description Directory for generated mirror files, generated types, and reports.
+   * @default '.archicat'
+   */
+  readonly outDir?: string;
+  /**
+   * @description TypeScript integration options used to generate `.archicat/tsconfig.json`.
+   * @default {}
+   */
+  readonly typescript?: TypeScriptConfigInput;
+  /**
+   * @description User TypeScript aliases generated by Archicat.
+   * @default {}
+   */
+  readonly alias?: AliasConfig;
+  /**
+   * @description Module discovery and alias config.
+   * @default { include: ['./src/modules'], alias: '#modules' }
+   */
+  readonly modules?: ModulesConfigInput;
+  /**
+   * @description Library discovery and alias config.
+   * @default { include: [], alias: '#library' }
+   */
+  readonly libraries?: LibrariesConfigInput;
+  /**
+   * @description App discovery config.
+   * @default { include: [] }
+   */
+  readonly apps?: AppsConfigInput;
+}
+/**
+ * @description Immutable Archicat config returned by `defineArchicatConfig`.
+ */
+type ArchicatConfig = Readonly<ArchicatConfigInput>;
+//#endregion
+//#region src/configs/surface-config.d.ts
+/**
+ * @description Surface root shorthand or full surface config.
+ */
+type ArchicatSurfaceInput<Dependency extends string> = string | ArchicatSurfaceConfig<Dependency>;
+/**
+ * @description Source surface config.
+ */
+interface ArchicatSurfaceConfig<Dependency extends string> {
+  /**
+   * @description Surface source root, relative to the definition file.
+   * @default Generates an empty mirror for the surface.
+   */
+  readonly root?: string;
+  /**
+   * @description Dependency targets visible from this surface.
+   * @default []
+   */
+  readonly dependencies?: readonly Dependency[];
+}
+/**
+ * @description Immutable normalized surface contract.
+ */
+type ArchicatSurfaceContract<Dependency extends string> = Readonly<{
+  readonly root?: string;
+  readonly dependencies: readonly Dependency[];
+}>;
+//#endregion
+//#region src/configs/library-config.d.ts
+/**
+ * @description User-facing library definition input.
+ */
+interface ArchicatLibraryInput {
+  /**
+   * @description Stable library name used in the Archicat project graph.
+   */
+  readonly name: string;
+  /**
+   * @description Library public API surface.
+   * @default Generates an empty public API mirror.
+   */
+  readonly api?: ArchicatSurfaceInput<ArchicatLibraryApiDependency>;
+  /**
+   * @description Library implementation surface.
+   * @default Generates a no-op implementation mirror.
+   */
+  readonly impl?: ArchicatSurfaceInput<ArchicatLibraryImplDependency>;
+}
+/**
+ * @description Immutable library definition contract loaded by Archicat.
+ */
+type ArchicatLibraryContract = Readonly<{
+  readonly kind: 'library';
+  readonly name: string;
+  readonly api: ArchicatSurfaceContract<ArchicatLibraryApiDependency>;
+  readonly impl: ArchicatSurfaceContract<ArchicatLibraryImplDependency>;
+}>;
+//#endregion
+//#region src/configs/module-config.d.ts
+/**
+ * @description User-facing module definition input.
+ */
+interface ArchicatModuleInput {
+  /**
+   * @description Stable module name used in the Archicat project graph.
+   */
+  readonly name: string;
+  /**
+   * @description Module public API surface.
+   * @default Generates an empty public API mirror.
+   */
+  readonly api?: ArchicatSurfaceInput<ArchicatModuleApiDependency>;
+  /**
+   * @description Module implementation surface.
+   * @default Generates a no-op implementation mirror.
+   */
+  readonly impl?: ArchicatSurfaceInput<ArchicatModuleImplDependency>;
+}
+/**
+ * @description Immutable module definition contract loaded by Archicat.
+ */
+type ArchicatModuleContract = Readonly<{
+  readonly kind: 'module';
+  readonly name: string;
+  readonly api: ArchicatSurfaceContract<ArchicatModuleApiDependency>;
+  readonly impl: ArchicatSurfaceContract<ArchicatModuleImplDependency>;
+}>;
+//#endregion
+//#region src/configs/define-app-config.d.ts
+/**
+ * @description Defines one Archicat app composition root.
+ */
+declare function defineApp(app: ArchicatAppInput): ArchicatAppContract;
+//#endregion
+//#region src/configs/define-archicat-config.d.ts
+/**
+ * @description Defines the root Archicat config.
+ */
+declare function defineArchicatConfig(config?: ArchicatConfigInput): ArchicatConfig;
+//#endregion
+//#region src/configs/define-library-config.d.ts
+/**
+ * @description Defines one Archicat library.
+ */
+declare function defineLibrary(library: ArchicatLibraryInput): ArchicatLibraryContract;
+//#endregion
+//#region src/configs/define-module-config.d.ts
+/**
+ * @description Defines one Archicat module.
+ */
+declare function defineModule(module: ArchicatModuleInput): ArchicatModuleContract;
+//#endregion
+export { type AliasConfig, type AppsConfigInput, type ArchicatAppContract, type ArchicatAppDependencies, type ArchicatAppDependency, type ArchicatAppInput, type ArchicatConfig, type ArchicatConfigInput, type ArchicatLibraryApiDependencies, type ArchicatLibraryApiDependency, type ArchicatLibraryContract, type ArchicatLibraryImplDependencies, type ArchicatLibraryImplDependency, type ArchicatLibraryInput, type ArchicatModuleApiDependencies, type ArchicatModuleApiDependency, type ArchicatModuleContract, type ArchicatModuleImplDependencies, type ArchicatModuleImplDependency, type ArchicatModuleInput, type ArchicatSurfaceConfig, type ArchicatSurfaceContract, type ArchicatSurfaceInput, type LibrariesConfigInput, type ModulesConfigInput, type TsConfigInput, type TypeScriptConfigInput, defineApp, defineArchicatConfig, defineLibrary, defineModule };

package/dist/src/index.mjs

@@ -0,0 +1 @@
+function e(e){return Object.freeze({kind:`app`,name:e.name,...e.root===void 0?{}:{root:e.root},dependencies:Object.freeze([...e.dependencies??[]])})}function t(e){let t={...e};for(let e of Object.keys(t))t[e]===void 0&&delete t[e];return Object.freeze(t)}function n(e={}){return t({root:e.root,outDir:e.outDir,typescript:e.typescript?r(e.typescript):void 0,alias:e.alias?Object.freeze({...e.alias}):void 0,modules:e.modules?a(e.modules):void 0,libraries:e.libraries?o(e.libraries):void 0,apps:e.apps?s(e.apps):void 0})}function r(e){return t({tsConfig:e.tsConfig?i(e.tsConfig):void 0})}function i(e){return t({extends:e.extends,include:e.include?Object.freeze([...e.include]):void 0,exclude:e.exclude?Object.freeze([...e.exclude]):void 0,files:e.files?Object.freeze([...e.files]):void 0,compilerOptions:e.compilerOptions?Object.freeze({...e.compilerOptions}):void 0})}function a(e){return t({include:e.include?Object.freeze([...e.include]):void 0,alias:e.alias})}function o(e){return t({include:e.include?Object.freeze([...e.include]):void 0,alias:e.alias})}function s(e){return t({include:e.include?Object.freeze([...e.include]):void 0})}function c(e){return typeof e==`string`?Object.freeze({root:e,dependencies:Object.freeze([])}):t({root:e?.root,dependencies:Object.freeze([...e?.dependencies??[]])})}function l(e){return Object.freeze({kind:`library`,name:e.name,api:c(e.api),impl:c(e.impl)})}function u(e){return Object.freeze({kind:`module`,name:e.name,api:c(e.api),impl:c(e.impl)})}export{e as defineApp,n as defineArchicatConfig,l as defineLibrary,u as defineModule};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "archicat",
+  "version": "0.1.0",
+  "description": "Modular mirroring (M²) for clean TypeScript architecture.",
+  "keywords": [
+    "architecture",
+    "clean-architecture",
+    "mirroring",
+    "modular",
+    "module-system"
+  ],
+  "homepage": "https://github.com/BuildPlease/ArchiCat#readme",
+  "bugs": {
+    "url": "https://github.com/BuildPlease/ArchiCat/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BuildPlease/ArchiCat.git"
+  },
+  "license": "MIT",
+  "author": "Simon Rastislav Kovačič",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/src/index.d.mts",
+        "default": "./dist/src/index.mjs"
+      },
+      "require": {
+        "types": "./dist/src/index.d.cts",
+        "default": "./dist/src/index.cjs"
+      }
+    }
+  },
+  "bin": {
+    "archicat": "./bin/archicat.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "dependencies": {
+    "@buildplease/core": "1.0.1",
+    "jiti": "2.7.0"
+  },
+  "devDependencies": {
+    "@buildplease/devkit": "1.0.1",
+    "@types/node": "26.2.0",
+    "tsdown": "0.22.14",
+    "typescript": "6.0.3",
+    "unrun": "0.3.1",
+    "vitest": "4.1.10"
+  },
+  "peerDependencies": {
+    "typescript": "6.0.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "pnpm run build:cli && pnpm run build:src",
+    "build:cli": "tsdown --config tsdown.config.cli.ts --config-loader unrun",
+    "build:src": "tsdown --config tsdown.config.src.ts --config-loader unrun",
+    "clean": "devkit run clean",
+    "format": "devkit run format-fix && devkit run lint-fix",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}