@lippelt/srd-core 0.1.0

package/dist/index.cjs

@@ -0,0 +1,55 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  clearRegistry: () => clearRegistry,
+  getSystem: () => getSystem,
+  listRegisteredSystems: () => listRegisteredSystems,
+  register: () => register
+});
+module.exports = __toCommonJS(index_exports);
+var registry = /* @__PURE__ */ new Map();
+function register(system) {
+  const existing = registry.get(system.id);
+  if (existing && existing !== system) {
+    throw new Error(
+      `[gmcr-srd-core] sistema "${system.id}" j\xE1 registrado por outra inst\xE2ncia`
+    );
+  }
+  registry.set(system.id, system);
+}
+function getSystem(id) {
+  return registry.get(id) ?? null;
+}
+function listRegisteredSystems() {
+  return [...registry.keys()];
+}
+function clearRegistry() {
+  registry.clear();
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearRegistry,
+  getSystem,
+  listRegisteredSystems,
+  register
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @lippelt/srd-core — contrato + registry para sistemas RPG plugáveis.\n *\n * Padrão de uso (lado do consumidor):\n *\n *   import { register, getSystem } from '@lippelt/srd-core'\n *   import { dnd5e2014 } from '@lippelt/srd-dnd5e-2014'\n *\n *   register(dnd5e2014)\n *   const sys = getSystem('dnd5e-2014')  // System | null\n */\n\nexport type {\n  System,\n  SystemId,\n  SystemRules,\n  DicePreset,\n  ConditionDef,\n  TrackerField,\n  RollResult,\n} from './types.js'\n\nimport type { System, SystemId } from './types.js'\n\nconst registry = new Map<SystemId, System>()\n\n/**\n * Registra um sistema. Idempotente: registrar o mesmo `system` (mesma\n * referência) duas vezes é no-op. Registrar uma instância DIFERENTE com\n * id já existente lança erro — proteção contra conflitos.\n */\nexport function register(system: System): void {\n  const existing = registry.get(system.id)\n  if (existing && existing !== system) {\n    throw new Error(\n      `[gmcr-srd-core] sistema \"${system.id}\" já registrado por outra instância`,\n    )\n  }\n  registry.set(system.id, system)\n}\n\n/** Resolve um sistema pelo id, ou null se não registrado. */\nexport function getSystem(id: SystemId): System | null {\n  return registry.get(id) ?? null\n}\n\n/** Lista os ids de sistemas atualmente registrados. */\nexport function listRegisteredSystems(): SystemId[] {\n  return [...registry.keys()]\n}\n\n/** Remove todos os registros. Útil em testes; raro em produção. */\nexport function clearRegistry(): void {\n  registry.clear()\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBA,IAAM,WAAW,oBAAI,IAAsB;AAOpC,SAAS,SAAS,QAAsB;AAC7C,QAAM,WAAW,SAAS,IAAI,OAAO,EAAE;AACvC,MAAI,YAAY,aAAa,QAAQ;AACnC,UAAM,IAAI;AAAA,MACR,4BAA4B,OAAO,EAAE;AAAA,IACvC;AAAA,EACF;AACA,WAAS,IAAI,OAAO,IAAI,MAAM;AAChC;AAGO,SAAS,UAAU,IAA6B;AACrD,SAAO,SAAS,IAAI,EAAE,KAAK;AAC7B;AAGO,SAAS,wBAAoC;AAClD,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;AAGO,SAAS,gBAAsB;AACpC,WAAS,MAAM;AACjB;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,128 @@
+/**
+ * Contrato comum para sistemas RPG plugáveis.
+ *
+ * Cada implementação (pacote separado) exporta um `System` e o consumidor
+ * registra com `register()` deste pacote. O consumidor escolhe quais
+ * sistemas instalar — `@lippelt/srd-core` por si só não traz nenhum.
+ */
+/**
+ * ID estável de um sistema. Convenção: `<sistema>-<edição>` em kebab-case
+ * (ex: `dnd5e-2014`, `lancer`, `vampire-v5`). Cada implementação define
+ * o seu; conflitos entre pacotes registrados são erro.
+ */
+type SystemId = string;
+/**
+ * Preset de rolagem rápida — botões que aparecem no painel de dados,
+ * adaptados ao sistema.
+ */
+interface DicePreset {
+    /** Identificador único dentro do sistema. */
+    id: string;
+    /** Texto exibido no botão (curto: "d20+mod", "Pool", "Hunger"). */
+    label: string;
+    /** Notação a rolar (formato GM Control Room: NdM+K, ou string especial). */
+    notation: string;
+    /** Categoria — ajuda a agrupar visualmente (ex: 'attack', 'save', 'damage'). */
+    category?: string;
+    /** Descrição expandida pra tooltip. */
+    description?: string;
+}
+interface ConditionDef {
+    /** ID estável (snake-case, ex: 'frightened'). */
+    id: string;
+    /** Nome de exibição (ex: 'Frightened', 'Amedrontado'). */
+    label: string;
+    /** Resumo do efeito mecânico (uma linha). */
+    summary?: string;
+}
+/**
+ * Definição de um campo numérico extra no tracker do sistema
+ * (além dos genéricos initiative/hp).
+ */
+interface TrackerField {
+    /** Chave estável usada na ficha (ex: 'ac', 'hunger'). */
+    key: string;
+    /** Rótulo curto (4–8 chars) — vai num pill compacto no tracker. */
+    label: string;
+    /** Tipo do valor — define UI (stepper, pair max/current, toggle). */
+    kind: 'integer' | 'maxCurrent' | 'boolean';
+    /** Faixa válida (inclusiva). */
+    min?: number;
+    max?: number;
+    /** Valor inicial pra novos combatentes. */
+    default?: number;
+    /** Descrição/tooltip. */
+    description?: string;
+}
+interface RollResult {
+    /** Rolagens individuais (todos os dados antes de filtragem). */
+    rolls: number[];
+    /** Modificador somado ao total. */
+    modifier: number;
+    /** Total final. */
+    total: number;
+    /** Notação humana do que foi rolado. */
+    notation: string;
+    /** Anotações estruturadas (ex: 'crit', 'fumble', 'advantage'). */
+    notes?: string[];
+}
+interface SystemRules {
+    /**
+     * Rola uma checagem do sistema. `kind` é definido por cada sistema
+     * (ex: 'attack', 'save', 'check', 'damage'). Retorna null se a mecânica
+     * não existe no sistema.
+     */
+    roll?: (kind: string, params: Record<string, unknown>) => RollResult | null;
+    /**
+     * Reduz dano conforme regras do sistema (resistência, vulnerabilidade,
+     * imunidade, armadura, etc).
+     */
+    applyDamage?: (incoming: number, target: Record<string, unknown>) => {
+        final: number;
+        notes?: string[];
+    };
+}
+interface System {
+    id: SystemId;
+    /** Nome humano (ex: "Dungeons & Dragons 5e (2014)"). */
+    name: string;
+    /** Versão da regra/SRD (ex: "SRD 5.1"). */
+    ruleVersion: string;
+    /** Atribuição obrigatória (se vier de SRD CC-BY etc). Vazio = MIT puro. */
+    attribution?: string;
+    /** Botões rápidos de rolagem que aparecem na UI. */
+    dicePresets: DicePreset[];
+    /** Condições/status pra autocomplete no tracker. */
+    conditions: ConditionDef[];
+    /** Campos extras do tracker (além de initiative/hp genéricos). */
+    trackerFields: TrackerField[];
+    /** Regras automatizáveis (opcionais). */
+    rules?: SystemRules;
+}
+
+/**
+ * @lippelt/srd-core — contrato + registry para sistemas RPG plugáveis.
+ *
+ * Padrão de uso (lado do consumidor):
+ *
+ *   import { register, getSystem } from '@lippelt/srd-core'
+ *   import { dnd5e2014 } from '@lippelt/srd-dnd5e-2014'
+ *
+ *   register(dnd5e2014)
+ *   const sys = getSystem('dnd5e-2014')  // System | null
+ */
+
+/**
+ * Registra um sistema. Idempotente: registrar o mesmo `system` (mesma
+ * referência) duas vezes é no-op. Registrar uma instância DIFERENTE com
+ * id já existente lança erro — proteção contra conflitos.
+ */
+declare function register(system: System): void;
+/** Resolve um sistema pelo id, ou null se não registrado. */
+declare function getSystem(id: SystemId): System | null;
+/** Lista os ids de sistemas atualmente registrados. */
+declare function listRegisteredSystems(): SystemId[];
+/** Remove todos os registros. Útil em testes; raro em produção. */
+declare function clearRegistry(): void;
+
+export { type ConditionDef, type DicePreset, type RollResult, type System, type SystemId, type SystemRules, type TrackerField, clearRegistry, getSystem, listRegisteredSystems, register };

package/dist/index.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Contrato comum para sistemas RPG plugáveis.
+ *
+ * Cada implementação (pacote separado) exporta um `System` e o consumidor
+ * registra com `register()` deste pacote. O consumidor escolhe quais
+ * sistemas instalar — `@lippelt/srd-core` por si só não traz nenhum.
+ */
+/**
+ * ID estável de um sistema. Convenção: `<sistema>-<edição>` em kebab-case
+ * (ex: `dnd5e-2014`, `lancer`, `vampire-v5`). Cada implementação define
+ * o seu; conflitos entre pacotes registrados são erro.
+ */
+type SystemId = string;
+/**
+ * Preset de rolagem rápida — botões que aparecem no painel de dados,
+ * adaptados ao sistema.
+ */
+interface DicePreset {
+    /** Identificador único dentro do sistema. */
+    id: string;
+    /** Texto exibido no botão (curto: "d20+mod", "Pool", "Hunger"). */
+    label: string;
+    /** Notação a rolar (formato GM Control Room: NdM+K, ou string especial). */
+    notation: string;
+    /** Categoria — ajuda a agrupar visualmente (ex: 'attack', 'save', 'damage'). */
+    category?: string;
+    /** Descrição expandida pra tooltip. */
+    description?: string;
+}
+interface ConditionDef {
+    /** ID estável (snake-case, ex: 'frightened'). */
+    id: string;
+    /** Nome de exibição (ex: 'Frightened', 'Amedrontado'). */
+    label: string;
+    /** Resumo do efeito mecânico (uma linha). */
+    summary?: string;
+}
+/**
+ * Definição de um campo numérico extra no tracker do sistema
+ * (além dos genéricos initiative/hp).
+ */
+interface TrackerField {
+    /** Chave estável usada na ficha (ex: 'ac', 'hunger'). */
+    key: string;
+    /** Rótulo curto (4–8 chars) — vai num pill compacto no tracker. */
+    label: string;
+    /** Tipo do valor — define UI (stepper, pair max/current, toggle). */
+    kind: 'integer' | 'maxCurrent' | 'boolean';
+    /** Faixa válida (inclusiva). */
+    min?: number;
+    max?: number;
+    /** Valor inicial pra novos combatentes. */
+    default?: number;
+    /** Descrição/tooltip. */
+    description?: string;
+}
+interface RollResult {
+    /** Rolagens individuais (todos os dados antes de filtragem). */
+    rolls: number[];
+    /** Modificador somado ao total. */
+    modifier: number;
+    /** Total final. */
+    total: number;
+    /** Notação humana do que foi rolado. */
+    notation: string;
+    /** Anotações estruturadas (ex: 'crit', 'fumble', 'advantage'). */
+    notes?: string[];
+}
+interface SystemRules {
+    /**
+     * Rola uma checagem do sistema. `kind` é definido por cada sistema
+     * (ex: 'attack', 'save', 'check', 'damage'). Retorna null se a mecânica
+     * não existe no sistema.
+     */
+    roll?: (kind: string, params: Record<string, unknown>) => RollResult | null;
+    /**
+     * Reduz dano conforme regras do sistema (resistência, vulnerabilidade,
+     * imunidade, armadura, etc).
+     */
+    applyDamage?: (incoming: number, target: Record<string, unknown>) => {
+        final: number;
+        notes?: string[];
+    };
+}
+interface System {
+    id: SystemId;
+    /** Nome humano (ex: "Dungeons & Dragons 5e (2014)"). */
+    name: string;
+    /** Versão da regra/SRD (ex: "SRD 5.1"). */
+    ruleVersion: string;
+    /** Atribuição obrigatória (se vier de SRD CC-BY etc). Vazio = MIT puro. */
+    attribution?: string;
+    /** Botões rápidos de rolagem que aparecem na UI. */
+    dicePresets: DicePreset[];
+    /** Condições/status pra autocomplete no tracker. */
+    conditions: ConditionDef[];
+    /** Campos extras do tracker (além de initiative/hp genéricos). */
+    trackerFields: TrackerField[];
+    /** Regras automatizáveis (opcionais). */
+    rules?: SystemRules;
+}
+
+/**
+ * @lippelt/srd-core — contrato + registry para sistemas RPG plugáveis.
+ *
+ * Padrão de uso (lado do consumidor):
+ *
+ *   import { register, getSystem } from '@lippelt/srd-core'
+ *   import { dnd5e2014 } from '@lippelt/srd-dnd5e-2014'
+ *
+ *   register(dnd5e2014)
+ *   const sys = getSystem('dnd5e-2014')  // System | null
+ */
+
+/**
+ * Registra um sistema. Idempotente: registrar o mesmo `system` (mesma
+ * referência) duas vezes é no-op. Registrar uma instância DIFERENTE com
+ * id já existente lança erro — proteção contra conflitos.
+ */
+declare function register(system: System): void;
+/** Resolve um sistema pelo id, ou null se não registrado. */
+declare function getSystem(id: SystemId): System | null;
+/** Lista os ids de sistemas atualmente registrados. */
+declare function listRegisteredSystems(): SystemId[];
+/** Remove todos os registros. Útil em testes; raro em produção. */
+declare function clearRegistry(): void;
+
+export { type ConditionDef, type DicePreset, type RollResult, type System, type SystemId, type SystemRules, type TrackerField, clearRegistry, getSystem, listRegisteredSystems, register };

package/dist/index.js

@@ -0,0 +1,27 @@
+// src/index.ts
+var registry = /* @__PURE__ */ new Map();
+function register(system) {
+  const existing = registry.get(system.id);
+  if (existing && existing !== system) {
+    throw new Error(
+      `[gmcr-srd-core] sistema "${system.id}" j\xE1 registrado por outra inst\xE2ncia`
+    );
+  }
+  registry.set(system.id, system);
+}
+function getSystem(id) {
+  return registry.get(id) ?? null;
+}
+function listRegisteredSystems() {
+  return [...registry.keys()];
+}
+function clearRegistry() {
+  registry.clear();
+}
+export {
+  clearRegistry,
+  getSystem,
+  listRegisteredSystems,
+  register
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @lippelt/srd-core — contrato + registry para sistemas RPG plugáveis.\n *\n * Padrão de uso (lado do consumidor):\n *\n *   import { register, getSystem } from '@lippelt/srd-core'\n *   import { dnd5e2014 } from '@lippelt/srd-dnd5e-2014'\n *\n *   register(dnd5e2014)\n *   const sys = getSystem('dnd5e-2014')  // System | null\n */\n\nexport type {\n  System,\n  SystemId,\n  SystemRules,\n  DicePreset,\n  ConditionDef,\n  TrackerField,\n  RollResult,\n} from './types.js'\n\nimport type { System, SystemId } from './types.js'\n\nconst registry = new Map<SystemId, System>()\n\n/**\n * Registra um sistema. Idempotente: registrar o mesmo `system` (mesma\n * referência) duas vezes é no-op. Registrar uma instância DIFERENTE com\n * id já existente lança erro — proteção contra conflitos.\n */\nexport function register(system: System): void {\n  const existing = registry.get(system.id)\n  if (existing && existing !== system) {\n    throw new Error(\n      `[gmcr-srd-core] sistema \"${system.id}\" já registrado por outra instância`,\n    )\n  }\n  registry.set(system.id, system)\n}\n\n/** Resolve um sistema pelo id, ou null se não registrado. */\nexport function getSystem(id: SystemId): System | null {\n  return registry.get(id) ?? null\n}\n\n/** Lista os ids de sistemas atualmente registrados. */\nexport function listRegisteredSystems(): SystemId[] {\n  return [...registry.keys()]\n}\n\n/** Remove todos os registros. Útil em testes; raro em produção. */\nexport function clearRegistry(): void {\n  registry.clear()\n}\n"],"mappings":";AAwBA,IAAM,WAAW,oBAAI,IAAsB;AAOpC,SAAS,SAAS,QAAsB;AAC7C,QAAM,WAAW,SAAS,IAAI,OAAO,EAAE;AACvC,MAAI,YAAY,aAAa,QAAQ;AACnC,UAAM,IAAI;AAAA,MACR,4BAA4B,OAAO,EAAE;AAAA,IACvC;AAAA,EACF;AACA,WAAS,IAAI,OAAO,IAAI,MAAM;AAChC;AAGO,SAAS,UAAU,IAA6B;AACrD,SAAO,SAAS,IAAI,EAAE,KAAK;AAC7B;AAGO,SAAS,wBAAoC;AAClD,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;AAGO,SAAS,gBAAsB;AACpC,WAAS,MAAM;AACjB;","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@lippelt/srd-core",
+  "version": "0.1.0",
+  "description": "Plugin core for tabletop RPG system modules (types + registry). Each system ships in its own package.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flippelt/gmcr-srd-systems.git",
+    "directory": "packages/core"
+  }
+}