sdocs 0.0.54 → 0.0.55

package/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.55] - 2026-07-05
+
+### Changed
+
+- **Renamed the stage alignment attributes** `align`/`alignY` (added in
+  0.0.54) to **`contentX`**/**`contentY`** — for horizontal/vertical content
+  alignment on `[preview]`/`[example]` and their `content.docs` and `[DOCS]`
+  defaults. Values and direction-aware behavior are unchanged.
+
 ## [0.0.54] - 2026-07-05
 
 ### Added

package/dist/language/parser.d.ts

@@ -14,9 +14,9 @@ export interface Sizing {
     /** gap of preview/example stages */
     gap: string | null;
     /** horizontal alignment of preview/example stage contents */
-    align: string | null;
+    contentX: string | null;
     /** vertical alignment of preview/example stage contents */
-    alignY: string | null;
+    contentY: string | null;
     /** table-of-contents visibility (PAGE) */
     toc: boolean | null;
 }

package/dist/language/parser.js

@@ -50,8 +50,8 @@ const SIZING_ATTR_RULES = {
 const STAGE_LAYOUT_ATTR_RULES = {
     direction: { required: false, kind: 'string', hint: 'direction="column"' },
     gap: { required: false, kind: 'string', hint: 'gap="16px"' },
-    align: { required: false, kind: 'string', hint: 'align="center"' },
-    alignY: { required: false, kind: 'string', hint: 'alignY="middle"' },
+    contentX: { required: false, kind: 'string', hint: 'contentX="center"' },
+    contentY: { required: false, kind: 'string', hint: 'contentY="middle"' },
 };
 function sizingOf(attrs) {
     const toc = stringAttr(attrs, 'toc');
@@ -60,8 +60,8 @@ function sizingOf(attrs) {
         padding: stringAttr(attrs, 'padding'),
         direction: stringAttr(attrs, 'direction'),
         gap: stringAttr(attrs, 'gap'),
-        align: stringAttr(attrs, 'align'),
-        alignY: stringAttr(attrs, 'alignY'),
+        contentX: stringAttr(attrs, 'contentX'),
+        contentY: stringAttr(attrs, 'contentY'),
         toc: toc === null ? null : toc === 'true',
     };
 }

package/dist/server/config.js

@@ -20,8 +20,8 @@ const DEFAULTS = {
             padding: '16px',
             direction: 'row',
             gap: '16px',
-            align: 'left',
-            alignY: 'top',
+            contentX: 'left',
+            contentY: 'top',
         },
         layout: { maxWidth: '100%', padding: '0px' },
     },

package/dist/server/snippet-compiler.d.ts

@@ -28,8 +28,8 @@ export declare function generateIframeComponent(scriptPrelude: string, snippetBo
     padding: string;
     direction?: string;
     gap?: string;
-    align?: string;
-    alignY?: string;
+    contentX?: string;
+    contentY?: string;
 }): string;
 /** The JS that boots a preview page: mount the wrapper + parent-frame messaging. */
 export declare function generateMountScript(iframeComponentId: string): string;

package/dist/server/snippet-compiler.js

@@ -88,8 +88,8 @@ export function generateIframeComponent(scriptPrelude, snippetBody, stateNames =
     // layout stages are flow-root blocks. Both contain child margins, so the
     // height reported for iframe auto-sizing is exact.
     //
-    // align/alignY are *physical* (horizontal/vertical); which flex property
-    // each drives depends on direction. The flow axis (main) takes
+    // contentX/contentY are *physical* (horizontal/vertical); which flex
+    // property each drives depends on direction. The flow axis (main) takes
     // justify-content, the other (cross) takes align-items — and align-items
     // has no distribution value, so a 'justify' that lands on the cross axis
     // falls back to stretch.
@@ -106,8 +106,8 @@ export function generateIframeComponent(scriptPrelude, snippetBody, stateNames =
         justify: 'space-between',
     };
     const flexStage = () => {
-        const h = H[stage.align ?? 'left'] ?? 'flex-start';
-        const v = V[stage.alignY ?? 'top'] ?? 'flex-start';
+        const h = H[stage.contentX ?? 'left'] ?? 'flex-start';
+        const v = V[stage.contentY ?? 'top'] ?? 'flex-start';
         const isColumn = String(stage.direction).startsWith('column');
         const justify = isColumn ? v : h;
         let alignItems = isColumn ? h : v;

package/dist/types.d.ts

@@ -35,9 +35,9 @@ export interface SdocsConfig {
             /** Stage gap. Default: '16px' */
             gap?: string;
             /** Horizontal alignment of stage contents: 'left'|'center'|'right'|'justify'. Default: 'left' */
-            align?: string;
+            contentX?: string;
             /** Vertical alignment of stage contents: 'top'|'middle'|'bottom'. Default: 'top' */
-            alignY?: string;
+            contentY?: string;
         };
         /** [LAYOUT] stages. Defaults: maxWidth '100%', padding '0px'. */
         layout?: ContentSizing;
@@ -52,13 +52,13 @@ export interface ContentSizing {
 export interface StageLayout {
     maxWidth: string;
     padding: string;
-    /** flex-direction + gap + align; set for preview/example stages only */
+    /** flex-direction + gap + contentX; set for preview/example stages only */
     direction?: string;
     gap?: string;
     /** horizontal ('left'|'center'|'right'|'justify') — mapped by direction */
-    align?: string;
+    contentX?: string;
     /** vertical ('top'|'middle'|'bottom') — mapped by direction */
-    alignY?: string;
+    contentY?: string;
 }
 /** Resolved config with all defaults applied */
 export interface ResolvedSdocsConfig {
@@ -79,8 +79,8 @@ export interface ResolvedSdocsConfig {
         docs: Required<ContentSizing> & {
             direction: string;
             gap: string;
-            align: string;
-            alignY: string;
+            contentX: string;
+            contentY: string;
         };
         layout: Required<ContentSizing>;
     };

package/dist/vite.js

@@ -308,13 +308,13 @@ export function sdocsPlugin(userConfig) {
                 maxWidth: block?.maxWidth ??
                     (entity.kind === 'LAYOUT' ? (entity.sizing.maxWidth ?? kindDefaults.maxWidth) : '100%'),
                 padding: block?.padding ?? entity.sizing.padding ?? kindDefaults.padding,
-                // direction/gap/align flex the preview/example stages only
+                // direction/gap/contentX flex the preview/example stages only
                 ...(entity.kind === 'DOCS' && block
                     ? {
                         direction: block.direction ?? entity.sizing.direction ?? config.content.docs.direction,
                         gap: block.gap ?? entity.sizing.gap ?? config.content.docs.gap,
-                        align: block.align ?? entity.sizing.align ?? config.content.docs.align,
-                        alignY: block.alignY ?? entity.sizing.alignY ?? config.content.docs.alignY,
+                        contentX: block.contentX ?? entity.sizing.contentX ?? config.content.docs.contentX,
+                        contentY: block.contentY ?? entity.sizing.contentY ?? config.content.docs.contentY,
                     }
                     : {}),
             });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sdocs",
-	"version": "0.0.54",
+	"version": "0.0.55",
 	"description": "A lightweight documentation tool for Svelte 5 components",
 	"type": "module",
 	"license": "MIT",