box is an R package that provides a modern, modular module system for organizing R code into hierarchical, composable, and reusable modules. It replaces the traditional `library` and `require` functions with a declarative, explicit import syntax (`box::use`) that supports selective name attachment, aliasing, and scoped imports. The system handles both packages and local R scripts as first-class modules, supports S3 method registration, cyclic imports, interactive help, and module lifecycle hooks (`.on_load`, `.on_unload`). The architecture is built on custom environment manipulation, a PEG-like specification parser, a caching layer for loaded modules, and a small C extension for performance-critical operations. The codebase is well-structured, extensively tested, and demonstrates advanced use of R's environment and S3 dispatch mechanisms.
This repository is an ESLint plugin (`@factory/eslint-plugin`) developed by Factory AI. It provides a suite of custom lint rules and shared configurations designed to enforce strict code organization, testing, and logging conventions. The codebase is fully AI-generated and explicitly unmaintained, intended for inspiration rather than direct import. It demonstrates high craftsmanship in AST manipulation (e.g., `jest-mock-require-actual`, `structured-logging` rules with auto-fix) and complex configuration curation (e.g., `frontend.js` config with extensive `no-restricted-syntax` selectors banning specific React/Next.js patterns). The rules enforce a highly opinionated architecture, including specific file naming conventions (`.page.tsx`, `.module.tsx`), mandatory middleware in route handlers, and structured logging over template literals. While the code quality and test coverage are strong, the plugin is technically drifted (ESLint 8.x API, TypeScript 5.x) and relies on outdated dependencies, limiting its direct applicability without significant modernization.