npm - @luma-layered-ts/eslint-plugin - Versions diffs - 0.0.0-stage → 1.0.1 - Mend

@luma-layered-ts/eslint-plugin 0.0.0-stage → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (22) hide show

package/lib/create-rule.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+declare const createRule: <Options extends readonly unknown[], MessageIds extends string>({ meta, name, ...rule }: Readonly<ESLintUtils.RuleWithMetaAndName<Options, MessageIds, unknown>>) => ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
+    name: string;
+};
+export { createRule };
+//# sourceMappingURL=create-rule.d.ts.map

package/lib/create-rule.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"create-rule.d.ts","sourceRoot":"","sources":["../src/create-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,QAAA,MAAM,UAAU;;CAGf,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/lib/create-rule.js ADDED Viewed

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRule = void 0;
+const utils_1 = require("@typescript-eslint/utils");
+const createRule = utils_1.ESLintUtils.RuleCreator((name) => `https://github.com/LumaKernel/luma-layered-ts/blob/main/prompts/eslint-rules.md#${name}`);
+exports.createRule = createRule;
+//# sourceMappingURL=create-rule.js.map

package/lib/create-rule.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"create-rule.js","sourceRoot":"","sources":["../src/create-rule.ts"],"names":[],"mappings":";;;AAAA,oDAAuD;AAEvD,MAAM,UAAU,GAAG,mBAAW,CAAC,WAAW,CACxC,CAAC,IAAI,EAAE,EAAE,CACP,mFAAmF,IAAI,EAAE,CAC5F,CAAC;AAEO,gCAAU"}

package/lib/index.d.ts ADDED Viewed

@@ -0,0 +1,38 @@
+import type { TSESLint } from "@typescript-eslint/utils";
+export declare const rules: {
+    server: TSESLint.RuleModule<"importViolation" | "encodedGlobal" | "ioGlobal" | "schemaBoundary" | "encodedMethod", [{
+        [x: string]: never;
+    }], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+    react: TSESLint.RuleModule<"importViolation" | "encodedGlobal" | "schemaBoundary" | "encodedMethod" | "componentParseMethod", [{
+        [x: string]: never;
+    }], unknown, TSESLint.RuleListener> & {
+        name: string;
+    };
+};
+export declare const configs: {
+    recommended: {
+        plugins: {
+            "@luma-layered-ts": {
+                rules: {
+                    server: TSESLint.RuleModule<"importViolation" | "encodedGlobal" | "ioGlobal" | "schemaBoundary" | "encodedMethod", [{
+                        [x: string]: never;
+                    }], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                    react: TSESLint.RuleModule<"importViolation" | "encodedGlobal" | "schemaBoundary" | "encodedMethod" | "componentParseMethod", [{
+                        [x: string]: never;
+                    }], unknown, TSESLint.RuleListener> & {
+                        name: string;
+                    };
+                };
+            };
+        };
+        rules: {
+            "@luma-layered-ts/server": "error";
+            "@luma-layered-ts/react": "error";
+        };
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,eAAO,MAAM,KAAK;;;;;;;;;;;CAGjB,CAAC;AAMF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAUnB,CAAC"}

package/lib/index.js ADDED Viewed

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configs = exports.rules = void 0;
+const server_1 = __importDefault(require("./rules/server"));
+const react_1 = __importDefault(require("./rules/react"));
+exports.rules = {
+    server: server_1.default,
+    react: react_1.default,
+};
+const plugin = {
+    rules: exports.rules,
+};
+exports.configs = {
+    recommended: {
+        plugins: {
+            "@luma-layered-ts": plugin,
+        },
+        rules: {
+            "@luma-layered-ts/server": "error",
+            "@luma-layered-ts/react": "error",
+        },
+    },
+};
+//# sourceMappingURL=index.js.map

package/lib/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,4DAAoC;AACpC,0DAAkC;AAGrB,QAAA,KAAK,GAAG;IACnB,MAAM,EAAN,gBAAM;IACN,KAAK,EAAL,eAAK;CACN,CAAC;AAEF,MAAM,MAAM,GAAG;IACb,KAAK,EAAL,aAAK;CAC2B,CAAC;AAEtB,QAAA,OAAO,GAAG;IACrB,WAAW,EAAE;QACX,OAAO,EAAE;YACP,kBAAkB,EAAE,MAAM;SAC3B;QACD,KAAK,EAAE;YACL,yBAAyB,EAAE,OAAO;YAClC,wBAAwB,EAAE,OAAO;SAClC;KACmC;CACvC,CAAC"}

package/lib/layers.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+export declare const LAYER_NAMES: readonly ["core", "service", "adapter", "infra", "ui/hooks", "ui/components", "ui/pages"];
+export type LayerName = (typeof LAYER_NAMES)[number];
+export declare function getLayerFromPath(filePath: string): LayerName | null;
+export declare function getLayerFromImport(importPath: string): LayerName | null;
+export declare function canImport(from: LayerName, to: LayerName): boolean;
+export declare const ENCODING_GLOBALS: Set<string>;
+export declare const IO_GLOBALS: Set<string>;
+export declare const SCHEMA_BOUNDARY_METHODS: Set<string>;
+export declare const STRING_INTERPRETATION_METHODS: Set<string>;
+//# sourceMappingURL=layers.d.ts.map

package/lib/layers.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,2FAQd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAarD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMnE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAcvE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,GAAG,OAAO,CAGjE;AAKD,eAAO,MAAM,gBAAgB,aAU3B,CAAC;AAGH,eAAO,MAAM,UAAU,aAMrB,CAAC;AAGH,eAAO,MAAM,uBAAuB,aAWlC,CAAC;AAGH,eAAO,MAAM,6BAA6B,aAyBxC,CAAC"}

package/lib/layers.js ADDED Viewed

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STRING_INTERPRETATION_METHODS = exports.SCHEMA_BOUNDARY_METHODS = exports.IO_GLOBALS = exports.ENCODING_GLOBALS = exports.LAYER_NAMES = void 0;
+exports.getLayerFromPath = getLayerFromPath;
+exports.getLayerFromImport = getLayerFromImport;
+exports.canImport = canImport;
+exports.LAYER_NAMES = [
+    "core",
+    "service",
+    "adapter",
+    "infra",
+    "ui/hooks",
+    "ui/components",
+    "ui/pages",
+];
+// import行列: 各レイヤがimport可能なレイヤ (自身は常に可)
+const allowedImports = {
+    core: [],
+    service: ["core"],
+    adapter: ["core", "service"],
+    infra: ["core", "service", "adapter"],
+    "ui/hooks": ["core", "service"],
+    "ui/components": ["core", "ui/hooks"],
+    "ui/pages": ["core", "service", "ui/hooks", "ui/components"],
+};
+function getLayerFromPath(filePath) {
+    const match = filePath.match(/\/src\/(ui\/(?:hooks|components|pages)|core|service|adapter|infra)\//);
+    if (!match)
+        return null;
+    return match[1];
+}
+function getLayerFromImport(importPath) {
+    for (const layer of exports.LAYER_NAMES) {
+        if (importPath.includes(`/${layer}/`) ||
+            importPath.startsWith(`${layer}/`) ||
+            importPath === layer) {
+            return layer;
+        }
+        if (importPath.startsWith(`@/${layer}/`) || importPath === `@/${layer}`) {
+            return layer;
+        }
+    }
+    return null;
+}
+function canImport(from, to) {
+    if (from === to)
+        return true;
+    return allowedImports[from].includes(to);
+}
+// --- Encoded representation restrictions ---
+// Globals that interact with encoded representations (serialization, parsing)
+exports.ENCODING_GLOBALS = new Set([
+    "JSON",
+    "parseInt",
+    "parseFloat",
+    "encodeURIComponent",
+    "decodeURIComponent",
+    "encodeURI",
+    "decodeURI",
+    "atob",
+    "btoa",
+]);
+// IO boundary globals
+exports.IO_GLOBALS = new Set([
+    "fetch",
+    "Request",
+    "Response",
+    "Headers",
+    "FormData",
+]);
+// Schema boundary methods (decode/encode = canonical ↔ encoded conversion)
+exports.SCHEMA_BOUNDARY_METHODS = new Set([
+    "decode",
+    "decodeSync",
+    "decodeUnknown",
+    "decodeUnknownSync",
+    "decodePromise",
+    "encode",
+    "encodeSync",
+    "encodeUnknown",
+    "encodeUnknownSync",
+    "encodePromise",
+]);
+// String interpretation methods (structural access, pattern matching, content inspection)
+exports.STRING_INTERPRETATION_METHODS = new Set([
+    "split",
+    "match",
+    "matchAll",
+    "replace",
+    "replaceAll",
+    "search",
+    "includes",
+    "startsWith",
+    "endsWith",
+    "indexOf",
+    "lastIndexOf",
+    "slice",
+    "substring",
+    "charAt",
+    "charCodeAt",
+    "codePointAt",
+    "normalize",
+    "padStart",
+    "padEnd",
+    "repeat",
+    "localeCompare",
+    "trim",
+    "trimStart",
+    "trimEnd",
+]);
+//# sourceMappingURL=layers.js.map

package/lib/layers.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"layers.js","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":";;;AAuBA,4CAMC;AAED,gDAcC;AAED,8BAGC;AAlDY,QAAA,WAAW,GAAG;IACzB,MAAM;IACN,SAAS;IACT,SAAS;IACT,OAAO;IACP,UAAU;IACV,eAAe;IACf,UAAU;CACF,CAAC;AAIX,uCAAuC;AACvC,MAAM,cAAc,GAA4C;IAC9D,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IAC5B,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;IACrC,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;IAC/B,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;IACrC,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC;CAC7D,CAAC;AAEF,SAAgB,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAC1B,sEAAsE,CACvE,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,CAAC,CAAc,CAAC;AAC/B,CAAC;AAED,SAAgB,kBAAkB,CAAC,UAAkB;IACnD,KAAK,MAAM,KAAK,IAAI,mBAAW,EAAE,CAAC;QAChC,IACE,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC;YACjC,UAAU,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC;YAClC,UAAU,KAAK,KAAK,EACpB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,UAAU,KAAK,KAAK,KAAK,EAAE,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,SAAS,CAAC,IAAe,EAAE,EAAa;IACtD,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,8CAA8C;AAE9C,8EAA8E;AACjE,QAAA,gBAAgB,GAAG,IAAI,GAAG,CAAC;IACtC,MAAM;IACN,UAAU;IACV,YAAY;IACZ,oBAAoB;IACpB,oBAAoB;IACpB,WAAW;IACX,WAAW;IACX,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AAEH,sBAAsB;AACT,QAAA,UAAU,GAAG,IAAI,GAAG,CAAC;IAChC,OAAO;IACP,SAAS;IACT,UAAU;IACV,SAAS;IACT,UAAU;CACX,CAAC,CAAC;AAEH,2EAA2E;AAC9D,QAAA,uBAAuB,GAAG,IAAI,GAAG,CAAC;IAC7C,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,mBAAmB;IACnB,eAAe;IACf,QAAQ;IACR,YAAY;IACZ,eAAe;IACf,mBAAmB;IACnB,eAAe;CAChB,CAAC,CAAC;AAEH,0FAA0F;AAC7E,QAAA,6BAA6B,GAAG,IAAI,GAAG,CAAC;IACnD,OAAO;IACP,OAAO;IACP,UAAU;IACV,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,UAAU;IACV,SAAS;IACT,aAAa;IACb,OAAO;IACP,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,WAAW;IACX,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,eAAe;IACf,MAAM;IACN,WAAW;IACX,SAAS;CACV,CAAC,CAAC"}

package/lib/rules/react.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+type Options = Record<string, never>;
+type MessageId = "importViolation" | "encodedGlobal" | "schemaBoundary" | "encodedMethod" | "componentParseMethod";
+declare const _default: import("@typescript-eslint/utils/dist/ts-eslint/Rule.js").RuleModule<MessageId, [Options], unknown, import("@typescript-eslint/utils/dist/ts-eslint/Rule.js").RuleListener> & {
+    name: string;
+};
+export default _default;
+//# sourceMappingURL=react.d.ts.map

package/lib/rules/react.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/rules/react.ts"],"names":[],"mappings":"AAYA,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAQrC,KAAK,SAAS,GACV,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,sBAAsB,CAAC;;;;AAE3B,wBAqJG"}

package/lib/rules/react.js ADDED Viewed

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@typescript-eslint/utils");
+const create_rule_js_1 = require("../create-rule.js");
+const layers_js_1 = require("../layers.js");
+const defaultOptions = {};
+const UI_LAYERS = new Set(["ui/hooks", "ui/components", "ui/pages"]);
+// components can call .display(), .trim(), .toString() — these don't interpret structure
+const COMPONENT_ALLOWED_METHODS = new Set(["display", "trim", "toString"]);
+exports.default = (0, create_rule_js_1.createRule)({
+    name: "react",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Enforce layered architecture for React UI layers (ui/hooks, ui/components, ui/pages). Checks imports, encoded representation globals, Schema boundary, and string interpretation.",
+        },
+        messages: {
+            importViolation: "'{{fromLayer}}' cannot import from '{{toLayer}}'.",
+            encodedGlobal: "'{{name}}' is an encoded representation API. Not allowed in '{{layer}}'. Use canonical types (Effect.ts) instead.",
+            schemaBoundary: "Schema.{{method}}() crosses the canonical/encoded boundary. Not allowed in '{{layer}}'. Decoding belongs in adapter.",
+            encodedMethod: "'.{{method}}()' interprets encoded representation. Not allowed in '{{layer}}'.",
+            componentParseMethod: "'.{{method}}()' interprets string structure. Components may only call .display() and .trim().",
+        },
+        schema: [],
+    },
+    defaultOptions: [defaultOptions],
+    create(context) {
+        const filePath = context.filename;
+        const layer = (0, layers_js_1.getLayerFromPath)(filePath);
+        if (!layer || !UI_LAYERS.has(layer))
+            return {};
+        const isComponent = layer === "ui/components";
+        function checkImport(importPath, node) {
+            const toLayer = (0, layers_js_1.getLayerFromImport)(importPath);
+            if (!toLayer)
+                return;
+            if (!(0, layers_js_1.canImport)(layer, toLayer)) {
+                context.report({
+                    node,
+                    messageId: "importViolation",
+                    data: { fromLayer: layer, toLayer },
+                });
+            }
+        }
+        return {
+            // --- Import checks ---
+            ImportDeclaration(node) {
+                checkImport(node.source.value, node);
+            },
+            ImportExpression(node) {
+                if (node.source.type === utils_1.AST_NODE_TYPES.Literal &&
+                    typeof node.source.value === "string") {
+                    checkImport(node.source.value, node);
+                }
+            },
+            TSExternalModuleReference(node) {
+                if (node.expression.type === utils_1.AST_NODE_TYPES.Literal &&
+                    typeof node.expression.value === "string") {
+                    checkImport(node.expression.value, node);
+                }
+            },
+            // --- Encoding globals (all UI layers) ---
+            Identifier(node) {
+                if (!layers_js_1.ENCODING_GLOBALS.has(node.name))
+                    return;
+                // Skip property access right-hand side
+                if (node.parent?.type === utils_1.AST_NODE_TYPES.MemberExpression &&
+                    node.parent.property === node &&
+                    !node.parent.computed) {
+                    return;
+                }
+                // Skip type contexts
+                if (isInTypeContext(node))
+                    return;
+                context.report({
+                    node,
+                    messageId: "encodedGlobal",
+                    data: { name: node.name, layer },
+                });
+            },
+            // --- Schema boundary + string interpretation ---
+            CallExpression(node) {
+                if (node.callee.type !== utils_1.AST_NODE_TYPES.MemberExpression ||
+                    node.callee.property.type !== utils_1.AST_NODE_TYPES.Identifier) {
+                    return;
+                }
+                const method = node.callee.property.name;
+                // Schema boundary (all UI layers)
+                if (layers_js_1.SCHEMA_BOUNDARY_METHODS.has(method)) {
+                    context.report({
+                        node,
+                        messageId: "schemaBoundary",
+                        data: { method, layer },
+                    });
+                    return;
+                }
+                // toString is always allowed
+                if (method === "toString")
+                    return;
+                if (isComponent) {
+                    // Components: display/trim allowed, parse methods forbidden
+                    if (COMPONENT_ALLOWED_METHODS.has(method))
+                        return;
+                    if (layers_js_1.STRING_INTERPRETATION_METHODS.has(method)) {
+                        context.report({
+                            node,
+                            messageId: "componentParseMethod",
+                            data: { method },
+                        });
+                    }
+                }
+                else {
+                    // hooks/pages: all string interpretation forbidden
+                    if (layers_js_1.STRING_INTERPRETATION_METHODS.has(method)) {
+                        context.report({
+                            node,
+                            messageId: "encodedMethod",
+                            data: { method, layer },
+                        });
+                    }
+                }
+            },
+        };
+        function isInTypeContext(node) {
+            let current = node.parent;
+            while (current) {
+                if (current.type.startsWith("TS") &&
+                    current.type !== utils_1.AST_NODE_TYPES.TSAsExpression &&
+                    current.type !== utils_1.AST_NODE_TYPES.TSSatisfiesExpression) {
+                    return true;
+                }
+                current = current.parent;
+            }
+            return false;
+        }
+    },
+});
+//# sourceMappingURL=react.js.map

package/lib/rules/react.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/lib/rules/server.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+type Options = Record<string, never>;
+type MessageId = "importViolation" | "encodedGlobal" | "ioGlobal" | "schemaBoundary" | "encodedMethod";
+declare const _default: import("@typescript-eslint/utils/dist/ts-eslint/Rule.js").RuleModule<MessageId, [Options], unknown, import("@typescript-eslint/utils/dist/ts-eslint/Rule.js").RuleListener> & {
+    name: string;
+};
+export default _default;
+//# sourceMappingURL=server.d.ts.map

package/lib/rules/server.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/rules/server.ts"],"names":[],"mappings":"AAaA,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAWrC,KAAK,SAAS,GACV,iBAAiB,GACjB,eAAe,GACf,UAAU,GACV,gBAAgB,GAChB,eAAe,CAAC;;;;AAEpB,wBAkJG"}

package/lib/rules/server.js ADDED Viewed

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@typescript-eslint/utils");
+const create_rule_js_1 = require("../create-rule.js");
+const layers_js_1 = require("../layers.js");
+const defaultOptions = {};
+const SERVER_LAYERS = new Set([
+    "core",
+    "service",
+    "adapter",
+    "infra",
+]);
+const INNER_LAYERS = new Set(["core", "service"]);
+exports.default = (0, create_rule_js_1.createRule)({
+    name: "server",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Enforce layered architecture for server-side layers (core, service, adapter, infra). Checks imports, encoded representation globals, Schema boundary, and string interpretation.",
+        },
+        messages: {
+            importViolation: "'{{fromLayer}}' cannot import from '{{toLayer}}'.",
+            encodedGlobal: "'{{name}}' is an encoded representation API. Not allowed in '{{layer}}'. Use canonical types (Effect.ts) instead.",
+            ioGlobal: "'{{name}}' is an IO boundary API. Not allowed in '{{layer}}'. IO belongs in infra.",
+            schemaBoundary: "Schema.{{method}}() crosses the canonical/encoded boundary. Only allowed in adapter/infra. Current layer: '{{layer}}'.",
+            encodedMethod: "'.{{method}}()' interprets encoded representation. Not allowed in '{{layer}}'. Encoded interpretation belongs in adapter.",
+        },
+        schema: [],
+    },
+    defaultOptions: [defaultOptions],
+    create(context) {
+        const filePath = context.filename;
+        const layer = (0, layers_js_1.getLayerFromPath)(filePath);
+        if (!layer || !SERVER_LAYERS.has(layer))
+            return {};
+        const isInner = INNER_LAYERS.has(layer);
+        function checkImport(importPath, node) {
+            const toLayer = (0, layers_js_1.getLayerFromImport)(importPath);
+            if (!toLayer)
+                return;
+            if (!(0, layers_js_1.canImport)(layer, toLayer)) {
+                context.report({
+                    node,
+                    messageId: "importViolation",
+                    data: { fromLayer: layer, toLayer },
+                });
+            }
+        }
+        return {
+            // --- Import checks (all server layers) ---
+            ImportDeclaration(node) {
+                checkImport(node.source.value, node);
+            },
+            ImportExpression(node) {
+                if (node.source.type === utils_1.AST_NODE_TYPES.Literal &&
+                    typeof node.source.value === "string") {
+                    checkImport(node.source.value, node);
+                }
+            },
+            TSExternalModuleReference(node) {
+                if (node.expression.type === utils_1.AST_NODE_TYPES.Literal &&
+                    typeof node.expression.value === "string") {
+                    checkImport(node.expression.value, node);
+                }
+            },
+            // --- Inner layer restrictions (core/service only) ---
+            ...(isInner
+                ? {
+                    // Restricted globals
+                    Identifier(node) {
+                        // Skip property access right-hand side (obj.JSON is fine)
+                        if (node.parent?.type === utils_1.AST_NODE_TYPES.MemberExpression &&
+                            node.parent.property === node &&
+                            !node.parent.computed) {
+                            return;
+                        }
+                        // Skip type contexts
+                        if (isInTypeContext(node))
+                            return;
+                        if (layers_js_1.ENCODING_GLOBALS.has(node.name)) {
+                            context.report({
+                                node,
+                                messageId: "encodedGlobal",
+                                data: { name: node.name, layer },
+                            });
+                        }
+                        else if (layers_js_1.IO_GLOBALS.has(node.name)) {
+                            context.report({
+                                node,
+                                messageId: "ioGlobal",
+                                data: { name: node.name, layer },
+                            });
+                        }
+                    },
+                    // Schema boundary + string interpretation methods
+                    CallExpression(node) {
+                        if (node.callee.type !== utils_1.AST_NODE_TYPES.MemberExpression ||
+                            node.callee.property.type !== utils_1.AST_NODE_TYPES.Identifier) {
+                            return;
+                        }
+                        const method = node.callee.property.name;
+                        if (layers_js_1.SCHEMA_BOUNDARY_METHODS.has(method)) {
+                            context.report({
+                                node,
+                                messageId: "schemaBoundary",
+                                data: { method, layer },
+                            });
+                            return;
+                        }
+                        // toString is allowed (logging, debugging)
+                        if (method === "toString")
+                            return;
+                        if (layers_js_1.STRING_INTERPRETATION_METHODS.has(method)) {
+                            context.report({
+                                node,
+                                messageId: "encodedMethod",
+                                data: { method, layer },
+                            });
+                        }
+                    },
+                }
+                : {}),
+        };
+        function isInTypeContext(node) {
+            let current = node.parent;
+            while (current) {
+                if (current.type.startsWith("TS") &&
+                    current.type !== utils_1.AST_NODE_TYPES.TSAsExpression &&
+                    current.type !== utils_1.AST_NODE_TYPES.TSSatisfiesExpression) {
+                    return true;
+                }
+                current = current.parent;
+            }
+            return false;
+        }
+    },
+});
+//# sourceMappingURL=server.js.map

package/lib/rules/server.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,6 +1,57 @@
 {
   "name": "@luma-layered-ts/eslint-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "ESLint plugin for luma-layered-ts architecture",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LumaKernel/luma-layered-ts",
+    "directory": "packages/eslint-plugin"
+  },
+  "homepage": "https://github.com/LumaKernel/luma-layered-ts/tree/main/packages/eslint-plugin",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest",
+    "test-cov": "vitest --coverage",
+    "lint": "eslint src && prettier . --list-different",
+    "lint-fix": "eslint src && prettier . --write",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "typescript",
+    "layered-architecture"
+  ],
+  "author": "Luma <world@luma.email>",
+  "license": "MIT",
+  "dependencies": {
+    "@typescript-eslint/rule-tester": "^8.67.0",
+    "@typescript-eslint/utils": "^8.67.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^24.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.67.0",
+    "@typescript-eslint/parser": "^8.67.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^10.0.0",
+    "prettier": "^3.5.3",
+    "semantic-release": "^25.0.9",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.67.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0 || ^10.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/README.md DELETED Viewed

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.