@dereekb/dbx-cli 13.15.0 → 13.17.0

package/eslint/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@dereekb/dbx-cli/eslint",
+  "version": "13.17.0",
+  "peerDependencies": {
+    "@dereekb/dbx-cli": "13.17.0",
+    "@dereekb/util": "13.17.0",
+    "@typescript-eslint/utils": "8.59.3"
+  },
+  "devDependencies": {
+    "@typescript-eslint/parser": "8.59.3",
+    "eslint": "10.4.0"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "module": "./index.esm.js",
+      "types": "./index.d.ts",
+      "import": "./index.cjs.mjs",
+      "default": "./index.cjs.js"
+    }
+  },
+  "module": "./index.esm.js",
+  "main": "./index.cjs.js",
+  "types": "./index.d.ts"
+}

package/eslint/rollup.alias-internal.config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @param config - The rollup config @nx/rollup hands to the hook.
+ * @param _options - The @nx/rollup options (unused).
+ * @returns The mutated rollup config.
+ *
+ * @nx /rollup `rollupConfig` hook that inlines the workspace's internal `@dereekb/*` imports into
+ * the published ESLint plugin bundle. Prepends an alias plugin redirecting {@link INTERNAL_ALIASES}
+ * to their TS sources and wraps the `external: "all"` callback so {@link BUNDLED_DEPENDENCIES} are
+ * treated as internal.
+ */
+export default function applyInternalAliases(config: any, _options: any): Promise<any>;

package/eslint/src/index.d.ts

@@ -0,0 +1 @@
+export * from './lib';

package/eslint/src/lib/index.d.ts

@@ -0,0 +1,2 @@
+export { DBX_CLI_VALID_DBX_ROUTE_MODEL_TAGS_RULE, type DbxCliValidDbxRouteModelTagsRuleDefinition } from './valid-dbx-route-model-tags.rule';
+export { DBX_CLI_ESLINT_PLUGIN, dbxCliESLintPlugin, type DbxCliEslintPlugin } from './plugin';

package/eslint/src/lib/plugin.d.ts

@@ -0,0 +1,22 @@
+import { type DbxCliValidDbxRouteModelTagsRuleDefinition } from './valid-dbx-route-model-tags.rule';
+/**
+ * ESLint plugin interface for `@dereekb/dbx-cli` rules.
+ */
+export interface DbxCliEslintPlugin {
+    readonly rules: {
+        readonly 'valid-dbx-route-model-tags': DbxCliValidDbxRouteModelTagsRuleDefinition;
+    };
+}
+/**
+ * ESLint plugin for `@dereekb/dbx-cli` rules.
+ *
+ * Register as a plugin in your flat ESLint config, then enable individual rules
+ * under the chosen plugin prefix (e.g. 'dereekb-dbx-cli/valid-dbx-route-model-tags').
+ */
+export declare const DBX_CLI_ESLINT_PLUGIN: DbxCliEslintPlugin;
+/**
+ * camelCase alias of {@link DBX_CLI_ESLINT_PLUGIN} matching the conventional ESLint plugin export name.
+ *
+ * @dbxAllowConstantName
+ */
+export declare const dbxCliESLintPlugin: DbxCliEslintPlugin;

package/eslint/src/lib/valid-dbx-route-model-tags.rule.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ESLint rule that validates `@dbxRouteModel` / `@dbxRouteModelList` JSDoc tag
+ * grammar at author time. Each tag is parsed through `@dereekb/dbx-cli`'s
+ * canonical {@link parseRouteModelTag} grammar — the exact parser the build-time
+ * route-manifest builder uses — so ESLint and the manifest generator can never
+ * disagree about what a valid tag is. A malformed tag (typo'd model type, bad
+ * key template, wrong token count, unknown `@dbxRouteModel*` name) is reported on
+ * its own JSDoc line with the parser's failure reason.
+ *
+ * Scope: route-model tags live on `@Component` classes in `*.component.ts` and on
+ * exported `Ng2StateDeclaration` consts in `*.router.ts`, so the rule visits class
+ * and variable declarations (anchoring to their `export` wrapper for the leading
+ * JSDoc). It has no auto-fix — the correct value requires human / agent judgment.
+ */
+interface AstNode {
+    readonly type: string;
+    [key: string]: any;
+}
+/**
+ * ESLint rule definition for valid-dbx-route-model-tags.
+ */
+export interface DbxCliValidDbxRouteModelTagsRuleDefinition {
+    readonly meta: {
+        readonly type: 'problem';
+        readonly docs: {
+            readonly description: string;
+            readonly recommended: boolean;
+        };
+        readonly messages: Readonly<Record<string, string>>;
+        readonly schema: readonly object[];
+    };
+    create(context: {
+        report: (descriptor: {
+            loc?: AstNode;
+            node?: AstNode;
+            messageId: string;
+            data?: Record<string, string>;
+        }) => void;
+        sourceCode: AstNode;
+    }): Record<string, (node: AstNode) => void>;
+}
+/**
+ * ESLint rule enforcing that `@dbxRouteModel` / `@dbxRouteModelList` tags parse
+ * cleanly through the canonical route-model grammar. Reuses
+ * {@link parseRouteModelTag} from `@dereekb/dbx-cli` so a tag that lints clean is
+ * a tag the build-time manifest builder will accept.
+ *
+ * Checks (delegated to the grammar parser):
+ *
+ * - `@dbxRouteModel <modelType> <keyTemplate>` has exactly two tokens with a valid
+ *   model-type identifier and a parseable key template (`:param` / `{authUid}` /
+ *   even-segment `gb/:id/...` form).
+ * - `@dbxRouteModelList <modelType>` has a single valid model-type token.
+ * - A `@dbxRouteModel*` tag with an unknown name is flagged.
+ *
+ * Report-only — no auto-fix, since the corrected value needs judgment.
+ */
+export declare const DBX_CLI_VALID_DBX_ROUTE_MODEL_TAGS_RULE: DbxCliValidDbxRouteModelTagsRuleDefinition;
+export {};