@palmyit/elements 0.1.7 → 0.1.19

package/README.md

@@ -10,4 +10,6 @@ yarn build
 
 Published publicly to npmjs. Pages load the CSS from jsDelivr (see [docs/README.md](docs/README.md)).
 
+To add or update an element, see [docs/authoring-elements.md](docs/authoring-elements.md).
+
 A push to `main` runs `.github/workflows/deploy-to-npmjs.yml`. Each commit bumps the patch version in `package.json`.

package/dist/definitions.d.ts

@@ -5,47 +5,56 @@
 export type { ElementType, DocumentAttributes, ElementHistory, ElementConfiguration, RegisteredElementConfiguration, } from './schema/elementConfiguration';
 export { elementIdSchema, defineElement } from './schema/elementConfiguration';
 export { elementRegistry, isElementType } from './schema/elementRegistry';
+export { elementCategories, hiddenFromDrawer, type ElementCategory, } from './schema/elementCategories';
 export type { ElementTemplate, TemplateContentItem, ApplyTemplateResult } from './schema/elementTemplates';
 export { applyElementTemplate } from './schema/elementTemplates';
 export type { StyleDefinition, StyleItem } from './schema/styleItems';
-export { styleItemsSchema, styleOverrideItemsSchema, styleLabels, toStyleItems, toStyleOverrideItems, } from './schema/styleItems';
+export { documentStyleAttribute, documentStyleSchema, documentStyleOverrideSchema, styleItemsSchema, styleOverrideItemsSchema, styleLabels, toDocumentStyle, toDocumentStyleOverride, toStyleItems, toStyleOverrideItems, } from './schema/styleItems';
 export { withDeviceSettings, type DeviceStyleOverrides, } from './schema/deviceSettings';
 export { VISIBILITY_PROP_BY_DEVICE, LANDSCAPE_VISIBILITY_PROP_BY_DEVICE, VISIBILITY_PROPS, DEVICE_CHOICES, visibilityProp, isShownOn, shownDeviceCount, type DeviceVisibility, type DeviceVisibilityProp, type DeviceChoice, } from './schema/deviceVisibility';
 export { defineLayoutElement } from './schema/layoutElementConfiguration';
 export { layoutChildren } from './schema/layoutChildren';
 export { textItemsSchema, toTextItems, type TextItem } from './schema/textItems';
-export { defaultPageStyle, pageStyleKeys } from './schema/PPage/pPage.definition';
-export { addressSchema } from './schema/addressSchema';
+export { defaultPageStyle, defaultPageSeo, defaultPageTheme, pageStyleKeys, PAGE_DIRS, PAGE_TEXT_SIZES, CONTENT_WIDTHS, RADIUS_STYLES, LINK_UNDERLINES, type PageDir, type PageTextSize, type ContentWidth, type RadiusStyle, type LinkUnderline, } from './elements/page/definition';
+export { addressSchema, linkAddressSchema } from './schema/addressSchema';
 export { backgroundStyleDefinitions, colorValue } from './schema/backgroundStyleDefinitions';
 export { elementStyleDefinitions, elementStyleSchema, lengthKeys, lengthValue, type LengthKey, } from './schema/elementStyleDefinitions';
-export { defaultLinkSettings, linkHistoryLabels, linkSettingsShape, toLinkAttributes, type LinkSettings, } from './schema/linkSettings';
-export { pButtonDefinition, defaultButtonProps, type ButtonStyle, type PButtonDocumentProps, } from './schema/PButton/pButton.definition';
-export { pCheckboxDefinition, defaultCheckboxProps } from './schema/PCheckbox/pCheckbox.definition';
-export { pContainerDefinition, defaultContainerStyle } from './schema/PContainer/pContainer.definition';
-export { pDividerDefinition, defaultDividerProps, type DividerSize } from './schema/PDivider/pDivider.definition';
-export { pIconDefinition, defaultIconProps } from './schema/PIcon/pIcon.definition';
-export { pImageDefinition, defaultImageProps, IMAGE_LENGTH_KEYS, IMAGE_PREFIX, type ImageStyle, type ImageLengthKey, type PImageDocumentProps, } from './schema/PImage/pImage.definition';
-export { pListDefinition, defaultListProps } from './schema/PList/pList.definition';
-export { pPageDefinition, type PPageRootProps } from './schema/PPage/pPage.definition';
-export { pRadioDefinition, defaultRadioProps } from './schema/PRadio/pRadio.definition';
-export { pRichTextDefinition, defaultRichTextProps } from './schema/PRichText/pRichText.definition';
-export { isFontFamily } from './schema/PRichText/richTextMarks';
-export { normalizeRichText, richTextToPlainText } from './schema/PRichText/richTextOptions';
-export { pSectionDefinition, defaultSectionStyle } from './schema/PSection/pSection.definition';
-export { pSelectDefinition, defaultSelectProps } from './schema/PSelect/pSelect.definition';
-export { pTableDefinition, defaultTableProps, fitRowsToHeaders, type TableRow } from './schema/PTable/pTable.definition';
-export { pTextDefinition, defaultTextProps, textStyleDefinitions, TEXT_PREFIX, TEXT_DECORATIONS, TEXT_ALIGNS, TEXT_TRANSFORMS, FONT_WEIGHTS, type TextStyle, type PTextDocumentProps, type TextDecoration, type TextAlign, type TextTransform, type FontWeight, } from './schema/PText/pText.definition';
-export { pTextAreaDefinition, defaultTextAreaProps } from './schema/PTextArea/pTextArea.definition';
-export { pTextFieldDefinition, defaultTextFieldProps } from './schema/PTextField/pTextField.definition';
-export { pVideoDefinition, defaultVideoProps } from './schema/PVideo/pVideo.definition';
+export { defaultLinkSettings, linkHistoryLabels, linkSettingsShape, linkRelAttribute, toLinkAttributes, LINK_RELS, type LinkSettings, type LinkRel, } from './schema/linkSettings';
+export { pArticleDefinition, defaultArticleProps, ARTICLE_LAYOUTS, ARTICLE_EXCERPT_LINES, type ArticleLayout, type ArticleExcerptLines, type PArticleDocumentProps, } from './elements/article/definition';
+export { pButtonDefinition, defaultButtonProps, type ButtonStyle, type PButtonDocumentProps, } from './elements/button/definition';
+export { pCheckboxDefinition, defaultCheckboxProps } from './elements/checkbox/definition';
+export { pContainerDefinition, defaultContainerStyle } from './elements/container/definition';
+export { pNavDefinition, defaultNavProps, NAV_POSITIONS, NAV_ALIGNMENTS, NAV_MOBILE_MENUS, NAV_COLLAPSE_AT, NAV_HEIGHTS, type NavPosition, type NavAlignment, type NavMobileMenu, type NavCollapseAt, type NavHeight, type NavItem, type NavCta, type PNavDocumentProps, } from './elements/nav/definition';
+export { pFooterDefinition, defaultFooterProps, defaultFooterStyle, type FooterLinkItem, type FooterLinkGroup, type FooterSocialLink, type PFooterDocumentProps, } from './elements/footer/definition';
+export { pDividerDefinition, defaultDividerProps, type DividerSize } from './elements/divider/definition';
+export { pIconDefinition, defaultIconProps, iconSizes, iconShapes, type IconSize, type IconShape, type PIconDocumentProps, } from './elements/icon/definition';
+export { pImageDefinition, defaultImageProps, IMAGE_LENGTH_KEYS, IMAGE_PREFIX, IMAGE_ASPECT_RATIOS, IMAGE_OBJECT_FITS, IMAGE_OBJECT_POSITIONS, IMAGE_SHADOWS, IMAGE_CAPTION_ALIGNS, type ImageStyle, type ImageLengthKey, type ImageAspectRatio, type ImageObjectFit, type ImageObjectPosition, type ImageShadow, type ImageCaptionAlign, type PImageDocumentProps, } from './elements/image/definition';
+export { pListDefinition, defaultListProps } from './elements/list/definition';
+export { pPageDefinition, type PPageRootProps } from './elements/page/definition';
+export { pRadioDefinition, defaultRadioProps } from './elements/radio/definition';
+export { pRichTextDefinition, defaultRichTextProps } from './elements/rich-text/definition';
+export { isFontFamily } from './elements/rich-text/richTextMarks';
+export { normalizeRichText, richTextToPlainText } from './elements/rich-text/richTextOptions';
+export { pSectionDefinition, defaultSectionStyle } from './elements/section/definition';
+export { pSelectDefinition, defaultSelectProps } from './elements/select/definition';
+export { pTableDefinition, defaultTableProps, fitRowsToHeaders, type TableRow } from './elements/table/definition';
+export { pTextDefinition, defaultTextProps, textStyleDefinitions, TEXT_PREFIX, TEXT_DECORATIONS, TEXT_ALIGNS, TEXT_TRANSFORMS, FONT_WEIGHTS, type TextStyle, type PTextDocumentProps, type TextDecoration, type TextAlign, type TextTransform, type FontWeight, } from './elements/text/definition';
+export { pHeadingDefinition, defaultHeadingProps, HEADING_LEVELS, HEADING_PREFIX, type HeadingLevel, type PHeadingDocumentProps, } from './elements/heading/definition';
+export { pTextAreaDefinition, defaultTextAreaProps } from './elements/text-area/definition';
+export { pTextFieldDefinition, defaultTextFieldProps } from './elements/text-field/definition';
+export { pVideoDefinition, defaultVideoProps, VIDEO_SOURCES, VIDEO_PRELOADS, VIDEO_ASPECT_RATIOS, type VideoSource, type VideoPreload, type VideoAspectRatio, type VideoCaptionTrack, type PVideoDocumentProps, } from './elements/video/definition';
+export { parseYoutubeId, youtubeEmbedUrl, youtubeThumbnailUrl, } from './elements/video/youtube';
 export type { ColorValue } from './schema/Fields/ColorField/color-value';
 export { toHexAlpha, fromHexAlpha } from './schema/Fields/ColorField/color-value';
+export type { StyleColor, PaletteColor, SpacingToken, TextSizeToken, ColorName, } from './render/styleTokens';
+export { SPACING_TOKENS, TEXT_SIZE_TOKENS, COLOR_NAMES, OPACITY_STEPS, toSpacingToken, toTextSizeToken, toPaletteColor, isPaletteColor, } from './render/styleTokens';
+export { styleToClasses, unresolvedStyleForVars, pageTokensToVarValues } from './render/styleToClasses';
 export type { BackgroundStyle } from './schema/Fields/BackgroundField/backgroundValue';
 export { isSafeGradientArgs, gradientToCss } from './schema/Fields/BackgroundField/backgroundValue';
 export { FONT_STYLES, type FontStyle } from './schema/Fields/FontStyleField';
-export { NO_ICON, isOutlineIconName, labelForIcon } from './schema/Fields/IconPicker/iconCatalog';
+export { NO_ICON, HEROICON_NAMES, isHeroiconName, labelForIcon, type HeroiconName, } from './schema/Fields/IconPicker/iconCatalog';
 export { BORDER_LINE_STYLES, FLEX_DIRECTIONS, FLEX_WRAPS, FLEX_JUSTIFY_CONTENTS, FLEX_ALIGN_ITEMS, FLEX_ALIGN_CONTENTS, defaultElementStyle, LENGTH_PATTERN, sanitizeLength, sanitizeAutoAsZero, sanitizeMaxLength, sanitizeBorderWidth, elementStyleToCssVariables, type BorderLineStyle, type FlexDirection, type FlexWrap, type FlexJustifyContent, type FlexAlignItems, type FlexAlignContent, type ElementLayout, type ElementOverflow, type GridColumnCount, type ElementStyleKind, type ElementStyle, } from './schema/style/elementStyle';
 export { backgroundStyleToCssVariables } from './schema/style/backgroundStyle';
 export { colorValueToCss, textSizeToCss } from './schema/style/page-styles';
-export { builderDevices, builderViewports, deviceForWidth, orientationForWidth, type DeviceName, type Orientation, type ViewportSize, type BuilderDevice, } from './schema/device/devices';
+export { builderDevices, builderViewports, deviceMediaQueries, deviceForWidth, orientationForWidth, type DeviceName, type Orientation, type ViewportSize, type BuilderDevice, } from './schema/device/devices';
 export { deviceStyleProp, deviceOverride, changedStyle, resolveDeviceStyle, type DeviceStyleProp, type DeviceStyles, } from './schema/device/deviceStyle';