Fix Windows CI, update README, bump to 0.1.3

- Escape backslashes in test TOML paths for Windows compatibility
  (\U in Windows temp paths was parsed as TOML unicode escape)
- Document both @Preview and @Local workflows with equal footing
- Add env var and CLI flag usage examples for typst compile
- Add directory layout diagram showing cache structure
- Add repository URL to Cargo.toml

Author: gordonwoodhull

Cargo.lock

@@ -1,7 +1,8 @@
 [package]
 name = "typst-gather"
-version = "0.1.2"
+version = "0.1.3"
 edition = "2021"
+repository = "https://github.com/quarto-dev/typst-gather"
 rust-version = "1.81"
 
 [dependencies]

Cargo.toml

@@ -14,7 +14,22 @@ cargo install --path .
 typst-gather packages.toml
 ```
 
-Then set `TYPST_PACKAGE_CACHE_PATH` to the destination directory when running Typst.
+Then point both `TYPST_PACKAGE_CACHE_PATH` and `TYPST_PACKAGE_PATH` at the
+destination directory so Typst can resolve both `@preview` and `@local` packages:
+
+```bash
+export TYPST_PACKAGE_CACHE_PATH=/path/to/packages
+export TYPST_PACKAGE_PATH=/path/to/packages
+typst compile document.typ
+```
+
+Or equivalently, using CLI flags:
+
+```bash
+typst compile document.typ \
+  --package-cache-path /path/to/packages \
+  --package-path /path/to/packages
+```
 
 ## TOML format
 
@@ -35,21 +50,32 @@ fontawesome = "0.5.0"
 my-template = "/path/to/src"
 ```
 
-- `destination` - Required. Directory where packages will be gathered.
-- `discover` - Optional. Paths to scan for imports. Can be:
+- `destination` — Required. Directory where packages will be gathered.
+- `discover` — Optional. Paths to scan for `#import` statements. Can be:
   - A single string path
   - An array of paths
   - Each path can be a `.typ` file or a directory (scans `.typ` files non-recursively)
-- `[preview]` packages are downloaded from Typst Universe (cached - skipped if already present)
-- `[local]` packages are copied from the specified directory (always fresh - version read from `typst.toml`)
+- `[preview]` — Packages downloaded from Typst Universe. Skipped if already cached.
+- `[local]` — Packages copied from a local directory. The source must contain a
+  `typst.toml` manifest with `name` and `version` fields. Always copies fresh
+  (overwrites any existing version).
+
+## How it works
+
+Both `@preview` and `@local` packages are written to the `destination` directory
+using Typst's standard cache layout:
 
-## Features
+```
+destination/
+├── preview/
+│   ├── cetz/0.4.1/
+│   └── fontawesome/0.5.0/
+└── local/
+    └── my-template/1.0.0/
+```
 
-- Recursively resolves `@preview` dependencies from `#import` statements
-- Uses Typst's own parser for reliable import detection
-- Discover mode scans .typ files for imports
-- Local packages always overwrite (clean slate)
-- Preview packages skip if already cached
+Recursively resolves `@preview` dependencies from `#import` statements using
+Typst's own parser for reliable import detection.
 
 ## Quarto Integration
 

README.md

@@ -324,8 +324,8 @@ destination = "{}"
 [local]
 my-pkg = "{}"
 "#,
-            cache_dir.path().display(),
-            src_dir.path().display()
+            cache_dir.path().display().to_string().replace('\\', "/"),
+            src_dir.path().display().to_string().replace('\\', "/")
         );
 
         let config = Config::parse(&toml).unwrap();
@@ -342,7 +342,7 @@ my-pkg = "{}"
     fn empty_config_does_nothing() {
         let cache_dir = TempDir::new().unwrap();
 
-        let toml = format!(r#"destination = "{}""#, cache_dir.path().display());
+        let toml = format!(r#"destination = "{}""#, cache_dir.path().display().to_string().replace('\\', "/"));
         let config = Config::parse(&toml).unwrap();
         let dest = config.destination.clone().unwrap();
         let configured_local: HashSet<String> = config.local.keys().cloned().collect();