@ankhorage/zora 3.1.1 → 3.3.1

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 3.3.1
+
+### Patch Changes
+
+- 0295f82: Update Ankhorage dependencies: `@ankhorage/surface`.
+
+## 3.3.0
+
+### Minor Changes
+
+- 62c1c68: Add a manifest-authorable ContentRail pattern with responsive item sizing, touch scrolling, accessible controls, RTL behavior, and reduced-motion support.
+
+## 3.2.0
+
+### Minor Changes
+
+- ff90f8c: Add a manifest-authorable, accessible ProgressRing with semantic colors and serializable center content.
+
 ## 3.1.1
 
 ### Patch Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # ZORA
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v3.0.2](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v3.1.1](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Opinionated React Native and React Native Web UI kit built on @ankhorage/surface.
 

package/dist/components/card/meta.d.ts

@@ -2,7 +2,7 @@ export declare const cardMeta: {
     readonly name: "Card";
     readonly category: "component";
     readonly directManifestNode: true;
-    readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+    readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
     readonly blueprint: {
         readonly label: "Card";
         readonly defaultProps: {

package/dist/components/progress/ProgressRing.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { type ProgressRingProps } from './types';
+/***
+ * Circular determinate progress with optional serializable center value and label content.
+ */
+export declare const ProgressRing: (props: ProgressRingProps) => React.ReactElement | null;
+//# sourceMappingURL=ProgressRing.d.ts.map

package/dist/components/progress/ProgressRing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressRing.d.ts","sourceRoot":"","sources":["../../../src/components/progress/ProgressRing.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,SAAS,CAAC;AA0ItE;;GAEG;AACH,eAAO,MAAM,YAAY,yDAAwC,CAAC"}

package/dist/components/progress/ProgressRing.js

@@ -0,0 +1,100 @@
+import React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { Stack } from '../../foundation';
+import { useZoraTheme } from '../../theme/useZoraTheme';
+import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import { Text } from '../text';
+import { resolveProgressFraction } from './resolveProgressFraction';
+import { resolveProgressRingGeometry } from './resolveProgressRingGeometry';
+import { resolveProgressRole } from './types';
+function ProgressRingInner({ themeId: _themeId, mode: _mode, interactionPolicy: _interactionPolicy, accessibilityLabel = 'Progress', accessibilityValueText, centerLabel, centerValue, color = 'primary', max = 100, size = 120, testID, thickness = 10, trackColor = 'neutral', value, }) {
+    const { theme } = useZoraTheme();
+    const fraction = resolveProgressFraction({ max, value });
+    const geometry = resolveProgressRingGeometry({ fraction, size, thickness });
+    const progressRole = resolveProgressRole(theme, color);
+    const trackRole = resolveProgressRole(theme, trackColor);
+    const accessibilityMaximum = Number.isFinite(max) && max > 0 ? max : 1;
+    const accessibilityValue = fraction * accessibilityMaximum;
+    const valueText = accessibilityValueText ?? `${Math.round(fraction * 100)}%`;
+    const segments = Array.from({ length: geometry.filledSegmentCount });
+    return (<View accessibilityLabel={accessibilityLabel} accessibilityRole="progressbar" accessibilityValue={{
+            max: accessibilityMaximum,
+            min: 0,
+            now: accessibilityValue,
+            text: valueText,
+        }} accessible style={{ height: geometry.diameter, width: geometry.diameter }} testID={testID}>
+      <View importantForAccessibility="no-hide-descendants" pointerEvents="none" style={styles.visual}>
+        <View style={[
+            styles.track,
+            {
+                borderColor: trackRole.softBg,
+                borderRadius: geometry.diameter / 2,
+                borderWidth: geometry.strokeWidth,
+            },
+        ]}/>
+
+        {segments.map((_, index) => (<View key={index} style={[
+                styles.segmentLayer,
+                { transform: [{ rotate: `${index * (360 / geometry.segmentCount)}deg` }] },
+            ]}>
+            <View style={{
+                backgroundColor: progressRole.base,
+                borderRadius: geometry.strokeWidth / 2,
+                height: geometry.strokeWidth,
+                left: (geometry.diameter - geometry.segmentWidth) / 2,
+                position: 'absolute',
+                top: 0,
+                width: geometry.segmentWidth,
+            }}/>
+          </View>))}
+      </View>
+
+      {centerValue !== undefined || centerLabel !== undefined ? (<View importantForAccessibility="no-hide-descendants" pointerEvents="none" style={styles.center}>
+          <Stack align="center" gap="xxs" px="s">
+            {centerValue !== undefined ? (<Text align="center" variant="lead" weight="bold">
+                {centerValue}
+              </Text>) : null}
+            {centerLabel !== undefined ? (<Text align="center" emphasis="muted" numberOfLines={2} variant="caption">
+                {centerLabel}
+              </Text>) : null}
+          </Stack>
+        </View>) : null}
+    </View>);
+}
+const styles = StyleSheet.create({
+    center: {
+        alignItems: 'center',
+        bottom: 0,
+        justifyContent: 'center',
+        left: 0,
+        position: 'absolute',
+        right: 0,
+        top: 0,
+    },
+    segmentLayer: {
+        bottom: 0,
+        left: 0,
+        position: 'absolute',
+        right: 0,
+        top: 0,
+    },
+    track: {
+        bottom: 0,
+        left: 0,
+        position: 'absolute',
+        right: 0,
+        top: 0,
+    },
+    visual: {
+        bottom: 0,
+        left: 0,
+        position: 'absolute',
+        right: 0,
+        top: 0,
+    },
+});
+/***
+ * Circular determinate progress with optional serializable center value and label content.
+ */
+export const ProgressRing = withZoraThemeScope(ProgressRingInner);
+//# sourceMappingURL=ProgressRing.js.map

package/dist/components/progress/ProgressRing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressRing.js","sourceRoot":"","sources":["../../../src/components/progress/ProgressRing.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from 'react';\nimport { StyleSheet, View } from 'react-native';\n\nimport { Stack } from '../../foundation';\nimport { useZoraTheme } from '../../theme/useZoraTheme';\nimport { withZoraThemeScope } from '../../theme/withZoraThemeScope';\nimport { Text } from '../text';\nimport { resolveProgressFraction } from './resolveProgressFraction';\nimport { resolveProgressRingGeometry } from './resolveProgressRingGeometry';\nimport { type ProgressRingProps, resolveProgressRole } from './types';\n\nfunction ProgressRingInner({\n  themeId: _themeId,\n  mode: _mode,\n  interactionPolicy: _interactionPolicy,\n  accessibilityLabel = 'Progress',\n  accessibilityValueText,\n  centerLabel,\n  centerValue,\n  color = 'primary',\n  max = 100,\n  size = 120,\n  testID,\n  thickness = 10,\n  trackColor = 'neutral',\n  value,\n}: ProgressRingProps) {\n  const { theme } = useZoraTheme();\n  const fraction = resolveProgressFraction({ max, value });\n  const geometry = resolveProgressRingGeometry({ fraction, size, thickness });\n  const progressRole = resolveProgressRole(theme, color);\n  const trackRole = resolveProgressRole(theme, trackColor);\n  const accessibilityMaximum = Number.isFinite(max) && max > 0 ? max : 1;\n  const accessibilityValue = fraction * accessibilityMaximum;\n  const valueText = accessibilityValueText ?? `${Math.round(fraction * 100)}%`;\n  const segments = Array.from({ length: geometry.filledSegmentCount });\n\n  return (\n    <View\n      accessibilityLabel={accessibilityLabel}\n      accessibilityRole=\"progressbar\"\n      accessibilityValue={{\n        max: accessibilityMaximum,\n        min: 0,\n        now: accessibilityValue,\n        text: valueText,\n      }}\n      accessible\n      style={{ height: geometry.diameter, width: geometry.diameter }}\n      testID={testID}\n    >\n      <View\n        importantForAccessibility=\"no-hide-descendants\"\n        pointerEvents=\"none\"\n        style={styles.visual}\n      >\n        <View\n          style={[\n            styles.track,\n            {\n              borderColor: trackRole.softBg,\n              borderRadius: geometry.diameter / 2,\n              borderWidth: geometry.strokeWidth,\n            },\n          ]}\n        />\n\n        {segments.map((_, index) => (\n          <View\n            key={index}\n            style={[\n              styles.segmentLayer,\n              { transform: [{ rotate: `${index * (360 / geometry.segmentCount)}deg` }] },\n            ]}\n          >\n            <View\n              style={{\n                backgroundColor: progressRole.base,\n                borderRadius: geometry.strokeWidth / 2,\n                height: geometry.strokeWidth,\n                left: (geometry.diameter - geometry.segmentWidth) / 2,\n                position: 'absolute',\n                top: 0,\n                width: geometry.segmentWidth,\n              }}\n            />\n          </View>\n        ))}\n      </View>\n\n      {centerValue !== undefined || centerLabel !== undefined ? (\n        <View\n          importantForAccessibility=\"no-hide-descendants\"\n          pointerEvents=\"none\"\n          style={styles.center}\n        >\n          <Stack align=\"center\" gap=\"xxs\" px=\"s\">\n            {centerValue !== undefined ? (\n              <Text align=\"center\" variant=\"lead\" weight=\"bold\">\n                {centerValue}\n              </Text>\n            ) : null}\n            {centerLabel !== undefined ? (\n              <Text align=\"center\" emphasis=\"muted\" numberOfLines={2} variant=\"caption\">\n                {centerLabel}\n              </Text>\n            ) : null}\n          </Stack>\n        </View>\n      ) : null}\n    </View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  center: {\n    alignItems: 'center',\n    bottom: 0,\n    justifyContent: 'center',\n    left: 0,\n    position: 'absolute',\n    right: 0,\n    top: 0,\n  },\n  segmentLayer: {\n    bottom: 0,\n    left: 0,\n    position: 'absolute',\n    right: 0,\n    top: 0,\n  },\n  track: {\n    bottom: 0,\n    left: 0,\n    position: 'absolute',\n    right: 0,\n    top: 0,\n  },\n  visual: {\n    bottom: 0,\n    left: 0,\n    position: 'absolute',\n    right: 0,\n    top: 0,\n  },\n});\n\n/***\n * Circular determinate progress with optional serializable center value and label content.\n */\nexport const ProgressRing = withZoraThemeScope(ProgressRingInner);\n"]}

package/dist/components/progress/index.d.ts

@@ -1,3 +1,4 @@
 export { Progress } from './Progress';
-export type { ProgressProps } from './types';
+export { ProgressRing } from './ProgressRing';
+export type { ProgressProps, ProgressRingProps } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/progress/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/progress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/progress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/components/progress/index.js

@@ -1,2 +1,3 @@
 export { Progress } from './Progress';
+export { ProgressRing } from './ProgressRing';
 //# sourceMappingURL=index.js.map

package/dist/components/progress/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/progress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { Progress } from './Progress';\nexport type { ProgressProps } from './types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/progress/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC","sourcesContent":["export { Progress } from './Progress';\nexport { ProgressRing } from './ProgressRing';\nexport type { ProgressProps, ProgressRingProps } from './types';\n"]}

package/dist/components/progress/meta.d.ts

@@ -41,4 +41,120 @@ export declare const progressMeta: {
         };
     };
 };
+export declare const progressRingMeta: {
+    readonly name: "ProgressRing";
+    readonly category: "component";
+    readonly description: "Displays circular determinate progress with optional center value and label text.";
+    readonly directManifestNode: true;
+    readonly allowedChildren: readonly [];
+    readonly blueprint: {
+        readonly label: "Progress ring";
+        readonly defaultProps: {
+            readonly value: 68;
+            readonly max: 100;
+            readonly color: "primary";
+            readonly trackColor: "neutral";
+            readonly size: 120;
+            readonly thickness: 10;
+            readonly centerValue: "68%";
+            readonly centerLabel: "Complete";
+            readonly accessibilityLabel: "Progress";
+            readonly accessibilityValueText: "68% complete";
+        };
+    };
+    readonly props: {
+        readonly value: {
+            readonly type: "number";
+            readonly category: "State";
+            readonly label: "Value";
+            readonly default: 68;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly max: {
+            readonly type: "number";
+            readonly category: "State";
+            readonly label: "Maximum";
+            readonly default: 100;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly centerValue: {
+            readonly type: "string";
+            readonly category: "Content";
+            readonly label: "Center value";
+            readonly default: "68%";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly centerLabel: {
+            readonly type: "string";
+            readonly category: "Content";
+            readonly label: "Center label";
+            readonly default: "Complete";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly accessibilityLabel: {
+            readonly type: "string";
+            readonly category: "Accessibility";
+            readonly label: "Accessibility label";
+            readonly default: "Progress";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly accessibilityValueText: {
+            readonly type: "string";
+            readonly category: "Accessibility";
+            readonly label: "Accessibility value text";
+            readonly default: "68% complete";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly color: {
+            readonly type: "enum";
+            readonly category: "Style";
+            readonly label: "Progress color";
+            readonly enum: readonly ["primary", "secondary", "tertiary", "quaternary", "neutral", "success", "warning", "error", "info", "danger"];
+            readonly default: "primary";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly trackColor: {
+            readonly type: "enum";
+            readonly category: "Style";
+            readonly label: "Track color";
+            readonly enum: readonly ["primary", "secondary", "tertiary", "quaternary", "neutral", "success", "warning", "error", "info", "danger"];
+            readonly default: "neutral";
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly size: {
+            readonly type: "number";
+            readonly category: "Layout";
+            readonly label: "Diameter";
+            readonly default: 120;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+        readonly thickness: {
+            readonly type: "number";
+            readonly category: "Style";
+            readonly label: "Thickness";
+            readonly default: 10;
+            readonly authoring: {
+                readonly authority: "instance";
+            };
+        };
+    };
+};
 //# sourceMappingURL=meta.d.ts.map

package/dist/components/progress/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/components/progress/meta.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Ca,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../../src/components/progress/meta.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Ca,CAAC;AAIvC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FS,CAAC"}

package/dist/components/progress/meta.js

@@ -42,4 +42,101 @@ export const progressMeta = {
         },
     },
 };
+const instanceAuthoring = { authority: 'instance' };
+export const progressRingMeta = {
+    name: 'ProgressRing',
+    category: 'component',
+    description: 'Displays circular determinate progress with optional center value and label text.',
+    directManifestNode: true,
+    allowedChildren: [],
+    blueprint: {
+        label: 'Progress ring',
+        defaultProps: {
+            value: 68,
+            max: 100,
+            color: 'primary',
+            trackColor: 'neutral',
+            size: 120,
+            thickness: 10,
+            centerValue: '68%',
+            centerLabel: 'Complete',
+            accessibilityLabel: 'Progress',
+            accessibilityValueText: '68% complete',
+        },
+    },
+    props: {
+        value: {
+            type: 'number',
+            category: 'State',
+            label: 'Value',
+            default: 68,
+            authoring: instanceAuthoring,
+        },
+        max: {
+            type: 'number',
+            category: 'State',
+            label: 'Maximum',
+            default: 100,
+            authoring: instanceAuthoring,
+        },
+        centerValue: {
+            type: 'string',
+            category: 'Content',
+            label: 'Center value',
+            default: '68%',
+            authoring: instanceAuthoring,
+        },
+        centerLabel: {
+            type: 'string',
+            category: 'Content',
+            label: 'Center label',
+            default: 'Complete',
+            authoring: instanceAuthoring,
+        },
+        accessibilityLabel: {
+            type: 'string',
+            category: 'Accessibility',
+            label: 'Accessibility label',
+            default: 'Progress',
+            authoring: instanceAuthoring,
+        },
+        accessibilityValueText: {
+            type: 'string',
+            category: 'Accessibility',
+            label: 'Accessibility value text',
+            default: '68% complete',
+            authoring: instanceAuthoring,
+        },
+        color: {
+            type: 'enum',
+            category: 'Style',
+            label: 'Progress color',
+            enum: [...ZORA_COLORS],
+            default: 'primary',
+            authoring: instanceAuthoring,
+        },
+        trackColor: {
+            type: 'enum',
+            category: 'Style',
+            label: 'Track color',
+            enum: [...ZORA_COLORS],
+            default: 'neutral',
+            authoring: instanceAuthoring,
+        },
+        size: {
+            type: 'number',
+            category: 'Layout',
+            label: 'Diameter',
+            default: 120,
+            authoring: instanceAuthoring,
+        },
+        thickness: {
+            type: 'number',
+            category: 'Style',
+            label: 'Thickness',
+            default: 10,
+            authoring: instanceAuthoring,
+        },
+    },
+};
 //# sourceMappingURL=meta.js.map

package/dist/components/progress/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../../src/components/progress/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,WAAW;IACrB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,EAAE;IACnB,SAAS,EAAE;QACT,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,GAAG,EAAE,GAAG;YACR,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,GAAG;SACV;KACF;IACD,KAAK,EAAE;QACL,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,EAAE;SACZ;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,GAAG;SACb;QACD,KAAK,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,CAAC,GAAG,WAAW,CAAC;YACtB,OAAO,EAAE,SAAS;SACnB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;YACrB,OAAO,EAAE,GAAG;SACb;KACF;CACmC,CAAC","sourcesContent":["import { ZORA_COLORS } from '../../internal/colorModel';\nimport type { ZoraComponentMeta } from '../../metadata';\n\nexport const progressMeta = {\n  name: 'Progress',\n  category: 'component',\n  directManifestNode: true,\n  allowedChildren: [],\n  blueprint: {\n    label: 'Progress',\n    defaultProps: {\n      value: 50,\n      max: 100,\n      color: 'primary',\n      size: 'm',\n    },\n  },\n  props: {\n    value: {\n      type: 'number',\n      category: 'State',\n      label: 'Value',\n      default: 50,\n    },\n    max: {\n      type: 'number',\n      category: 'State',\n      label: 'Max',\n      default: 100,\n    },\n    color: {\n      type: 'enum',\n      category: 'Style',\n      label: 'Color',\n      enum: [...ZORA_COLORS],\n      default: 'primary',\n    },\n    size: {\n      type: 'enum',\n      category: 'Style',\n      label: 'Size',\n      enum: ['s', 'm', 'l'],\n      default: 'm',\n    },\n  },\n} as const satisfies ZoraComponentMeta;\n"]}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../../src/components/progress/meta.ts"],"names":[],"mappings":"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","sourcesContent":["import { ZORA_COLORS } from '../../internal/colorModel';\nimport type { ZoraComponentMeta } from '../../metadata';\n\nexport const progressMeta = {\n  name: 'Progress',\n  category: 'component',\n  directManifestNode: true,\n  allowedChildren: [],\n  blueprint: {\n    label: 'Progress',\n    defaultProps: {\n      value: 50,\n      max: 100,\n      color: 'primary',\n      size: 'm',\n    },\n  },\n  props: {\n    value: {\n      type: 'number',\n      category: 'State',\n      label: 'Value',\n      default: 50,\n    },\n    max: {\n      type: 'number',\n      category: 'State',\n      label: 'Max',\n      default: 100,\n    },\n    color: {\n      type: 'enum',\n      category: 'Style',\n      label: 'Color',\n      enum: [...ZORA_COLORS],\n      default: 'primary',\n    },\n    size: {\n      type: 'enum',\n      category: 'Style',\n      label: 'Size',\n      enum: ['s', 'm', 'l'],\n      default: 'm',\n    },\n  },\n} as const satisfies ZoraComponentMeta;\n\nconst instanceAuthoring = { authority: 'instance' } as const;\n\nexport const progressRingMeta = {\n  name: 'ProgressRing',\n  category: 'component',\n  description: 'Displays circular determinate progress with optional center value and label text.',\n  directManifestNode: true,\n  allowedChildren: [],\n  blueprint: {\n    label: 'Progress ring',\n    defaultProps: {\n      value: 68,\n      max: 100,\n      color: 'primary',\n      trackColor: 'neutral',\n      size: 120,\n      thickness: 10,\n      centerValue: '68%',\n      centerLabel: 'Complete',\n      accessibilityLabel: 'Progress',\n      accessibilityValueText: '68% complete',\n    },\n  },\n  props: {\n    value: {\n      type: 'number',\n      category: 'State',\n      label: 'Value',\n      default: 68,\n      authoring: instanceAuthoring,\n    },\n    max: {\n      type: 'number',\n      category: 'State',\n      label: 'Maximum',\n      default: 100,\n      authoring: instanceAuthoring,\n    },\n    centerValue: {\n      type: 'string',\n      category: 'Content',\n      label: 'Center value',\n      default: '68%',\n      authoring: instanceAuthoring,\n    },\n    centerLabel: {\n      type: 'string',\n      category: 'Content',\n      label: 'Center label',\n      default: 'Complete',\n      authoring: instanceAuthoring,\n    },\n    accessibilityLabel: {\n      type: 'string',\n      category: 'Accessibility',\n      label: 'Accessibility label',\n      default: 'Progress',\n      authoring: instanceAuthoring,\n    },\n    accessibilityValueText: {\n      type: 'string',\n      category: 'Accessibility',\n      label: 'Accessibility value text',\n      default: '68% complete',\n      authoring: instanceAuthoring,\n    },\n    color: {\n      type: 'enum',\n      category: 'Style',\n      label: 'Progress color',\n      enum: [...ZORA_COLORS],\n      default: 'primary',\n      authoring: instanceAuthoring,\n    },\n    trackColor: {\n      type: 'enum',\n      category: 'Style',\n      label: 'Track color',\n      enum: [...ZORA_COLORS],\n      default: 'neutral',\n      authoring: instanceAuthoring,\n    },\n    size: {\n      type: 'number',\n      category: 'Layout',\n      label: 'Diameter',\n      default: 120,\n      authoring: instanceAuthoring,\n    },\n    thickness: {\n      type: 'number',\n      category: 'Style',\n      label: 'Thickness',\n      default: 10,\n      authoring: instanceAuthoring,\n    },\n  },\n} as const satisfies ZoraComponentMeta;\n"]}

package/dist/components/progress/resolveProgressRingGeometry.d.ts

@@ -0,0 +1,12 @@
+export declare function resolveProgressRingGeometry({ fraction, size, thickness, }: {
+    fraction: number;
+    size: number;
+    thickness: number;
+}): {
+    diameter: number;
+    filledSegmentCount: number;
+    segmentCount: number;
+    segmentWidth: number;
+    strokeWidth: number;
+};
+//# sourceMappingURL=resolveProgressRingGeometry.d.ts.map

package/dist/components/progress/resolveProgressRingGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveProgressRingGeometry.d.ts","sourceRoot":"","sources":["../../../src/components/progress/resolveProgressRingGeometry.ts"],"names":[],"mappings":"AAAA,wBAAgB,2BAA2B,CAAC,EAC1C,QAAQ,EACR,IAAI,EACJ,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;;;;;;EAoBA"}

package/dist/components/progress/resolveProgressRingGeometry.js

@@ -0,0 +1,27 @@
+export function resolveProgressRingGeometry({ fraction, size, thickness, }) {
+    const diameter = normalizePositiveNumber(size, DEFAULT_SIZE, MINIMUM_SIZE);
+    const strokeWidth = Math.min(normalizePositiveNumber(thickness, DEFAULT_THICKNESS, MINIMUM_THICKNESS), diameter / 2);
+    const centerlineRadius = (diameter - strokeWidth) / 2;
+    const segmentCount = Math.max(MINIMUM_SEGMENT_COUNT, Math.min(MAXIMUM_SEGMENT_COUNT, Math.round(Math.PI * centerlineRadius)));
+    const normalizedFraction = Math.min(Math.max(Number.isFinite(fraction) ? fraction : 0, 0), 1);
+    return {
+        diameter,
+        filledSegmentCount: Math.round(normalizedFraction * segmentCount),
+        segmentCount,
+        segmentWidth: Math.max(1, (2 * Math.PI * centerlineRadius) / segmentCount + 0.5),
+        strokeWidth,
+    };
+}
+const DEFAULT_SIZE = 120;
+const DEFAULT_THICKNESS = 10;
+const MAXIMUM_SEGMENT_COUNT = 120;
+const MINIMUM_SEGMENT_COUNT = 32;
+const MINIMUM_SIZE = 24;
+const MINIMUM_THICKNESS = 1;
+function normalizePositiveNumber(value, fallback, minimum) {
+    if (!Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.max(value, minimum);
+}
+//# sourceMappingURL=resolveProgressRingGeometry.js.map

package/dist/components/progress/resolveProgressRingGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveProgressRingGeometry.js","sourceRoot":"","sources":["../../../src/components/progress/resolveProgressRingGeometry.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CAAC,EAC1C,QAAQ,EACR,IAAI,EACJ,SAAS,GAKV;IACC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,EACxE,QAAQ,GAAG,CAAC,CACb,CAAC;IACF,MAAM,gBAAgB,GAAG,CAAC,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,qBAAqB,EACrB,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,gBAAgB,CAAC,CAAC,CACxE,CAAC;IACF,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9F,OAAO;QACL,QAAQ;QACR,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,CAAC;QACjE,YAAY;QACZ,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,gBAAgB,CAAC,GAAG,YAAY,GAAG,GAAG,CAAC;QAChF,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,YAAY,GAAG,GAAG,CAAC;AACzB,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAC7B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,SAAS,uBAAuB,CAAC,KAAa,EAAE,QAAgB,EAAE,OAAe;IAC/E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAClC,CAAC","sourcesContent":["export function resolveProgressRingGeometry({\n  fraction,\n  size,\n  thickness,\n}: {\n  fraction: number;\n  size: number;\n  thickness: number;\n}) {\n  const diameter = normalizePositiveNumber(size, DEFAULT_SIZE, MINIMUM_SIZE);\n  const strokeWidth = Math.min(\n    normalizePositiveNumber(thickness, DEFAULT_THICKNESS, MINIMUM_THICKNESS),\n    diameter / 2,\n  );\n  const centerlineRadius = (diameter - strokeWidth) / 2;\n  const segmentCount = Math.max(\n    MINIMUM_SEGMENT_COUNT,\n    Math.min(MAXIMUM_SEGMENT_COUNT, Math.round(Math.PI * centerlineRadius)),\n  );\n  const normalizedFraction = Math.min(Math.max(Number.isFinite(fraction) ? fraction : 0, 0), 1);\n\n  return {\n    diameter,\n    filledSegmentCount: Math.round(normalizedFraction * segmentCount),\n    segmentCount,\n    segmentWidth: Math.max(1, (2 * Math.PI * centerlineRadius) / segmentCount + 0.5),\n    strokeWidth,\n  };\n}\n\nconst DEFAULT_SIZE = 120;\nconst DEFAULT_THICKNESS = 10;\nconst MAXIMUM_SEGMENT_COUNT = 120;\nconst MINIMUM_SEGMENT_COUNT = 32;\nconst MINIMUM_SIZE = 24;\nconst MINIMUM_THICKNESS = 1;\n\nfunction normalizePositiveNumber(value: number, fallback: number, minimum: number): number {\n  if (!Number.isFinite(value) || value <= 0) {\n    return fallback;\n  }\n\n  return Math.max(value, minimum);\n}\n"]}

package/dist/components/progress/types.d.ts

@@ -7,5 +7,17 @@ export interface ProgressProps extends ZoraBaseProps {
     color?: ZoraColor;
     size?: ZoraControlSize;
 }
+export interface ProgressRingProps extends ZoraBaseProps {
+    value: number;
+    max?: number;
+    color?: ZoraColor;
+    trackColor?: ZoraColor;
+    size?: number;
+    thickness?: number;
+    centerValue?: string;
+    centerLabel?: string;
+    accessibilityLabel?: string;
+    accessibilityValueText?: string;
+}
 export declare function resolveProgressRole(theme: SurfaceTheme, color: ZoraColor): RoleSemantics;
 //# sourceMappingURL=types.d.ts.map

package/dist/components/progress/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/progress/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,aAAa,CAwBxF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/components/progress/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,GAAG,aAAa,CAwBxF"}

package/dist/components/progress/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/progress/types.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,mBAAmB,CAAC,KAAmB,EAAE,KAAgB;IACvE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;QACnC,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAChC,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;QAC/B,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;QAC9B,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,KAAK,SAAS,CAAC;QACf;YACE,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;IAC1C,CAAC;AACH,CAAC","sourcesContent":["import type { RoleSemantics, SurfaceTheme } from '@ankhorage/surface';\n\nimport type { ZoraColor, ZoraControlSize } from '../../internal/recipes';\nimport type { ZoraBaseProps } from '../../theme/ZoraBaseProps';\n\nexport interface ProgressProps extends ZoraBaseProps {\n  value: number;\n  max?: number;\n  color?: ZoraColor;\n  size?: ZoraControlSize;\n}\n\nexport function resolveProgressRole(theme: SurfaceTheme, color: ZoraColor): RoleSemantics {\n  switch (color) {\n    case 'secondary':\n      return theme.semantics.secondary;\n    case 'tertiary':\n      return theme.semantics.accent;\n    case 'quaternary':\n      return theme.semantics.highlight;\n    case 'error':\n      return theme.semantics.error;\n    case 'info':\n      return theme.semantics.info;\n    case 'primary':\n      return theme.semantics.action.primary;\n    case 'danger':\n      return theme.semantics.action.danger;\n    case 'success':\n      return theme.semantics.success;\n    case 'warning':\n      return theme.semantics.warning;\n    case 'neutral':\n    default:\n      return theme.semantics.action.neutral;\n  }\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/components/progress/types.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,mBAAmB,CAAC,KAAmB,EAAE,KAAgB;IACvE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;QACnC,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC;QAChC,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;QAC/B,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;QAC9B,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;QACxC,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;QACvC,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC;QACjC,KAAK,SAAS,CAAC;QACf;YACE,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;IAC1C,CAAC;AACH,CAAC","sourcesContent":["import type { RoleSemantics, SurfaceTheme } from '@ankhorage/surface';\n\nimport type { ZoraColor, ZoraControlSize } from '../../internal/recipes';\nimport type { ZoraBaseProps } from '../../theme/ZoraBaseProps';\n\nexport interface ProgressProps extends ZoraBaseProps {\n  value: number;\n  max?: number;\n  color?: ZoraColor;\n  size?: ZoraControlSize;\n}\n\nexport interface ProgressRingProps extends ZoraBaseProps {\n  value: number;\n  max?: number;\n  color?: ZoraColor;\n  trackColor?: ZoraColor;\n  size?: number;\n  thickness?: number;\n  centerValue?: string;\n  centerLabel?: string;\n  accessibilityLabel?: string;\n  accessibilityValueText?: string;\n}\n\nexport function resolveProgressRole(theme: SurfaceTheme, color: ZoraColor): RoleSemantics {\n  switch (color) {\n    case 'secondary':\n      return theme.semantics.secondary;\n    case 'tertiary':\n      return theme.semantics.accent;\n    case 'quaternary':\n      return theme.semantics.highlight;\n    case 'error':\n      return theme.semantics.error;\n    case 'info':\n      return theme.semantics.info;\n    case 'primary':\n      return theme.semantics.action.primary;\n    case 'danger':\n      return theme.semantics.action.danger;\n    case 'success':\n      return theme.semantics.success;\n    case 'warning':\n      return theme.semantics.warning;\n    case 'neutral':\n    default:\n      return theme.semantics.action.neutral;\n  }\n}\n"]}

package/dist/foundation/meta.d.ts

@@ -3,7 +3,7 @@ export declare const foundationMetas: {
         readonly name: "Box";
         readonly category: "foundation";
         readonly directManifestNode: true;
-        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         readonly blueprint: {
             readonly label: "Box";
         };
@@ -21,7 +21,7 @@ export declare const foundationMetas: {
         readonly name: "Container";
         readonly category: "foundation";
         readonly directManifestNode: true;
-        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         readonly blueprint: {
             readonly label: "Container";
         };
@@ -41,7 +41,7 @@ export declare const foundationMetas: {
         readonly name: "Grid";
         readonly category: "foundation";
         readonly directManifestNode: true;
-        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         readonly blueprint: {
             readonly label: "Grid";
         };
@@ -75,7 +75,7 @@ export declare const foundationMetas: {
         readonly name: "Stack";
         readonly category: "foundation";
         readonly directManifestNode: true;
-        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ReaderSurface"];
+        readonly allowedChildren: readonly ["Box", "Stack", "Grid", "Container", "Divider", "Text", "Heading", "Button", "ButtonGroup", "ThemeModeToggle", "Input", "Textarea", "FormField", "Card", "Panel", "Notice", "EmptyState", "SectionHeader", "SettingsRow", "PostCard", "ChatListItem", "MessageBubble", "ProgressRing", "ReaderSurface", "ContentRail"];
         readonly blueprint: {
             readonly label: "Stack";
         };

package/dist/index.d.ts

@@ -56,8 +56,8 @@ export type { NavigationListProps, ZoraNavigationRouteMap } from './components/n
 export { NavigationList } from './components/navigation-list';
 export type { PaginationProps } from './components/pagination';
 export { Pagination } from './components/pagination';
-export type { ProgressProps } from './components/progress';
-export { Progress } from './components/progress';
+export type { ProgressProps, ProgressRingProps } from './components/progress';
+export { Progress, ProgressRing } from './components/progress';
 export type { RadioGroupOption, RadioGroupProps, RadioProps } from './components/radio';
 export { Radio, RadioGroup } from './components/radio';
 export type { RatingProps } from './components/rating';
@@ -108,6 +108,8 @@ export type { CollectionEditorProps, CollectionEditorRenderItemProps, } from './
 export { CollectionEditor } from './patterns/collection-editor';
 export type { ConfirmDialogProps } from './patterns/confirm-dialog';
 export { ConfirmDialog } from './patterns/confirm-dialog';
+export type { ContentRailControlPressEvent, ContentRailDirection, ContentRailItemSize, ContentRailMotion, ContentRailProps, ContentRailSpacing, ContentRailVisibleRangeChangeEvent, } from './patterns/content-rail';
+export { ContentRail } from './patterns/content-rail';
 export type { DisclosureSectionProps } from './patterns/disclosure-section';
 export { DisclosureSection } from './patterns/disclosure-section';
 export type { EmptyStateAction, EmptyStateProps } from './patterns/empty-state';