@bakers-build/addon-essentials 0.0.0-stage → 0.1.0-next.38

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keytec GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @bakers-build/addon-essentials
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+bakers.build aggregator plugin: auto-loads the dropsh essentials (markdown + authoritative JSON:API schema).
+
+Part of the bakers.build CLI. Install the meta package `@bakers-build/bakers` to get the `bakers` CLI with all addons. Source: https://git.key-tec.de/bakers-build/bakers-build (bakers-cli/).

package/dist/src/children.d.ts

@@ -0,0 +1,18 @@
+import type { DropSHPlugin } from 'dropsh/plugin';
+/** Options essentials forwards to the children that take any. */
+export interface EssentialsOptions {
+    /**
+     * BB-495: no longer read. The ambient-workspace filler moved to `bakers ui`,
+     * which attaches `@bakers-build/addon-workspace` itself; the dropsh request path
+     * carries authentication and nothing else, so the caller names the workspace
+     * on the call instead of a config value stamping it in.
+     */
+    workspace_id?: string;
+}
+/**
+ * The config-free essentials: markdown renderer, authoritative JSON:API schema
+ * and BB-403's name resolver, which lives in its own
+ * `@bakers-build/addon-name-refs` package. Exactly three plugins, regardless of
+ * `opts` (BB-495).
+ */
+export declare function essentialChildren(_opts?: EssentialsOptions): DropSHPlugin[];

package/dist/src/children.js

@@ -0,0 +1,19 @@
+// The one place that says which plugins `@bakers-build/addon-essentials` pulls in.
+//
+// It exists because essentials is reachable through TWO config forms that must
+// not drift: the legacy `plugins: [{ plugin: '@bakers-build/addon-essentials' }]`
+// descriptor, which constructs this package's DEFAULT EXPORT, and the
+// Storybook-style `addons: ['@bakers-build/addon-essentials']`, which runs its
+// `./preset`. Both call this function, so a child added here appears on both.
+import { nameRefsPlugin } from '@bakers-build/addon-name-refs';
+import { jsonapiSchemaPlugin } from '@dropsh/plugin-jsonapi-schema';
+import { markdownPlugin } from '@dropsh/plugin-markdown';
+/**
+ * The config-free essentials: markdown renderer, authoritative JSON:API schema
+ * and BB-403's name resolver, which lives in its own
+ * `@bakers-build/addon-name-refs` package. Exactly three plugins, regardless of
+ * `opts` (BB-495).
+ */
+export function essentialChildren(_opts = {}) {
+    return [markdownPlugin(), jsonapiSchemaPlugin(), nameRefsPlugin()];
+}

package/dist/src/index.d.ts

@@ -0,0 +1,25 @@
+import { type EssentialsOptions } from './children.js';
+/**
+ * Aggregator: pull the essentials in through a single `plugins[]` entry.
+ * `composePlugins(...)` returns the flat child list; dropsh (>= 0.5.6) flattens
+ * a plugins[] entry that resolves to an array into separate plugin entries, and
+ * the conductor's own resolver does the same — so each child stays a distinct,
+ * genuine plugin, indistinguishable from listing them one by one. No hand-merged
+ * or presence-guarded composite hooks.
+ *
+ * `authProvider`-carrying plugins (oauth2, with per-profile credentials) are
+ * deliberately NOT here — they stay explicit in the config (AC-4).
+ *
+ * BB-351 made `@bakers-build/addon-workspace` a child too, so an ambient workspace
+ * was filled on every connection without any config naming it. BB-495 removed
+ * it: the dropsh request path carries authentication and nothing else, and the
+ * caller names the workspace on the call. `bakers ui` attaches that plugin to its
+ * own chain instead, because a focused workspace is what makes its lists
+ * readable. No child here reads an option any more.
+ *
+ * Add a new essential = add it in `children.ts` (+ a real dependency in
+ * package.json). Existing configs naming only this aggregator pick it up (AC-5).
+ */
+declare const _default: (opts?: EssentialsOptions) => import("dropsh/plugin").DropSHPlugin[];
+export default _default;
+export { type EssentialsOptions, essentialChildren } from './children.js';

package/dist/src/index.js

@@ -0,0 +1,25 @@
+import { composePlugins } from 'dropsh/plugin';
+import { essentialChildren } from './children.js';
+/**
+ * Aggregator: pull the essentials in through a single `plugins[]` entry.
+ * `composePlugins(...)` returns the flat child list; dropsh (>= 0.5.6) flattens
+ * a plugins[] entry that resolves to an array into separate plugin entries, and
+ * the conductor's own resolver does the same — so each child stays a distinct,
+ * genuine plugin, indistinguishable from listing them one by one. No hand-merged
+ * or presence-guarded composite hooks.
+ *
+ * `authProvider`-carrying plugins (oauth2, with per-profile credentials) are
+ * deliberately NOT here — they stay explicit in the config (AC-4).
+ *
+ * BB-351 made `@bakers-build/addon-workspace` a child too, so an ambient workspace
+ * was filled on every connection without any config naming it. BB-495 removed
+ * it: the dropsh request path carries authentication and nothing else, and the
+ * caller names the workspace on the call. `bakers ui` attaches that plugin to its
+ * own chain instead, because a focused workspace is what makes its lists
+ * readable. No child here reads an option any more.
+ *
+ * Add a new essential = add it in `children.ts` (+ a real dependency in
+ * package.json). Existing configs naming only this aggregator pick it up (AC-5).
+ */
+export default (opts = {}) => composePlugins(...essentialChildren(opts));
+export { essentialChildren } from './children.js';

package/dist/src/preset.d.ts

@@ -0,0 +1,3 @@
+import type { BbPreset } from '@bakers-build/core';
+import { type EssentialsOptions } from './children.js';
+export declare const connectionPlugins: BbPreset<EssentialsOptions>['connectionPlugins'];

package/dist/src/preset.js

@@ -0,0 +1,17 @@
+// BB-215: the essentials meta-addon self-declares its connection contributions
+// via `./preset`. It pulls the essentials into the connection surface through a
+// single entry — the children are returned flat, exactly as the default-export
+// aggregator does, so each child stays a distinct plugin. The children are
+// essentials' OWN deps (imported in `children.ts`, resolved from this package's
+// node_modules), so no fragile transitive resolution from the config's bases.
+//
+// BB-351 made `@bakers-build/addon-workspace` one of those children, and it was the
+// only one that read an option. BB-495 removed it, so no child reads an option
+// any more: `opts` is still the GLOBAL options `loadBbConfig` hands every
+// preset, but nothing here consumes them. `workspace_id` is optional in the
+// connection config and reaches `bakers ui` alone.
+import { essentialChildren } from './children.js';
+export const connectionPlugins = (acc, opts) => [
+    ...acc,
+    ...essentialChildren((opts ?? {})),
+];

package/package.json

@@ -1,6 +1,31 @@
 {
   "name": "@bakers-build/addon-essentials",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-next.38",
+  "description": "bakers.build aggregator plugin: auto-loads the dropsh essentials (markdown + authoritative JSON:API schema).",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./preset": "./dist/src/preset.js"
+  },
+  "files": [
+    "dist/src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.key-tec.de/bakers-build/bakers-build.git",
+    "directory": "bakers-cli/addons/essentials"
+  },
+  "dependencies": {
+    "@dropsh/plugin-markdown": "^0.7.1",
+    "@dropsh/plugin-jsonapi-schema": "^0.7.1",
+    "@bakers-build/addon-name-refs": "^0.1.0-next.38",
+    "dropsh": "^0.7.5"
+  },
+  "peerDependencies": {
+    "@bakers-build/core": "^0.1.0-next.38"
+  }
+}