palabra 2.4.3 → 2.4.5

package/ChangeLog

@@ -1,3 +1,13 @@
+2026.04.14, v2.4.5
+
+feature:
+- b5149ab parse: letra -> tinta
+
+2026.04.14, v2.4.4
+
+feature:
+- b6a4437 palabra: parser: prepare
+
 2026.04.14, v2.4.3
 
 feature:

package/README.md

@@ -9,7 +9,9 @@
 [CoverageURL]: https://coveralls.io/github/coderaiser/palabra?branch=master
 [CoverageIMGURL]: https://coveralls.io/repos/coderaiser/palabra/badge.svg?branch=master&service=github
 
-Install software easier then ever before.
+Install packages easier than ever before.
+Palabra install packages named letras, each letra is a set of commands, written in declarative form,
+and compiled during install to bash script.
 
 <img width="546" height="405" alt="image" src="https://github.com/user-attachments/assets/272fb625-a51e-488f-9d58-89268f810efb" />
 
@@ -40,12 +42,12 @@ Then run:
 palabra
 ```
 
-### `i`
+### `(i)nstall`
 
 You can also use interactive mode:
 
 ```
-palabra i bun node deno rust go nvim fasm -d /usr/local/src
+palabra install bun node deno rust go nvim fasm -d /usr/local/src
 ```
 
 You can also pass version:
@@ -56,7 +58,7 @@ palabra i nvim@0.11
 
 Default installation directory is `~/.local/src`.
 
-### `l`
+### `list`
 
 To list all packages that can be installed use `l`:
 
@@ -76,6 +78,35 @@ Use `PALABRA_DIR` or [`XDG_DATA_HOME`](https://specifications.freedesktop.org/ba
 
 That's it!
 
+## Types of letras
+
+There is a different types of letras. Each author release in one of next ways.
+
+### Single binary
+
+Provided url to executable, that should be downloaded and set `chmod +x`, and
+then copy to directory `$PALABRA_DIR` and make symlinks.
+
+### Single Binary archive
+
+Provided url to archive with single executable, that should be downloaded, and
+then copy to directory `$PALABRA_DIR` and made symlinks.
+
+### Nested archive
+
+Provided url to archive with nested directory structure, that should be downloaded,
+extracted and then copied to directory `$PALABRA_DIR` and made symlinks.
+
+### Root archive
+
+Provided url to archive with all files located on top level, that should be downloaded,
+extracted and then copied to directory `$PALABRA_DIR` and made symlinks.
+
+### Script
+
+Provided url to script that should be downloaded and executed 
+
+
 ## License
 
 MIT

package/letras/oxker/oxker.json

@@ -2,6 +2,6 @@
     "name": "oxker",
     "version": "0.13.1",
     "url": "https://github.com/mrjackwills/oxker/releases/download/v{{ version }}/oxker_linux_x86_64.tar.gz",
-    "bin": "",
-    "test": "oxker --version"
+    "test": "oxker --version",
+    "type": "root-archive"
 }

package/lib/parser/parser.js

@@ -6,6 +6,7 @@ import {execute, isExecute} from './execute.js';
 import {parseEnv} from './parse-env.js';
 import {run} from './run.js';
 import {download} from './download.js';
+import {prepare} from './prepare.js';
 
 const {isArray} = Array;
 const maybeArray = (a) => isArray(a) ? a : [a];
@@ -16,17 +17,10 @@ const {entries} = Object;
 
 const isString = (a) => typeof a === 'string';
 
-const addDefaults = (letra) => ({
-    confirmar: true,
-    directorio: '~/.local/share',
-    ...letra,
-});
-
 export const parse = (letra) => {
-    letra = addDefaults(letra);
-    const envLine = parseEnv(letra);
-    
+    const tinta = prepare(letra);
     const commands = [];
+    
     const {
         url,
         beforeInstall,
@@ -34,61 +28,55 @@ export const parse = (letra) => {
         test,
         name,
         bin = `/bin/${name}`,
-        hogar = name,
         directorio,
-        executable,
-    } = letra;
+    } = tinta;
+    
+    const envLine = parseEnv(tinta);
     
     if (beforeInstall)
         commands.push(...run({
-            letra,
+            letra: tinta,
             commands: beforeInstall,
             envLine,
         }));
     
-    if (letra.preparado)
-        commands.push(...download(letra));
-    else if (isArchive(letra))
-        commands.push(...extract(letra));
-    else if (isExecute(letra))
-        commands.push(...execute(letra));
+    if (tinta.preparado)
+        commands.push(...download(tinta));
+    else if (isArchive(tinta))
+        commands.push(...extract(tinta));
+    else if (isExecute(tinta))
+        commands.push(...execute(tinta));
     
-    if (isBool(letra.execute) && !letra.execute) {
-        const renderedURL = rendy(url, letra);
+    if (isBool(tinta.execute) && !tinta.execute) {
+        const renderedURL = rendy(url, tinta);
         commands.push(`curl -fsSL ${renderedURL}`);
     }
     
-    commands.push(...createSymlinks({
-        directorio,
-        hogar,
-        name,
-        bin,
-        executable,
-    }));
+    commands.push(...createSymlinks(tinta));
     
-    if (letra.rename)
-        commands.push(...rename(letra));
+    if (tinta.rename)
+        commands.push(...rename(tinta));
     
-    if (letra.commands)
+    if (tinta.commands)
         commands.push(...run({
-            letra,
-            commands: letra.commands,
+            letra: tinta,
+            commands: tinta.commands,
             envLine,
         }));
     
     if (afterInstall)
         commands.push(...run({
-            letra,
+            letra: tinta,
             commands: afterInstall,
             envLine,
         }));
     
-    if (letra.executable && isString(bin))
-        commands.push(`chmod +x ${rendy(join(directorio, name, bin), letra)}`);
+    if (tinta.executable && isString(bin))
+        commands.push(`chmod +x ${rendy(join(directorio, name, bin), tinta)}`);
     
     if (test)
         for (const testCommand of maybeArray(test)) {
-            const cmd = rendy(testCommand, letra);
+            const cmd = rendy(testCommand, tinta);
             
             if (envLine) {
                 commands.push(`${envLine}${cmd}`);

package/lib/parser/prepare.js

@@ -0,0 +1,27 @@
+const parseBin = ({name, type}) => {
+    if (type === 'root-archive')
+        return '';
+    
+    return `/bin/${name}`;
+};
+
+export const prepare = (letra) => {
+    const {
+        confirmar = true,
+        directorio = '~/.local/share',
+        url,
+        name,
+        bin = parseBin(letra),
+        hogar = name,
+    } = letra;
+    
+    return {
+        confirmar,
+        directorio,
+        url,
+        name,
+        bin,
+        hogar,
+        ...letra,
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palabra",
-  "version": "2.4.3",
+  "version": "2.4.5",
   "type": "module",
   "author": "coderaiser <mnemonic.enemy@gmail.com> (https://github.com/coderaiser)",
   "description": "Palabra software installer",