@memberjunction/standards 0.0.0 → 6.1.0-edge.1

package/dist/checks/ui-layers.js

@@ -0,0 +1,407 @@
+/**
+ * @fileoverview The UI layering standard.
+ *
+ * Enforces the boundaries in the MJ repo's `guides/UI_LAYERING_GUIDE.md`:
+ *
+ *   runtime  (L0)      pure TS — no Angular at all
+ *   widgets  (L1+L2)   framework-clean Angular — no Router, no Explorer, no global provider
+ *   surface  (L3)      Explorer surfaces — NavigationService only, never Router
+ *   shell              the navigation layer ITSELF — the documented Router exception
+ *
+ * A package opts in by declaring `"mjUILayer"` in its own package.json. A package without the
+ * field is skipped, unless `requireDeclared` is on — see the option's docs for why that matters.
+ *
+ * @module @memberjunction/standards
+ */
+import { readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+const VALID_LAYERS = ['runtime', 'widgets', 'surface', 'shell'];
+/** Module specifiers a layer may never import, with the reason shown on failure. */
+const FORBIDDEN_MODULES = {
+    runtime: [[/^@angular\//, 'L0 runtime code must be pure TypeScript — importable from Node, a worker, or a non-Angular host']],
+    widgets: [
+        [/^@angular\/router$/, 'widgets must not route — emit an event and let the host decide'],
+        [/^@memberjunction\/ng-shared$/, 'ng-shared is Explorer (NavigationService / BaseResourceComponent) — that is L3'],
+        [/^@memberjunction\/ng-explorer/, 'Explorer packages are L3 — a widget that imports one cannot be reused'],
+    ],
+    // L3 lives inside an app that has Router configured, and `RouterModule` is a legitimate import
+    // for declarative `routerLink` chrome. What breaks the shell is *imperative* navigation, so the
+    // surface rule bans the symbols below rather than the module.
+    surface: [],
+    // The shell IS the navigation layer — what NavigationService is implemented on top of. Banning
+    // Router here would ban the implementation of the rule.
+    shell: [],
+};
+/** Imported symbol names a layer may never bind, whatever module they came from. */
+const FORBIDDEN_SYMBOLS = {
+    runtime: [],
+    widgets: [
+        ['Router', 'routing belongs to the host'],
+        ['ActivatedRoute', 'routing belongs to the host'],
+        ['NavigationEnd', 'routing belongs to the host'],
+        ['RouterModule', 'routing belongs to the host'],
+        ['NavigationService', 'navigation is L3 — emit an intent event instead'],
+        ['SharedService', 'SharedService is Explorer chrome — emit a notification event instead'],
+        ['BaseResourceComponent', 'a resource component IS an Explorer surface — that class belongs in the L3 package'],
+        ['BaseDashboard', 'a dashboard IS an Explorer surface — that class belongs in the L3 package'],
+    ],
+    surface: [
+        ['Router', 'use NavigationService — Router desyncs the shell tab state from the URL'],
+        ['ActivatedRoute', 'use GetQueryParams() / OnQueryParamsChanged()'],
+        ['NavigationEnd', 'the shell owns URL sync — never subscribe to Router events'],
+    ],
+    shell: [],
+};
+/**
+ * Source constructs a layer may never contain.
+ *
+ * Note the `\(\s*\)` — only the ZERO-ARGUMENT form is a violation. `new RunView(provider)` passes
+ * a provider explicitly and is correct; a blunter pattern flagged it, which is exactly the kind of
+ * false positive that gets a gate switched off.
+ */
+const FORBIDDEN_PATTERNS = {
+    runtime: [],
+    widgets: [
+        [/\bnew\s+RunViews?\s*\(\s*\)/, 'new RunView()', 'binds the global provider — use RunView.FromMetadataProvider(this.ProviderToUse)'],
+        [/\bnew\s+RunQuery\s*\(\s*\)/, 'new RunQuery()', 'binds the global provider — use this.RunQueryToUse'],
+        [/\bnew\s+Metadata\s*\(\s*\)/, 'new Metadata()', 'binds the global provider — use this.ProviderToUse'], // global-provider-ok: this is the pattern TABLE (a documentation string), not a call site
+    ],
+    surface: [],
+    shell: [],
+};
+/** Dependency specifiers a layer may never declare. The manifest half of the module ban. */
+const FORBIDDEN_DEPS = {
+    runtime: [/^@angular\//],
+    widgets: [/^@angular\/router$/, /^@memberjunction\/ng-shared$/, /^@memberjunction\/ng-explorer/],
+    surface: [],
+    shell: [],
+};
+const SOURCE_EXTENSIONS = ['.ts', '.tsx', '.mts', '.cts'];
+const SKIP_DIRS = new Set(['node_modules', 'dist', 'build', '.git', '.angular', 'coverage', 'generated']);
+const ALLOW_MARKER = 'mj-ui-layers-allow';
+// ─────────────────────────────────────────────────────────────────────────────
+// Source analysis
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Blank out `//` and block comments, preserving every newline so line numbers still line up.
+ *
+ * Necessary because MJ source documents itself heavily: a JSDoc block explaining "this calls
+ * `new RunView()` on the global provider" is a comment about a violation, not a violation, and a
+ * gate that cannot tell the difference gets switched off. String literals are left alone — the
+ * banned constructs do not plausibly appear in one.
+ */
+export function StripComments(source) {
+    let out = '';
+    let index = 0;
+    while (index < source.length) {
+        const two = source.slice(index, index + 2);
+        if (two === '//') {
+            const end = source.indexOf('\n', index);
+            const stop = end === -1 ? source.length : end;
+            out += ' '.repeat(stop - index);
+            index = stop;
+        }
+        else if (two === '/*') {
+            const end = source.indexOf('*/', index + 2);
+            const stop = end === -1 ? source.length : end + 2;
+            out += source.slice(index, stop).replace(/[^\n]/g, ' ');
+            index = stop;
+        }
+        else {
+            out += source[index];
+            index++;
+        }
+    }
+    return out;
+}
+/**
+ * Extract every import/export-from specifier with the names it binds and its 1-based line.
+ *
+ * Import-aware rather than grep-based: matching the bare word `Router` anywhere produces false
+ * positives on `RouterLikeThing`, on comments and on strings. What matters is whether the module
+ * *binds* the symbol.
+ */
+export function ParseImports(source) {
+    const results = [];
+    const re = /(?:^|\n)\s*(?:import|export)\s*(?:type\s+)?(?:([\s\S]*?)\s*from\s*)?['"]([^'"]+)['"]/g;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const [full, clause = '', specifier] = match;
+        const line = source.slice(0, match.index + full.indexOf(specifier)).split('\n').length;
+        const names = [];
+        const braced = /\{([\s\S]*?)\}/.exec(clause);
+        if (braced) {
+            for (const raw of braced[1].split(',')) {
+                const name = raw.trim().replace(/^type\s+/, '').split(/\s+as\s+/)[0].trim();
+                if (name)
+                    names.push(name);
+            }
+        }
+        const defaultOrNamespace = clause.replace(/\{[\s\S]*?\}/, '').replace(/^type\s+/, '').trim().replace(/,$/, '').trim();
+        if (defaultOrNamespace && !defaultOrNamespace.startsWith('*'))
+            names.push(defaultOrNamespace);
+        results.push({ Specifier: specifier, Names: names, Line: line });
+    }
+    return results;
+}
+/**
+ * Does the given 1-based line carry a reviewed-exception marker, on itself or the line above?
+ *
+ * The preceding line counts because a real exception deserves a sentence of explanation and a
+ * trailing comment long enough to hold one is unreadable. Only ONE line above — a wider window
+ * would let a marker drift away from the thing it excuses.
+ */
+export function IsAllowed(lines, lineNumber) {
+    const own = lines[lineNumber - 1] ?? '';
+    const above = lineNumber >= 2 ? (lines[lineNumber - 2] ?? '') : '';
+    return own.includes(ALLOW_MARKER) || above.includes(ALLOW_MARKER);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Filesystem walk
+// ─────────────────────────────────────────────────────────────────────────────
+function findPackageDirs(root) {
+    const found = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        if (entries.some((e) => e.isFile() && e.name === 'package.json'))
+            found.push(dir);
+        for (const entry of entries) {
+            if (!entry.isDirectory() || SKIP_DIRS.has(entry.name))
+                continue;
+            walk(join(dir, entry.name));
+        }
+    };
+    walk(root);
+    return found;
+}
+function findSourceFiles(packageDir) {
+    const found = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name))
+                    walk(full);
+            }
+            else if (SOURCE_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {
+                found.push(full);
+            }
+        }
+    };
+    walk(packageDir);
+    return found;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// The check
+// ─────────────────────────────────────────────────────────────────────────────
+/** Check one opted-in package. */
+function checkPackage(packageDir, layer, repoRoot, packageName) {
+    const violations = [];
+    const add = (file, line, message) => {
+        violations.push({ File: relative(repoRoot, file), Line: line, Message: message, Package: packageName });
+    };
+    // Sources first: the manifest half needs to know which forbidden imports carry a reviewed
+    // exception, because the dependency-check gate (Knip) requires every real import to be
+    // declared — an excused import therefore FORCES a declaration, and flagging that declaration
+    // would put the two gates in deadlock.
+    const excusedSpecifiers = new Set();
+    for (const file of findSourceFiles(packageDir)) {
+        const raw = readFileSync(file, 'utf8');
+        const source = StripComments(raw);
+        // Allow-markers live IN comments, so they are read from the original text.
+        const lines = raw.split('\n');
+        const codeLines = source.split('\n');
+        for (const { Specifier, Names, Line } of ParseImports(source)) {
+            if (IsAllowed(lines, Line)) {
+                if (FORBIDDEN_MODULES[layer].some(([pattern]) => pattern.test(Specifier)))
+                    excusedSpecifiers.add(Specifier);
+                continue;
+            }
+            for (const [pattern, reason] of FORBIDDEN_MODULES[layer]) {
+                if (pattern.test(Specifier))
+                    add(file, Line, `imports "${Specifier}" — ${reason}`);
+            }
+            for (const [symbol, reason] of FORBIDDEN_SYMBOLS[layer]) {
+                if (Names.includes(symbol))
+                    add(file, Line, `imports "${symbol}" — ${reason}`);
+            }
+        }
+        for (const [pattern, label, reason] of FORBIDDEN_PATTERNS[layer]) {
+            codeLines.forEach((text, index) => {
+                if (pattern.test(text) && !IsAllowed(lines, index + 1))
+                    add(file, index + 1, `uses ${label} — ${reason}`);
+            });
+        }
+    }
+    const manifestPath = join(packageDir, 'package.json');
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const declared = { ...(manifest.dependencies ?? {}), ...(manifest.peerDependencies ?? {}) };
+    for (const dep of Object.keys(declared)) {
+        for (const pattern of FORBIDDEN_DEPS[layer]) {
+            if (!pattern.test(dep))
+                continue;
+            // A declaration backing a marker-excused import inherits the exception; an unexcused
+            // import of the same module still flags on its own line, so nothing slips through.
+            const backsExcusedImport = [...excusedSpecifiers].some((s) => s === dep || s.startsWith(`${dep}/`));
+            if (!backsExcusedImport)
+                add(manifestPath, 0, `declares "${dep}" — a "${layer}" package must not depend on it`);
+        }
+    }
+    return violations;
+}
+/**
+ * Read a package's declared layer.
+ *
+ * Returns `undefined` for no declaration and `null` for an invalid one — different outcomes: the
+ * first is "not adopted", the second is a typo that must be reported.
+ */
+function readLayer(packageDir) {
+    try {
+        const manifest = JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8'));
+        const raw = manifest.mjUILayer;
+        const layer = raw === undefined ? undefined : VALID_LAYERS.includes(raw) ? raw : null;
+        return { Name: manifest.name ?? packageDir, Layer: layer };
+    }
+    catch {
+        return null;
+    }
+}
+/** The registered UI layering standard. */
+export const UILayersCheck = {
+    Id: 'ui-layers',
+    Title: 'Widgets must not import Router or MJ Explorer, and must read through ProviderToUse',
+    Since: '6.0.0',
+    DefaultSeverity: 'error',
+    DocsUrl: 'https://github.com/MemberJunction/MJ/blob/next/guides/UI_LAYERING_GUIDE.md',
+    Description: 'Four UI layers: L0 pure-TS runtime, L1 presentational widget, L2 composite widget, L3 Explorer surface. ' +
+        'Nothing below L3 may import @angular/router or an Explorer package; nothing below L3 may construct a ' +
+        'global-provider RunView/Metadata. Packages opt in with "mjUILayer" in their own package.json.',
+    DefaultRoots: ['packages'],
+    DefaultOptions: {
+        /**
+         * Turn "no mjUILayer field" from a skip into a violation, across every scanned root.
+         *
+         * Once a tree is clean, LOCK it. The way drift returns is not an edit to an existing
+         * package — it is a NEW package that never opts in, and from the outside "undeclared" is
+         * indistinguishable from "compliant".
+         */
+        requireDeclared: false,
+        /**
+         * Lock only these subtrees (repo-relative path prefixes), leaving the rest adopting.
+         *
+         * This is the shape a real migration actually takes: one tree gets cleaned and must stay
+         * clean, while the others are still being worked through. Without it a repo has to choose
+         * between locking everything (impossible mid-migration) and locking nothing (which is how
+         * drift returns), and most will pick nothing.
+         */
+        requireDeclaredIn: [],
+    },
+    Run(context) {
+        const violations = [];
+        const notes = [];
+        const undeclared = [];
+        let checkedCount = 0;
+        const requireDeclaredAll = context.Options['requireDeclared'] === true;
+        const lockedPrefixes = Array.isArray(context.Options['requireDeclaredIn'])
+            ? context.Options['requireDeclaredIn'].filter((p) => typeof p === 'string')
+            : [];
+        const isLocked = (packageDir) => {
+            if (requireDeclaredAll)
+                return true;
+            const rel = relative(context.RepoRoot, packageDir).split('\\').join('/');
+            return lockedPrefixes.some((prefix) => rel === prefix || rel.startsWith(`${prefix}/`));
+        };
+        for (const root of context.Roots) {
+            const absolute = join(context.RepoRoot, root);
+            for (const packageDir of findPackageDirs(absolute)) {
+                const info = readLayer(packageDir);
+                if (!info)
+                    continue;
+                if (info.Layer === undefined) {
+                    undeclared.push({ Name: info.Name, Locked: isLocked(packageDir) });
+                    continue;
+                }
+                if (info.Layer === null) {
+                    violations.push({
+                        File: relative(context.RepoRoot, join(packageDir, 'package.json')),
+                        Line: 0,
+                        Message: `mjUILayer is not one of ${VALID_LAYERS.join(' | ')}`,
+                        Package: info.Name,
+                    });
+                    continue;
+                }
+                checkedCount++;
+                violations.push(...checkPackage(packageDir, info.Layer, context.RepoRoot, info.Name));
+            }
+        }
+        const lockedUndeclared = undeclared.filter((u) => u.Locked).map((u) => u.Name).sort();
+        for (const name of lockedUndeclared) {
+            violations.push({
+                File: 'package.json',
+                Line: 0,
+                Message: `${name} has no "mjUILayer" declaration and sits in a locked tree. ` +
+                    `Add "mjUILayer": "${VALID_LAYERS.join('" | "')}" to its package.json.`,
+                Package: name,
+            });
+        }
+        const skipped = undeclared.length - lockedUndeclared.length;
+        notes.push(`${checkedCount} package(s) checked; ${lockedUndeclared.length} undeclared in a locked tree; ` +
+            `${skipped} undeclared elsewhere and skipped`);
+        return { Violations: violations, Notes: notes };
+    },
+};
+/**
+ * Layers a tool may assign automatically, strictest first.
+ *
+ * **`shell` is deliberately absent.** It checks nothing, so every package "passes" as `shell` —
+ * auto-assigning it would hand a permanent exemption to exactly the packages that most need work,
+ * and the repo would get a green check that means nothing. `shell` is a human decision, reserved
+ * for the handful of packages that genuinely implement navigation.
+ */
+const AUTO_ASSIGNABLE_LAYERS = ['runtime', 'widgets', 'surface'];
+/**
+ * Find packages with no `mjUILayer` and work out which layers they could honestly claim.
+ *
+ * This is what lets `mj standards adopt` declare the already-compliant packages instead of leaving
+ * a repo with a config that enforces nothing. It answers the question by **running the rules**
+ * against a hypothetical layer, not by editing anything — probing by writing a field to
+ * package.json and reverting it would be a data-loss bug waiting for an interrupted process.
+ *
+ * `WouldPassAs` is ordered strictest-first and never contains `shell`, so a caller taking
+ * `WouldPassAs[0]` gets the most informative honest label, and a package that passes nothing comes
+ * back with an empty array — "needs work", not "call it shell".
+ */
+export function ProbeUndeclaredPackages(repoRoot, roots) {
+    const results = [];
+    for (const root of roots) {
+        for (const packageDir of findPackageDirs(join(repoRoot, root))) {
+            const info = readLayer(packageDir);
+            if (!info || info.Layer !== undefined)
+                continue;
+            const wouldPassAs = AUTO_ASSIGNABLE_LAYERS.filter((layer) => checkPackage(packageDir, layer, repoRoot, info.Name).length === 0);
+            results.push({ Dir: packageDir, Name: info.Name, WouldPassAs: wouldPassAs });
+        }
+    }
+    return results;
+}
+/** Write `mjUILayer` into a package's manifest, preserving formatting as best as JSON allows. */
+export function DeclareLayer(packageDir, layer) {
+    const path = join(packageDir, 'package.json');
+    const manifest = JSON.parse(readFileSync(path, 'utf8'));
+    manifest['mjUILayer'] = layer;
+    writeFileSync(path, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+}
+//# sourceMappingURL=ui-layers.js.map

package/dist/checks/ui-layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-layers.js","sourceRoot":"","sources":["../../src/checks/ui-layers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAM3C,MAAM,YAAY,GAAc,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAE3E,oFAAoF;AACpF,MAAM,iBAAiB,GAA6C;IAChE,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,iGAAiG,CAAC,CAAC;IAC7H,OAAO,EAAE;QACL,CAAC,oBAAoB,EAAE,gEAAgE,CAAC;QACxF,CAAC,8BAA8B,EAAE,gFAAgF,CAAC;QAClH,CAAC,+BAA+B,EAAE,uEAAuE,CAAC;KAC7G;IACD,+FAA+F;IAC/F,gGAAgG;IAChG,8DAA8D;IAC9D,OAAO,EAAE,EAAE;IACX,+FAA+F;IAC/F,wDAAwD;IACxD,KAAK,EAAE,EAAE;CACZ,CAAC;AAEF,oFAAoF;AACpF,MAAM,iBAAiB,GAA6C;IAChE,OAAO,EAAE,EAAE;IACX,OAAO,EAAE;QACL,CAAC,QAAQ,EAAE,6BAA6B,CAAC;QACzC,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;QACjD,CAAC,eAAe,EAAE,6BAA6B,CAAC;QAChD,CAAC,cAAc,EAAE,6BAA6B,CAAC;QAC/C,CAAC,mBAAmB,EAAE,iDAAiD,CAAC;QACxE,CAAC,eAAe,EAAE,sEAAsE,CAAC;QACzF,CAAC,uBAAuB,EAAE,oFAAoF,CAAC;QAC/G,CAAC,eAAe,EAAE,2EAA2E,CAAC;KACjG;IACD,OAAO,EAAE;QACL,CAAC,QAAQ,EAAE,yEAAyE,CAAC;QACrF,CAAC,gBAAgB,EAAE,+CAA+C,CAAC;QACnE,CAAC,eAAe,EAAE,4DAA4D,CAAC;KAClF;IACD,KAAK,EAAE,EAAE;CACZ,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAqD;IACzE,OAAO,EAAE,EAAE;IACX,OAAO,EAAE;QACL,CAAC,6BAA6B,EAAE,eAAe,EAAE,kFAAkF,CAAC;QACpI,CAAC,4BAA4B,EAAE,gBAAgB,EAAE,oDAAoD,CAAC;QACtG,CAAC,4BAA4B,EAAE,gBAAgB,EAAE,oDAAoD,CAAC,EAAE,0FAA0F;KACrM;IACD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE;CACZ,CAAC;AAEF,4FAA4F;AAC5F,MAAM,cAAc,GAA8B;IAC9C,OAAO,EAAE,CAAC,aAAa,CAAC;IACxB,OAAO,EAAE,CAAC,oBAAoB,EAAE,8BAA8B,EAAE,+BAA+B,CAAC;IAChG,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE;CACZ,CAAC;AAEF,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAC1G,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IACxC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9C,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;YAChC,KAAK,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;YAClD,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACxD,KAAK,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACJ,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;YACrB,KAAK,EAAE,CAAC;QACZ,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACvC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,EAAE,GAAG,uFAAuF,CAAC;IACnG,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACvF,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACT,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5E,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,CAAC;QACL,CAAC;QACD,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACtH,IAAI,kBAAkB,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC9F,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,UAAkB;IACzD,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACtE,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,SAAS,eAAe,CAAC,IAAY;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QAC/B,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACD,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO;QACX,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YAChE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,CAAC;IACL,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,SAAS,eAAe,CAAC,UAAkB;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;QAC/B,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACD,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACL,OAAO;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,CAAC;iBAAM,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACnE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,kCAAkC;AAClC,SAAS,YAAY,CAAC,UAAkB,EAAE,KAAc,EAAE,QAAgB,EAAE,WAAmB;IAC3F,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe,EAAQ,EAAE;QAC9D,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5G,CAAC,CAAC;IAEF,0FAA0F;IAC1F,uFAAuF;IACvF,6FAA6F;IAC7F,uCAAuC;IACvC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAClC,2EAA2E;QAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAErC,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,IAAI,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBACzB,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAAE,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC5G,SAAS;YACb,CAAC;YACD,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvD,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;oBAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,SAAS,OAAO,MAAM,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,MAAM,OAAO,MAAM,EAAE,CAAC,CAAC;YACnF,CAAC;QACL,CAAC;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/D,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBAC9B,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC;oBAAE,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,KAAK,MAAM,MAAM,EAAE,CAAC,CAAC;YAC9G,CAAC,CAAC,CAAC;QACP,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAG7D,CAAC;IACF,MAAM,QAAQ,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,gBAAgB,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5F,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,SAAS;YACjC,qFAAqF;YACrF,mFAAmF;YACnF,MAAM,kBAAkB,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;YACpG,IAAI,CAAC,kBAAkB;gBAAE,GAAG,CAAC,YAAY,EAAE,CAAC,EAAE,aAAa,GAAG,UAAU,KAAK,iCAAiC,CAAC,CAAC;QACpH,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,UAAkB;IACjC,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAGjF,CAAC;QACF,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC;QAC/B,MAAM,KAAK,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAc,CAAC,CAAC,CAAC,CAAE,GAAe,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9G,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,aAAa,GAAkB;IACxC,EAAE,EAAE,WAAW;IACf,KAAK,EAAE,oFAAoF;IAC3F,KAAK,EAAE,OAAO;IACd,eAAe,EAAE,OAAO;IACxB,OAAO,EAAE,4EAA4E;IACrF,WAAW,EACP,0GAA0G;QAC1G,uGAAuG;QACvG,+FAA+F;IACnG,YAAY,EAAE,CAAC,UAAU,CAAC;IAC1B,cAAc,EAAE;QACZ;;;;;;WAMG;QACH,eAAe,EAAE,KAAK;QACtB;;;;;;;WAOG;QACH,iBAAiB,EAAE,EAAc;KACpC;IAED,GAAG,CAAC,OAAqB;QACrB,MAAM,UAAU,GAAgB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,UAAU,GAA6C,EAAE,CAAC;QAChE,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;QACvE,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YACtE,CAAC,CAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YACvG,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,QAAQ,GAAG,CAAC,UAAkB,EAAW,EAAE;YAC7C,IAAI,kBAAkB;gBAAE,OAAO,IAAI,CAAC;YACpC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzE,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QAC3F,CAAC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC9C,KAAK,MAAM,UAAU,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;gBACnC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAEpB,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC3B,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;oBACnE,SAAS;gBACb,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;oBACtB,UAAU,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;wBAClE,IAAI,EAAE,CAAC;wBACP,OAAO,EAAE,2BAA2B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE;wBAC9D,OAAO,EAAE,IAAI,CAAC,IAAI;qBACrB,CAAC,CAAC;oBACH,SAAS;gBACb,CAAC;gBAED,YAAY,EAAE,CAAC;gBACf,UAAU,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1F,CAAC;QACL,CAAC;QAED,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QACtF,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;YAClC,UAAU,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,CAAC;gBACP,OAAO,EACH,GAAG,IAAI,6DAA6D;oBACpE,qBAAqB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,wBAAwB;gBAC3E,OAAO,EAAE,IAAI;aAChB,CAAC,CAAC;QACP,CAAC;QAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC5D,KAAK,CAAC,IAAI,CACN,GAAG,YAAY,wBAAwB,gBAAgB,CAAC,MAAM,gCAAgC;YAC1F,GAAG,OAAO,mCAAmC,CACpD,CAAC;QACF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACpD,CAAC;CACJ,CAAC;AAkBF;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAAc,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,KAAe;IACrE,MAAM,OAAO,GAAwB,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,UAAU,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;YACnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAS;YAChD,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAC7C,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAC/E,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;QACjF,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,KAAc;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA4B,CAAC;IACnF,QAAQ,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;IAC9B,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Reading and writing `.mj-standards.json`.
+ *
+ * @module @memberjunction/standards
+ */
+import type { StandardsConfig } from './types.js';
+/** The file a repo's adoption lives in, at the repository root. */
+export declare const CONFIG_FILENAME = ".mj-standards.json";
+/** Thrown when a config file exists but cannot be trusted. */
+export declare class StandardsConfigError extends Error {
+}
+/** Absolute path to a repo's config file. */
+export declare function ConfigPath(repoRoot: string): string;
+/** Does this repo have an adoption record? */
+export declare function HasConfig(repoRoot: string): boolean;
+/**
+ * Load and validate a repo's config.
+ *
+ * Validation is strict and the errors name the fix, because the failure mode of a lenient loader
+ * is a config that looks adopted and enforces nothing. A typo in a severity should stop the build,
+ * not quietly disable a standard.
+ */
+export declare function LoadConfig(repoRoot: string): StandardsConfig;
+/** Write a config, formatted for humans — this file gets read and edited by hand. */
+export declare function SaveConfig(repoRoot: string, config: StandardsConfig): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAyB,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE,mEAAmE;AACnE,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAIpD,8DAA8D;AAC9D,qBAAa,oBAAqB,SAAQ,KAAK;CAAG;AAElD,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAsE5D;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAQ1E"}

package/dist/config.js

@@ -0,0 +1,98 @@
+/**
+ * @fileoverview Reading and writing `.mj-standards.json`.
+ *
+ * @module @memberjunction/standards
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** The file a repo's adoption lives in, at the repository root. */
+export const CONFIG_FILENAME = '.mj-standards.json';
+const VALID_SEVERITIES = ['off', 'warn', 'error'];
+/** Thrown when a config file exists but cannot be trusted. */
+export class StandardsConfigError extends Error {
+}
+/** Absolute path to a repo's config file. */
+export function ConfigPath(repoRoot) {
+    return join(repoRoot, CONFIG_FILENAME);
+}
+/** Does this repo have an adoption record? */
+export function HasConfig(repoRoot) {
+    return existsSync(ConfigPath(repoRoot));
+}
+/**
+ * Load and validate a repo's config.
+ *
+ * Validation is strict and the errors name the fix, because the failure mode of a lenient loader
+ * is a config that looks adopted and enforces nothing. A typo in a severity should stop the build,
+ * not quietly disable a standard.
+ */
+export function LoadConfig(repoRoot) {
+    const path = ConfigPath(repoRoot);
+    if (!existsSync(path)) {
+        throw new StandardsConfigError(`No ${CONFIG_FILENAME} at ${repoRoot}. Run \`mj standards adopt\` to create one.`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (e) {
+        throw new StandardsConfigError(`${CONFIG_FILENAME} is not valid JSON: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new StandardsConfigError(`${CONFIG_FILENAME} must contain a JSON object.`);
+    }
+    const raw = parsed;
+    const standardsVersion = raw['StandardsVersion'];
+    if (typeof standardsVersion !== 'string' || standardsVersion.length === 0) {
+        throw new StandardsConfigError(`${CONFIG_FILENAME} is missing "StandardsVersion". It records the MJ version this repo adopted ` +
+            `standards against, and is what stops newer standards from activating themselves here.`);
+    }
+    const checksRaw = raw['Checks'];
+    if (typeof checksRaw !== 'object' || checksRaw === null) {
+        throw new StandardsConfigError(`${CONFIG_FILENAME} is missing a "Checks" object.`);
+    }
+    const checks = {};
+    for (const [id, value] of Object.entries(checksRaw)) {
+        if (typeof value !== 'object' || value === null) {
+            throw new StandardsConfigError(`${CONFIG_FILENAME}: Checks["${id}"] must be an object.`);
+        }
+        const entry = value;
+        const severity = entry['Severity'];
+        if (typeof severity !== 'string' || !VALID_SEVERITIES.includes(severity)) {
+            throw new StandardsConfigError(`${CONFIG_FILENAME}: Checks["${id}"].Severity must be one of ${VALID_SEVERITIES.join(' | ')}.`);
+        }
+        const roots = entry['Roots'];
+        if (roots !== undefined && (!Array.isArray(roots) || roots.some((r) => typeof r !== 'string'))) {
+            throw new StandardsConfigError(`${CONFIG_FILENAME}: Checks["${id}"].Roots must be an array of strings.`);
+        }
+        const options = entry['Options'];
+        if (options !== undefined && (typeof options !== 'object' || options === null)) {
+            throw new StandardsConfigError(`${CONFIG_FILENAME}: Checks["${id}"].Options must be an object.`);
+        }
+        checks[id] = {
+            Severity: severity,
+            ...(roots ? { Roots: roots } : {}),
+            ...(options ? { Options: options } : {}),
+        };
+    }
+    const rootsRaw = raw['Roots'];
+    if (rootsRaw !== undefined && (!Array.isArray(rootsRaw) || rootsRaw.some((r) => typeof r !== 'string'))) {
+        throw new StandardsConfigError(`${CONFIG_FILENAME}: "Roots" must be an array of strings.`);
+    }
+    return {
+        StandardsVersion: standardsVersion,
+        ...(rootsRaw ? { Roots: rootsRaw } : {}),
+        Checks: checks,
+    };
+}
+/** Write a config, formatted for humans — this file gets read and edited by hand. */
+export function SaveConfig(repoRoot, config) {
+    const ordered = {
+        $schema: config.$schema ?? './node_modules/@memberjunction/standards/schema/mj-standards.schema.json',
+        StandardsVersion: config.StandardsVersion,
+        ...(config.Roots ? { Roots: config.Roots } : {}),
+        Checks: config.Checks,
+    };
+    writeFileSync(ConfigPath(repoRoot), `${JSON.stringify(ordered, null, 2)}\n`, 'utf8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `@memberjunction/standards` — MemberJunction's engineering standards, as runnable checks.
+ *
+ * ## What this is for
+ *
+ * MJ's standards live in two forms. **Judgment standards** are prose that has to be read — the
+ * guides in the MJ repo. **Executable standards** are the ones a machine can settle, and those are
+ * here. Shipping them as a versioned package rather than a file to copy is what lets a dozen repos
+ * — first-party, client, and external — stay aligned as the standards evolve.
+ *
+ * ## The property that makes it safe
+ *
+ * **A new standard never changes an existing repo's result.** A check is registered here as
+ * *available*; it does not run until a repo's `.mj-standards.json` names it. Checks whose `Since`
+ * postdates the repo's recorded `StandardsVersion` are reported as available and stay inert until
+ * a human runs `mj standards adopt --upgrade`.
+ *
+ * That means this package can ship new standards continuously, and a repo pinned on an older MJ
+ * never wakes up to a red build it did not ask for.
+ *
+ * ## Usage
+ *
+ * ```bash
+ * mj standards adopt --ci github --declare-compliant   # scaffold a repo
+ * mj standards check                                   # run what the repo adopted
+ * mj standards list                                    # what exists, and what this repo uses
+ * ```
+ *
+ * @module @memberjunction/standards
+ */
+export * from './types.js';
+export * from './version.js';
+export * from './config.js';
+export * from './registry.js';
+export * from './runner.js';
+export * from './scaffold.js';
+export * from './checks/ui-layers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * `@memberjunction/standards` — MemberJunction's engineering standards, as runnable checks.
+ *
+ * ## What this is for
+ *
+ * MJ's standards live in two forms. **Judgment standards** are prose that has to be read — the
+ * guides in the MJ repo. **Executable standards** are the ones a machine can settle, and those are
+ * here. Shipping them as a versioned package rather than a file to copy is what lets a dozen repos
+ * — first-party, client, and external — stay aligned as the standards evolve.
+ *
+ * ## The property that makes it safe
+ *
+ * **A new standard never changes an existing repo's result.** A check is registered here as
+ * *available*; it does not run until a repo's `.mj-standards.json` names it. Checks whose `Since`
+ * postdates the repo's recorded `StandardsVersion` are reported as available and stay inert until
+ * a human runs `mj standards adopt --upgrade`.
+ *
+ * That means this package can ship new standards continuously, and a repo pinned on an older MJ
+ * never wakes up to a red build it did not ask for.
+ *
+ * ## Usage
+ *
+ * ```bash
+ * mj standards adopt --ci github --declare-compliant   # scaffold a repo
+ * mj standards check                                   # run what the repo adopted
+ * mj standards list                                    # what exists, and what this repo uses
+ * ```
+ *
+ * @module @memberjunction/standards
+ */
+export * from './types.js';
+export * from './version.js';
+export * from './config.js';
+export * from './registry.js';
+export * from './runner.js';
+export * from './scaffold.js';
+export * from './checks/ui-layers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC"}