@theholocron/holocron-plugin-fern 5.0.0-alpha.277 → 5.0.0-alpha.279

package/dist/index.d.mts

@@ -1,8 +1,11 @@
 import { AuthError, DnsRecordRequest, PluginToken, ResolveTokenInput, Wiki, WikiProvisionOpts, WikiProxyConfig } from "@theholocron/cli";
+/** Resolves the Fern token from `--token`, `HOLOCRON_FERN_TOKEN`, `FERN_TOKEN` or the keyring entry for `fern`, and throws `AuthError` when none is set. */
 export declare const resolveToken: import("@theholocron/cli").TokenResolver;
 /** Every token this plugin takes, for `holocron doctor tokens`. */
 export declare const tokens: PluginToken[];
+/** The Fern CLI version written into `fern/fern.config.json`. */
 export declare const FERN_VERSION = "5.114.1";
+/** Options for the Fern `wiki` capability. */
 interface FernWikiOptions extends ResolveTokenInput {
   /** Absolute path to the working repo root. Injected by the loader from RuntimeContext. */
   repoRoot?: string;
@@ -47,9 +50,12 @@ interface FernWikiOptions extends ResolveTokenInput {
    */
   icon?: string;
 }
+/** `wiki` capability for Fern: writes the Fern config and docs scaffold for a repo. */
 export declare class FernWiki implements Wiki {
   private readonly opts;
+  /** Capability key; always `"wiki"`. */
   readonly key: "wiki";
+  /** Provider name; always `"fern"`. */
   readonly providerName = "fern";
   constructor(opts: FernWikiOptions);
   provision(callOpts?: WikiProvisionOpts): Promise<string>;
@@ -79,8 +85,11 @@ export declare class FernWiki implements Wiki {
   }>;
   dnsRecord(): DnsRecordRequest | null;
 }
+/** Options for the Fern plugin; the same as the `wiki` capability's. */
 export type FernPluginOptions = FernWikiOptions;
+/** Builds the `wiki` capability from the plugin options. */
 export declare function wiki(opts: FernPluginOptions): Wiki;
+/** Creates the Fern plugin: its `connection` probe and the `wiki` capability. */
 export declare function createPlugin(options?: FernPluginOptions): {
   name: string;
   probes: {

package/dist/index.mjs

@@ -3,6 +3,7 @@ import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { stringifyJson } from "@theholocron/json-utils";
 // src/auth.ts
+/** Resolves the Fern token from `--token`, `HOLOCRON_FERN_TOKEN`, `FERN_TOKEN` or the keyring entry for `fern`, and throws `AuthError` when none is set. */
 const resolveToken = createResolveToken({
 	envName: "HOLOCRON_FERN_TOKEN",
 	vendorEnvName: "FERN_TOKEN",
@@ -12,10 +13,14 @@ const resolveToken = createResolveToken({
 /** Every token this plugin takes, for `holocron doctor tokens`. */
 const tokens = [resolveToken.token];
 // src/capabilities/wiki.ts
+/** The Fern CLI version written into `fern/fern.config.json`. */
 const FERN_VERSION = "5.114.1";
+/** `wiki` capability for Fern: writes the Fern config and docs scaffold for a repo. */
 var FernWiki = class {
 	opts;
+	/** Capability key; always `"wiki"`. */
 	key = "wiki";
+	/** Provider name; always `"fern"`. */
 	providerName = "fern";
 	constructor(opts) {
 		this.opts = opts;
@@ -173,9 +178,11 @@ function updateInstancesBlock(content, instanceUrl, customDomain, multiSource, r
 	return content.replace(blockRe, newBlock);
 }
 // src/index.ts
+/** Builds the `wiki` capability from the plugin options. */
 function wiki(opts) {
 	return new FernWiki(opts);
 }
+/** Creates the Fern plugin: its `connection` probe and the `wiki` capability. */
 function createPlugin(options = {}) {
 	return {
 		name: "@theholocron/holocron-plugin-fern",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-fern",
-  "version": "5.0.0-alpha.277",
+  "version": "5.0.0-alpha.279",
   "description": "Holocron plugin for Fern. Implements the wiki capability for engineering knowledge publishing.",
   "keywords": [
     "fern",
@@ -30,7 +30,7 @@
     "dist"
   ],
   "dependencies": {
-    "@theholocron/json-utils": "^1.16.1-alpha.2"
+    "@theholocron/json-utils": "^1.16.1-alpha.3"
   },
   "devDependencies": {
     "@types/node": "^26",
@@ -43,14 +43,14 @@
     "tsx": "4.23.15",
     "typescript": "^5.9.3",
     "vitest": "^5.0.5",
-    "@theholocron/cli": "5.0.0-alpha.277",
-    "@theholocron/eslint-config": "^8.9.0-alpha.3",
-    "@theholocron/tsdown-config": "^8.9.0-alpha.3",
-    "@theholocron/vitest-config": "^8.9.0-alpha.3",
-    "@theholocron/tsconfig": "^8.9.0-alpha.3"
+    "@theholocron/eslint-config": "^8.9.0-alpha.4",
+    "@theholocron/tsconfig": "^8.9.0-alpha.4",
+    "@theholocron/tsdown-config": "^8.9.0-alpha.4",
+    "@theholocron/vitest-config": "^8.9.0-alpha.4",
+    "@theholocron/cli": "5.0.0-alpha.279"
   },
   "peerDependencies": {
-    "@theholocron/cli": "5.0.0-alpha.277"
+    "@theholocron/cli": "5.0.0-alpha.279"
   },
   "engines": {
     "node": ">=22"