@dogsbay/format-astro 0.2.0-beta.2 → 0.2.0-beta.21
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/dist/base-path.d.ts +86 -0
- package/dist/base-path.d.ts.map +1 -1
- package/dist/base-path.js +117 -0
- package/dist/base-path.js.map +1 -1
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -2
- package/dist/index.js.map +1 -1
- package/dist/llms-txt.d.ts +13 -2
- package/dist/llms-txt.d.ts.map +1 -1
- package/dist/llms-txt.js +79 -12
- package/dist/llms-txt.js.map +1 -1
- package/dist/project.d.ts +89 -5
- package/dist/project.d.ts.map +1 -1
- package/dist/project.js +630 -92
- package/dist/project.js.map +1 -1
- package/dist/serialize.d.ts +13 -0
- package/dist/serialize.d.ts.map +1 -1
- package/dist/serialize.js +136 -16
- package/dist/serialize.js.map +1 -1
- package/dist/sitemap.d.ts +49 -0
- package/dist/sitemap.d.ts.map +1 -0
- package/dist/sitemap.js +119 -0
- package/dist/sitemap.js.map +1 -0
- package/dist/taxonomy.d.ts +13 -0
- package/dist/taxonomy.d.ts.map +1 -1
- package/dist/taxonomy.js +53 -18
- package/dist/taxonomy.js.map +1 -1
- package/package.json +4 -4
package/dist/project.d.ts
CHANGED
|
@@ -112,12 +112,45 @@ export interface AstroProjectOptions {
|
|
|
112
112
|
*/
|
|
113
113
|
defaultLocale?: string;
|
|
114
114
|
/**
|
|
115
|
-
* When set, emit
|
|
116
|
-
*
|
|
117
|
-
*
|
|
118
|
-
*
|
|
115
|
+
* When set, emit deploy artifacts for the named platform.
|
|
116
|
+
*
|
|
117
|
+
* - `"cloudflare-workers"` — `wrangler.jsonc` + `wrangler` devDep +
|
|
118
|
+
* `deploy` script.
|
|
119
|
+
* - `"github-pages"` — `.github/workflows/deploy.yml` (Astro →
|
|
120
|
+
* `actions/deploy-pages` workflow) + `public/.nojekyll`.
|
|
121
|
+
*
|
|
122
|
+
* Both targets scaffold their files write-if-missing — re-running
|
|
123
|
+
* the build never clobbers an author-edited workflow YAML or
|
|
124
|
+
* wrangler config.
|
|
125
|
+
*/
|
|
126
|
+
deploy?: "cloudflare-workers" | "github-pages";
|
|
127
|
+
/**
|
|
128
|
+
* Astro `build.inlineStylesheets` policy.
|
|
129
|
+
*
|
|
130
|
+
* - `"auto"` (default): inline only stylesheets below 4 KB,
|
|
131
|
+
* externalize the rest. Best for multi-page sites.
|
|
132
|
+
* - `"always"`: inline every stylesheet. Best for single-page
|
|
133
|
+
* sites where first-paint latency dominates.
|
|
134
|
+
* - `"never"`: always externalize. Maximizes cache reuse.
|
|
135
|
+
*
|
|
136
|
+
* Mirrors `dogsbay.config.yml`'s `build.inlineStylesheets`. Flows
|
|
137
|
+
* through `astro.config.dogsbay.mjs` so changes propagate without
|
|
138
|
+
* a scaffold rebuild. See docs/perf-tuning.md.
|
|
119
139
|
*/
|
|
120
|
-
|
|
140
|
+
inlineStylesheets?: "auto" | "always" | "never";
|
|
141
|
+
/**
|
|
142
|
+
* Repo root — the directory containing `dogsbay.config.yml`. The
|
|
143
|
+
* Astro project (`outputDir`) is typically a subdirectory like
|
|
144
|
+
* `<projectDir>/astro/`. Deploy artifacts that GitHub Actions
|
|
145
|
+
* needs at the repo root (`.github/workflows/deploy.yml`) are
|
|
146
|
+
* written here, while artifacts that ship inside the Astro build
|
|
147
|
+
* (e.g. `public/.nojekyll`) stay under `outputDir`.
|
|
148
|
+
*
|
|
149
|
+
* When unset, defaults to `outputDir` — covers flat-layout flows
|
|
150
|
+
* (`dogsbay convert --to astro`) where the Astro project IS the
|
|
151
|
+
* repo. site-init and site-build always pass it explicitly.
|
|
152
|
+
*/
|
|
153
|
+
projectDir?: string;
|
|
121
154
|
/**
|
|
122
155
|
* Overwrite all files including maintainer-customizable scaffold
|
|
123
156
|
* files (theme.css, astro.config.mjs, package.json, site.json,
|
|
@@ -214,7 +247,36 @@ export declare function emitSiteScaffold(outputDir: string, siteName: string, op
|
|
|
214
247
|
export declare function emitAstroPages(pages: ExportPage[], nav: NavItem[], outputDir: string, options: AstroProjectOptions): Promise<{
|
|
215
248
|
generated: number;
|
|
216
249
|
outputNav: NavItem[];
|
|
250
|
+
/**
|
|
251
|
+
* Output paths (relative to outputDir, OS-native separators) of the
|
|
252
|
+
* `.astro` files just written. Used by passthrough emit to detect
|
|
253
|
+
* collisions with hand-authored `.astro` files declared in nav.yml
|
|
254
|
+
* — see plans/passthrough-astro-pages.md.
|
|
255
|
+
*/
|
|
256
|
+
generatedPaths: Set<string>;
|
|
217
257
|
}>;
|
|
258
|
+
/** Passthrough source → destination pair, computed by the CLI's collector. */
|
|
259
|
+
export interface PassthroughCopy {
|
|
260
|
+
/** Absolute path to the source file (under contentDir). */
|
|
261
|
+
sourceAbs: string;
|
|
262
|
+
/**
|
|
263
|
+
* Output path relative to outputDir, OS-native separators. Same
|
|
264
|
+
* shape as `emitAstroPages` `generatedPaths` so the collision
|
|
265
|
+
* check can use a plain `Set.has`.
|
|
266
|
+
*/
|
|
267
|
+
outputRelPath: string;
|
|
268
|
+
/** Source path relative to contentDir, for error messages. */
|
|
269
|
+
source: string;
|
|
270
|
+
}
|
|
271
|
+
/**
|
|
272
|
+
* Copy each passthrough `.astro` source to its computed output path.
|
|
273
|
+
* Aborts with a clear error if the destination is already in
|
|
274
|
+
* `generatedPaths` (a generated page from `emitAstroPages` would
|
|
275
|
+
* silently overwrite the hand-authored file otherwise).
|
|
276
|
+
*/
|
|
277
|
+
export declare function emitPassthroughAstroPages(copies: PassthroughCopy[], outputDir: string, generatedPaths: Set<string>): {
|
|
278
|
+
copied: number;
|
|
279
|
+
};
|
|
218
280
|
/**
|
|
219
281
|
* Emit `public/robots.txt` with `Content-Signal` directives + sitemap
|
|
220
282
|
* link. Always overwrites — the file's contents are pure derivation
|
|
@@ -222,6 +284,28 @@ export declare function emitAstroPages(pages: ExportPage[], nav: NavItem[], outp
|
|
|
222
284
|
* them at the CDN level.
|
|
223
285
|
*/
|
|
224
286
|
export declare function emitConfigDerivedFiles(outputDir: string, options: AstroProjectOptions): void;
|
|
287
|
+
/**
|
|
288
|
+
* Per-deploy-target artifact emission.
|
|
289
|
+
*
|
|
290
|
+
* Called from `emitSiteScaffold` (with `forceOverwrite=writeScaffold`
|
|
291
|
+
* so `--force` regenerates from template) and from `dogsbay site
|
|
292
|
+
* build` (with `forceOverwrite=false` so an existing site can adopt
|
|
293
|
+
* a deploy target by editing config and rebuilding — the missing
|
|
294
|
+
* artifact gets created on the next build).
|
|
295
|
+
*
|
|
296
|
+
* Emit policy is the union: write when forced OR when the file is
|
|
297
|
+
* missing. Author edits to e.g. the workflow YAML survive every
|
|
298
|
+
* regular build.
|
|
299
|
+
*
|
|
300
|
+
* Currently handles `github-pages` (workflow + .nojekyll). The
|
|
301
|
+
* existing `cloudflare-workers` artifacts (wrangler.jsonc + package
|
|
302
|
+
* scripts) stay in the scaffold-only path because they overlap with
|
|
303
|
+
* scaffold-only files (package.json scripts, devDependencies). A
|
|
304
|
+
* future refactor could fold them in here too.
|
|
305
|
+
*/
|
|
306
|
+
export declare function emitDeployArtifacts(outputDir: string, options: AstroProjectOptions, opts?: {
|
|
307
|
+
forceOverwrite: boolean;
|
|
308
|
+
}): void;
|
|
225
309
|
/**
|
|
226
310
|
* Shape of the emitted `src/data/switcherMap.json` file.
|
|
227
311
|
* Switcher components import this JSON directly, so the shape
|
package/dist/project.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}
|