@nielspeter/eess-ts 0.1.0

package/dist/models/arch-jsx-element.js

@@ -0,0 +1,231 @@
+import { Node, } from 'ts-morph';
+/**
+ * Standard HTML tag names per the WHATWG HTML Living Standard.
+ * Use with `areHtmlElements(...STANDARD_HTML_TAGS)`
+ * for unambiguous "all standard HTML elements" matching (excludes custom
+ * elements like `<my-widget>`).
+ */
+export const STANDARD_HTML_TAGS = [
+    'a',
+    'abbr',
+    'address',
+    'area',
+    'article',
+    'aside',
+    'audio',
+    'b',
+    'base',
+    'bdi',
+    'bdo',
+    'blockquote',
+    'body',
+    'br',
+    'button',
+    'canvas',
+    'caption',
+    'cite',
+    'code',
+    'col',
+    'colgroup',
+    'data',
+    'datalist',
+    'dd',
+    'del',
+    'details',
+    'dfn',
+    'dialog',
+    'div',
+    'dl',
+    'dt',
+    'em',
+    'embed',
+    'fieldset',
+    'figcaption',
+    'figure',
+    'footer',
+    'form',
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'head',
+    'header',
+    'hgroup',
+    'hr',
+    'html',
+    'i',
+    'iframe',
+    'img',
+    'input',
+    'ins',
+    'kbd',
+    'label',
+    'legend',
+    'li',
+    'link',
+    'main',
+    'map',
+    'mark',
+    'menu',
+    'meta',
+    'meter',
+    'nav',
+    'noscript',
+    'object',
+    'ol',
+    'optgroup',
+    'option',
+    'output',
+    'p',
+    'picture',
+    'pre',
+    'progress',
+    'q',
+    'rp',
+    'rt',
+    'ruby',
+    's',
+    'samp',
+    'script',
+    'search',
+    'section',
+    'select',
+    'slot',
+    'small',
+    'source',
+    'span',
+    'strong',
+    'style',
+    'sub',
+    'summary',
+    'sup',
+    'table',
+    'tbody',
+    'td',
+    'template',
+    'textarea',
+    'tfoot',
+    'th',
+    'thead',
+    'time',
+    'title',
+    'tr',
+    'track',
+    'u',
+    'ul',
+    'var',
+    'video',
+    'wbr',
+];
+/**
+ * Classify a tag name as HTML intrinsic or component.
+ * - Dot-notation (contains '.') → always component
+ * - Lowercase first char → HTML intrinsic
+ * - Uppercase first char → component
+ */
+function isHtmlTag(tagName) {
+    if (tagName.includes('.'))
+        return false;
+    const firstChar = tagName[0];
+    return firstChar !== undefined && firstChar === firstChar.toLowerCase();
+}
+/**
+ * Type predicate for filtering JsxAttribute from JsxAttributeLike.
+ * Narrows the type so downstream code doesn't need redundant checks.
+ */
+function isNamedAttribute(a) {
+    return Node.isJsxAttribute(a);
+}
+/**
+ * Shared attribute accessors for both JsxElement and JsxSelfClosingElement.
+ * Extracts attribute-access logic into a single place to avoid duplication.
+ */
+function buildAttributeAccessors(getAttrs) {
+    function namedAttrs() {
+        return getAttrs().filter(isNamedAttribute);
+    }
+    return {
+        getAttribute(name) {
+            const attr = namedAttrs().find((a) => a.getNameNode().getText() === name);
+            if (!attr)
+                return undefined;
+            const init = attr.getInitializer();
+            if (!init)
+                return undefined; // valueless attribute
+            if (Node.isStringLiteral(init))
+                return init.getLiteralValue();
+            return init.getText();
+        },
+        hasAttribute(name) {
+            return namedAttrs().some((a) => a.getNameNode().getText() === name);
+        },
+        getAttributeNames() {
+            return namedAttrs().map((a) => a.getNameNode().getText());
+        },
+    };
+}
+/**
+ * Create an ArchJsxElement from a JsxElement (has opening + closing tags).
+ */
+// eess-exclude eess/no-unused-exports: consumed by the test suite (tests are outside the build project)
+export function fromJsxElement(el) {
+    const opening = el.getOpeningElement();
+    const tagName = opening.getTagNameNode().getText();
+    const htmlTag = isHtmlTag(tagName);
+    const attrs = buildAttributeAccessors(() => opening.getAttributes());
+    return {
+        getName: () => tagName,
+        getSourceFile: () => el.getSourceFile(),
+        isHtmlElement: () => htmlTag,
+        isComponent: () => !htmlTag,
+        ...attrs,
+        hasChildren: () => true,
+        getNode: () => el,
+        getStartLineNumber: () => el.getStartLineNumber(),
+    };
+}
+/**
+ * Create an ArchJsxElement from a JsxSelfClosingElement (no children).
+ */
+// eess-exclude eess/no-unused-exports: consumed by the test suite (tests are outside the build project)
+export function fromJsxSelfClosingElement(el) {
+    const tagName = el.getTagNameNode().getText();
+    const htmlTag = isHtmlTag(tagName);
+    const attrs = buildAttributeAccessors(() => el.getAttributes());
+    return {
+        getName: () => tagName,
+        getSourceFile: () => el.getSourceFile(),
+        isHtmlElement: () => htmlTag,
+        isComponent: () => !htmlTag,
+        ...attrs,
+        hasChildren: () => false,
+        getNode: () => el,
+        getStartLineNumber: () => el.getStartLineNumber(),
+    };
+}
+/**
+ * Scan a source file for all JSX elements.
+ *
+ * Short-circuits on non-.tsx/.jsx files. Uses single-pass traversal.
+ * Collects both JsxElement (has children) and JsxSelfClosingElement (no children).
+ * JsxFragment nodes are intentionally excluded — they have no tag name or attributes.
+ * Nested JSX elements ARE collected (consistent with collectCalls).
+ */
+export function collectJsxElements(sourceFile) {
+    const filePath = sourceFile.getFilePath();
+    if (!filePath.endsWith('.tsx') && !filePath.endsWith('.jsx'))
+        return [];
+    const elements = [];
+    sourceFile.forEachDescendant((node) => {
+        if (Node.isJsxElement(node)) {
+            elements.push(fromJsxElement(node));
+        }
+        else if (Node.isJsxSelfClosingElement(node)) {
+            elements.push(fromJsxSelfClosingElement(node));
+        }
+    });
+    return elements;
+}
+//# sourceMappingURL=arch-jsx-element.js.map

package/dist/models/arch-jsx-element.js.map

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

package/dist/models/cross-layer.d.ts

@@ -0,0 +1,15 @@
+import type { SourceFile } from 'ts-morph';
+/** A named layer resolved to its source files. */
+export interface Layer {
+    readonly name: string;
+    readonly pattern: string;
+    readonly files: SourceFile[];
+}
+/** A matched pair of elements from two layers. */
+export interface LayerPair<A = SourceFile, B = SourceFile> {
+    readonly left: A;
+    readonly leftLayer: string;
+    readonly right: B;
+    readonly rightLayer: string;
+}
+//# sourceMappingURL=cross-layer.d.ts.map

package/dist/models/cross-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-layer.d.ts","sourceRoot":"","sources":["../../src/models/cross-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,kDAAkD;AAClD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,UAAU;IACvD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;IAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B"}

package/dist/models/cross-layer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cross-layer.js.map

package/dist/models/cross-layer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-layer.js","sourceRoot":"","sources":["../../src/models/cross-layer.ts"],"names":[],"mappings":""}

package/dist/models/slice.d.ts

@@ -0,0 +1,60 @@
+import type { SourceFile } from 'ts-morph';
+import type { ArchProject } from '../core/project.js';
+/**
+ * A slice groups source files into a logical unit.
+ * Slices are the nodes in the slice dependency graph.
+ */
+export interface Slice {
+    /** Slice name — directory name for matching(), key name for assignedFrom() */
+    readonly name: string;
+    /** Source files belonging to this slice */
+    readonly files: SourceFile[];
+}
+/**
+ * A mapping of slice names to glob patterns.
+ * Used by `assignedFrom()` to define slices explicitly.
+ *
+ * @example
+ * const layers: SliceDefinition = {
+ *   presentation: 'src/controllers/**',
+ *   application: 'src/services/**',
+ *   domain: 'src/domain/**',
+ * }
+ */
+export type SliceDefinition = Record<string, string>;
+/**
+ * Resolve slices by matching a glob pattern against source file paths.
+ * Each unique directory matching the glob becomes a slice.
+ *
+ * The glob must contain a wildcard segment that distinguishes slices.
+ * For example, 'src/features/*\/' matches each subdirectory of src/features/
+ * as a separate slice.
+ *
+ * @param project - The loaded ArchProject
+ * @param glob - A glob pattern where the wildcard segment defines slice boundaries
+ * @returns Array of slices, one per matching directory
+ *
+ * @example
+ * resolveByMatching(project, 'src/features/*\/')
+ * // => [{ name: 'auth', files: [...] }, { name: 'billing', files: [...] }]
+ */
+export declare function resolveByMatching(project: ArchProject, glob: string): Slice[];
+/**
+ * Resolve slices from an explicit name-to-glob mapping.
+ * Each key becomes a slice name, and files matching its glob are assigned to it.
+ *
+ * A file matching multiple globs is assigned to the FIRST matching slice.
+ * Files matching no glob are excluded from all slices.
+ *
+ * @param project - The loaded ArchProject
+ * @param definition - Map of slice names to glob patterns
+ * @returns Array of slices in definition key order
+ *
+ * @example
+ * resolveByDefinition(project, {
+ *   presentation: 'src/controllers/**',
+ *   domain: 'src/domain/**',
+ * })
+ */
+export declare function resolveByDefinition(project: ArchProject, definition: SliceDefinition): Slice[];
+//# sourceMappingURL=slice.d.ts.map

package/dist/models/slice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice.d.ts","sourceRoot":"","sources":["../../src/models/slice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAErD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAC7B;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,EAAE,CAoC7E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,GAAG,KAAK,EAAE,CAsB9F"}

package/dist/models/slice.js

@@ -0,0 +1,89 @@
+import picomatch from 'picomatch';
+/**
+ * Resolve slices by matching a glob pattern against source file paths.
+ * Each unique directory matching the glob becomes a slice.
+ *
+ * The glob must contain a wildcard segment that distinguishes slices.
+ * For example, 'src/features/*\/' matches each subdirectory of src/features/
+ * as a separate slice.
+ *
+ * @param project - The loaded ArchProject
+ * @param glob - A glob pattern where the wildcard segment defines slice boundaries
+ * @returns Array of slices, one per matching directory
+ *
+ * @example
+ * resolveByMatching(project, 'src/features/*\/')
+ * // => [{ name: 'auth', files: [...] }, { name: 'billing', files: [...] }]
+ */
+export function resolveByMatching(project, glob) {
+    // Prepend ** if the glob is not already absolute or globbed at the root,
+    // so it matches anywhere in an absolute file path.
+    // Append */** to match: the slice directory segment (*) + any files inside (/**)
+    const fullGlob = glob.startsWith('/') || glob.startsWith('**') ? glob + '*/**' : '**/' + glob + '*/**';
+    const isMatch = picomatch(fullGlob);
+    const sourceFiles = project.getSourceFiles();
+    const sliceMap = new Map();
+    // Extract the base directory (everything up to and including the last / in the original glob)
+    // For 'src/feature-', basedir is 'src/' so that 'feature-a' is extracted as slice name.
+    // For 'src/features/*/', basedir is 'src/features/' so that the wildcard dirs are slice names.
+    const lastSlashIdx = glob.lastIndexOf('/');
+    const baseDir = lastSlashIdx >= 0 ? glob.slice(0, lastSlashIdx + 1) : '';
+    for (const sf of sourceFiles) {
+        const filePath = sf.getFilePath();
+        if (!isMatch(filePath))
+            continue;
+        // Extract the slice name: the first directory segment after baseDir
+        const baseDirIdx = filePath.indexOf(baseDir);
+        if (baseDirIdx === -1)
+            continue;
+        const relativePart = filePath.slice(baseDirIdx + baseDir.length);
+        const sliceName = relativePart.split('/')[0];
+        if (!sliceName)
+            continue;
+        const existing = sliceMap.get(sliceName);
+        if (existing) {
+            existing.push(sf);
+        }
+        else {
+            sliceMap.set(sliceName, [sf]);
+        }
+    }
+    return Array.from(sliceMap.entries()).map(([name, files]) => ({ name, files }));
+}
+/**
+ * Resolve slices from an explicit name-to-glob mapping.
+ * Each key becomes a slice name, and files matching its glob are assigned to it.
+ *
+ * A file matching multiple globs is assigned to the FIRST matching slice.
+ * Files matching no glob are excluded from all slices.
+ *
+ * @param project - The loaded ArchProject
+ * @param definition - Map of slice names to glob patterns
+ * @returns Array of slices in definition key order
+ *
+ * @example
+ * resolveByDefinition(project, {
+ *   presentation: 'src/controllers/**',
+ *   domain: 'src/domain/**',
+ * })
+ */
+export function resolveByDefinition(project, definition) {
+    const sourceFiles = project.getSourceFiles();
+    const entries = Object.entries(definition);
+    const matchers = entries.map(([name, glob]) => ({
+        name,
+        isMatch: picomatch(glob),
+        files: [],
+    }));
+    for (const sf of sourceFiles) {
+        const filePath = sf.getFilePath();
+        for (const matcher of matchers) {
+            if (matcher.isMatch(filePath)) {
+                matcher.files.push(sf);
+                break; // first match wins
+            }
+        }
+    }
+    return matchers.map(({ name, files }) => ({ name, files }));
+}
+//# sourceMappingURL=slice.js.map

package/dist/models/slice.js.map

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

package/dist/predicates/call.d.ts

@@ -0,0 +1,49 @@
+import type { Predicate } from '@nielspeter/eess';
+import type { ArchCall } from '../models/arch-call.js';
+/**
+ * Matches calls on an object with the given name.
+ *
+ * For `app.get(...)`, onObject('app') matches.
+ * For `router.route.get(...)`, onObject('router.route') matches.
+ *
+ * @param name - Exact object name (after optional-chaining normalization)
+ */
+export declare function onObject(name: string): Predicate<ArchCall>;
+/**
+ * Matches calls whose method name matches the given pattern.
+ *
+ * For `app.get(...)`, withMethod('get') matches.
+ * For `app.get(...)`, withMethod(/^(get|post)$/) matches.
+ * For `handleError(...)` (bare call), withMethod('handleError') matches.
+ *
+ * @param nameOrRegex - Exact method name or regex pattern
+ */
+export declare function withMethod(nameOrRegex: string | RegExp): Predicate<ArchCall>;
+/**
+ * Matches calls where the argument at the given index matches a pattern.
+ *
+ * The pattern is matched against the argument's getText() output.
+ * Use for flexible argument matching (e.g., variable references, expressions).
+ *
+ * @param index - Zero-based argument position
+ * @param pattern - Regex or exact string to match against argument text
+ */
+export declare function withArgMatching(index: number, pattern: string | RegExp): Predicate<ArchCall>;
+/**
+ * Matches calls where the argument at the given index is a string literal
+ * matching the given glob pattern.
+ *
+ * Only matches when the argument is an actual string literal (quoted).
+ * The glob is matched against the string content (without quotes).
+ *
+ * @param index - Zero-based argument position
+ * @param glob - Glob pattern matched against the string literal value
+ *
+ * @example
+ * // Match: router.get('/api/users', handler)
+ * // Match: router.get('/api/users/:id', handler)
+ * // No match: router.get(pathVariable, handler)
+ * withStringArg(0, '/api/users/**')
+ */
+export declare function withStringArg(index: number, glob: string): Predicate<ArchCall>;
+//# sourceMappingURL=call.d.ts.map

package/dist/predicates/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/predicates/call.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAYtD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAQ1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAiB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAa5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAc9E"}

package/dist/predicates/call.js

@@ -0,0 +1,115 @@
+import { Node } from 'ts-morph';
+import picomatch from 'picomatch';
+/**
+ * Normalize text for matching: replace optional chaining `?.` with `.`
+ * so users don't need to account for both forms.
+ *
+ * Same normalization as src/helpers/matchers.ts.
+ */
+function normalizeText(text) {
+    return text.replace(/\?\./g, '.');
+}
+/**
+ * Matches calls on an object with the given name.
+ *
+ * For `app.get(...)`, onObject('app') matches.
+ * For `router.route.get(...)`, onObject('router.route') matches.
+ *
+ * @param name - Exact object name (after optional-chaining normalization)
+ */
+export function onObject(name) {
+    return {
+        description: `on object '${name}'`,
+        test: (call) => {
+            const obj = call.getObjectName();
+            return obj !== undefined && normalizeText(obj) === name;
+        },
+    };
+}
+/**
+ * Matches calls whose method name matches the given pattern.
+ *
+ * For `app.get(...)`, withMethod('get') matches.
+ * For `app.get(...)`, withMethod(/^(get|post)$/) matches.
+ * For `handleError(...)` (bare call), withMethod('handleError') matches.
+ *
+ * @param nameOrRegex - Exact method name or regex pattern
+ */
+export function withMethod(nameOrRegex) {
+    if (typeof nameOrRegex === 'string') {
+        return {
+            description: `with method '${nameOrRegex}'`,
+            test: (call) => {
+                const method = call.getMethodName();
+                return method !== undefined && normalizeText(method) === nameOrRegex;
+            },
+        };
+    }
+    return {
+        description: `with method matching ${String(nameOrRegex)}`,
+        test: (call) => {
+            const method = call.getMethodName();
+            return method !== undefined && nameOrRegex.test(normalizeText(method));
+        },
+    };
+}
+/**
+ * Matches calls where the argument at the given index matches a pattern.
+ *
+ * The pattern is matched against the argument's getText() output.
+ * Use for flexible argument matching (e.g., variable references, expressions).
+ *
+ * @param index - Zero-based argument position
+ * @param pattern - Regex or exact string to match against argument text
+ */
+export function withArgMatching(index, pattern) {
+    const regex = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
+    return {
+        description: `with argument ${String(index)} matching ${String(regex)}`,
+        test: (call) => {
+            const args = call.getArguments();
+            if (index >= args.length)
+                return false;
+            const argNode = args[index];
+            if (!argNode)
+                return false;
+            const argText = argNode.getText();
+            return regex.test(argText);
+        },
+    };
+}
+/**
+ * Matches calls where the argument at the given index is a string literal
+ * matching the given glob pattern.
+ *
+ * Only matches when the argument is an actual string literal (quoted).
+ * The glob is matched against the string content (without quotes).
+ *
+ * @param index - Zero-based argument position
+ * @param glob - Glob pattern matched against the string literal value
+ *
+ * @example
+ * // Match: router.get('/api/users', handler)
+ * // Match: router.get('/api/users/:id', handler)
+ * // No match: router.get(pathVariable, handler)
+ * withStringArg(0, '/api/users/**')
+ */
+export function withStringArg(index, glob) {
+    const isMatch = picomatch(glob);
+    return {
+        description: `with string argument ${String(index)} matching '${glob}'`,
+        test: (call) => {
+            const args = call.getArguments();
+            if (index >= args.length)
+                return false;
+            const arg = args[index];
+            if (!arg)
+                return false;
+            // Use ts-morph type guard (ADR-005: no duck typing or as casts)
+            if (!Node.isStringLiteral(arg))
+                return false;
+            return isMatch(arg.getLiteralValue());
+        },
+    };
+}
+//# sourceMappingURL=call.js.map

package/dist/predicates/call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/predicates/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAC/B,OAAO,SAAS,MAAM,WAAW,CAAA;AAIjC;;;;;GAKG;AACH,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO;QACL,WAAW,EAAE,cAAc,IAAI,GAAG;QAClC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;YAChC,OAAO,GAAG,KAAK,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,CAAA;QACzD,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,WAA4B;IACrD,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO;YACL,WAAW,EAAE,gBAAgB,WAAW,GAAG;YAC3C,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;gBACb,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;gBACnC,OAAO,MAAM,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,WAAW,CAAA;YACtE,CAAC;SACF,CAAA;IACH,CAAC;IACD,OAAO;QACL,WAAW,EAAE,wBAAwB,MAAM,CAAC,WAAW,CAAC,EAAE;QAC1D,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;YACnC,OAAO,MAAM,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;QACxE,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,OAAwB;IACrE,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACzE,OAAO;QACL,WAAW,EAAE,iBAAiB,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,EAAE;QACvE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;YAChC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAA;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3B,IAAI,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAA;YAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;YACjC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,IAAY;IACvD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC/B,OAAO;QACL,WAAW,EAAE,wBAAwB,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,GAAG;QACvE,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;YAChC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAA;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;YACvB,IAAI,CAAC,GAAG;gBAAE,OAAO,KAAK,CAAA;YACtB,gEAAgE;YAChE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAA;QACvC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/predicates/class.d.ts

@@ -0,0 +1,42 @@
+import type { ClassDeclaration } from 'ts-morph';
+import type { Predicate } from '@nielspeter/eess';
+/**
+ * Matches classes that extend the named base class.
+ *
+ * Uses the extends clause expression text, e.g. `class Foo extends Bar`
+ * matches `extend('Bar')`.
+ */
+export declare function extend(className: string): Predicate<ClassDeclaration>;
+/**
+ * Matches classes that have an explicit `implements` clause for the named interface.
+ *
+ * Checks `getImplements()` expression texts.
+ */
+export declare function implement(interfaceName: string): Predicate<ClassDeclaration>;
+/**
+ * Matches classes that have a decorator with the given name.
+ *
+ * @example haveDecorator('Controller') matches `@Controller class Foo {}`
+ */
+export declare function haveDecorator(name: string): Predicate<ClassDeclaration>;
+/**
+ * Matches classes that have a decorator whose name matches the regex.
+ */
+export declare function haveDecoratorMatching(regex: RegExp): Predicate<ClassDeclaration>;
+/**
+ * Matches abstract classes.
+ */
+export declare function areAbstract(): Predicate<ClassDeclaration>;
+/**
+ * Matches classes that have a method with the given name.
+ */
+export declare function haveMethodNamed(name: string): Predicate<ClassDeclaration>;
+/**
+ * Matches classes that have a method whose name matches the regex.
+ */
+export declare function haveMethodMatching(regex: RegExp): Predicate<ClassDeclaration>;
+/**
+ * Matches classes that have a property with the given name.
+ */
+export declare function havePropertyNamed(name: string): Predicate<ClassDeclaration>;
+//# sourceMappingURL=class.d.ts.map

package/dist/predicates/class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../../src/predicates/class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAKrE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAM5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAKvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAKhF;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAKzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAKzE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAS7E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAK3E"}