@se-studio/core-data-types 1.0.144 → 1.0.147

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @se-studio/core-data-types
 
+## 1.0.147
+
+### Patch Changes
+
+- Version bump: patch for changed packages
+
+## 1.0.146
+
+### Patch Changes
+
+- Version bump: patch for changed packages
+
+## 1.0.145
+
+### Patch Changes
+
+- Version bump: patch for changed packages
+
 ## 1.0.144
 
 ### Patch Changes

package/dist/index.d.ts

@@ -39,7 +39,7 @@ export { isCustomType } from './types/customType';
 export type { IBasePage } from './types/page';
 export { isPage } from './types/page';
 export type { ISchema } from './types/schema';
-export type { IBaseTag, IBaseTags } from './types/tag';
+export type { IBaseTag, IBaseTags, IBaseTagType } from './types/tag';
 export { isTag, isTags, } from './types/tag';
 export type { Horizontal, IAnimation, IExternalVideo, IFullVideo, IImage, ILocalVideo, IOptimisedSvg, IPicture, IResponsiveVisual, ISvgData, ISvgImage, IVideo, IVideoDetails, IVideoEmbed, IVisual, IVisualCommon, IVisualSizes, Vertical, } from './types/visual';
 export { getVisualHorizontalPosition, getVisualWidthPercent, isAnimation, isExternalVideo, isFullVideo, isImage, isLocalVideo, isPicture, isResponsiveVisual, isSvgData, isSvgImage, isVideo, isVisual, isVisualAnimation, isVisualImage, isVisualVideo, processSizes, } from './types/visual';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,KAAK,EACL,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,MAAM,EACN,WAAW,EACX,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,UAAU,EACV,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,YAAY,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EACL,KAAK,EACL,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,MAAM,EACN,WAAW,EACX,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAa,EACb,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/types/tag.d.ts

@@ -1,8 +1,15 @@
 import type { IBaseModel, ITyped } from './common';
 import type { ISchema } from './schema';
+export interface IBaseTagType {
+    id: string;
+    name: string;
+    slug?: string | null;
+    /** Resolved indexPageTopContent merged with template — for tag type index pages */
+    contents?: ReadonlyArray<ITyped>;
+}
 export interface IBaseTag extends IBaseModel {
     type: 'Tag';
-    tagType?: string | null;
+    tagType?: IBaseTagType | null;
     structuredData?: ReadonlyArray<ISchema>;
     contents?: ReadonlyArray<ITyped>;
 }

package/dist/types/tag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/types/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,QAAQ,CAE9D;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,SAAS,CAEhE"}
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../../src/types/tag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,QAAQ,CAE9D;AAED,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,IAAI,SAAS,CAEhE"}

package/dist/types/tag.js.map

@@ -1 +1 @@
-{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/types/tag.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,KAAK,CAAC,OAAmB;IACvC,OAAO,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC;AAChC,CAAC;AAMD,MAAM,UAAU,MAAM,CAAC,OAAmB;IACxC,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC"}
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../src/types/tag.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,KAAK,CAAC,OAAmB;IACvC,OAAO,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC;AAChC,CAAC;AAMD,MAAM,UAAU,MAAM,CAAC,OAAmB;IACxC,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC"}

package/docs/llms.md

@@ -0,0 +1,169 @@
+# @se-studio/core-data-types — LLM Reference
+
+Pure TypeScript type definitions for SE Studio content models. No runtime dependencies. Used by all other `@se-studio` packages and consuming apps.
+
+> **Note:** Consuming projects use `noUncheckedIndexedAccess` — array/object index access returns `T | undefined`. Always null-check index results.
+
+## Content Types
+
+### Page
+```ts
+import type { IBasePage } from '@se-studio/core-data-types';
+import { isPage } from '@se-studio/core-data-types';
+
+interface IBasePage {
+  id: string;
+  slug: string;
+  title: string;
+  description?: string;
+  content: unknown[];      // array of components/collections
+  // ... more fields
+}
+```
+
+### Article
+```ts
+import type { IBaseArticle, IBaseArticleType } from '@se-studio/core-data-types';
+import { isArticle, isArticleType } from '@se-studio/core-data-types';
+```
+
+### Tag
+```ts
+import type { IBaseTag, IBaseTags, IBaseTagType } from '@se-studio/core-data-types';
+import { isTag, isTags } from '@se-studio/core-data-types';
+```
+
+### Component & Collection
+```ts
+import type { IBaseComponent, IBaseCollection, IBaseExternalComponent } from '@se-studio/core-data-types';
+import { isComponent, isCollection, isExternalComponent } from '@se-studio/core-data-types';
+```
+
+### Person
+```ts
+import type { IBasePerson } from '@se-studio/core-data-types';
+import { isPerson } from '@se-studio/core-data-types';
+```
+
+### Banner
+```ts
+import type { IBanner } from '@se-studio/core-data-types';
+import { isBanner } from '@se-studio/core-data-types';
+```
+
+### Custom Type
+```ts
+import type { IBaseCustomType } from '@se-studio/core-data-types';
+import { isCustomType } from '@se-studio/core-data-types';
+```
+
+## Link Types
+
+All internal/external link variants share the `ILinkProps` base.
+
+```ts
+import type {
+  IInternalLink,    // link to internal page (has slug + href)
+  IExternalLink,    // link to external URL
+  IDownloadLink,    // link to downloadable asset
+  IBlankLink,       // blank/empty link
+  IPageLink,        // lightweight page reference (id + slug + title)
+  IArticleLink,     // lightweight article reference
+  IArticleTypeLink,
+  ITagLink,
+  IPersonLink,
+  INavigationItem,
+  INavigation,
+} from '@se-studio/core-data-types';
+
+import {
+  isInternalLink,
+  isExternalLink,
+  isDownloadLink,
+  isBlankLink,
+  isPageLink,
+  isArticleLink,
+  isArticleTypeLink,
+  isTagLink,
+  isPersonLink,
+  isLink,           // any link type
+} from '@se-studio/core-data-types';
+```
+
+## Visual / Media Types
+
+```ts
+import type {
+  IVisual,            // union of all visual types
+  IResponsiveVisual,  // { desktop: IVisual; mobile?: IVisual }
+  IImage,             // { url, width, height, alt, ... }
+  IPicture,           // responsive image with multiple sources
+  IVideo,             // union of video types
+  IFullVideo,         // self-hosted video
+  ILocalVideo,        // local video file
+  IExternalVideo,     // YouTube / Vimeo embed
+  IAnimation,         // Lottie / SVG animation
+  ISvgImage,          // inline SVG
+  IOptimisedSvg,
+} from '@se-studio/core-data-types';
+
+import {
+  isVisual, isImage, isPicture,
+  isVideo, isFullVideo, isLocalVideo, isExternalVideo,
+  isAnimation, isSvgImage, isSvgData,
+  isResponsiveVisual,
+  isVisualImage, isVisualVideo, isVisualAnimation,
+} from '@se-studio/core-data-types';
+```
+
+## Context Types
+
+```ts
+import type {
+  IPageContext,       // current page info passed through renderer
+  IAnalyticsContext,  // analytics tracking context
+  IContentContext,    // content rendering context
+  IPageLink,          // minimal page reference { slug, title, href? }
+} from '@se-studio/core-data-types';
+```
+
+## Utility Types
+
+```ts
+import type {
+  IBaseModel,    // { id: string; type: string }
+  ITyped,        // { type: string }
+  InternalType,  // discriminated union helper
+} from '@se-studio/core-data-types';
+```
+
+## Visual Helpers
+
+```ts
+import {
+  getVisualHorizontalPosition,  // returns Tailwind object-position class
+  getVisualWidthPercent,
+  processSizes,                 // compute Next.js Image sizes string
+} from '@se-studio/core-data-types';
+```
+
+## Ordering Helpers
+
+```ts
+import { orderContentWithHtmlHeroFirst } from '@se-studio/core-data-types';
+// Reorders a content array so HTML hero components appear first
+```
+
+## Usage Pattern
+
+Apps extend base types with project-specific fields:
+
+```ts
+// In your app's types
+import type { IBasePage } from '@se-studio/core-data-types';
+
+export interface IPage extends IBasePage {
+  heroImage?: IImage;
+  themeColor?: string;
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-data-types",
-  "version": "1.0.144",
+  "version": "1.0.147",
   "description": "Core TypeScript type definitions for SE Studio content models",
   "repository": {
     "type": "git",
@@ -19,7 +19,8 @@
   },
   "files": [
     "dist",
-    "*.md"
+    "*.md",
+    "docs"
   ],
   "keywords": [
     "typescript",