dirsql 0.4.106 → 0.4.108

package/docs/howto/query-without-config.md

@@ -65,7 +65,7 @@ why indexes belong to only one of them, are in
   `config` nor `tables` and call `query("SELECT * FROM './'")`
   ([SDK reference](../reference/sdk.md)).
 - Paths outside the root resolve too — `'/var/log/*.log'`, `'../notes'`,
-  `'~/notes/*.md'` — reporting absolute paths
+  `'~/notes/*.md'` — reporting paths as you wrote them
   ([path-tables reference](../reference/path-tables.md#paths-outside-the-index-root)).
 - `.git/` is skipped by default, and a git repo's `.gitignore` hides what it
   lists, so a bare `'./**'` does not drown in machinery

package/docs/reference/columns.md

@@ -31,7 +31,7 @@ lazily-read hidden [`content`](./path-tables.md#columns) column.
 
 | Column | Type | Value |
 |---|---|---|
-| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); absolute for a `/`, `../` or `~/` path-table. |
+| `path` | TEXT | The file's path relative to the scan root (e.g. `posts/hello.md`); as written for a `../` path-table, absolute for a `/` or `~/` one. |
 | `basename` | TEXT | The filename, including extension (`hello.md`). |
 | `dir` | TEXT | The parent directory relative to the root (`posts`); the empty string for files directly under the root. |
 | `ext` | TEXT | The file extension without the leading dot (`md`). Original case is preserved — `Photo.JPG` yields `JPG`; use `LOWER(ext)` for case-insensitive matching. `NULL` when the file has no extension. |

package/docs/reference/glob.md

@@ -19,7 +19,7 @@ divergence is a written decision.
 ## The fixture
 
 Every example below runs against this tree. A name ending in `/` is an empty
-directory, `a -> b` is a symlink, and `.gitignore` holds `*.log`.
+directory, `a -> b` is a symlink, and `.gitignore` holds `*.log` and `dist/`.
 
 <!-- conformance-tree -->
 ```text
@@ -48,6 +48,8 @@ docs/.draft.md
 docs/nested/deep.md
 docs/nested/.cache/x.md
 node_modules/pkg/index.js
+dist/bundle.js
+dist/sub/o.js
 real/r.md
 uni/1.md
 uni/a.md
@@ -126,13 +128,22 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `./*.log` | none | gitignore |
 | `./ignored.log` | `ignored.log` |  |
 | `./{ignored,x}.log` | `ignored.log` |  |
+| `./dist/*.js` | none | gitignore |
+| `./dist/**/*.js` | none | gitignore |
+| `./dist/sub/*.js` | none | gitignore |
+| `./d*/*.js` | none | gitignore |
+| `./dist/bundle.js` | `dist/bundle.js` |  |
+| `./dist/sub/o.js` | `dist/sub/o.js` |  |
 | `./**/*.js` | `node_modules/pkg/index.js` |  |
 | `./node_modules/*/index.js` | `node_modules/pkg/index.js` |  |
 | `./docs/**/*.md` | `docs/api.md`, `docs/guide.md`, `docs/nested/deep.md` |  |
 | `./docs/*.md` | `docs/api.md`, `docs/guide.md` |  |
-| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` | absolute |
-| `../proj/docs/*.md` | `$BASE/proj/docs/api.md`, `$BASE/proj/docs/guide.md` | absolute |
+| `$ROOT/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `~/docs/*.md` | `$ROOT/docs/api.md`, `$ROOT/docs/guide.md` |  |
+| `../proj/docs/*.md` | `../proj/docs/api.md`, `../proj/docs/guide.md` |  |
+| `../*/top.md` | `../proj/top.md` |  |
+| `../proj/**/deep.md` | `../proj/docs/nested/deep.md` |  |
+| `../proj/docs` | `../proj/docs/api.md`, `../proj/docs/guide.md` | directory-name |
 
 ## Divergences from bash
 
@@ -141,10 +152,17 @@ A test runs every row against dirsql as a path-table and, with the leading
 | `gitignore` | Inside a git repo, `.gitignore` files hide files and directories a wildcard matches, never one the pattern spells out. `--no-ignore` turns it off. | A query over a repo should not drown in build output. |
 | `directory-name` | A pattern's last component that names a directory lists the files directly inside it, like `ls docs`. A trailing `/` is `*` appended. | A table is rows of files, and `ls` is the shell habit. |
 | `files-only` | A pattern that matches a directory but no file returns nothing. | Every row is a file. |
-| `absolute` | `/`, `~/` and `../` patterns report absolute `path` values, with `..` folded out textually. | The scanned root is derived from the pattern, so there is no relative base. |
 
 `.git` needs no rule of its own: the dotfile rule hides it.
 
+## Syntax, not behavior
+
+A path-table starts with `./`, `/`, `~/` or `../`. That is how `FROM` tells a
+path from a table name, so `FROM './**/*.md'` is a glob and `FROM docs` is a
+table. A config `glob` has no such need and is written without the `./`.
+Bash accepts a bare `**/*.md`; dirsql does not in a path-table. This is syntax,
+not a divergence: past the prefix, the glob behaves as bash does.
+
 ## Where the glob is anchored
 
 A path-table pattern is relative to the index root and starts with `./`. A config `[[table]] glob`

package/docs/reference/path-tables.md

@@ -109,19 +109,15 @@ Three other prefixes resolve, with their usual shell meanings:
 | You write | dirsql scans |
 | --- | --- |
 | `'/var/log/*.log'` | an absolute path |
-| `'../notes'` | relative to the index root's parent |
+| `'../notes'` | relative to the index root's parent, as written |
 | `'~/notes/*.md'` | relative to your home directory |
 
 A directory named this way is one level too; `'../notes/**'` descends. The
 trailing-`/` rule holds here as well: `'~/*/'` is `'~/*/*'`.
-`..` is folded out textually, not followed through symlinks, so the directory
-scanned is a function of the string you wrote.
-
-**These report absolute `path` values.** A `./` path-table reports paths
-relative to the index root, matching every other dirsql table; a `/`, `../` or
-`~/` path-table has no meaningful relative base — the root it scans is derived
-from the pattern, not named by you — so it reports the full path instead. The
-value you get back is one you can paste into another command:
+**A `../` path-table reports `path` as written**, relative to the directory
+dirsql runs in, as bash prints it: `'../notes/*.md'` gives `../notes/a.md`. A
+`/` or `~/` path-table is absolute already, so it reports the full path. Either
+value is one you can paste into another command:
 
 ```sql
 SELECT path FROM '/var/log/*.log';
@@ -144,7 +140,7 @@ table:
 
 | Column | Type | Meaning |
 | --- | --- | --- |
-| `path` | TEXT | path relative to the index root (absolute for `/`, `../`, `~/` tables) |
+| `path` | TEXT | path relative to the index root (as written for `../` tables, absolute for `/` and `~/` tables) |
 | `basename` | TEXT | filename with extension |
 | `dir` | TEXT | parent directory, relative to the index root |
 | `ext` | TEXT | extension without the dot |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirsql",
-  "version": "0.4.106",
+  "version": "0.4.108",
   "description": "Ephemeral SQL index over a local directory",
   "license": "MIT",
   "repository": "https://github.com/thekevinscott/dirsql",
@@ -221,10 +221,10 @@
     ]
   },
   "optionalDependencies": {
-    "@dirsql/lib-linux-x64-gnu": "0.4.106",
-    "@dirsql/lib-linux-arm64-gnu": "0.4.106",
-    "@dirsql/lib-darwin-x64": "0.4.106",
-    "@dirsql/lib-darwin-arm64": "0.4.106",
-    "@dirsql/lib-win32-x64-msvc": "0.4.106"
+    "@dirsql/lib-linux-x64-gnu": "0.4.108",
+    "@dirsql/lib-linux-arm64-gnu": "0.4.108",
+    "@dirsql/lib-darwin-x64": "0.4.108",
+    "@dirsql/lib-darwin-arm64": "0.4.108",
+    "@dirsql/lib-win32-x64-msvc": "0.4.108"
   }
 }