@spikedpunch/align-core 0.1.0

package/dist/types/branded.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Branded primitives (CODING_BEST_PRACTICES.md §11): confusion between these string kinds is
+ * expensive (wrong file targeted, wrong rule cited, baseline entry applied to the wrong
+ * violation), so they are branded rather than left as plain `string`.
+ *
+ * Constructors live at the trusted boundary (scanner output, DSL component registration, zod
+ * `.parse()`); everywhere else these are trusted, not re-validated (parse-don't-validate,
+ * CODING_BEST_PRACTICES.md §12).
+ */
+export type RepoRelativePath = string & {
+    readonly __brand: 'RepoRelativePath';
+};
+export type ComponentName = string & {
+    readonly __brand: 'ComponentName';
+};
+export type RuleId = string & {
+    readonly __brand: 'RuleId';
+};
+export type ViolationId = string & {
+    readonly __brand: 'ViolationId';
+};
+export declare function toRepoRelativePath(raw: string): RepoRelativePath;
+export declare function toComponentName(raw: string): ComponentName;
+export declare function toRuleId(raw: string): RuleId;
+export declare function toViolationId(raw: string): ViolationId;
+//# sourceMappingURL=branded.d.ts.map

package/dist/types/branded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.d.ts","sourceRoot":"","sources":["../../src/types/branded.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAC;AACjF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAC3E,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAEvE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAIhE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAE1D;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAEtD"}

package/dist/types/branded.js

@@ -0,0 +1,24 @@
+/**
+ * Branded primitives (CODING_BEST_PRACTICES.md §11): confusion between these string kinds is
+ * expensive (wrong file targeted, wrong rule cited, baseline entry applied to the wrong
+ * violation), so they are branded rather than left as plain `string`.
+ *
+ * Constructors live at the trusted boundary (scanner output, DSL component registration, zod
+ * `.parse()`); everywhere else these are trusted, not re-validated (parse-don't-validate,
+ * CODING_BEST_PRACTICES.md §12).
+ */
+export function toRepoRelativePath(raw) {
+    // Normalize to forward slashes so brand construction is also the one place path separators
+    // get canonicalized (Windows dev boxes, mixed-separator inputs).
+    return raw.split('\\').join('/');
+}
+export function toComponentName(raw) {
+    return raw;
+}
+export function toRuleId(raw) {
+    return raw;
+}
+export function toViolationId(raw) {
+    return raw;
+}
+//# sourceMappingURL=branded.js.map

package/dist/types/branded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branded.js","sourceRoot":"","sources":["../../src/types/branded.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,2FAA2F;IAC3F,iEAAiE;IACjE,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAqB,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,GAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,GAAkB,CAAC;AAC5B,CAAC"}

package/dist/types/graph.d.ts

@@ -0,0 +1,46 @@
+import type { ComponentName, RepoRelativePath } from './branded.js';
+export type EdgeKind = 'import' | 'reexport' | 'dynamic' | 'type-only';
+export interface DependencyGraphNode {
+    readonly file: RepoRelativePath;
+    readonly component: ComponentName;
+    readonly loc: number;
+    readonly exports: readonly string[];
+    readonly snippet: string;
+}
+export interface DependencyGraphEdge {
+    readonly from: RepoRelativePath;
+    readonly to: RepoRelativePath;
+    readonly specifier: string;
+    readonly line: number;
+    readonly kind: EdgeKind;
+    readonly snippet: string;
+}
+export interface ExternalPackageNode {
+    readonly id: string;
+    readonly packageName: string;
+    readonly isBuiltin: boolean;
+}
+export interface ExternalDependencyEdge {
+    readonly from: RepoRelativePath;
+    readonly to: string;
+    readonly specifier: string;
+    readonly line: number;
+    readonly kind: EdgeKind;
+    readonly snippet: string;
+}
+export type UncertaintyReason = 'non-literal-dynamic-specifier' | 'unresolvable-specifier' | 'asset-specifier' | 'build-output-excluded' | 'fixture-excluded';
+export interface UncertaintyMarker {
+    readonly file: RepoRelativePath;
+    readonly specifier: string;
+    readonly line: number;
+    readonly reason: UncertaintyReason;
+}
+export interface DependencyGraph {
+    readonly nodes: readonly DependencyGraphNode[];
+    readonly edges: readonly DependencyGraphEdge[];
+    readonly externalNodes: readonly ExternalPackageNode[];
+    readonly externalEdges: readonly ExternalDependencyEdge[];
+    readonly uncertain: readonly UncertaintyMarker[];
+    readonly scannedAt: number;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/types/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/types/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAQpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAOxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD,MAAM,WAAW,mBAAmB;IAKlC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,iBAAiB,GACzB,+BAA+B,GAC/B,wBAAwB,GACxB,iBAAiB,GACjB,uBAAuB,GACvB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAI/C,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,aAAa,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/types/graph.js

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

package/dist/types/graph.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from './branded.js';
+export * from './violation.js';
+export * from './ir.js';
+export * from './graph.js';
+export * from './manifest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+export * from './branded.js';
+export * from './violation.js';
+export * from './ir.js';
+export * from './graph.js';
+export * from './manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}