@astryxdesign/core 0.1.9 → 0.2.0-canary.0b7a99e

package/src/theme/index.ts

@@ -71,19 +71,13 @@ export {expandTypeScale, generateTypeScaleComponents} from './expandTypeScale';
 export type {TypeScaleConfig, TypeScaleTokens} from './expandTypeScale';
 
 export {expandRadiusScale} from './expandRadiusScale';
-export type {
-  RadiusScaleConfig,
-  RadiusScaleTokens,
-} from './expandRadiusScale';
+export type {RadiusScaleConfig, RadiusScaleTokens} from './expandRadiusScale';
 
 export {expandColorScale} from './expandColorScale';
 export type {ColorScaleConfig, ColorScaleTokens} from './expandColorScale';
 
 export {expandMotionScale} from './expandMotionScale';
-export type {
-  MotionScaleConfig,
-  MotionScaleTokens,
-} from './expandMotionScale';
+export type {MotionScaleConfig, MotionScaleTokens} from './expandMotionScale';
 
 // Export token defaults and vars for use in custom components and themes
 export {
@@ -146,6 +140,7 @@ export type {
   ResolvedThemeMode,
 } from './tokens';
 
+export type {TextColorMap} from '../Text';
 export type {
   ThemeMode,
   HeadingTag,
@@ -155,6 +150,7 @@ export type {
   TextSize,
   TextWeight,
   TextColor,
+  BuiltinTextColor,
   TypographyConfig,
   TypographyRole,
   FontWeight,

package/src/theme/types.ts

@@ -15,11 +15,7 @@
  * Raw CSS values (e.g. '800') are accepted as an escape hatch.
  */
 export type FontWeight =
-  | 'normal'
-  | 'medium'
-  | 'semibold'
-  | 'bold'
-  | (string & {});
+  'normal' | 'medium' | 'semibold' | 'bold' | (string & {});
 
 /**
  * A typography role declaration (body, heading, or code).
@@ -152,18 +148,23 @@ export type TextSize =
 /**
  * Font weight variants for Text/Heading
  */
+import type {TextColorMap} from '../Text';
+
 export type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 
 /**
- * Text color variants for Text/Heading
+ * Built-in text color variants for Text/Heading. The concrete keys that ship
+ * with the design system, independent of theme augmentation — used where a
+ * value must be one of the real StyleX color styles (see `resolveStyleColor`).
  */
-export type TextColor =
-  | 'primary'
-  | 'secondary'
-  | 'disabled'
-  | 'placeholder'
-  | 'accent'
-  | 'inherit';
+export type BuiltinTextColor =
+  'primary' | 'secondary' | 'disabled' | 'placeholder' | 'accent' | 'inherit';
+
+/**
+ * Text color variants for Text/Heading. Extensible via module augmentation of
+ * `TextColorMap`.
+ */
+export type TextColor = keyof TextColorMap;
 
 /**
  * Display mode for Text/Heading

package/src/theme/useTheme.doc.mjs

@@ -1,6 +1,6 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
 
-/** @type {import('../docs-types').HookDoc} */
+/** @type {import('@astryxdesign/cli/authoring').HookDoc} */
 export const docs = {
   name: 'useTheme',
   displayName: 'useTheme',
@@ -87,7 +87,7 @@ export const docs = {
   importPath: '@astryxdesign/core/theme',
 };
 
-/** @type {import('../docs-types').HookTranslationDoc} */
+/** @type {import('@astryxdesign/cli/authoring').HookTranslationDoc} */
 export const docsDense = {
   description:
     'Programmatic access to theme tokens for SVG/canvas/charts needing JS values instead of CSS vars.',

package/src/utils/index.ts

@@ -98,3 +98,5 @@ export {
 export type {RGBA} from './color';
 
 export {devWarn, devError, warnOnce, formatDevMessage} from './devWarning';
+
+export {rtlStyles} from './rtlStyles';

package/src/utils/plainDate.test.ts

@@ -235,19 +235,37 @@ describe('plainDateAddMonths', () => {
     });
   });
 
-  it('overflows day into next month when target month is shorter', () => {
+  it('clamps to the last day when the target month is shorter', () => {
+    // Jan 31 + 1 month lands in February (clamped), not overflowed into
+    // March — matching Temporal.PlainDate.add and date-fns addMonths.
     expect(plainDateAddMonths({year: 2026, month: 1, day: 31}, 1)).toEqual({
       year: 2026,
-      month: 3,
-      day: 3,
+      month: 2,
+      day: 28,
     });
   });
 
-  it('overflows Jan 31 + 1 month in leap year', () => {
+  it('clamps to Feb 29 in a leap year', () => {
     expect(plainDateAddMonths({year: 2024, month: 1, day: 31}, 1)).toEqual({
       year: 2024,
-      month: 3,
-      day: 2,
+      month: 2,
+      day: 29,
+    });
+  });
+
+  it('clamps when subtracting into a shorter month', () => {
+    expect(plainDateAddMonths({year: 2026, month: 3, day: 31}, -1)).toEqual({
+      year: 2026,
+      month: 2,
+      day: 28,
+    });
+  });
+
+  it('clamps a 31st onto a 30-day month', () => {
+    expect(plainDateAddMonths({year: 2026, month: 5, day: 31}, 1)).toEqual({
+      year: 2026,
+      month: 6,
+      day: 30,
     });
   });
 });

package/src/utils/plainDate.ts

@@ -72,9 +72,14 @@ export function plainDateDayOfWeek(pd: PlainDate): number {
 }
 
 export function plainDateAddMonths(pd: PlainDate, n: number): PlainDate {
-  const d = plainDateToDate(pd);
-  d.setMonth(d.getMonth() + n);
-  return plainDateFromDate(d);
+  // Pure month arithmetic with day clamping (Temporal.PlainDate.add
+  // semantics): Jan 31 + 1 month is Feb 28/29, not Mar 2/3. Date#setMonth
+  // would overflow the excess days into the following month instead.
+  const totalMonths = pd.year * 12 + (pd.month - 1) + n;
+  const year = Math.floor(totalMonths / 12);
+  const month = (((totalMonths % 12) + 12) % 12) + 1;
+  const day = Math.min(pd.day, getDaysInMonth(year, month));
+  return {year, month, day};
 }
 
 export function plainDateAddDays(pd: PlainDate, n: number): PlainDate {
@@ -83,7 +88,16 @@ export function plainDateAddDays(pd: PlainDate, n: number): PlainDate {
   return plainDateFromDate(d);
 }
 
-function getTimeZoneParts(
+/**
+ * The wall-clock fields an instant reads as in a given zone.
+ *
+ * A fixed `'en-US'` locale with `hourCycle: 'h23'` keeps the parts numeric and
+ * stable whatever locale the viewer has, so callers can assemble machine
+ * shapes (`YYYY-MM-DD`, `HH:mm:ss`) from them. Exported for Timestamp, whose
+ * `system_*` formats are built from these fields rather than through `Intl`
+ * formatting.
+ */
+export function getTimeZoneParts(
   instant: number,
   timezoneID: string,
 ): {

package/src/utils/rtlStyles.ts

@@ -0,0 +1,49 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file rtlStyles.ts
+ * @input None
+ * @output Shared StyleX style that horizontally mirrors an element under RTL
+ * @position Core utility; applied to directional-icon wrappers in Calendar,
+ *   Lightbox, and the Table expand/disclosure plugins
+ *
+ * `mirror` flips its element on the horizontal axis only when an ancestor
+ * carries `dir="rtl"`. Using `scaleX(-1)` (not `scale(-1, -1)`) keeps the
+ * vertical axis intact, and applying it OUTSIDE any state-driven rotation lets
+ * it compose correctly — e.g. a Table disclosure chevron still rotates to point
+ * down when expanded under RTL. The `:is([dir="rtl"] *)` selector matches the
+ * MobileNav drawer convention; a bare `direction: rtl` alone won't trigger it.
+ *
+ * `centerInline(blockOffset?)` horizontally centers an absolutely-positioned,
+ * auto-width element on the inline axis, correctly in BOTH LTR and RTL, with an
+ * optional block-axis (Y) offset composed into the same transform. It
+ * intentionally uses PHYSICAL `left: 50%` + `translateX(-50%)`: both reference
+ * the same physical edge, so the pair is direction-symmetric and centers
+ * identically regardless of `dir`. A logical `insetInlineStart: 50%` would flip
+ * the anchor edge in RTL while the physical translate does not, leaving the
+ * element off-center by its own width (centered in LTR, broken in RTL). This is
+ * the one case where physical `left` is the correct choice, so the
+ * `no-physical-properties` suppression lives here ONCE rather than at each call
+ * site. The `@astryx/no-physical-properties` lint recognises this exact pattern
+ * and points offenders here.
+ *
+ * `blockOffset` is any CSS length/percentage for translateY (pass `'0px'` for
+ * none): e.g. `centerInline('100%')` sits the element one full height below its
+ * anchor, `centerInline('-50%')` centers it on both axes.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/utils/index.ts
+ */
+
+import * as stylex from '@stylexjs/stylex';
+
+export const rtlStyles = stylex.create({
+  mirror: {
+    transform: {default: null, ':is([dir="rtl"] *)': 'scaleX(-1)'},
+  },
+  centerInline: (blockOffset: string) => ({
+    // eslint-disable-next-line @astryx/no-physical-properties -- intentional: physical left+translateX(-50%) is direction-symmetric and the correct way to center; a logical anchor would break RTL centering (see file header).
+    left: '50%',
+    transform: `translate(-50%, ${blockOffset})`,
+  }),
+});

package/dist/Thumbnail/thumbnail.markers.stylex.d.ts

@@ -1,9 +0,0 @@
-import * as stylex from '@stylexjs/stylex';
-/**
- * Scoped marker for Thumbnail ancestor selectors. Applied to the image
- * container so the remove button's hover/focus reveal (`showRemoveOn="hover"`)
- * responds only to this thumbnail — not to hover/focus state from an outer
- * container the thumbnail happens to sit inside.
- */
-export declare const thumbnailScope: ReturnType<typeof stylex.defineMarker>;
-//# sourceMappingURL=thumbnail.markers.stylex.d.ts.map

package/dist/Thumbnail/thumbnail.markers.stylex.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"thumbnail.markers.stylex.d.ts","sourceRoot":"","sources":["../../src/Thumbnail/thumbnail.markers.stylex.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,YAAY,CAC3C,CAAC"}

package/dist/Thumbnail/thumbnail.markers.stylex.js

@@ -1,14 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-import * as stylex from '@stylexjs/stylex';
-
-/**
- * Scoped marker for Thumbnail ancestor selectors. Applied to the image
- * container so the remove button's hover/focus reveal (`showRemoveOn="hover"`)
- * responds only to this thumbnail — not to hover/focus state from an outer
- * container the thumbnail happens to sit inside.
- */
-export const thumbnailScope = {
-  x9jk0ni: "x9jk0ni",
-  $$css: true
-};

package/dist/authoring/doc.d.ts

@@ -1,145 +0,0 @@
-/**
- * @file doc.ts
- * @input A component/function/generic doc object (without the `type` tag).
- * @output Type-preserving `createComponentDoc`/`createFunctionDoc`/`createDoc`
- *   helpers plus the doc-authoring TypeScript surface.
- * @position Integration-author authoring surface. See `./index.ts` for why
- *   these authoring factories live in `@astryxdesign/core`.
- *
- * A doc describes a documentable unit of the design system so the CLI and docs
- * surfaces can list, search, and render it. There are three kinds, each a tiny
- * runtime identity helper that stamps a `type` discriminant:
- *
- *   - `createComponentDoc` -> `type: 'component'` — a component (or a family).
- *   - `createFunctionDoc`  -> `type: 'function'`  — any function, including
- *      hooks: an "inputs + outputs" surface (`params` + `returns`).
- *   - `createDoc`          -> `type: 'generic'`   — reference/topic docs.
- *
- * These factories do NOT validate. Validation happens at the CLI load boundary,
- * where doc discovery runs the loaded value through a schema that accepts BOTH
- * the stamped formats and the legacy loose `export const docs = {...}` shape.
- */
-/**
- * Fields shared by every doc kind (component + function + generic).
- *
- * `group` vs `parent` are distinct:
- *   - `group` is a FLAT sidebar bucket label; many docs can share it and it is
- *     NOT an inheritance key.
- *   - `parent` is a DIRECTED inheritance/composition pointer — a doc naming the
- *     doc it belongs to (e.g. a sub-component naming its parent component). The
- *     legacy `subComponentOf` field is a synonym.
- *
- * `relatedDocs` is a single flat curated cross-reference list; it replaces the
- * legacy split `relatedComponents` + `relatedHooks`.
- */
-export interface AstryxBaseDocInput {
-    /** Name of the documented unit, without any prefix, PascalCase. Required. */
-    name: string;
-    /** Human-readable display name for gallery/sidebar. */
-    displayName?: string;
-    /** Short description. */
-    description?: string;
-    /** Usage documentation (description, best practices, anatomy, slotElements). */
-    usage?: unknown;
-    /** Flat sidebar grouping label (not an inheritance key). */
-    group?: string;
-    /** Overview-page functional category. */
-    category?: string;
-    /** CLI fuzzy-search keywords. */
-    keywords?: string[];
-    /** Directed inheritance/composition pointer to the doc this belongs to. */
-    parent?: string;
-    /** Flat curated cross-reference list of related doc names. */
-    relatedDocs?: string[];
-    /** Hide the whole doc from human-facing UI (stays importable/discoverable). */
-    hidden?: boolean;
-    /** Exclude from the categorized overview page (kept in sidebar/CLI). */
-    isHiddenFromOverview?: boolean;
-    /** Any additional fields the rich doc surface carries. */
-    [key: string]: unknown;
-}
-/** A single documented prop (mirrors `PropDoc` from core docs-types). */
-export interface AstryxPropInput {
-    name: string;
-    type: string;
-    description: string;
-    default?: string;
-    required?: boolean;
-    [key: string]: unknown;
-}
-/** A single documented param (mirrors `HookParamDoc`). */
-export interface AstryxParamInput {
-    name: string;
-    type: string;
-    description: string;
-    default?: string;
-    required?: boolean;
-    [key: string]: unknown;
-}
-/** A single documented return field (mirrors `HookReturnDoc`). */
-export interface AstryxReturnInput {
-    name: string;
-    type: string;
-    description: string;
-    [key: string]: unknown;
-}
-/**
- * Input accepted by {@link createComponentDoc}. A component (or a family). The
- * `type` discriminant is injected by the factory. `anatomy`/`slotElements` live
- * inside `usage`; `importPath` is DERIVED (never authored).
- */
-export interface AstryxComponentDocInput extends AstryxBaseDocInput {
-    /** All public props for the component. */
-    props: AstryxPropInput[];
-    /** Theming/selector-surface metadata. */
-    theming?: unknown;
-    /** Interactive-preview playground configuration. */
-    playground?: unknown;
-    /** Short code examples rendered after the props table. */
-    examples?: unknown[];
-}
-/**
- * Input accepted by {@link createFunctionDoc}. Covers any function, including
- * hooks: an inputs (`params`) + outputs (`returns`) surface. The `type`
- * discriminant is injected by the factory; `importPath` is DERIVED.
- */
-export interface AstryxFunctionDocInput extends AstryxBaseDocInput {
-    /** Function/hook parameters or options-object fields. */
-    params: AstryxParamInput[];
-    /** Return value documentation. One entry per field (or a single primitive). */
-    returns: AstryxReturnInput[];
-}
-/**
- * Input accepted by {@link createDoc}. A generic reference/topic doc — just the
- * shared base. The `type` discriminant is injected by the factory.
- */
-export type AstryxGenericDocInput = AstryxBaseDocInput;
-/**
- * Back-compat alias. Previously `createDoc` accepted a broad component-doc
- * record; the union of the three input kinds preserves that permissiveness for
- * any code referring to the old name.
- */
-export type AstryxComponentDoc = AstryxComponentDocInput | AstryxFunctionDocInput | AstryxGenericDocInput;
-/**
- * Author a component doc. Stamp-only: returns the def with `type: 'component'`
- * injected. Validation happens at the CLI load boundary.
- */
-export declare function createComponentDoc<T extends AstryxComponentDocInput>(def: T): T & {
-    type: 'component';
-};
-/**
- * Author a function doc (covers any function, including hooks). Stamp-only:
- * returns the def with `type: 'function'` injected. Validation happens at the
- * CLI load boundary.
- */
-export declare function createFunctionDoc<T extends AstryxFunctionDocInput>(def: T): T & {
-    type: 'function';
-};
-/**
- * Author a generic reference/topic doc. Stamp-only: returns the def with
- * `type: 'generic'` injected. Validation happens at the CLI load boundary.
- */
-export declare function createDoc<T extends AstryxGenericDocInput>(def: T): T & {
-    type: 'generic';
-};
-//# sourceMappingURL=doc.d.ts.map

package/dist/authoring/doc.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"doc.d.ts","sourceRoot":"","sources":["../../src/authoring/doc.ts"],"names":[],"mappings":"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"}

package/dist/authoring/doc.js

@@ -1,100 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file doc.ts
- * @input A component/function/generic doc object (without the `type` tag).
- * @output Type-preserving `createComponentDoc`/`createFunctionDoc`/`createDoc`
- *   helpers plus the doc-authoring TypeScript surface.
- * @position Integration-author authoring surface. See `./index.ts` for why
- *   these authoring factories live in `@astryxdesign/core`.
- *
- * A doc describes a documentable unit of the design system so the CLI and docs
- * surfaces can list, search, and render it. There are three kinds, each a tiny
- * runtime identity helper that stamps a `type` discriminant:
- *
- *   - `createComponentDoc` -> `type: 'component'` — a component (or a family).
- *   - `createFunctionDoc`  -> `type: 'function'`  — any function, including
- *      hooks: an "inputs + outputs" surface (`params` + `returns`).
- *   - `createDoc`          -> `type: 'generic'`   — reference/topic docs.
- *
- * These factories do NOT validate. Validation happens at the CLI load boundary,
- * where doc discovery runs the loaded value through a schema that accepts BOTH
- * the stamped formats and the legacy loose `export const docs = {...}` shape.
- */
-
-/**
- * Fields shared by every doc kind (component + function + generic).
- *
- * `group` vs `parent` are distinct:
- *   - `group` is a FLAT sidebar bucket label; many docs can share it and it is
- *     NOT an inheritance key.
- *   - `parent` is a DIRECTED inheritance/composition pointer — a doc naming the
- *     doc it belongs to (e.g. a sub-component naming its parent component). The
- *     legacy `subComponentOf` field is a synonym.
- *
- * `relatedDocs` is a single flat curated cross-reference list; it replaces the
- * legacy split `relatedComponents` + `relatedHooks`.
- */
-
-/** A single documented prop (mirrors `PropDoc` from core docs-types). */
-
-/** A single documented param (mirrors `HookParamDoc`). */
-
-/** A single documented return field (mirrors `HookReturnDoc`). */
-
-/**
- * Input accepted by {@link createComponentDoc}. A component (or a family). The
- * `type` discriminant is injected by the factory. `anatomy`/`slotElements` live
- * inside `usage`; `importPath` is DERIVED (never authored).
- */
-
-/**
- * Input accepted by {@link createFunctionDoc}. Covers any function, including
- * hooks: an inputs (`params`) + outputs (`returns`) surface. The `type`
- * discriminant is injected by the factory; `importPath` is DERIVED.
- */
-
-/**
- * Input accepted by {@link createDoc}. A generic reference/topic doc — just the
- * shared base. The `type` discriminant is injected by the factory.
- */
-
-/**
- * Back-compat alias. Previously `createDoc` accepted a broad component-doc
- * record; the union of the three input kinds preserves that permissiveness for
- * any code referring to the old name.
- */
-
-/**
- * Author a component doc. Stamp-only: returns the def with `type: 'component'`
- * injected. Validation happens at the CLI load boundary.
- */
-export function createComponentDoc(def) {
-  return {
-    ...def,
-    type: 'component'
-  };
-}
-
-/**
- * Author a function doc (covers any function, including hooks). Stamp-only:
- * returns the def with `type: 'function'` injected. Validation happens at the
- * CLI load boundary.
- */
-export function createFunctionDoc(def) {
-  return {
-    ...def,
-    type: 'function'
-  };
-}
-
-/**
- * Author a generic reference/topic doc. Stamp-only: returns the def with
- * `type: 'generic'` injected. Validation happens at the CLI load boundary.
- */
-export function createDoc(def) {
-  return {
-    ...def,
-    type: 'generic'
-  };
-}

package/dist/authoring/index.d.ts

@@ -1,29 +0,0 @@
-/**
- * @file index.ts
- * @input None (barrel).
- * @output The Astryx integration-authoring surface: the stamp-only factories an
- *   integration package uses to describe what it contributes (integrations,
- *   templates, docs), plus their TypeScript input/output types.
- * @position Producer-facing authoring surface, exported as
- *   `@astryxdesign/core/authoring`.
- *
- * ## Why these live in core
- *
- * These factories are tiny, zero-runtime-dependency identity functions whose
- * value is their TypeScript surface. Hosting them in `@astryxdesign/core` (the
- * base of the dependency graph) means core's own docs can adopt them without a
- * core -> cli -> core cycle, and integration authors get the types without a
- * hard dependency on the CLI. The CLI re-exports every factory from its
- * existing subpaths (`@astryxdesign/cli/integration|template|doc`) for
- * back-compat; the CLI keeps the Zod validation schemas at its load boundary.
- *
- * `createConfig` is intentionally NOT here — it is a consumer surface (every app
- * with an `astryx.config`), exported separately as `@astryxdesign/core/config`.
- */
-export { createIntegration } from './integration';
-export type { AstryxIntegration } from './integration';
-export { createPageTemplate, createBlockTemplate } from './template';
-export type { AstryxTemplatePreview, AstryxTemplateInput, AstryxPageTemplateInput, AstryxBlockTemplateInput, AstryxPageTemplate, AstryxBlockTemplate, AstryxTemplate, } from './template';
-export { createComponentDoc, createFunctionDoc, createDoc } from './doc';
-export type { AstryxBaseDocInput, AstryxPropInput, AstryxParamInput, AstryxReturnInput, AstryxComponentDocInput, AstryxFunctionDocInput, AstryxGenericDocInput, AstryxComponentDoc, } from './doc';
-//# sourceMappingURL=index.d.ts.map

package/dist/authoring/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/authoring/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAChD,YAAY,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAErD,OAAO,EAAC,kBAAkB,EAAE,mBAAmB,EAAC,MAAM,YAAY,CAAC;AACnE,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAC,kBAAkB,EAAE,iBAAiB,EAAE,SAAS,EAAC,MAAM,OAAO,CAAC;AACvE,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,OAAO,CAAC"}

package/dist/authoring/index.js

@@ -1,28 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file index.ts
- * @input None (barrel).
- * @output The Astryx integration-authoring surface: the stamp-only factories an
- *   integration package uses to describe what it contributes (integrations,
- *   templates, docs), plus their TypeScript input/output types.
- * @position Producer-facing authoring surface, exported as
- *   `@astryxdesign/core/authoring`.
- *
- * ## Why these live in core
- *
- * These factories are tiny, zero-runtime-dependency identity functions whose
- * value is their TypeScript surface. Hosting them in `@astryxdesign/core` (the
- * base of the dependency graph) means core's own docs can adopt them without a
- * core -> cli -> core cycle, and integration authors get the types without a
- * hard dependency on the CLI. The CLI re-exports every factory from its
- * existing subpaths (`@astryxdesign/cli/integration|template|doc`) for
- * back-compat; the CLI keeps the Zod validation schemas at its load boundary.
- *
- * `createConfig` is intentionally NOT here — it is a consumer surface (every app
- * with an `astryx.config`), exported separately as `@astryxdesign/core/config`.
- */
-
-export { createIntegration } from "./integration.js";
-export { createPageTemplate, createBlockTemplate } from "./template.js";
-export { createComponentDoc, createFunctionDoc, createDoc } from "./doc.js";

package/dist/authoring/integration.d.ts

@@ -1,35 +0,0 @@
-/**
- * @file integration.ts
- * @input An integration package's manifest object.
- * @output A type-preserving `createIntegration` helper plus the
- *   `AstryxIntegration` manifest surface.
- * @position Integration-author authoring surface. See `./index.ts` for why
- *   these authoring factories live in `@astryxdesign/core`.
- *
- * `createIntegration` is an intentionally tiny runtime identity function: it
- * returns its argument unchanged. Validation is NOT performed here — it happens
- * at the CLI load boundary.
- */
-/**
- * Integration manifest exported from a conventional root manifest file
- * (astryx.integration.{ts,mjs,js}) sibling to the integration package's
- * package.json. Identity (name/version) comes from the package's
- * package.json, not from the manifest.
- */
-export interface AstryxIntegration {
-    /** Relative path to the components/docs root (resolved to absolute). */
-    components?: string;
-    /** Relative path to the templates root (resolved to absolute). */
-    templates?: string;
-    /** Relative path to the codemods root (resolved to absolute). */
-    codemods?: string;
-    /** Where to file issues/feedback for this integration. */
-    issuesUrl?: string;
-}
-/**
- * Type-preserving helper for an Astryx integration manifest. Returns its
- * argument unchanged; the value is the exported TypeScript surface. Validation
- * happens at the CLI load boundary.
- */
-export declare function createIntegration<T extends AstryxIntegration>(integration: T): T;
-//# sourceMappingURL=integration.d.ts.map

package/dist/authoring/integration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/authoring/integration.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAC3D,WAAW,EAAE,CAAC,GACb,CAAC,CAEH"}

package/dist/authoring/integration.js

@@ -1,30 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file integration.ts
- * @input An integration package's manifest object.
- * @output A type-preserving `createIntegration` helper plus the
- *   `AstryxIntegration` manifest surface.
- * @position Integration-author authoring surface. See `./index.ts` for why
- *   these authoring factories live in `@astryxdesign/core`.
- *
- * `createIntegration` is an intentionally tiny runtime identity function: it
- * returns its argument unchanged. Validation is NOT performed here — it happens
- * at the CLI load boundary.
- */
-
-/**
- * Integration manifest exported from a conventional root manifest file
- * (astryx.integration.{ts,mjs,js}) sibling to the integration package's
- * package.json. Identity (name/version) comes from the package's
- * package.json, not from the manifest.
- */
-
-/**
- * Type-preserving helper for an Astryx integration manifest. Returns its
- * argument unchanged; the value is the exported TypeScript surface. Validation
- * happens at the CLI load boundary.
- */
-export function createIntegration(integration) {
-  return integration;
-}