dmencu 3.5.1 → 3.5.2
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.
- package/CLAUDE.md +19 -2
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -36,11 +36,12 @@ Las tablas están definidas siguiendo la convención de `backend-plus`: cada tab
|
|
|
36
36
|
## Convenciones de código
|
|
37
37
|
|
|
38
38
|
- **Todos los tipos deben ser explícitos**. Prohibido usar `any`, casts vía `unknown`, o cualquier magia sin justificación.
|
|
39
|
+
- Si un callback recibe un parámetro sin tipo, tiparlo (por ejemplo `(item:MenuInfoBase) => ...`), no dejarlo implícito.
|
|
39
40
|
- Si existe código de bajo nivel inevitablemente sin tipado estricto, debe estar estrictamente encapsulado en ubicaciones muy delimitadas y tratado como excepción, no como norma.
|
|
40
41
|
- **Preservar el estilo existente** al modificar archivos: incluyendo el uso de `var` donde ya se usa.
|
|
41
42
|
- **No tocar el formato de lo que ya existe**: el diff de un cambio debe mostrar sólo las líneas que cambian de verdad.
|
|
42
43
|
- No reindentar, no reformatear, no quitar ni agregar espacios al final de las líneas, y no agregar ni quitar el salto de línea final del archivo.
|
|
43
|
-
- Respetar el fin de línea de cada archivo: hay archivos con CRLF y otros con LF. Las líneas nuevas van con el mismo fin de línea que el resto del archivo.
|
|
44
|
+
- Respetar el fin de línea de cada archivo: hay archivos con CRLF y otros con LF. Las líneas nuevas van con el mismo fin de línea que el resto del archivo. Revisar con `git ls-files --eol <archivo>`.
|
|
44
45
|
- En Windows no editar con `sed -i` ni herramientas que reescriban el archivo completo, porque pueden convertir CRLF a LF.
|
|
45
46
|
- Antes de commitear, revisar `git diff --stat` contra `git diff --ignore-all-space --ignore-cr-at-eol --stat`. Si dan distinto, hay cambios de formato que hay que revertir.
|
|
46
47
|
- Los nombres de tablas, columnas y variables de dominio van **en castellano**, consistente con el esquema de base de datos.
|
|
@@ -48,6 +49,13 @@ Las tablas están definidas siguiendo la convención de `backend-plus`: cada tab
|
|
|
48
49
|
|
|
49
50
|
---
|
|
50
51
|
|
|
52
|
+
## Compilación
|
|
53
|
+
|
|
54
|
+
- **Compilación sin fallbacks**: el build no tolera errores. No agregar `|| echo "continue w/error"` a los scripts de `package.json`. Un error de compilación se corrige en el código.
|
|
55
|
+
- Si `mixin-patch` se cuelga sin salida, casi seguro hay un `.d.ts` viejo en `dist/` que dispara la regex de `mixin-patch` (catastrophic backtracking). Solución: borrar `dist/` y volver a compilar.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
51
59
|
## Contexto de base de datos — esquema `base`
|
|
52
60
|
|
|
53
61
|
Todos los objetos pertenecen al esquema `base`. Los nombres están en castellano.
|
|
@@ -84,4 +92,13 @@ Ejemplos de lógica que vive en la base de datos:
|
|
|
84
92
|
Mantener actualizada la documentación en la medida que se agreguen o modifiquen las funcionalidades.
|
|
85
93
|
|
|
86
94
|
- `docs/` es la documentación para desarrolladores.
|
|
87
|
-
- `ayuda/` es la ayuda en línea para usuarios que se ve en el menú según rol, permisos y modo (ver `docs/ayuda-online.md`). Al agregar o cambiar una opción de menú o una funcionalidad que usan las personas, agregar o actualizar su tema en `ayuda/`.
|
|
95
|
+
- `ayuda/` es la ayuda en línea para usuarios que se ve en el menú según rol, permisos y modo (ver `docs/ayuda-online.md`). Al agregar o cambiar una opción de menú o una funcionalidad que usan las personas, agregar o actualizar su tema en `ayuda/`.
|
|
96
|
+
|
|
97
|
+
---
|
|
98
|
+
|
|
99
|
+
## Publicación
|
|
100
|
+
|
|
101
|
+
- `dmencu` se publica en npm **sólo desde GitHub Actions** (`.github/workflows/publish.yml`). No hacer `npm publish` local.
|
|
102
|
+
- Para publicar: `npm version patch` (o `minor`/`major`), que sube `package.json`, hace el commit y crea el tag `vX.Y.Z`; después `git push --follow-tags`. El push del tag dispara el workflow.
|
|
103
|
+
- Un tag por versión. No crear ni pushear el tag antes de subir la versión en `package.json`.
|
|
104
|
+
- Detalle, requisitos (Trusted publisher) y diagnóstico de errores: `docs/publicacion.md`.
|
package/package.json
CHANGED