@modernpoacher/sprockets 0.0.287 → 1.0.0

package/src/js/components/common/text-content/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/components/common/text-content'
+export * from '#sprockets/components/common/text-content'

package/src/{components → js/components}/common/text-content/index.d.mts

@@ -1,9 +1,7 @@
 declare module '#sprockets/components/common/text-content' {
   import type React from 'react'
 
-  export interface TextContentProps {
-    textContent: string
-  }
+  export type TextContentProps = SprocketsTypes.Components.Common.TextContent.TextContentProps
 
   export default function TextContent (props: TextContentProps): React.JSX.Element | null
 }

package/src/{components → js/components}/common/text-content/index.jsx

@@ -1,15 +1,16 @@
 /**
- * TextContent component
- *
- * @typedef {import('@modernpoacher/sprockets/components/common/text-content').TextContentProps} TextContentProps
+ *  @typedef {SprocketsTypes.Components.Common.TextContent.TextContentProps} TextContentProps
  */
 
+/**
+ *  TextContent component
+ */
 import React from 'react'
 import PropTypes from 'prop-types'
 
 /**
- * @param {TextContentProps}
- * @returns {React.JSX.Element | null}
+ *  @param {TextContentProps} props
+ *  @returns {React.JSX.Element | null}
  */
 export default function TextContent ({ textContent }) {
   if (textContent) {
@@ -24,5 +25,5 @@ export default function TextContent ({ textContent }) {
 }
 
 TextContent.propTypes = {
-  textContent: PropTypes.string.isRequired
+  textContent: PropTypes.string
 }

package/src/{components → js/components}/common/visually-hidden-text/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/sprockets/components/common/visually-hidden-te
 log('`sprockets` is awake')
 
 const {
-  default: component
+  default: VisuallyHiddenText
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = VisuallyHiddenText

package/src/js/components/common/visually-hidden-text/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/components/common/visually-hidden-text'
+export * from '#sprockets/components/common/visually-hidden-text'

package/src/{components → js/components}/common/visually-hidden-text/index.d.mts

@@ -1,9 +1,7 @@
 declare module '#sprockets/components/common/visually-hidden-text' {
   import type React from 'react'
 
-  export interface VisuallyHiddenTextProps {
-    visuallyHiddenText: string
-  }
+  export type VisuallyHiddenTextProps = SprocketsTypes.Components.Common.VisuallyHiddenText.VisuallyHiddenTextProps
 
   export default function VisuallyHiddenText (props: VisuallyHiddenTextProps): React.JSX.Element | null
 }

package/src/{components → js/components}/common/visually-hidden-text/index.jsx

@@ -1,15 +1,16 @@
 /**
- * VisuallyHiddenText component
- *
- * @typedef {import('@modernpoacher/sprockets/components/common/visually-hidden-text').VisuallyHiddenTextProps} VisuallyHiddenTextProps
+ *  @typedef {SprocketsTypes.Components.Common.VisuallyHiddenText.VisuallyHiddenTextProps} VisuallyHiddenTextProps
  */
 
+/**
+ *  VisuallyHiddenText component
+ */
 import React from 'react'
 import PropTypes from 'prop-types'
 
 /**
- * @param {VisuallyHiddenTextProps}
- * @returns {React.JSX.Element | null}
+ *  @param {VisuallyHiddenTextProps} props
+ *  @returns {React.JSX.Element | null}
  */
 export default function VisuallyHiddenText ({ visuallyHiddenText }) {
   if (visuallyHiddenText) {
@@ -24,5 +25,5 @@ export default function VisuallyHiddenText ({ visuallyHiddenText }) {
 }
 
 VisuallyHiddenText.propTypes = {
-  visuallyHiddenText: PropTypes.string.isRequired
+  visuallyHiddenText: PropTypes.string
 }

package/src/{components → js/components}/description/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/sprockets/components/description')
 log('`sprockets` is awake')
 
 const {
-  default: component
+  default: Description
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Description

package/src/js/components/description/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/components/description'
+export * from '#sprockets/components/description'

package/src/{components → js/components}/description/index.d.mts

@@ -1,11 +1,6 @@
 declare module '#sprockets/components/description' {
-  import React from 'react'
-
-  export interface DescriptionProps {
-    description: string
-  }
-
-  export default class Description extends React.Component<DescriptionProps> {}
+  export { default } from '#sprockets/super/components/description'
+  export * from '#sprockets/super/components/description'
 }
 
 declare module '@modernpoacher/sprockets/components/description' {

package/src/js/components/description/index.jsx

@@ -0,0 +1,5 @@
+/**
+ *  Description component
+ */
+
+export { default } from '#sprockets/super/components/description'

package/src/{components → js/components}/error-message/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/sprockets/components/error-message')
 log('`sprockets` is awake')
 
 const {
-  default: component
+  default: ErrorMessage
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = ErrorMessage

package/src/js/components/error-message/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/components/error-message'
+export * from '#sprockets/components/error-message'

package/src/{components → js/components}/error-message/index.d.mts

@@ -1,11 +1,6 @@
 declare module '#sprockets/components/error-message' {
-  import React from 'react'
-
-  export interface ErrorMessageProps {
-    errorMessage: string
-  }
-
-  export default class ErrorMessage extends React.Component<ErrorMessageProps> {}
+  export { default } from '#sprockets/super/components/error-message'
+  export * from '#sprockets/super/components/error-message'
 }
 
 declare module '@modernpoacher/sprockets/components/error-message' {

package/src/js/components/error-message/index.jsx

@@ -0,0 +1,5 @@
+/**
+ *  ErrorMessage component
+ */
+
+export { default } from '#sprockets/super/components/error-message'

package/src/{components → js/components}/group/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/sprockets/components/group')
 log('`sprockets` is awake')
 
 const {
-  default: component
+  default: Group
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Group

package/src/js/components/group/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/components/group'
+export * from '#sprockets/components/group'

package/src/js/components/group/index.d.mts

@@ -0,0 +1,9 @@
+declare module '#sprockets/components/group' {
+  export { default } from '#sprockets/super/components/group'
+  export * from '#sprockets/super/components/group'
+}
+
+declare module '@modernpoacher/sprockets/components/group' {
+  export { default } from '#sprockets/components/group'
+  export * from '#sprockets/components/group'
+}

package/src/js/components/group/index.jsx

@@ -0,0 +1,5 @@
+/**
+ *  Group component
+ */
+
+export { default } from '#sprockets/super/components/group'

package/src/js/components/index.cjs

@@ -0,0 +1,32 @@
+require('@babel/register')({
+  ignore: [
+    /node_modules\/(?!@modernpoacher\/cogs|@modernpoacher\/sprockets|@modernpoacher\/gremlins)/
+  ]
+})
+
+const debug = require('debug')
+
+const log = debug('@modernpoacher/sprockets/components')
+
+log('`sprockets` is awake')
+
+const {
+  default: Description
+} = require('./description/index.jsx')
+
+const {
+  default: ErrorMessage
+} = require('./error-message/index.jsx')
+
+const {
+  default: Group
+} = require('./group/index.jsx')
+
+const {
+  default: Title
+} = require('./title/index.jsx')
+
+module.exports.Description = Description
+module.exports.ErrorMessage = ErrorMessage
+module.exports.Group = Group
+module.exports.Title = Title

package/src/js/components/index.d.cts

@@ -0,0 +1,4 @@
+export { default as Description } from '#sprockets/components/description'
+export { default as ErrorMessage } from '#sprockets/components/error-message'
+export { default as Group } from '#sprockets/components/group'
+export { default as Title } from '#sprockets/components/title'

package/src/js/components/index.d.mts

@@ -0,0 +1,4 @@
+export { default as Description } from '#sprockets/components/description'
+export { default as ErrorMessage } from '#sprockets/components/error-message'
+export { default as Group } from '#sprockets/components/group'
+export { default as Title } from '#sprockets/components/title'

package/src/js/components/index.mjs

@@ -0,0 +1,10 @@
+import debug from 'debug'
+
+const log = debug('@modernpoacher/sprockets/components')
+
+log('`sprockets` is awake')
+
+export { default as Description } from './description/index.cjs'
+export { default as ErrorMessage } from './error-message/index.cjs'
+export { default as Group } from './group/index.cjs'
+export { default as Title } from './title/index.cjs'

package/src/{components → js/components}/title/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/sprockets/components/title')
 log('`sprockets` is awake')
 
 const {
-  default: component
+  default: Title
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Title

package/src/js/components/title/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/components/title'
+export * from '#sprockets/components/title'

package/src/{components → js/components}/title/index.d.mts

@@ -1,11 +1,6 @@
 declare module '#sprockets/components/title' {
-  import React from 'react'
-
-  export interface TitleProps {
-    title: string
-  }
-
-  export default class Title extends React.Component<TitleProps> {}
+  export { default } from '#sprockets/super/components/title'
+  export * from '#sprockets/super/components/title'
 }
 
 declare module '@modernpoacher/sprockets/components/title' {

package/src/js/components/title/index.jsx

@@ -0,0 +1,5 @@
+/**
+ *  Title component
+ */
+
+export { default } from '#sprockets/super/components/title'

package/src/js/index.d.cts

@@ -0,0 +1,34 @@
+import type CheckAnswersSprocket from '#sprockets/sprockets/check-answers'
+
+import type {
+  CheckAnswersProps
+} from '#sprockets/sprockets/check-answers'
+
+import type ErrorSummarySprocket from '#sprockets/sprockets/error-summary'
+
+import type {
+  ErrorSummaryProps
+} from '#sprockets/sprockets/error-summary'
+
+import type FieldsetSprocket from '#sprockets/sprockets/fieldset'
+
+import type {
+  FieldsetProps
+} from '#sprockets/sprockets/fieldset'
+
+export type AnswerDefinitionType = SprocketsTypes.AnswerDefinitionType
+export type FieldChangeType = SprocketsTypes.FieldChangeType
+export type ErrorDefinitionType = SprocketsTypes.ErrorDefinitionType
+export type FieldErrorType = SprocketsTypes.FieldErrorType
+
+export { default as CheckAnswersSprocket } from '#sprockets/sprockets/check-answers'
+export { default as ErrorSummarySprocket } from '#sprockets/sprockets/error-summary'
+export { default as FieldsetSprocket } from '#sprockets/sprockets/fieldset'
+
+declare const sprockets: {
+  CheckAnswersSprocket: CheckAnswersSprocket<CheckAnswersProps>
+  ErrorSummarySprocket: ErrorSummarySprocket<ErrorSummaryProps>
+  FieldsetSprocket: FieldsetSprocket<FieldsetProps>
+}
+
+export default sprockets

package/src/js/index.d.mts

@@ -0,0 +1,34 @@
+import type CheckAnswersSprocket from '#sprockets/sprockets/check-answers'
+
+import type {
+  CheckAnswersProps
+} from '#sprockets/sprockets/check-answers'
+
+import type ErrorSummarySprocket from '#sprockets/sprockets/error-summary'
+
+import type {
+  ErrorSummaryProps
+} from '#sprockets/sprockets/error-summary'
+
+import type FieldsetSprocket from '#sprockets/sprockets/fieldset'
+
+import type {
+  FieldsetProps
+} from '#sprockets/sprockets/fieldset'
+
+export type AnswerDefinitionType = SprocketsTypes.AnswerDefinitionType
+export type FieldChangeType = SprocketsTypes.FieldChangeType
+export type ErrorDefinitionType = SprocketsTypes.ErrorDefinitionType
+export type FieldErrorType = SprocketsTypes.FieldErrorType
+
+export { default as CheckAnswersSprocket } from '#sprockets/sprockets/check-answers'
+export { default as ErrorSummarySprocket } from '#sprockets/sprockets/error-summary'
+export { default as FieldsetSprocket } from '#sprockets/sprockets/fieldset'
+
+declare const sprockets: {
+  CheckAnswersSprocket: CheckAnswersSprocket<CheckAnswersProps>
+  ErrorSummarySprocket: ErrorSummarySprocket<ErrorSummaryProps>
+  FieldsetSprocket: FieldsetSprocket<FieldsetProps>
+}
+
+export default sprockets

package/src/js/sprockets/check-answers/group/answer-item.d.cts

@@ -0,0 +1 @@
+export { default } from '#sprockets/sprockets/check-answers/group/answer-item'

package/src/js/sprockets/check-answers/group/answer-item.d.mts

@@ -0,0 +1,11 @@
+declare module '#sprockets/sprockets/check-answers/group/answer-item' {
+  import type React from 'react'
+
+  type AnswerDefinitionType = SprocketsTypes.AnswerDefinitionType
+
+  export default function AnswerItem (props: AnswerDefinitionType): React.JSX.Element
+}
+
+declare module '@modernpoacher/sprockets/sprockets/check-answers/group/answer-item' {
+  export { default } from '#sprockets/sprockets/check-answers/group/answer-item'
+}

package/src/{sprockets → js/sprockets}/check-answers/group/answer-item.jsx

@@ -1,3 +1,7 @@
+/**
+ *  @typedef {SprocketsTypes.AnswerDefinitionType} AnswerDefinitionType
+ */
+
 import React from 'react'
 import PropTypes from 'prop-types'
 
@@ -5,6 +9,11 @@ import AnswerTitle from './answer-title.jsx'
 import AnswerValue from './answer-value.jsx'
 import ChangeAnswer from './change-answer.jsx'
 
+/**
+ *
+ *  @param {AnswerDefinitionType} props
+ *  @returns {React.JSX.Element}
+ */
 export default function AnswerItem ({ answer: { title, value }, changeAnswer: { href, text, visuallyHiddenText } }) {
   return (
     <div className='answer'>

package/src/{sprockets → js/sprockets}/check-answers/group/answer-title.cjs

@@ -10,4 +10,5 @@ const log = debug('@modernpoacher/sprockets/sprockets/check-answers/group/answer
 
 log('`sprockets` is awake')
 
+// @ts-ignore
 module.exports = require('./answer-title.jsx')

package/src/js/sprockets/check-answers/group/answer-title.d.cts

@@ -0,0 +1 @@
+export { default } from '#sprockets/sprockets/check-answers/group/answer-title'

package/src/js/sprockets/check-answers/group/answer-title.d.mts

@@ -0,0 +1,9 @@
+declare module '#sprockets/sprockets/check-answers/group/answer-title' {
+  import type React from 'react'
+
+  export default function AnswerItem (props: { title: string }): React.JSX.Element
+}
+
+declare module '@modernpoacher/sprockets/sprockets/check-answers/group/answer-title' {
+  export { default } from '#sprockets/sprockets/check-answers/group/answer-title'
+}

package/src/{sprockets → js/sprockets}/check-answers/group/answer-title.jsx

@@ -2,8 +2,8 @@ import React from 'react'
 import PropTypes from 'prop-types'
 
 /**
- * @param {SprocketsTypes.AnswerDefinitionType}
- * @returns {React.JSX.Element}
+ *  @param {{ title: string }} props
+ *  @returns {React.JSX.Element}
  */
 export default function AnswerTitle ({ title }) {
   return (

package/src/{sprockets → js/sprockets}/check-answers/group/answer-value.cjs

@@ -10,4 +10,5 @@ const log = debug('@modernpoacher/sprockets/sprockets/check-answers/group/answer
 
 log('`sprockets` is awake')
 
+// @ts-ignore
 module.exports = require('./answer-value.jsx')

package/src/js/sprockets/check-answers/group/answer-value.d.cts

@@ -0,0 +1 @@
+export { default } from '#sprockets/sprockets/check-answers/group/answer-value'

package/src/js/sprockets/check-answers/group/answer-value.d.mts

@@ -0,0 +1,9 @@
+declare module '#sprockets/sprockets/check-answers/group/answer-value' {
+  import type React from 'react'
+
+  export default function AnswerValue (props: { value: string | string[] }): React.JSX.Element
+}
+
+declare module '@modernpoacher/sprockets/sprockets/check-answers/group/answer-value' {
+  export { default } from '#sprockets/sprockets/check-answers/group/answer-value'
+}

package/src/js/sprockets/check-answers/group/answer-value.jsx

@@ -0,0 +1,63 @@
+import React from 'react'
+import PropTypes from 'prop-types'
+
+/**
+ *  @param {number} n
+ *  @returns {(
+ *    a: Array<string | React.JSX.Element>,
+ *    v: string,
+ *    i: number
+ *  ) => Array<string | React.JSX.Element>}
+ */
+function getReduce (n) {
+  /**
+   *  @param {Array<string | React.JSX.Element>} a
+   *  @param {string} v
+   *  @param {number} i
+   *  @returns {Array<string | React.JSX.Element>}
+   */
+  return function reduce (a, v, i) {
+    const s = String(v)
+
+    return (i !== n)
+      ? a.concat(s).concat(<br key={i} />)
+      : a.concat(s)
+  }
+}
+
+/**
+ *  @param {string | string[]} value
+ *  @returns {string | Array<string | React.JSX.Element>}
+ */
+function getAnswerValue (value) {
+  if (Array.isArray(value)) {
+    const n = value.length - 1
+
+    return (
+      value.reduce(getReduce(n), [])
+    )
+  }
+
+  return String(value)
+}
+
+/**
+ *  @param {{ value: string | string[] }} props
+ *  @returns {React.JSX.Element}
+ */
+export default function AnswerValue ({ value }) {
+  return (
+    <dd className='answer-value'>
+      {getAnswerValue(value)}
+    </dd>
+  )
+}
+
+AnswerValue.propTypes = {
+  value: PropTypes.oneOfType([
+    PropTypes.string,
+    PropTypes.arrayOf(
+      PropTypes.string
+    )
+  ]).isRequired
+}

package/src/{sprockets → js/sprockets}/check-answers/group/change-answer.cjs

@@ -10,4 +10,5 @@ const log = debug('@modernpoacher/sprockets/sprockets/check-answers/group/change
 
 log('`sprockets` is awake')
 
+// @ts-ignore
 module.exports = require('./change-answer.jsx')

package/src/js/sprockets/check-answers/group/change-answer.d.cts

@@ -0,0 +1 @@
+export { default } from '#sprockets/sprockets/check-answers/group/answer-value'

package/src/js/sprockets/check-answers/group/change-answer.d.mts

@@ -0,0 +1,9 @@
+declare module '#sprockets/sprockets/check-answers/group/change-answer' {
+  import type React from 'react'
+
+  export default function ChangeAnswer (props: { href: string; text: string; visuallyHiddenText?: string }): React.JSX.Element
+}
+
+declare module '@modernpoacher/sprockets/sprockets/check-answers/group/change-answer' {
+  export { default } from '#sprockets/sprockets/check-answers/group/change-answer'
+}

package/src/{sprockets → js/sprockets}/check-answers/group/change-answer.jsx

@@ -12,6 +12,10 @@ import VisuallyHiddenText from '#sprockets/components/common/visually-hidden-tex
 
 const log = debug('@modernpoacher/sprockets/sprockets/check-answers/group/change-answer')
 
+/**
+ *  @param {{ textContent?: string, visuallyHiddenText: string }} props
+ *  @returns {React.JSX.Element | null}
+ */
 function TextContentWithVisuallyHiddenText ({ textContent, visuallyHiddenText }) {
   return (
     <>
@@ -23,10 +27,14 @@ function TextContentWithVisuallyHiddenText ({ textContent, visuallyHiddenText })
 }
 
 TextContentWithVisuallyHiddenText.propTypes = {
-  textContent: PropTypes.string.isRequired,
-  visuallyHiddenText: PropTypes.string.isRequired
+  textContent: PropTypes.string,
+  visuallyHiddenText: PropTypes.string
 }
 
+/**
+ *  @param {{ textContent?: string, visuallyHiddenText?: string }} props
+ *  @returns {React.JSX.Element | null}
+ */
 function LinkText ({ textContent, visuallyHiddenText }) {
   if (textContent) {
     return (
@@ -35,18 +43,20 @@ function LinkText ({ textContent, visuallyHiddenText }) {
         : <TextContent textContent={textContent} />
     )
   }
+
+  return null
 }
 
 LinkText.propTypes = {
-  textContent: PropTypes.string.isRequired,
-  visuallyHiddenText: PropTypes.string.isRequired
+  textContent: PropTypes.string,
+  visuallyHiddenText: PropTypes.string
 }
 
 /**
- * @param {SprocketsTypes.AnswerDefinitionType}
- * @returns {React.JSX.Element}
+ *  @param {{ href: string, text: string, visuallyHiddenText?: string }} props
+ *  @returns {React.JSX.Element}
  */
-export default function ChangeAnswer ({ changeAnswer: { href, text, visuallyHiddenText } }) {
+export default function ChangeAnswer ({ href, text, visuallyHiddenText }) {
   log('ChangeAnswer')
 
   return (
@@ -59,9 +69,7 @@ export default function ChangeAnswer ({ changeAnswer: { href, text, visuallyHidd
 }
 
 ChangeAnswer.propTypes = {
-  changeAnswer: PropTypes.shape({
-    href: PropTypes.string.isRequired,
-    text: PropTypes.string.isRequired,
-    visuallyHiddenText: PropTypes.string.isRequired
-  }).isRequired
+  href: PropTypes.string.isRequired,
+  text: PropTypes.string.isRequired,
+  visuallyHiddenText: PropTypes.string
 }

package/src/{sprockets → js/sprockets}/check-answers/group/index.cjs

@@ -11,7 +11,10 @@ const log = debug('@modernpoacher/sprockets/sprockets/check-answers/group')
 log('`sprockets` is awake')
 
 const {
-  default: component
+  default: Group
 } = require('./index.jsx')
 
-module.exports = component
+/**
+ *  Exports only default
+ */
+module.exports = Group

package/src/js/sprockets/check-answers/group/index.d.cts

@@ -0,0 +1,2 @@
+export { default } from '#sprockets/sprockets/check-answers/group'
+export * from '#sprockets/sprockets/check-answers/group'