ember-storybook 0.1.6 → 0.2.1

package/declarations/client/docs/block-params.d.ts

@@ -1,4 +1,16 @@
 import type { BlockInfo, BlockParam } from 'ember-docgen';
-/** Flatten the params union into plain block params, unwrapping yield hashes. */
+/**
+ * Unwrap the params union to plain block params at the yield surface: a
+ * yield hash expands to its named entries, but unfolded named types
+ * (`nested`) are not descended into. Use for anything reflecting what the
+ * block actually receives (e.g. slot bindings).
+ */
+export declare function unwrapBlockParamsShallow(params: BlockInfo['params']): BlockParam[];
+/**
+ * Unwrap every block param: yield hashes expand to their named entries and
+ * unfolded named types descend into all members — the whole param tree. Use
+ * wherever every referenced component must be found (subcomponent
+ * collection, ref rewriting).
+ */
 export declare function unwrapBlockParams(params: BlockInfo['params']): BlockParam[];
 //# sourceMappingURL=block-params.d.ts.map

package/declarations/client/docs/block-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-params.d.ts","sourceRoot":"","sources":["../../../src/client/docs/block-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAkB,MAAM,cAAc,CAAC;AAM1E,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE,CAE3E"}
+{"version":3,"file":"block-params.d.ts","sourceRoot":"","sources":["../../../src/client/docs/block-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAkB,MAAM,cAAc,CAAC;AAM1E;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,UAAU,EAAE,CAkB3E"}

package/declarations/client/docs/blocks/blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../../src/client/docs/blocks/blocks.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAA8B,MAAM,cAAc,CAAC;AAE1E,eAAO,MAAM,SAAS;;;mGAInB,CAAC;AAOJ,eAAO,MAAM,QAAQ;;;yGAIlB,CAAC;AAsKJ,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,iBAAiB,EACjB,IAAI,EACL,EAAE;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;;;2HAiCA;AAED,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,iBAAiB,EACjB,IAAI,EACL,EAAE;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;;;sGAOA"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../../src/client/docs/blocks/blocks.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAA8B,MAAM,cAAc,CAAC;AAE1E,eAAO,MAAM,SAAS;;;mGAInB,CAAC;AAOJ,eAAO,MAAM,QAAQ;;;yGAIlB,CAAC;AA+NJ,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,iBAAiB,EACjB,IAAI,EACL,EAAE;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;;;2HAiCA;AAED,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,iBAAiB,EACjB,IAAI,EACL,EAAE;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;;;sGAOA"}

package/declarations/client/docs/blocks/subcomponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subcomponents.d.ts","sourceRoot":"","sources":["../../../../src/client/docs/blocks/subcomponents.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAgDpD,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,IAAI,EACL,EAAE;IACD,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;;;kHAmCA"}
+{"version":3,"file":"subcomponents.d.ts","sourceRoot":"","sources":["../../../../src/client/docs/blocks/subcomponents.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAmDpD,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,IAAI,EACL,EAAE;IACD,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;;;kHAmCA"}

package/declarations/client/docs/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/client/docs/config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAuBlC,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAC/B,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,KAC7C,cAAc,CAAC,EAkCnB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,UAQxB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAsB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/client/docs/config.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,wBAAwB,EACxB,cAAc,EACf,MAAM,0BAA0B,CAAC;AAuBlC,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAC/B,OAAO,EAAE,wBAAwB,CAAC,aAAa,CAAC,KAC7C,cAAc,CAAC,EAoCnB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,UAQxB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,iBAAiB,CAAC,aAAa,CAAC,EAAsB,CAAC"}

package/declarations/client/docs/extractArgTypes.d.ts

@@ -1,3 +1,29 @@
 import type { ComponentSignature } from 'ember-docgen';
+/**
+ * Returns a new argTypes object with entries sorted alphabetically by name,
+ * matching Storybook's `alpha` sort order. The input object is not mutated.
+ */
+export declare function sortArgTypes(argTypes: Record<string, unknown>): Record<string, unknown>;
 export declare function buildArgTypes(sig: ComponentSignature): Record<string, unknown>;
+/**
+ * Merges signature-derived argTypes with the story-provided argTypes.
+ *
+ * Signature argTypes are the base; story argTypes enhance them for better
+ * rendering (custom `name`, `control`, `options`, ...). For args present in
+ * both, story fields win — but only when they carry an actual value, so an
+ * explicit `undefined` never masks a signature field. The signature keeps the
+ * `table` and `description` the story does not override.
+ *
+ * The `type` object is deep-merged: a story-provided partial `type` (e.g.
+ * `type: 'string'`) keeps the signature's `required` flag unless the story
+ * explicitly sets it, while the story's `type.name` still wins.
+ */
+export declare function mergeArgTypes(signatureArgTypes: Record<string, unknown>, storyArgTypes: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Whether the docs page should render the Args/controls table: either the
+ * component signature exposes args, or the meta carries story-provided
+ * argTypes (e.g. for a template-only component with story argTypes but no
+ * signature args).
+ */
+export declare function shouldShowArgsSection(sig: ComponentSignature, metaArgTypes?: Record<string, unknown>): boolean;
 //# sourceMappingURL=extractArgTypes.d.ts.map

package/declarations/client/docs/extractArgTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractArgTypes.d.ts","sourceRoot":"","sources":["../../../src/client/docs/extractArgTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAoCpE,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB9E"}
+{"version":3,"file":"extractArgTypes.d.ts","sourceRoot":"","sources":["../../../src/client/docs/extractArgTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAoCpE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvF;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB9E;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,kBAAkB,EACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,OAAO,CAET"}

package/declarations/client/docs/page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/client/docs/page.ts"],"names":[],"mappings":"AAiFA,MAAM,CAAC,OAAO,UAAU,IAAI,4EAiC3B"}
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/client/docs/page.ts"],"names":[],"mappings":"AAuFA,MAAM,CAAC,OAAO,UAAU,IAAI,4EAiC3B"}

package/declarations/client/docs/signature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../src/client/docs/signature.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,IAAI,EAAE,SAAS,GACd,MAAM,GAAG,SAAS,CAgBpB;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GACjD,kBAAkB,CAsBpB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,IAAI,EAAE,SAAS,GACd,eAAe,EAAE,CA8CnB"}
+{"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../../../src/client/docs/signature.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAcD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,SAAS,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,IAAI,EAAE,SAAS,GACd,MAAM,GAAG,SAAS,CAoBpB;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,kBAAkB,EAC7B,SAAS,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GACjD,kBAAkB,CAsBpB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,IAAI,EAAE,SAAS,GACd,eAAe,EAAE,CAiDnB"}

package/dist/block-params-wjiT2Ht6.mjs

@@ -0,0 +1,32 @@
+//#region src/client/docs/block-params.ts
+function isBlockParam(param) {
+	return Object.hasOwn(param, "name") && Object.hasOwn(param, "type");
+}
+/**
+* Unwrap the params union to plain block params at the yield surface: a
+* yield hash expands to its named entries, but unfolded named types
+* (`nested`) are not descended into. Use for anything reflecting what the
+* block actually receives (e.g. slot bindings).
+*/
+function unwrapBlockParamsShallow(params) {
+	return params.flatMap((param) => isBlockParam(param) ? [param] : Object.values(param));
+}
+/**
+* Unwrap every block param: yield hashes expand to their named entries and
+* unfolded named types descend into all members — the whole param tree. Use
+* wherever every referenced component must be found (subcomponent
+* collection, ref rewriting).
+*/
+function unwrapBlockParams(params) {
+	const result = [];
+	for (const param of params) if (isBlockParam(param)) {
+		result.push(param);
+		const nested = param.nested;
+		if (nested && nested.length > 0) result.push(...unwrapBlockParams(nested));
+	} else result.push(...unwrapBlockParams(Object.values(param)));
+	return result;
+}
+//#endregion
+export { unwrapBlockParamsShallow as n, unwrapBlockParams as t };
+
+//# sourceMappingURL=block-params-wjiT2Ht6.mjs.map

package/dist/block-params-wjiT2Ht6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-params-wjiT2Ht6.mjs","names":["isBlockParam","param","Object","hasOwn","unwrapBlockParamsShallow","params","flatMap","values","unwrapBlockParams","result","push","nested","length"],"sources":["../src/client/docs/block-params.ts"],"sourcesContent":["import type { BlockInfo, BlockParam, HashBlockParam } from 'ember-docgen';\n\nfunction isBlockParam(param: BlockParam | HashBlockParam): param is BlockParam {\n  return Object.hasOwn(param, 'name') && Object.hasOwn(param, 'type');\n}\n\n/**\n * Unwrap the params union to plain block params at the yield surface: a\n * yield hash expands to its named entries, but unfolded named types\n * (`nested`) are not descended into. Use for anything reflecting what the\n * block actually receives (e.g. slot bindings).\n */\nexport function unwrapBlockParamsShallow(params: BlockInfo['params']): BlockParam[] {\n  return params.flatMap((param) => (isBlockParam(param) ? [param] : Object.values(param)));\n}\n\n/**\n * Unwrap every block param: yield hashes expand to their named entries and\n * unfolded named types descend into all members — the whole param tree. Use\n * wherever every referenced component must be found (subcomponent\n * collection, ref rewriting).\n */\nexport function unwrapBlockParams(params: BlockInfo['params']): BlockParam[] {\n  const result: BlockParam[] = [];\n\n  for (const param of params) {\n    if (isBlockParam(param)) {\n      result.push(param);\n\n      const nested = param.nested;\n\n      if (nested && nested.length > 0) {\n        result.push(...unwrapBlockParams(nested));\n      }\n    } else {\n      result.push(...unwrapBlockParams(Object.values(param)));\n    }\n  }\n\n  return result;\n}\n"],"mappings":";AAEA,SAASA,aAAaC,OAAyD;CAC7E,OAAOC,OAAOC,OAAOF,OAAO,MAAM,KAAKC,OAAOC,OAAOF,OAAO,MAAM;AACpE;;;;;;;AAQA,SAAgBG,yBAAyBC,QAA2C;CAClF,OAAOA,OAAOC,SAASL,UAAWD,aAAaC,KAAK,IAAI,CAACA,KAAK,IAAIC,OAAOK,OAAON,KAAK,CAAE;AACzF;;;;;;;AAQA,SAAgBO,kBAAkBH,QAA2C;CAC3E,MAAMI,SAAuB,CAAA;CAE7B,KAAK,MAAMR,SAASI,QAClB,IAAIL,aAAaC,KAAK,GAAG;EACvBQ,OAAOC,KAAKT,KAAK;EAEjB,MAAMU,SAASV,MAAMU;EAErB,IAAIA,UAAUA,OAAOC,SAAS,GAC5BH,OAAOC,KAAK,GAAGF,kBAAkBG,MAAM,CAAC;CAE5C,OACEF,OAAOC,KAAK,GAAGF,kBAAkBN,OAAOK,OAAON,KAAK,CAAC,CAAC;CAI1D,OAAOQ;AACT"}

package/dist/client/docs/config.mjs

@@ -1,9 +1,9 @@
 import { n as isEmberStoryResult } from "../../story-result-CCx6LMia.mjs";
-import { t as unwrapBlockParams } from "../../block-params-C68OkWMC.mjs";
+import { n as unwrapBlockParamsShallow, t as unwrapBlockParams } from "../../block-params-wjiT2Ht6.mjs";
 import { emitTransformCode, useEffect, useRef } from "storybook/preview-api";
 import { SourceType } from "storybook/internal/docs-tools";
 import emberData from "virtual:ember-storybook";
-import { ArgTypes, Controls, Description, DocsContext, Heading, Primary, Stories, Subheading, Subtitle, Title, useOf } from "@storybook/addon-docs/blocks";
+import { Controls, Description, DocsContext, Heading, Primary, PureArgsTable, Stories, Subheading, Subtitle, Title, useOf } from "@storybook/addon-docs/blocks";
 import { Fragment, createElement, useContext } from "react";
 import { NAVIGATE_URL } from "storybook/internal/core-events";
 import { styled } from "storybook/theming";
@@ -21,6 +21,13 @@ function mapTypeToControl(type) {
 		default: return { type: "object" };
 	}
 }
+/**
+* Returns a new argTypes object with entries sorted alphabetically by name,
+* matching Storybook's `alpha` sort order. The input object is not mutated.
+*/
+function sortArgTypes(argTypes) {
+	return Object.fromEntries(Object.entries(argTypes).toSorted(([a], [b]) => a.localeCompare(b)));
+}
 function buildArgTypes(sig) {
 	const argTypes = {};
 	for (const [name, arg] of Object.entries(sig.args)) argTypes[name] = {
@@ -36,8 +43,63 @@ function buildArgTypes(sig) {
 			defaultValue: arg.defaultValue ? { summary: arg.defaultValue } : void 0
 		}
 	};
-	return argTypes;
+	return sortArgTypes(argTypes);
 }
+function isObject(value) {
+	return typeof value === "object" && value !== null;
+}
+/**
+* Merges signature-derived argTypes with the story-provided argTypes.
+*
+* Signature argTypes are the base; story argTypes enhance them for better
+* rendering (custom `name`, `control`, `options`, ...). For args present in
+* both, story fields win — but only when they carry an actual value, so an
+* explicit `undefined` never masks a signature field. The signature keeps the
+* `table` and `description` the story does not override.
+*
+* The `type` object is deep-merged: a story-provided partial `type` (e.g.
+* `type: 'string'`) keeps the signature's `required` flag unless the story
+* explicitly sets it, while the story's `type.name` still wins.
+*/
+function mergeArgTypes(signatureArgTypes, storyArgTypes) {
+	const merged = { ...signatureArgTypes };
+	for (const [name, storyArg] of Object.entries(storyArgTypes)) {
+		if (storyArg === void 0) continue;
+		const sigArg = merged[name];
+		if (!isObject(sigArg) || !isObject(storyArg)) {
+			merged[name] = storyArg;
+			continue;
+		}
+		const storyFields = Object.fromEntries(Object.entries(storyArg).filter(([, value]) => value !== void 0));
+		const mergedArg = {
+			...sigArg,
+			...storyFields
+		};
+		if (isObject(sigArg.type) && isObject(storyFields.type)) mergedArg.type = {
+			...sigArg.type,
+			...storyFields.type
+		};
+		merged[name] = mergedArg;
+	}
+	return merged;
+}
+/**
+* Whether the docs page should render the Args/controls table: either the
+* component signature exposes args, or the meta carries story-provided
+* argTypes (e.g. for a template-only component with story argTypes but no
+* signature args).
+*/
+function shouldShowArgsSection(sig, metaArgTypes) {
+	return Object.keys(sig.args).length > 0 || Object.keys(metaArgTypes ?? {}).length > 0;
+}
+//#endregion
+//#region src/client/docs/signature.ts
+/**
+* Key used for default exports in signature/component maps. Mirrors
+* ember-docgen's `Default` sentinel — duplicated as a literal so client
+* code does not pull ember-docgen's node-only dependencies into the bundle.
+*/
+const DEFAULT_EXPORT = "__DEFAULT__";
 /**
 * Resolve the human-facing name of a referenced component export.
 *
@@ -54,8 +116,9 @@ function componentDisplayName(ref, data) {
 	const rawEntry = data[ref.filePath];
 	const componentEntry = hasSignatureMap(rawEntry) ? rawEntry : void 0;
 	if (!componentEntry) return ref.exportName === "__DEFAULT__" ? void 0 : ref.exportName;
-	if (ref.exportName === "__DEFAULT__") return componentEntry.meta["__DEFAULT__"] ?? void 0;
-	return componentEntry.meta[ref.exportName] ?? ref.exportName;
+	const meta = componentEntry.meta;
+	if (ref.exportName === "__DEFAULT__") return meta?.[DEFAULT_EXPORT];
+	return meta?.[ref.exportName] ?? ref.exportName;
 }
 function applyModifiers(signature, modifiers) {
 	if (!modifiers || modifiers.length === 0) return signature;
@@ -77,7 +140,7 @@ function collectSubcomponents(blocks, data) {
 	for (const block of Object.values(blocks)) for (const param of unwrapBlockParams(block.params)) {
 		if (!param.componentRef) continue;
 		const { filePath, exportName, importPath, modifiers } = param.componentRef;
-		const name = componentDisplayName(param.componentRef, data) ?? param.name;
+		const name = param.componentRef.local ? param.name : componentDisplayName(param.componentRef, data) ?? param.name;
 		if (seen.has(name)) continue;
 		seen.add(name);
 		if (importPath) result.push({
@@ -215,7 +278,10 @@ const SubcomponentLink = styled.a(({ theme }) => ({
 	textDecoration: "none",
 	"&:hover": { textDecoration: "underline" }
 }));
-const Indent = styled.span(() => ({ marginInlineStart: "20px" }));
+const CodeLine = styled.div(({ theme }) => ({
+	fontSize: theme.typography.size.s2 - 1,
+	lineHeight: "19px"
+}));
 /**
 * In-page anchor to a subcomponent section. Mirrors Storybook's own
 * in-docs navigation (TableOfContents / AnchorInPage): the default anchor
@@ -244,56 +310,98 @@ function SubcomponentAnchor({ name, children }) {
 	}, children);
 }
 /** Display name for a block param's type: the referenced component's own
-* name when available, otherwise the raw type string. */
+* name when available, the yield key for local components, otherwise the
+* raw type string. */
 function displayTypeName(param, data) {
+	if (param.componentRef?.local) return param.name;
 	return (data ? componentDisplayName(param.componentRef, data) : void 0) ?? param.type;
 }
-function renderType(param, subcomponentNames, data) {
+function isBlockParam(param) {
+	return Object.hasOwn(param, "name") && Object.hasOwn(param, "type");
+}
+function isNamedParam(name) {
+	return Boolean(name) && !name.startsWith("param");
+}
+/**
+* A `BlockParam` whose type was unfolded from a named non-component type is
+* an object just like an inline yield hash — normalize its members to
+* `[name, param]` entries. `undefined` for scalar params.
+*/
+function memberEntriesOf(param) {
+	const nested = param.nested;
+	if (!nested || nested.length === 0) return void 0;
+	return nested.flatMap((entry) => isBlockParam(entry) ? [[entry.name, entry]] : Object.entries(entry));
+}
+function renderTypeValue(param, subcomponentNames, data) {
 	const displayType = displayTypeName(param, data);
-	if (param.componentRef) return subcomponentNames.has(displayType) ? createElement(SubcomponentAnchor, {
+	return subcomponentNames.has(displayType) ? createElement(SubcomponentAnchor, {
 		key: "type",
 		name: displayType
 	}, displayType) : createElement(ParamType, { key: "type" }, displayType);
-	return createElement(ParamType, { key: "type" }, param.type);
-}
-function renderParam(param, subcomponentNames, data) {
-	const type = renderType(param, subcomponentNames, data);
-	return [
-		createElement(ParamName, { key: "name" }, param.name),
-		createElement("span", { key: "colon" }, ": "),
-		type
-	];
 }
-function isBlockParam(param) {
-	return Object.hasOwn(param, "name") && Object.hasOwn(param, "type");
+function descLine(param, key, depth) {
+	if (!param.description) return void 0;
+	const style = depth === void 0 ? void 0 : {
+		marginBottom: 0,
+		marginLeft: depth * 20 + 10
+	};
+	return createElement(ParamDesc, {
+		key,
+		style
+	}, param.description);
 }
-function renderParams(params, subcomponentNames, data) {
-	return params.map((param, i) => {
-		if (!isBlockParam(param)) {
-			const children = [
-				createElement("span", { key: "open" }, "- {"),
-				createElement("br", { key: "br-open" }),
-				...Object.entries(param).flatMap(([key, p]) => [createElement(Indent, { key: `indent-${key}` }), renderParam(p, subcomponentNames, data)]),
-				createElement("br", { key: "br-close" }),
-				createElement("span", { key: "close" }, "}")
-			];
-			return createElement(Fragment, { key: i }, ...children);
+function codeLine(key, depth, children) {
+	return createElement(CodeLine, {
+		key,
+		style: { paddingInlineStart: depth * 20 }
+	}, ...children);
+}
+/**
+* Render an object param JSON-style: an opening brace line (optionally
+* prefixed `name: `), member lines one level deeper, and a closing brace —
+* no dashes, no blank lines between the object's lines. Object members
+* recurse; scalar members render as `name: type`.
+*/
+function renderParamBlock(name, entries, subcomponentNames, data, depth, key) {
+	const head = name ? [createElement(ParamName, { key: `${key}-n` }, name), ": "] : [];
+	const lines = [codeLine(`${key}-o`, depth, [...head, "{"])];
+	for (const [i, [memberName, memberParam]] of entries.entries()) {
+		const memberKey = `${key}-${i}`;
+		const memberEntries = memberEntriesOf(memberParam);
+		if (memberEntries) lines.push(...renderParamBlock(memberName, memberEntries, subcomponentNames, data, depth + 1, memberKey));
+		else lines.push(codeLine(`${memberKey}-l`, depth + 1, [
+			createElement(ParamName, { key: `${memberKey}-n` }, memberName),
+			": ",
+			renderTypeValue(memberParam, subcomponentNames, data)
+		]));
+		const desc = descLine(memberParam, `${memberKey}-d`, depth + 1);
+		if (desc) lines.push(desc);
+	}
+	lines.push(codeLine(`${key}-x`, depth, ["}"]));
+	return lines;
+}
+function renderParams(params, subcomponentNames, data, keyPrefix = "p") {
+	return params.flatMap((param, i) => {
+		const key = `${keyPrefix}-${i}`;
+		if (!isBlockParam(param)) return renderParamBlock(void 0, Object.entries(param), subcomponentNames, data, 0, key);
+		const entries = memberEntriesOf(param);
+		if (entries) {
+			const lines = renderParamBlock(isNamedParam(param.name) ? param.name : void 0, entries, subcomponentNames, data, 0, key);
+			const desc = descLine(param, `${key}-d`, 0);
+			if (desc) lines.push(desc);
+			return lines;
 		}
-		const isNamed = param.name && !param.name.startsWith("param");
-		const displayType = displayTypeName(param, data);
-		const isSubcomponent = subcomponentNames.has(displayType);
-		const children = [];
-		const typeChildren = [];
-		if (isSubcomponent) typeChildren.push(createElement(SubcomponentAnchor, {
-			key: "type",
-			name: displayType
-		}, displayType));
-		else typeChildren.push(createElement(ParamType, { key: "type" }, displayType));
-		if (isNamed) children.push(createElement("span", { key: "sep" }, "- "), createElement(ParamName, { key: "name" }, param.name), createElement("span", { key: "colon" }, ": "), ...typeChildren);
-		else children.push(createElement("span", { key: "sep" }, "- "), ...typeChildren);
+		const type = renderTypeValue(param, subcomponentNames, data);
+		const children = isNamedParam(param.name) ? [
+			"- ",
+			createElement(ParamName, { key: "name" }, param.name),
+			": ",
+			type
+		] : ["- ", type];
 		const rows = [createElement(ParamRow, { key: "row" }, ...children)];
-		if (param.description) rows.push(createElement(ParamDesc, { key: "desc" }, param.description));
-		return createElement(Fragment, { key: i }, ...rows);
+		const desc = descLine(param, "desc");
+		if (desc) rows.push(desc);
+		return createElement(Fragment, { key }, ...rows);
 	});
 }
 function BlocksTable({ blocks, subcomponentNames, data }) {
@@ -397,7 +505,7 @@ const SectionLabel = styled.div(({ theme }) => ({
 function renderSubcomponentSignature(sig, subcomponentNames, data) {
 	const children = [];
 	if (sig.element) children.push(createElement(ElementBlock, { element: sig.element }));
-	if (Object.keys(sig.args).length > 0) children.push(createElement(SectionLabel, void 0, "Args"), createElement(ArgTypes, { include: Object.keys(sig.args) }));
+	if (Object.keys(sig.args).length > 0) children.push(createElement(SectionLabel, void 0, "Args"), createElement(PureArgsTable, { rows: buildArgTypes(sig) }));
 	if (Object.keys(sig.blocks).length > 0) children.push(createElement(SectionLabel, {
 		key: "blocks-label",
 		style: { marginTop: 12 }
@@ -427,10 +535,10 @@ function SubcomponentsArea({ components, data }) {
 }
 //#endregion
 //#region src/client/docs/page.ts
-function addSignature(signature, data) {
+function addSignature(signature, data, metaArgTypes) {
 	const children = [];
 	if (signature.element) children.push(createElement(ElementBlock, { element: signature.element }));
-	if (Object.keys(signature.args).length > 0) children.push(createElement(Subheading, void 0, "Args"), createElement(Controls));
+	if (shouldShowArgsSection(signature, metaArgTypes)) children.push(createElement(Subheading, void 0, "Args"), createElement(Controls));
 	if (Object.keys(signature.blocks).length > 0) {
 		const subcomponents = collectSubcomponents(signature.blocks, data);
 		const subcomponentNames = new Set(subcomponents.map((s) => s.name));
@@ -477,7 +585,7 @@ function Page() {
 		createElement(Description),
 		createElement(Primary)
 	];
-	if (signature) children.push(...addSignature(signature, data));
+	if (signature) children.push(...addSignature(signature, data, resolved.preparedMeta?.argTypes));
 	children.push(createElement(Stories));
 	return createElement(Fragment, void 0, ...children);
 }
@@ -500,7 +608,7 @@ function toArgument(key, value, argTypes) {
 }
 function generateBlockContent(blockInfo) {
 	if (blockInfo.params.length === 0) return "...";
-	return `{{yield ${unwrapBlockParams(blockInfo.params).map((p) => p.name).join(", ")}}}`;
+	return `{{yield ${unwrapBlockParamsShallow(blockInfo.params).map((p) => p.name).join(", ")}}}`;
 }
 function generateBlockSourceCode(sig, args, indent) {
 	const blockNames = Object.keys(sig.blocks);
@@ -509,7 +617,7 @@ function generateBlockSourceCode(sig, args, indent) {
 	for (const blockName of blockNames) {
 		const blockInfo = sig.blocks[blockName];
 		if (args[blockName] === void 0 && blockInfo.params.length === 0) continue;
-		const params = unwrapBlockParams(blockInfo.params).map((p) => p.name).join(" ");
+		const params = unwrapBlockParamsShallow(blockInfo.params).map((p) => p.name).join(" ");
 		const slotBindings = params ? ` as |${params}|` : "";
 		const content = generateBlockContent(blockInfo);
 		if (blockName === "default" && !slotBindings) blocks.push(content);
@@ -593,23 +701,17 @@ const argTypesEnhancers = [(context) => {
 	const filePath = context.parameters.fileName;
 	if (filePath && Object.hasOwn(data, filePath)) {
 		const sig = resolveSig(data[filePath]);
-		if (sig) return {
-			...buildArgTypes(sig),
-			...context.argTypes
-		};
-		return context.argTypes;
+		if (sig) return sortArgTypes(mergeArgTypes(buildArgTypes(sig), context.argTypes));
+		return sortArgTypes(context.argTypes);
 	}
 	const leaf = titleLeaf(context.title);
 	if (leaf) for (const entry of Object.values(data)) {
 		if (!("meta" in entry)) continue;
 		if (titleLeaf(entry.meta.title) !== leaf) continue;
 		const sig = resolveSig(entry);
-		if (sig) return {
-			...buildArgTypes(sig),
-			...context.argTypes
-		};
+		if (sig) return sortArgTypes(mergeArgTypes(buildArgTypes(sig), context.argTypes));
 	}
-	return context.argTypes;
+	return sortArgTypes(context.argTypes);
 }];
 const parameters = { docs: {
 	source: {