@silexlabs/silex 3.0.0-alpha.100

package/src/ts/client/grapesjs/settings.ts

@@ -0,0 +1,208 @@
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import {html, render} from 'lit-html'
+import {live} from 'lit-html/directives/live.js'
+import * as grapesjs from 'grapesjs/dist/grapes.min.js'
+
+import { WebsiteSettings } from '../../types'
+
+const pluginName = 'settings-dialog'
+const el = document.createElement('div')
+let modal
+
+// Get version from webpack (see plugin in webpack.config.js)
+declare const VERSION: string
+
+export const cmdOpenSettings = 'open-settings'
+
+let version = 'v3'
+export const settingsDialog = grapesjs.plugins.add(pluginName, (editor, opts) => {
+  // Display Silex version from package.json
+  try {
+    version = VERSION
+  } catch (error) {
+    // Cannot get version from webpack (see plugin in webpack.config.js)
+  }
+  console.info('Silex version:', version)
+  editor.Commands.add(cmdOpenSettings, {
+    run: (_, sender, {page}) => {
+      modal = editor.Modal.open({
+        title: page ? 'Page settings' : 'Site Settings',
+        content: '',
+        attributes: { class: 'settings-dialog' },
+      })
+        .onceClose(() => {
+          sender.set('active', 0) // Deactivate the button to make it ready to be clicked again
+          editor.stopCommand(cmdOpenSettings) // apparently this is needed to be able to run the command several times
+        })
+      displaySettings(editor, opts, page)
+      modal.setContent(el)
+      const form = el.querySelector('form')
+      form.onsubmit = event => {
+        event.preventDefault()
+        saveSettings(editor, opts, page)
+        editor.stopCommand(cmdOpenSettings)
+      }
+      form.querySelector('input')?.focus()
+      return modal
+    },
+    stop: () => {
+      modal.close()
+    },
+  })
+  // add settings to the website
+  editor.on('storage:start:store', (data) => {
+    data.settings = editor.getModel().get('settings')
+    data.name = editor.getModel().get('name')
+  })
+  editor.on('storage:end:load', (data) => {
+    const model = editor.getModel()
+    model.set('settings', data.settings || {})
+    model.set('name', data.name)
+    updateDom(editor)
+  })
+  editor.on('page', (e) => {
+    editor.Canvas.getFrameEl().addEventListener('load', () => {
+      updateDom(editor)
+    })
+  })
+})
+
+// Is the model a site or a page?
+function isSite(model) { return !!model.getHtml }
+
+function displaySettings(editor, config, model = editor.getModel()) {
+  const settings = model.get('settings') || {} as WebsiteSettings
+  model.set('settings', settings)
+  render(html`
+    <p>The page settings will override site settings, <a href="https://github.com/silexlabs/Silex/wiki/Settings" target="_blank">more info about settings here</a>.</p>
+    <form class="silex-form">
+      <h2>General settings</h2>
+      <div class="silex-form__group col2">
+        <label class="silex-form__element">
+          <h3>${isSite(model) ? 'Site name' : 'Page name'}</h3>
+          <p>${isSite(model) ? 'The project name in the editor, for you and your team.' : 'Label of the page in the editor, and file name of the HTML page.'}</p>
+          <input type="text" name="name" .value=${live(model.get('name') || '')}/>
+        </label>
+        <label class="silex-form__element">
+          <h3>Website language</h3>
+          <p>This is the default language code for this website. Example: en, fr, es...</p>
+          <input type="text" name="lang" .value=${live(settings.lang || '')}/>
+        </label>
+        <label class="silex-form__element">
+          <h3>Title</h3>
+          <p>Title of the browser window, and title in the search engines results. It is used by search engines to find out what your site is talking about. The title should be a maximum of 70 characters long, including spaces.</p>
+          <input type="text" name="title" .value=${live(settings.title || '')}/>
+        </label>
+        <label class="silex-form__element">
+          <h3>Description</h3>
+          <p>Description displayed by the search engines in search results. It is used by search engines to find out what your site is talking about. It is best to keep meta descriptions between 150 and 160 characters.</p>
+          <input type="text" name="description" .value=${live(settings.description || '')}/>
+        </label>
+        <label class="silex-form__element">
+          <h3>Favicon</h3>
+          <p>Small image displayed in the browser's address bar and in tabs. The recommended size is 16×16 or 32×32 pixels. This can be a URL or a relative path.</p>
+          <input type="text" name="favicon" .value=${live(settings.favicon || '')}/>
+        </label>
+      </div>
+      <h2>Social networks sharing</h2>
+      <div>
+        <p>Once your website is live, you can use these tools to test sharing:&nbsp;<a target="_blank" href="https://developers.facebook.com/tools/debug/">Facebook</a>,
+        <a target="_blank" href="https://cards-dev.twitter.com/validator">Twitter</a>,
+        <a target="_blank" href="https://www.linkedin.com/post-inspector/inspect/">Linkedin</a></p>
+      </div>
+      <div class="silex-form__group col2">
+        <label class="silex-form__element">
+          <h3>Title</h3>
+          <p>The title of your website displayed when a user shares your website on a social network.
+        Do not include any branding in this title, just eye-catching phrase, e.g. "Learn everything about fishing".
+        Title should be between 60 and 90 characters long.</p>
+          <input type="text" name="og:title" .value=${live(settings['og:title'] || '')}/>
+        </label>
+        <label class="silex-form__element">
+          <h3>Description</h3>
+          <p>Description displayed when a user shares your website on a social network. Make it catchy, and invite readers to visit your website too, e.g. "Sam's website about fishing, check it out!" Title should be between 60 and 90 characters long.</p>
+          <input type="text" name="og:description" .value=${live(settings['og:description'] || '')}/>
+        </label>
+        <label class="silex-form__element">
+          <h3>Image</h3>
+          <p>Thumbnail image which is displayed when your website is shared on a social network. The optimal size is 1200×627 pixels. At this size, your thumbnail will be big and stand out from the crowd. But do not exceed the 5MB size limit. If you use an image that is smaller than 400 pixels x 209 pixels, it will render as a much smaller thumbnail.</p>
+          <p>Please enter the full URL here, e.g. "http://mysite.com/path/to/image.jpg"</p>
+          <input type="text" name="og:image" .value=${live(settings['og:image'] || '')}/>
+        </label>
+      </div>
+      <h2>Code</h2>
+      <div class="silex-form__group">
+        <label class="silex-form__element">
+          <h3>HTML head</h3>
+          <p>HTML code which will be inserted in the HEAD tag.</p>
+          <textarea name="head" .value=${live(settings.head || '')}></textarea>
+        </label>
+      </div>
+      <footer>
+        <p class="silex-version">Silex ${version}</p>
+        <input class="silex-button" type="button" @click=${e => editor.stopCommand(cmdOpenSettings)} value="Cancel">
+        <input class="silex-button" type="submit" value="Ok">
+      </footer>
+    </form>
+  `, el)
+}
+
+function saveSettings(editor, config, model = editor.getModel()) {
+  const form = el.querySelector('form')
+  const formData = new FormData(form)
+  const data = Array.from(formData as any)
+    .reduce((aggregate, [key, value]) => {
+      aggregate[key] = value
+      return aggregate
+    }, {}) as {[key: string]: any}
+    // take the name out to the main model (by design in grapesjs pages)
+  const { name, ...settings } = data
+  model.set({
+    settings,
+    name,
+  })
+  // save if auto save is on
+  editor.getModel().set('changesCount', editor.getDirtyCount() + 1)
+  // update the DOM
+  updateDom(editor)
+}
+function getHeadContainer(doc, className) {
+  const container = doc.head.querySelector(`.${className}`)
+  if(container) {
+    return container
+  }
+  const newContainer = doc.createElement('div')
+  newContainer.classList.add(className)
+  doc.head.appendChild(newContainer)
+  return newContainer
+}
+function updateDom(editor) {
+  const doc = editor.Canvas.getDocument()
+  if(doc) {
+    // Site head
+    getHeadContainer(doc, 'site-head')
+      .innerHTML = editor.getModel().get('settings').head || ''
+    // Pages head
+    getHeadContainer(doc, 'page-head')
+      .innerHTML = editor.Pages.getSelected().get('settings')?.head || ''
+  } else {
+    // No document??
+  }
+}
+

package/src/ts/client/grapesjs/storage.ts

@@ -0,0 +1,121 @@
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import { ConnectorId, WebsiteId, WebsiteData, ConnectorUser, ConnectorType, ApiError, Asset, Page, Component, Style } from '../../types'
+import { websiteLoad, websiteSave } from '../api'
+import { cmdLogin, eventLoggedIn, eventLoggedOut, getCurrentUser, updateUser } from './LoginDialog'
+import { addTempDataToPages, addTempDataToAssetUrl, addTempDataToStyles, removeTempDataFromAssetUrl, removeTempDataFromPages, removeTempDataFromStyles } from '../assetUrl'
+
+export const storagePlugin = (editor) => {
+  editor.Storage.add('connector', {
+    async load(options: { id: WebsiteId, connectorId: ConnectorId }): Promise<WebsiteData> {
+      try {
+        const user: ConnectorUser = await getCurrentUser(editor) ?? await updateUser(editor, ConnectorType.STORAGE, options.connectorId)
+        if(!user) throw new ApiError('Not logged in', 401)
+        const data = await websiteLoad({websiteId: options.id, connectorId: user.storage.connectorId}) as WebsiteData
+        if(data.assets) data.assets = addTempDataToAssetUrl(data.assets, options.id, user.storage.connectorId)
+        if(data.pages) data.pages = addTempDataToPages(data.pages, options.id, user.storage.connectorId)
+        if(data.styles) data.styles = addTempDataToStyles(data.styles, options.id, user.storage.connectorId)
+        return data
+
+      } catch (err) {
+        if(err.httpStatusCode === 401) {
+          editor.once(eventLoggedIn, async () => {
+            try {
+              editor.StorageManager.setAutosave(false)
+              const data = await editor.Storage.load(options)
+              editor.StorageManager.setAutosave(true)
+              editor.loadProjectData(data)
+            } catch (err) {
+              console.error('connectorPlugin load error', err)
+              throw err
+            }
+          })
+          editor.Commands.run(cmdLogin)
+        }
+        console.error('connectorPlugin load error', err)
+        throw err
+      }
+    },
+
+    async store(data: WebsiteData, options: { id: WebsiteId, connectorId: ConnectorId }) {
+      try {
+        if(await getCurrentUser(editor)) {
+          const user = await getCurrentUser(editor)
+          data.assets = removeTempDataFromAssetUrl(data.assets)
+          data.pages = removeTempDataFromPages(data.pages)
+          data.styles = removeTempDataFromStyles(data.styles)
+          await websiteSave({websiteId: options.id, connectorId: user.storage.connectorId, data})
+        } else {
+          editor.once(eventLoggedIn, () => {
+            return editor.Storage.store()
+          })
+          editor.Commands.run(cmdLogin)
+        }
+      } catch (err) {
+        console.error('connectorPlugin store error', err)
+        throw err
+      }
+    }
+  })
+  // Handle errors
+  editor.on('storage:error:load', (err: Error) => {
+    handleError(err)
+  })
+  editor.on('storage:error:store', (err: Error) => {
+    handleError(err)
+  })
+  editor.on('asset:upload:end', (err: Error) => {
+    editor.store()
+  })
+  editor.on('asset:upload:error', (err: Error) => {
+    handleError(err)
+  })
+  function handleError(_err: Error | string) {
+    const err: Error = typeof _err === 'string' ? JSON.parse(_err) : _err
+    console.error('Error with loading or saving website or uploading asset', err, err instanceof ApiError)
+    if (err instanceof ApiError) {
+      console.error('ApiError', err.httpStatusCode, err.message)
+      switch (err.httpStatusCode) {
+      case 404:
+        return editor.Modal.open({
+          title: 'Website not found',
+
+          content: `This website could not be found.<br><hr>${err.message}`,
+        })
+      case 403:
+        return editor.Modal.open({
+          title: 'Access denied',
+          content: `You are not allowed to access this website.<br><hr>${err.message}`,
+        })
+      case 401:
+        editor.trigger(eventLoggedOut)
+        return
+      default:
+        return editor.Modal.open({
+          title: 'Error',
+          content: `An error occured.<br>${err.message}`,
+        })
+      }
+    } else {
+      return editor.Modal.open({
+        title: 'Error',
+        content: `An error occured.<br>${err.message}`,
+      })
+    }
+  }
+}

package/src/ts/client/grapesjs/symbolDialogs.ts

@@ -0,0 +1,38 @@
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+import * as grapesjs from 'grapesjs/dist/grapes.min.js'
+import { cmdAddSymbol } from '@silexlabs/grapesjs-symbols'
+
+export const cmdPromptAddSymbol = 'symbol-prompt-add'
+
+export default grapesjs.plugins.add(name, (editor, opts) => {
+  function getNext(prefix) {
+    let idx = 1
+    while(editor.Symbols.find(s => s.get('label') === prefix + idx)) {
+      idx++
+    }
+    return prefix + idx
+  }
+  editor.Commands.add(cmdPromptAddSymbol, {
+    run: (_, sender) => {
+      const label = prompt('Label', getNext('Symbol '))
+      const icon = 'fa-gem'
+      editor.runCommand(cmdAddSymbol, { label, icon })
+    }
+  })
+})

package/src/ts/client/index.ts

@@ -0,0 +1,98 @@
+/*
+ * Silex website builder, free/libre no-code tool for makers.
+ * Copyright (c) 2023 lexoyo and Silex Labs foundation
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * @fileoverview
+ * Defines the entry point of Silex client side application
+ *
+ */
+
+import { assetsPublicationTransformer } from './assetUrl'
+import { ClientConfig } from './config'
+import { ClientEvent } from './events'
+import { initEditor, getEditor } from './grapesjs/index'
+
+// Expose API to calling app as window.silex
+export * from './expose'
+
+/**
+ * Start Silex, called from host HTML page with window.silex.start()
+ */
+export async function start(options = {}) {
+  const config = new ClientConfig()
+  Object.assign(config, options)
+
+  // Add the publication transformers which are used to cleanup assets URLs
+  config.addPublicationTransformers(assetsPublicationTransformer)
+
+  // Config file in root folder which may be generated by the server
+  await config.addPlugin(config.clientConfigUrl, {})
+
+  // Debug mode
+  if (config.debug) {
+    console.warn('Silex starting in debug mode.', {config})
+  }
+
+  // Notify plugins that loading is over and Silex is starting
+  config.emit(ClientEvent.STARTUP_START)
+
+  // Init GrapesJS config which depend on the config file properties
+  config.initGrapesConfig()
+
+  // Start grapesjs
+  config.emit(ClientEvent.GRAPESJS_START)
+  try{
+    await initEditor(config.grapesJsConfig)
+  } catch(e) {
+    console.error('Error starting Silex', e)
+    throw e
+  }
+
+  const editor = getEditor()
+
+  // Store the config in the editor
+  editor.getModel().set('config', config)
+
+  // Notify plugins
+  config.emit(ClientEvent.GRAPESJS_END, { editor })
+
+  // Init internationalization module
+  editor.I18n.setLocale(config.lang)
+
+  // Load the site
+  editor.StorageManager.setAutosave(false)
+  try {
+    await editor.load(null)
+  } catch(e) {
+    if(e.httpStatusCode === 401) {
+      // Unauthorized, will try to login
+    } else {
+      // Will display an error message, see in storage.ts
+    }
+  } finally {
+    setTimeout(() => {
+      // This needs time for grapesjs
+      editor.editor.set('changesCount', 0)
+      editor.StorageManager.setAutosave(true)
+
+      // This needs time for the loader to be hidden
+      document.querySelector('.silex-loader').classList.add('silex-dialog-hide')
+      document.querySelector('#gjs').classList.remove('silex-dialog-hide')
+      config.emit(ClientEvent.STARTUP_END, { editor, config })
+    }, 100)
+  }
+}

package/src/ts/client/publication-transformers.test.ts

@@ -0,0 +1,199 @@
+import { jest,  expect, describe, it, beforeEach } from '@jest/globals'
+import { Mock } from 'jest-mock'
+import {
+  renderComponents,
+  renderCssRules,
+  resetRenderComponents,
+  resetRenderCssRules,
+  PublicationTransformer,
+  transformFiles,
+  transformBgImage
+} from './publication-transformers'
+import { ClientConfig } from './config'
+import GrapesJS, { Component, Editor, ObjectStrings, Page } from 'grapesjs'
+import { ClientSideFile, ClientSideFileType, PublicationData } from '../types'
+
+describe('publication-transformers', () => {
+  let mockConfig: ClientConfig
+  let mockFile: ClientSideFile
+  let mockData: PublicationData
+  let transformer: PublicationTransformer
+
+  let editor: Editor
+
+  beforeEach(() => {
+    // Initialize your mocks here
+    editor = GrapesJS.init({
+      headless: true,
+      storageManager: { autoload: false },
+    })
+    expect(editor).not.toBeUndefined()
+    editor.addComponents(`
+      <nav class="parent">
+        <div class="child">Hello world</div>
+      <nav>
+    `)
+    editor.addStyle(`
+      .parent {
+        color: red;
+      }
+      .child {
+        color: blue;
+      }
+    `)
+    mockFile = {
+      path: 'test path',
+      content: 'test content',
+    } as ClientSideFile
+    mockData = {
+      files: [mockFile],
+      pages: [{} as Page],
+    } as any as PublicationData
+    transformer = {
+      renderComponent: jest.fn(),
+      renderCssRule: jest.fn(),
+      transformFile: jest.fn(),
+      transformPermalink: jest.fn(),
+      transformPath: jest.fn(),
+    } as PublicationTransformer
+    mockConfig = { getEditor: jest.fn(() => editor), publicationTransformers: [transformer] } as unknown as ClientConfig
+    editor.getModel().set('config', mockConfig)
+  })
+
+  it('should transform components', () => {
+    const renderComponent = transformer.renderComponent as Mock
+    renderComponent.mockReturnValue('mockHtml')
+    renderComponents(editor)
+    const html = editor.getHtml()
+    expect(renderComponent).toBeCalledTimes(6)
+    const results = renderComponent.mock.calls.map(call => call[0] as Component)
+    const parent = results.find(c => c.getClasses()[0] === 'parent')
+    expect(parent).not.toBeUndefined()
+    const child = results.find(c => c.getClasses()[0] === 'child')
+    expect(child).not.toBeUndefined()
+  })
+
+  it('should reset transformed pages', () => {
+    const renderComponent = transformer.renderComponent as Mock
+    renderComponent.mockReturnValue('mockHtml')
+    renderComponents(editor)
+    resetRenderComponents(editor)
+    const html = editor.getHtml()
+    expect(renderComponent).toBeCalledTimes(0)
+    expect(html).toContain('Hello world')
+  })
+
+  it('should transform styles', () => {
+    const transformCssRule = transformer.renderCssRule as Mock
+    transformCssRule.mockImplementation((rule: any) => {
+      return { color: 'test'+rule.color } as ObjectStrings
+    })
+    renderCssRules(editor)
+    const css = editor.getCss()
+    expect(transformCssRule).toBeCalledTimes(2)
+    const results = transformCssRule.mock.results.map(r => r.value as ObjectStrings)
+    const parent = results.find(c => c.color === 'testred')
+    expect(parent).not.toBeUndefined()
+    const child = results.find(c => c.color === 'testblue')
+    expect(child).not.toBeUndefined()
+    expect(css).toContain('color:test')
+    expect(css).not.toContain('color:blue')
+  })
+
+  it('should reset transformed styles', () => {
+    const renderCssRule = transformer.renderCssRule as Mock
+    const returned = {color: 'test'} as ObjectStrings
+    renderCssRule.mockReturnValue(returned)
+    renderCssRules(editor)
+    resetRenderCssRules(editor)
+    const css = editor.getCss()
+    expect(renderCssRule).toBeCalledTimes(0)
+    expect(css).toContain('color:blue')
+  })
+
+  it('should transform files', () => {
+    const transformFile = transformer.transformFile as Mock
+    const returned = {path: 'test path changed', content: 'test content changed'} as ClientSideFile
+    transformFile.mockReturnValue(returned)
+    expect(mockData.files?.length).toBe(1)
+    if (mockData.files?.length) { // To avoid ! operator on mockData.files and make the lint happy
+      expect(mockData.files[0]).toBe(mockFile)
+      transformFiles(editor, mockData)
+      expect(transformFile).toBeCalledTimes(1)
+      expect(mockData.files[0]).toBe(returned)
+    }
+  })
+  it('should transform permalinks of images src', () => {
+    editor.addComponents(`
+      <img src="test.png">
+    `)
+    const transformPermalink = transformer.transformPermalink as Mock
+    const transformedSrc = 'transformed.png'
+    transformPermalink.mockReturnValue(transformedSrc)
+    renderComponents(editor)
+    const html = editor.getHtml()
+    expect(transformPermalink).toBeCalledTimes(2) // 2x because of c.attributes.src and c.attributes.attributes.src
+    expect(transformPermalink.mock.calls[0][0]).toBe('test.png')
+    expect(transformPermalink.mock.calls[0][1]).toBe('asset')
+  })
+  it('should transform a style rule with background image', () => {
+    expect(transformBgImage(editor, { 'background-image': 'url(test.png)' })).toEqual({ 'background-image': 'url(test.png)' })
+    const transformPermalink = transformer.transformPermalink as Mock
+    const transformedSrc = 'transformed.png'
+    transformPermalink.mockImplementation((url, type) => (url as string).replace('test.png', transformedSrc))
+    expect(transformBgImage(editor, { 'background-image': 'url(test.png)' })).toEqual({ 'background-image': 'url(transformed.png)' })
+    expect(transformBgImage(editor, { 'background-image': 'url("test.png")' })).toEqual({ 'background-image': 'url(transformed.png)' })
+  })
+
+  it('should transform permalinks of background images in inline css', () => {
+    const el = document.createElement('div')
+    const [comp] = editor.addComponents(el)
+    comp.setStyle({ 'background-image': 'url(test.png)' })
+    //editor.addComponents(`
+    //  <div style="color: black; background-image: url(test.png);"></div>
+    //`)
+    const transformPermalink = transformer.transformPermalink as Mock
+    const transformedSrc = 'transformed.png'
+    transformPermalink.mockReturnValue(transformedSrc)
+    renderComponents(editor)
+    const css = editor.getCss()
+    expect(transformPermalink).toBeCalledTimes(1)
+    expect(transformPermalink.mock.calls[0][0]).toBe('test.png')
+    expect(transformPermalink.mock.calls[0][1]).toBe('asset')
+    expect(css).toContain('url(test.png)')
+  })
+  it('should transform permalinks of background images in styles', () => {
+    editor.addComponents(`
+      <div class="test"></div>
+    `)
+    editor.addStyle(`
+      .test {
+        background-image: url(test.png);
+      }
+    `)
+    const transformPermalink = transformer.transformPermalink as Mock
+    const transformedSrc = 'transformed.png'
+    transformPermalink.mockReturnValue(transformedSrc)
+    renderCssRules(editor)
+    const css = editor.getCss()
+    expect(transformPermalink).toBeCalledTimes(1)
+    expect(transformPermalink.mock.calls[0][0]).toBe('test.png')
+    expect(transformPermalink.mock.calls[0][1]).toBe('asset')
+    expect(css).toContain(`url(${transformedSrc})`)
+  })
+  it('should transform links to pages to match permalinks ', () => {
+    editor.addComponents(`
+      <a href="./index.html">test</a>
+    `)
+    const transformPermalink = transformer.transformPermalink as Mock
+    const transformedPermalink = './transformed-page.html'
+    transformPermalink.mockReturnValue(transformedPermalink)
+    renderComponents(editor)
+    const html = editor.getHtml()
+    expect(transformPermalink).toBeCalledTimes(1)
+    expect((transformPermalink.mock.calls[0][0])).toBe('./index.html')
+    expect((transformPermalink.mock.calls[0][1])).toBe(ClientSideFileType.HTML)
+    expect(html).not.toContain('href="./index.html"')
+    expect(html).toContain(`href="${transformedPermalink}"`)
+  })
+})