drawio_dsl 0.8.8 → 0.8.9

data/.builders/generators/project-plan.rb

@@ -1,85 +0,0 @@
-KManager.action :project_plan do
-  action do
-
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(rounded: 1, glass: 1)
-      .page('In progress', theme: :style_03, margin_left: 0, margin_top: 0) do
-
-        # h5(x: 300, y: 0, w: 400, h: 80, title: 'DrawIO DSL')
-        # p(x: 350, y: 40, w: 400, h: 80, title: 'Project plan - In progress')
-
-        grid_layout(y: 90, direction: :horizontal, grid_h: 80, grid_w: 320, wrap_at: 3, grid: 0)
-        
-        todo(title: 'improve coverage')
-        todo(title: 'class html builder to support include/extend modules, class methods')
-        todo(title: 'add new shapes related to line connectors')
-        todo(title: 'line connector aliases gives a simple way to use predefined line configurations')
-        todo(title: 'line connectors need to support autolinking using ids')
-        todo(title: 'line connectors should not effect the grid positioning systems')
-        todo(title: 'export diagram json for use with a different DSL builder')
-      end
-      .page('To Do', theme: :style_02, margin_left: 0, margin_top: 0) do
-
-        # h5(x: 300, y: 0, w: 400, h: 80, title: 'DrawIO DSL')
-        # p(x: 350, y: 40, w: 400, h: 80, title: 'Project plan')
-
-        grid_layout(y:90, direction: :horizontal, grid_h: 80, grid_w: 320, wrap_at: 3, grid: 0)
-
-        todo(title: 'refactor HTML builder to custom GEM or use existing ruby GEM')
-        todo(title: 'add page background to theme, use it whenever the theme is set at a diagram/page level')
-        todo(title: 'move DrawioDsl::Formatters::Factory::FORMATTERS to resource file')
-        todo(title: 'move DrawioDsl::Formatters::StyleBuilder::MAPPINGS to resource file')
-        todo(title: 'settings style attributes need to de-duplicate, might be best to utilize the new StyleBuilder class')
-        todo(title: 'write SVG directly into other projects')
-        todo(title: 'add :shape, :line and :text to random shape generator, note: you can see the issue in the samples/20-styled-shapes.rb where the text is not rendered')
-        todo(title: 'Nodes need to support child nodes')
-        todo(title: 'Grid layout does not position itself in relation to the last element')
-        todo(title: 'Dynamic sized shapes that expand to the size of their text')
-        todo(title: 'Control of text padding left, right, top and bottom')
-        todo(title: 'Improve the theme control over text-only shapes')
-        todo(title: 'x,y settings do not work for shapes within a grid layout')
-        todo(title: 'page layout so that you drop elements on and they are positioned correctly, e.g centered, left, right, etc, maybe a grid layout with a wrap of 1 and a width of the page is sufficient')
-      end
-      .page('Done', theme: :style_06, margin_left: 0, margin_top: 0) do
-
-        # h5(x: 300, y: 0, w: 400, h: 80, title: 'DrawIO DSL')
-        # p(x: 350, y: 40, w: 400, h: 80, title: 'Done')
-
-        grid_layout(y:90, direction: :horizontal, grid_h: 80, grid_w: 320, wrap_at: 3, grid: 0)
-
-        todo(title: 'export_json will output a diagram in machine readable format')
-        todo(title: 'class html formatter to support regular html nodes such as p, h1.. ul, li that are found on the builder')
-        todo(title: 'group box, like a regular box but with a top aligned h1 style title')
-        todo(title: 'build a domain (class) diagram')
-        todo(title: 'build configuration for line strokes %i[dashed dotted dashdot dashdotdot dotdotdot longdash)')
-        todo(title: 'build configuration for line compass %i[n ne e se s sw w nw]')
-        todo(title: 'build configuration for line shape %i[style1 style2 style3 style4]')
-        todo(title: 'build configuration for arrows %i[straight triangle diamond circle cross short default none plain skewed_dash concave er_many er_one er_one_optional er_one_mandatory er_many_optional er_many_mandatory]')
-        todo(title: 'refactor the shape->text_only (boolean) to category (symbol)')
-        todo(title: 'ensure that ids are working as expected')
-        todo(title: 'alter the initial parameter of all shapes so that it can be an ID, without named attribute')
-        todo(title: 'move project-plan files')
-        todo(title: 'alter configure_shape so it sets the default shape key and use that for selecting the default HTML formatter')
-        todo(title: 'add todo shape to simplify project plan drawing')
-        todo(title: 'introduce .value property to shape and let it use either formatted HTML or plain text title')
-        todo(title: 'formatter DSL that can render HTML directly into the value property')
-        todo(title: 'formatter DSL for class and interface generation')
-        todo(title: 'generate extension based graphics based on drawio extensions.js')
-        todo(title: 'active? flag on page defaulting to true. set to false to exclude page from diagram.')
-        todo(title: 'first level child nodes need to hang of node 1')
-        todo(title: 'node has child nodes and add_node will set a nodes parent')
-        todo(title: 'nodes can belong to a parent node, the top level node responds with truthy to root?')
-        todo(title: 'add sample diagram for the github readme file')
-        todo(title: 'write samples into docs folder and display in readme')
-        todo(title: 'add export as .PNG, needs to take a page number as the PNG will not support multiple pages')
-        todo(title: 'add export as .SVG, needs to take a page number as the SVG will not support multiple pages')
-        todo(title: 'add save as .drawio')
-      end
-      .cd(:docs)
-      .save('project-plan/project.drawio')
-      .export_svg('project-plan/project_in_progress', page: 1)
-      .export_svg('project-plan/project_todo'       , page: 2)
-      .export_svg('project-plan/project_done'       , page: 3)
-  end
-end

data/.builders/generators/sample_diagrams/05-samples.rb

@@ -1,36 +0,0 @@
-def rnd(max)
-  Random.rand(0..max) == 0 ? 1 : 0
-end
-KManager.action :bootstrap do
-  action do
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_01)
-      .page('Samples') do
-        grid_layout(wrap_at: 5)
-
-        # KConfig.configuration.drawio.shapes.select { |shape| shape.type != :shape && !shape.text_only }.each do |shape|
-        #   # print random number between 0 and 1
-        #   send(shape.type, theme: KConfig.configuration.drawio.random_theme, title: shape.type.to_s, shape: shape, rounded: rnd(2), gloss: rnd(2), sketch: rnd(8))
-        # end
-
-        for jersy_number in 67..112
-          team_color = :style_02
-          team_color = :style_03 if jersy_number % 3 == 0
-          team_color = :style_04 if jersy_number % 12 == 0
-
-          if jersy_number % 20 == 0
-            cloud(title: jersy_number, theme: team_color)
-          else
-            actor(title: jersy_number, theme: team_color)
-          end
-        end
-      
-
-      end
-      .cd(:spec)
-      .osave('.samples/05-samples.drawio')
-      # .cd(:docs)
-      # .export_svg('samples/samples', page: 1)
-  end
-end

data/.builders/generators/sample_diagrams/10-page-margin.rb

@@ -1,42 +0,0 @@
-KManager.action :bootstrap do
-  action do
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_01)
-      .page('PgMargin-default') do
-        grid_layout(wrap_at: 4)
-        square(title: 'Page Margin 50, 50 (Default)')
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .page('PgMargin-0-0', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 4)
-        square(title: 'Page Margin 0, 0')
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .page('PgMargin-90-70', margin_left: 90, margin_top: 70) do
-        grid_layout(wrap_at: 4)
-        square(title: 'Page Margin 90, 70')
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .cd(:spec)
-      .save('.samples/10-page-margin.drawio')
-  end
-end

data/.builders/generators/sample_diagrams/15-grid-direction.rb

@@ -1,34 +0,0 @@
-KManager.action :bootstrap do
-  action do
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_01)
-      .page('Horizontal', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3, direction: :horizontal)
-        h4(title: 'Horizontal')
-        circle(title: '01')
-        square(title: '02')
-        circle(title: '03')
-        square(title: '04')
-        circle(title: '05')
-        square(title: '06')
-        circle(title: '07')
-      end
-      .page('Vertical', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3, direction: :vertical)
-        h4(title: 'Vertical')
-        circle(title: '01')
-        square(title: '02')
-        circle(title: '03')
-        square(title: '04')
-        circle(title: '05')
-        square(title: '06')
-        circle(title: '07')
-      end
-      .cd(:spec)
-      .save('.samples/15-grid-direction.drawio')
-      .cd(:docs)
-      .export_svg('samples/grid-direction-horizontal', page: 1)
-      .export_svg('samples/grid-direction-vertical', page: 2)
-  end
-end

data/.builders/generators/sample_diagrams/16-grid-alignment.rb

@@ -1,70 +0,0 @@
-KManager.action :bootstrap do
-  action do
-
-    # KConfig.configuration.drawio.square.w = KConfig.configuration.drawio.square.w / 4
-    # KConfig.configuration.drawio.square.h = KConfig.configuration.drawio.square.h / 4
-    # KConfig.configuration.drawio.circle.w = KConfig.configuration.drawio.circle.w / 4
-    # KConfig.configuration.drawio.circle.h = KConfig.configuration.drawio.circle.h / 4
-    # KConfig.configuration.drawio.rectangle.w = KConfig.configuration.drawio.rectangle.w / 4
-    # KConfig.configuration.drawio.rectangle.h = KConfig.configuration.drawio.rectangle.h / 4
-
-    director = DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_01)
-      .page('Grid-Center', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3)
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .page('Grid-Top', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3, v_align: :top, h_align: :center)
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .page('Grid-Bottom', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3, v_align: :bottom, h_align: :center)
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .page('Grid-Left', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3, v_align: :center, h_align: :left)
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .page('Grid-Right', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 3, v_align: :center, h_align: :right)
-        circle
-        square
-        circle
-        square
-        circle
-        square
-        circle
-      end
-      .cd(:spec)
-      .save('.samples/16-grid-alignment.drawio')
-      .cd(:docs)
-      # note: there is no difference between center and top/bottom/left/right using SVG/PNG
-      .export_svg('samples/grid-alignment', page: 1)
-  end
-end

data/.builders/generators/sample_diagrams/20-styles.rb

@@ -1,61 +0,0 @@
-KManager.action :styled_shapes do
-  action do
-
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_06)
-      .page('Style-Plain', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 5)
-
-        KConfig.configuration.drawio.shapes.members.each do |shape|
-          next if shape == :shape
-
-          send(shape, title: shape.to_s, shape: shape)
-        end
-      end
-      .page('Style-Shadow', shadow: 1, margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 5)
-
-        KConfig.configuration.drawio.shapes.members.each do |shape|
-          next if shape == :shape
-
-          send(shape, title: shape.to_s, shape: shape)
-        end
-      end
-      .page('Style-Rounded', rounded: 1, margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 5)
-
-        KConfig.configuration.drawio.shapes.members.each do |shape|
-          next if shape == :shape
-
-          send(shape, title: shape.to_s, shape: shape)
-        end
-      end
-      .page('Style-Glass', glass: 1, margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 5)
-
-        KConfig.configuration.drawio.shapes.members.each do |shape|
-          next if shape == :shape
-
-          send(shape, title: shape.to_s, shape: shape)
-        end
-      end
-      .page('Style-Sketch', sketch: 1, margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 5)
-
-        KConfig.configuration.drawio.shapes.members.each do |shape|
-          next if shape == :shape
-
-          send(shape, title: shape.to_s, shape: shape)
-        end
-      end
-      .cd(:spec)
-      .osave('.samples/20-styled-shapes.drawio')
-      .cd(:docs)
-      .export_svg('samples/styles-plain', page: 1)
-      .export_svg('samples/styles-shadow', page: 2)
-      .export_svg('samples/styles-rounded', page: 3)
-      .export_svg('samples/styles-glass', page: 4)
-      .export_svg('samples/styles-sketch', page: 5)
-  end
-end

data/.builders/generators/sample_diagrams/25-themes.rb

@@ -1,37 +0,0 @@
-KManager.action :bootstrap do
-  action do
-
-    # :rounded, :shadow, :sketch, :glass
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_06)
-      .page('Style-Plain', margin_left: 0, margin_top: 0, rounded: 1, background: '#FFEADB') do
-        grid_layout(wrap_at: 8)
-
-        KConfig.configuration.drawio.themes.keys.each do |theme|
-          square(title: theme.to_s, theme: theme)
-        end
-      end
-      .page('Style-Plain', margin_left: 0, margin_top: 0, rounded: 1, background: '#FFEADB') do
-        grid_layout(wrap_at: 8)
-
-        KConfig.configuration.drawio.themes.keys.each do |theme|
-          circle(title: theme.to_s, theme: theme)
-        end
-      end
-      .page('Style-Plain', margin_left: 0, margin_top: 0, rounded: 1, background: '#FFEADB') do
-        grid_layout(wrap_at: 8)
-
-        KConfig.configuration.drawio.themes.keys.each do |theme|
-          random(title: theme.to_s, theme: theme)
-        end
-      end
-      .cd(:spec)
-      .save('.samples/25-themes.drawio')
-      .cd(:docs)
-      .export_svg('samples/themes-square', page: 1)
-      .export_svg('samples/themes-circle', page: 2)
-      .export_svg('samples/themes-random', page: 3)
-
-  end
-end

data/.builders/generators/sample_diagrams/30-html-shapes.rb

@@ -1,70 +0,0 @@
-KManager.action :html_shapes do
-  action do
-
-    # :rounded, :shadow, :sketch, :glass
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_11)
-      .page('Style-Plain', margin_left: 0, margin_top: 0, rounded: 0, background: '#FFEADB') do
-        grid_layout(wrap_at: 8)
-
-        interface(theme: :style_07) do
-          format
-            .header('IPerson')
-            .field(:field1, type: :string)
-            .field(:field2, type: :string)
-            .method(:full_name, type: :string)
-        end
-
-        klass do
-          format(:class)
-            .header('Person')
-            .field(:field1, type: :string)
-            .field(:field2, type: :string)
-            .field(:age, type: :integer)
-            .field(:birthday, type: :date)
-            .method(:full_name, type: :string)
-        end
-
-        klass(h: 280) do
-          format
-            .header('Custom HTML')
-            .p('David')
-            .b('Cruwys')
-            .hr
-            .h1('h1')
-            .h2('h2')
-            .h3('h3')
-            .h4('h4')
-            .h5('h5')
-            .h6('h6')
-            .ul_s
-            .li('li')
-            .li('li')
-            .ul_e
-        end
-
-        interface(theme: :style_07, h: 280) do
-          format
-            .header('ICustom HTML')
-            .p('David')
-            .b('Cruwys')
-            .hr
-            .h1('h1')
-            .h2('h2')
-            .h3('h3')
-            .h4('h4')
-            .h5('h5')
-            .h6('h6')
-            .ul_s
-            .li('li')
-            .li('li')
-            .ul_e
-        end
-      end
-      .cd(:spec)
-      .osave('.samples/30-html-shapes.drawio')
-      # .cd(:docs)
-      # .export_svg('samples/html-shapes', page: 1)
-  end
-end

data/.builders/generators/sample_diagrams/35-ids-and-arrows.rb

@@ -1,28 +0,0 @@
-KManager.action :bootstrap do
-  action do
-
-    DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_06)
-      .page('Style-Plain', margin_left: 0, margin_top: 0) do
-        grid_layout(wrap_at: 2, grid_w: 400)
-
-        shape_count = 2
-        # for 1 to 20 step 2
-        (1..shape_count).step(2).each do |i|
-          circle(i, title: i)
-          ellipse(i+1, title: i + 1)
-        end
-
-        (1..shape_count).step(2).each do |i|
-          line(source: i, target: i+1)
-        end
-
-        # # label = '<div style="background-color: #B85450; height: 100%; margin: 0; border: 1px solid red;"><p style="padding: 10px; font-size: 12px;color: #ffffff;width: 150px;"><img style="margin-right: 20px" src="https://picsum.photos/40" /> the quick brown fox jumped over the lazy dog</p></div>'
-        # label = ''
-
-      end
-      .cd(:spec)
-      .save('.samples/35-ids-and-arrows.drawio')
-  end
-end

data/.builders/generators/sample_diagrams/50-willoughby-council.rb

@@ -1,51 +0,0 @@
-KManager.action :bootstrap do
-  action do
-
-    # :rounded, :shadow, :sketch, :glass
-    director = DrawioDsl::Drawio
-      .init(k_builder, on_exist: :write, on_action: :execute)
-      .diagram(theme: :style_03)
-      .page('Shapes', margin_left: 0, margin_top: 0, rounded: 1) do
-        grid_layout(direction: :vertical, grid_h: 120, grid_w: 400, wrap_at: 10, grid: 0)
-
-        h5(w: 400, h: 80, title: 'Preparation for Investigation')
-        p(w: 400, h: 80, title: '(<b>source</b>: <i>Hunter & Central Coast Regional Environmental Management Strategy – Investigations guideline</i>)')
-        square(w: 300, h: 80, title: 'Enter report into system')
-        square(w: 300, h: 80, title: 'Preliminary Review')
-        square(w: 300, h: 80, title: 'Insufficient Information')
-        square(w: 300, h: 80, title: 'Seek Additional Information')
-        square(w: 300, h: 80, title: 'Identify Possible Breach')
-        square(w: 300, h: 80, title: 'Insufficient evidence or no breach detected')
-        square(w: 300, h: 80, title: 'Plan follow up action')
-        square(w: 300, h: 80, title: 'Establish Jurisdiction - Council or other agency?')
-        square(w: 300, h: 80, title: 'Refer to other agency')
-        square(w: 300, h: 80, title: 'Council Responsibility')
-        square(w: 300, h: 80, title: 'Plan investigation')
-        square(w: 300, h: 80, title: 'Conduct investigation Gather and manage evidence (Evidence Gathering Guideline)')
-        square(w: 300, h: 80, title: 'Prepare recommendations report')
-        square(w: 300, h: 80, title: 'Make decision')
-        square(w: 300, h: 80, title: 'Take action (Enforcement Options Guideline)')
-        square(w: 300, h: 80, title: 'Review investigation')
-        square(w: 300, h: 80, title: 'Close case')
-        square(w: 300, h: 80, title: 'Feedback to complainant')
-
-        grid_layout(wrap_at: 40, direction: :vertical, grid_w: 250, grid_h: 150, wrap_at: 5)
-
-        square(theme: :style_02, w: 240, h: 140, title: '1. Complaint received by Council gets recorded into the system.')
-        square(theme: :style_02, w: 240, h: 140, title: '2. Council Officer will review the nature of the complaint and consider what evidence or information it has.')
-        square(theme: :style_02, w: 240, h: 140, title: '3. If the information given thus far is insufficient Officer can go back to complainant and seek additional information.')
-        square(theme: :style_02, w: 240, h: 140, title: '4. With that information Council should be in a position to identify whether there has been a breach.')
-        square(theme: :style_02, w: 240, h: 140, title: '5. If there has been a breach: establish whether it&apos;s a matter for which the Council has jurisdiction (ie is it a piece of legislation for which the Council has the authority to enforce?).')
-        square(theme: :style_02, w: 240, h: 140, title: '6. If not: Council can refer that matter to another agency; such as Police, Fisheries, Transport NSW, EPA etc')
-        square(theme: :style_02, w: 240, h: 140, title: '7. If it is the Councils responsibility then Council needs to plan out the investigation. That will be through: gathering and collecting evidence through statements, observations, interviews, samples, items of interest.')
-        square(theme: :style_02, w: 240, h: 140, title: '8. The Council Officer should prepare a recommendations report which will: <br/>* go through the history of the matter <br/>* go through the investigations that have happened <br/>* go through the evidence that the Council has and then provide a recommendation as to the future action to be taken')
-        square(theme: :style_02, w: 240, h: 140, title: '9. Once the Council has that evidence and is in a position that it thinks it can MAKE A DECISION')
-        square(theme: :style_02, w: 240, h: 140, title: '10. TAKE ACTION: Once a decision is made as to the action that should happen in respect of the breach the council can then decide as to what the appropriate action is: WARNING, CIVIL, CRIMINAL and then proceed from there => it is important to keep the complainant informed throughout the entire process to be able to explain why you have taken the course you&apos;ve taken and to be able to justify it')
-
-      end
-      .cd(:spec)
-      .save('.samples/50-willoughby-council.drawio')
-      .cd(:docs)
-      .export_svg('samples/willoughby-council', page: 1)
-  end
-end