{"id":"roberto-av/roblox-core-kit","name":"roblox-core-kit","scope":"roberto-av","platform":"roblox","description":"UI multiplataforma, navegación por gamepad y debug extensible con Iris","version":"0.1.0","latest":"0.1.0","versions":["0.1.0"],"license":"MIT","licenseRating":"safe","licenseCaveats":[],"licenseVerified":true,"dependencies":{"sirmallard/iris":{"version":"^2.0.0","alias":"Iris"},"sleitnick/signal":{"version":"^2.0.1","alias":"Signal"}},"integrity":"1dbf16a38200e51dd94536b254ddf662214d2db5ef150a488aebb310de146994","likes":0,"downloads":0,"install":"forest install roberto-av/roblox-core-kit","url":"https://forest.dev/p/roblox/roberto-av/roblox-core-kit","files":"https://api.forest.dev/ai/package/roblox/roberto-av/roblox-core-kit/files","readme":"# roblox-core-kit\n\nUI multiplataforma, navegación por gamepad y depuración extensible con Iris para Roblox. Luau `--!strict`, sin lógica de juego ni persistencia.\n\n- **Capas de UI** persistentes entre respawns y respetando las zonas seguras.\n- **Router de vistas** con pila LIFO, trampa de foco para gamepad y retroceso por B / Backspace.\n- **Componentes**: `Button`, `Modal`, `SubModal` (drawer), `ScrollView`, `Toast`, `ConfirmDialog`.\n- **Debug seguro**: consola Iris en el cliente y servidor autoritativo (lista blanca, rate limit, esquema de tipos).\n\n## Instalación (Wally)\n\n```toml\n[dependencies]\nCoreKit = \"roberto-av/roblox-core-kit@^0.1.0\"\n```\n\n```bash\nwally install\nrojo sourcemap default.project.json -o sourcemap.json\nwally-package-types --sourcemap sourcemap.json Packages/\n```\n\nEn `0.x` un cambio incompatible sube MINOR: `^0.1.0` acepta `0.1.x` pero no `0.2.0`.\n\n## Ejemplo mínimo (cliente)\n\n```lua\nlocal ReplicatedStorage = game:GetService(\"ReplicatedStorage\")\nlocal CoreKit = ReplicatedStorage.Packages.CoreKit\n\nlocal UiRouter = require(CoreKit.UiRouter)\nlocal Modal = require(CoreKit.Components.Modal)\n\nUiRouter:Init()\n\nUiRouter:Register(\"Inventario\", function()\n\tlocal modal = Modal.new({ Title = \"Inventario\", ViewId = \"Inventario\" })\n\treturn {\n\t\tKind = \"Screen\",\n\t\tLayer = \"Windows\",\n\t\tContainer = modal.Gui,\n\t}\nend)\n\nUiRouter:Push(\"Inventario\") -- abre\nUiRouter:Pop(\"Inventario\") -- cierra solo si es la cima\n```\n\n## Debug (servidor)\n\nLa lista blanca vive únicamente en un script de `ServerScriptService`:\n\n```lua\nlocal DebugService = require(ReplicatedStorage.Packages.CoreKit.Debug.DebugService)\n\nDebugService.Init({ AllowedUserIds = { 123456 }, ProductionEnabled = false })\nDebugService.RegisterCommand(\"give_coins\", {\n\tArgs = { \"integer\" },\n\tCallback = function(player, args)\n\t\treturn true, args[1]\n\tend,\n})\n```\n\n## Desarrollo\n\n```bash\nrokit install\nwally install\nrojo serve dev.project.json\nstylua --check src example\nselene src example\npython scripts/verify-package.py\n```\n\nDocumentación: [ARCHITECTURE](docs/ARCHITECTURE.md) · [API_REFERENCE](docs/API_REFERENCE.md) · [CHANGELOG](CHANGELOG.md).\n\n## Licencia\n\nMIT.\n","readmeTruncated":false}